@alchemy.run/modal 0.0.0 → 2.0.0-beta.87

package/lib/DictClient.js

@@ -0,0 +1,89 @@
+import * as dict from "@distilled.cloud/modal/dict";
+import * as Effect from "effect/Effect";
+import { decodeJson, encodeJson } from "./BindingHttp.js";
+import { operations } from "./internal.js";
+/** The dict operations the clients call, resolved by `ModalBindings.withCredentials`. */
+export const DictOps = operations({
+    clearDict: dict.clearDict,
+    dictContains: dict.dictContains,
+    dictContents: dict.dictContents,
+    dictLen: dict.dictLen,
+    dictPop: dict.dictPop,
+    getDict: dict.getDict,
+    updateDict: dict.updateDict,
+});
+export const makeReadDictClient = (dictId, ops) => ({
+    dictId,
+    get: (key) => Effect.gen(function* () {
+        const encodedKey = yield* encodeJson(key);
+        const id = yield* dictId;
+        const response = yield* ops.getDict({
+            dictId: id,
+            key: encodedKey,
+        });
+        return response.found && response.value !== undefined
+            ? yield* decodeJson(response.value)
+            : undefined;
+    }),
+    contains: (key) => Effect.gen(function* () {
+        const encodedKey = yield* encodeJson(key);
+        const id = yield* dictId;
+        const response = yield* ops.dictContains({
+            dictId: id,
+            key: encodedKey,
+        });
+        return response.found ?? false;
+    }),
+    len: () => Effect.gen(function* () {
+        const id = yield* dictId;
+        const response = yield* ops.dictLen({ dictId: id });
+        return response.len ?? 0;
+    }),
+    entries: () => Effect.gen(function* () {
+        const id = yield* dictId;
+        const { items } = yield* ops.dictContents({
+            dictId: id,
+            keys: true,
+            values: true,
+        });
+        return yield* Effect.forEach(items, (entry) => Effect.all([decodeJson(entry.key ?? ""), decodeJson(entry.value ?? "")]));
+    }),
+});
+export const makeWriteDictClient = (dictId, ops) => ({
+    dictId,
+    put: (key, value, options = {}) => Effect.gen(function* () {
+        const encodedKey = yield* encodeJson(key);
+        const id = yield* dictId;
+        const response = yield* ops.updateDict({
+            dictId: id,
+            updates: [{ key: encodedKey, value: yield* encodeJson(value) }],
+            ifNotExists: options.ifNotExists,
+        });
+        return options.ifNotExists ? (response.created ?? false) : true;
+    }),
+    update: (entries) => Effect.gen(function* () {
+        const updates = yield* Effect.forEach([...entries], ([key, value]) => Effect.all({ key: encodeJson(key), value: encodeJson(value) }));
+        const id = yield* dictId;
+        yield* ops.updateDict({ dictId: id, updates });
+    }),
+    pop: (key) => Effect.gen(function* () {
+        const encodedKey = yield* encodeJson(key);
+        const id = yield* dictId;
+        const response = yield* ops.dictPop({
+            dictId: id,
+            key: encodedKey,
+        });
+        return response.found && response.value !== undefined
+            ? yield* decodeJson(response.value)
+            : undefined;
+    }),
+    clear: () => Effect.gen(function* () {
+        const id = yield* dictId;
+        yield* ops.clearDict({ dictId: id });
+    }),
+});
+export const makeReadWriteDictClient = (dictId, ops) => ({
+    ...makeReadDictClient(dictId, ops),
+    ...makeWriteDictClient(dictId, ops),
+});
+//# sourceMappingURL=DictClient.js.map

package/lib/DictClient.js.map

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

package/lib/Domain.d.ts

@@ -0,0 +1,86 @@
+import * as domain from "@distilled.cloud/modal/domain";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import type { Providers } from "./Providers.ts";
+declare const DomainUnexpectedResponse_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Modal.DomainUnexpectedResponse";
+} & Readonly<A>;
+export declare class DomainUnexpectedResponse extends DomainUnexpectedResponse_base<{
+    readonly message: string;
+}> {
+}
+export interface DomainProps {
+    /** The domain name (`agents.example.com`). Changing it replaces the domain. */
+    domainName: string;
+}
+/** A DNS record to create at your DNS provider. */
+export interface DomainDnsRecord {
+    readonly type: string;
+    readonly name: string;
+    readonly value: string;
+}
+export interface DomainAttributes {
+    /** Domain ID. */
+    domainId: string;
+    /** The domain name. */
+    domainName: string;
+    /** Records to create at your DNS provider before the certificate issues. */
+    dnsRecords: DomainDnsRecord[];
+    /** `pending`, `issued`, `failed` or `revoked`. */
+    certificateStatus: string;
+}
+/**
+ * A custom domain for Modal web endpoints, sandbox tunnels
+ * (`customDomain` on `create`) and model endpoints. Create the records in
+ * `dnsRecords` at your DNS provider; Modal issues the certificate once they
+ * resolve.
+ *
+ * :::caution
+ * Modal has no API to remove a domain. Destroying this resource stops
+ * tracking it; remove the domain in the Modal dashboard.
+ * :::
+ *
+ * ### Adding a domain
+ * **Example:** Register a domain and output its DNS records
+ * ```typescript
+ * // alchemy.run.ts
+ * import * as Modal from "@alchemy.run/modal";
+ * import * as Alchemy from "alchemy";
+ * import * as Effect from "effect/Effect";
+ *
+ * export default Alchemy.Stack(
+ *   "Agents",
+ *   { providers: Modal.providers() },
+ *   Effect.gen(function* () {
+ *     const agents = yield* Modal.Domain("Agents", { domainName: "agents.example.com" });
+ *     return { records: agents.dnsRecords, certificate: agents.certificateStatus };
+ *   }),
+ * );
+ * ```
+ *
+ * ### Serving a sandbox on it
+ * **Example:** Tunnels on the custom domain
+ * ```typescript
+ * const sandbox = yield* sandboxes.create({
+ *   encryptedPorts: [3000],
+ *   customDomain: "agents.example.com",
+ * });
+ * ```
+ *
+ * @resource
+ * @product Domain
+ */
+export declare const Domain: import("alchemy/Resource").ResourceConstructor<Domain, Providers> & Effect.Effect<import("alchemy/Resource").ResourceConstructor<Domain, never>, never, never> & {
+    Self: import("alchemy/Self").Self<Domain>;
+    Provider: Provider.Provider<Domain>;
+    Aliases: readonly string[] | undefined;
+    ref(id: string, options?: {
+        stage?: string;
+        stack?: string;
+    }): Effect.Effect<Domain, never, never>;
+} & ((id: string, props: import("./internal/Declared.ts").DeclaredProps<DomainProps>) => Effect.Effect<Domain, never, Providers>);
+export type Domain = Resource<"Modal.Domain", DomainProps, DomainAttributes, never, Providers>;
+export declare const DomainProvider: () => import("effect/Layer").Layer<Provider.Provider<Domain>, never, domain.ModalOpContext>;
+export {};
+//# sourceMappingURL=Domain.d.ts.map

package/lib/Domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Domain.d.ts","sources":["../src/Domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AAExD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;;;;AAEhD,qBAAa,wBAAyB,SAAQ,8BAAmD;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;AAEL,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,MAAM;;;;;;;;iIAAyD,CAAC;AAE7E,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAoB/F,eAAO,MAAM,cAAc,6FA+CxB,CAAC"}

package/lib/Domain.js

@@ -0,0 +1,113 @@
+import * as domain from "@distilled.cloud/modal/domain";
+import { isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import { declarable } from "./internal/Declared.js";
+export class DomainUnexpectedResponse extends Data.TaggedError("Modal.DomainUnexpectedResponse") {
+}
+/**
+ * A custom domain for Modal web endpoints, sandbox tunnels
+ * (`customDomain` on `create`) and model endpoints. Create the records in
+ * `dnsRecords` at your DNS provider; Modal issues the certificate once they
+ * resolve.
+ *
+ * :::caution
+ * Modal has no API to remove a domain. Destroying this resource stops
+ * tracking it; remove the domain in the Modal dashboard.
+ * :::
+ *
+ * ### Adding a domain
+ * **Example:** Register a domain and output its DNS records
+ * ```typescript
+ * // alchemy.run.ts
+ * import * as Modal from "@alchemy.run/modal";
+ * import * as Alchemy from "alchemy";
+ * import * as Effect from "effect/Effect";
+ *
+ * export default Alchemy.Stack(
+ *   "Agents",
+ *   { providers: Modal.providers() },
+ *   Effect.gen(function* () {
+ *     const agents = yield* Modal.Domain("Agents", { domainName: "agents.example.com" });
+ *     return { records: agents.dnsRecords, certificate: agents.certificateStatus };
+ *   }),
+ * );
+ * ```
+ *
+ * ### Serving a sandbox on it
+ * **Example:** Tunnels on the custom domain
+ * ```typescript
+ * const sandbox = yield* sandboxes.create({
+ *   encryptedPorts: [3000],
+ *   customDomain: "agents.example.com",
+ * });
+ * ```
+ *
+ * @resource
+ * @product Domain
+ */
+export const Domain = declarable()(Resource("Modal.Domain"));
+const STATUS = {
+    CERTIFICATE_STATUS_PENDING: "pending",
+    CERTIFICATE_STATUS_ISSUED: "issued",
+    CERTIFICATE_STATUS_FAILED: "failed",
+    CERTIFICATE_STATUS_REVOKED: "revoked",
+};
+const toAttrs = (d) => ({
+    domainId: d.domainId ?? "",
+    domainName: d.domainName ?? "",
+    dnsRecords: (d.dnsRecords ?? []).map((record) => ({
+        type: (record.type ?? "").replace(/^DNS_RECORD_TYPE_/, ""),
+        name: record.name ?? "",
+        value: record.value ?? "",
+    })),
+    certificateStatus: STATUS[d.certificateStatus ?? ""] ?? "pending",
+});
+export const DomainProvider = () => Provider.effect(Domain, Effect.gen(function* () {
+    const observe = Effect.fn(function* (domainName) {
+        const { domains } = yield* domain.listDomain({});
+        return (domains ?? []).find((d) => d.domainName === domainName);
+    });
+    return {
+        stables: ["domainId", "domainName"],
+        diff: Effect.fn(function* ({ news, olds }) {
+            if (!isResolved(news))
+                return undefined;
+            return news.domainName !== olds?.domainName
+                ? { action: "replace" }
+                : undefined;
+        }),
+        read: Effect.fn(function* ({ olds, output }) {
+            const name = output?.domainName ?? olds?.domainName;
+            if (!name)
+                return undefined;
+            const found = yield* observe(name);
+            return found ? toAttrs(found) : undefined;
+        }),
+        reconcile: Effect.fn(function* ({ news, session }) {
+            // Observe, then ensure; refresh the certificate status either way.
+            let found = yield* observe(news.domainName);
+            if (!found) {
+                yield* session.note(`Adding domain ${news.domainName}...`);
+                yield* domain
+                    .createDomain({ domainName: news.domainName })
+                    .pipe(Effect.catchTag("DomainAlreadyExists", () => Effect.void));
+                found = yield* observe(news.domainName);
+            }
+            if (!found?.domainId) {
+                return yield* new DomainUnexpectedResponse({
+                    message: `Modal domain ${news.domainName} was not listed after create`,
+                });
+            }
+            const verified = yield* domain
+                .verifyDomainCertificate({ domainId: found.domainId })
+                .pipe(Effect.catchTag("DomainNotFound", () => Effect.succeed({ domain: found })));
+            return toAttrs(verified.domain ?? found);
+        }),
+        // Modal has no domain delete RPC; see the caution in the JSDoc.
+        delete: () => Effect.void,
+    };
+}));
+//# sourceMappingURL=Domain.js.map

package/lib/Domain.js.map

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

package/lib/Endpoint.d.ts

@@ -0,0 +1,181 @@
+import * as endpoint from "@distilled.cloud/modal/endpoint";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { type EnvironmentInput } from "./internal.ts";
+import type { Providers } from "./Providers.ts";
+declare const EndpointProvisioningFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Modal.EndpointProvisioningFailed";
+} & Readonly<A>;
+/** Provisioning failed, was cancelled, or didn't finish in time. */
+export declare class EndpointProvisioningFailed extends EndpointProvisioningFailed_base<{
+    readonly endpointId: string;
+    readonly status: string;
+    readonly message: string;
+}> {
+}
+/** Where the model comes from. */
+export type EndpointModel = 
+/** A model from Modal's catalog, by Hugging Face repo id (`"Qwen/Qwen3-8B"`). */
+{
+    readonly repoId: string;
+}
+/** A Hugging Face repo, with a token for gated or private models. */
+ | {
+    readonly huggingface: string;
+    readonly revision?: string;
+    readonly token?: string | Redacted.Redacted<string>;
+    /** The catalog model it's derived from, for serving defaults. */
+    readonly baseModel: string;
+}
+/** Weights on a Modal Volume. */
+ | {
+    readonly volume: {
+        readonly volumeId: string;
+    };
+    readonly path: string;
+    /** The catalog model it's derived from, for serving defaults. */
+    readonly baseModel: string;
+};
+export type EndpointApi = "openai-chat-completions" | "openai-responses" | "anthropic-messages";
+export interface EndpointProps {
+    /**
+     * Endpoint name, unique per environment. If omitted, one is generated from
+     * the stack, stage and logical ID. Changing it replaces the endpoint.
+     */
+    name?: string;
+    /** Environment the endpoint runs in. Changing it replaces the endpoint. */
+    environment?: EnvironmentInput;
+    /** The model to serve. Changing it replaces the endpoint. */
+    model: EndpointModel;
+    /**
+     * APIs the endpoint speaks.
+     * @default ["openai-chat-completions"]
+     */
+    apis?: EndpointApi[];
+    /**
+     * Inputs the model accepts.
+     * @default ["text"]
+     */
+    inputs?: Array<"text" | "image" | "audio">;
+    /**
+     * `dedicated` runs on GPUs reserved for you (billed while running);
+     * `shared` runs on Modal's shared pool.
+     * @default "dedicated"
+     */
+    servingMode?: "dedicated" | "shared";
+    /** Regions the model runs in. @default Modal picks */
+    regions?: string[];
+    /**
+     * The region requests enter through. Changing it replaces the endpoint.
+     * @default "us-west"
+     */
+    routingRegion?: string;
+    /**
+     * Serve without proxy authentication. Without it, callers send a
+     * `Modal.WebhookToken` as `Modal-Key` / `Modal-Secret`, and Modal only
+     * creates the endpoint once a webhook token with access to its environment
+     * exists (`EndpointProxyTokenRequired` otherwise): deploy the token first.
+     * @default false
+     */
+    unauthenticated?: boolean;
+    /** Free-form description. */
+    description?: string;
+}
+export interface EndpointAttributes {
+    /** Endpoint ID. */
+    endpointId: string;
+    /** Endpoint name. */
+    name: string;
+    /** Environment name, or `undefined` for the workspace default. */
+    environment: string | undefined;
+    /** Base URL of the endpoint's APIs (`…/v1/chat/completions`, `…/v1/messages`). */
+    url: string;
+    /** Whether callers need a proxy auth token. */
+    requiresAuth: boolean;
+}
+/**
+ * A Modal Endpoint: a managed model server that speaks the OpenAI Chat
+ * Completions, OpenAI Responses or Anthropic Messages API, from a catalog
+ * model, a Hugging Face repo, or weights on a Modal Volume.
+ *
+ * Reconcile waits until the endpoint is live, which takes minutes while the
+ * model loads. Modal can't change an endpoint in place, so any change
+ * replaces it.
+ *
+ * :::caution
+ * A dedicated endpoint reserves GPUs and is billed while it runs. Destroy it
+ * (or use `servingMode: "shared"`) when you're done.
+ * :::
+ *
+ * ### Serving a model
+ * **Example:** A catalog model behind the OpenAI API
+ * ```typescript
+ * import * as Modal from "@alchemy.run/modal";
+ *
+ * export const Qwen = Modal.Endpoint("Qwen", {
+ *   model: { repoId: "Qwen/Qwen3-8B" },
+ *   apis: ["openai-chat-completions", "anthropic-messages"],
+ * });
+ * ```
+ *
+ * **Example:** Fine-tuned weights from a Volume
+ * ```typescript
+ * import * as Modal from "@alchemy.run/modal";
+ *
+ * export const Weights = Modal.Volume("Weights", {});
+ * export const Tuned = Modal.Endpoint("Tuned", {
+ *   model: { volume: Weights, path: "/checkpoints/final", baseModel: "Qwen/Qwen3-8B" },
+ * });
+ * ```
+ *
+ * ### Calling it
+ * **Example:** From a Cloudflare Worker with `Modal.FetchServer`
+ * ```typescript
+ * import * as Cloudflare from "@alchemy.run/cloudflare";
+ * import * as Modal from "@alchemy.run/modal";
+ * import * as Effect from "effect/Effect";
+ * import * as HttpClientRequest from "effect/http/HttpClientRequest";
+ * import * as HttpServerResponse from "effect/http/HttpServerResponse";
+ * import { Qwen } from "./Qwen.ts";
+ *
+ * export default class Chat extends Cloudflare.Worker<Chat>()(
+ *   "Chat",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     // Creates a webhook token for the Worker and sends it as Modal's proxy auth.
+ *     const qwen = yield* Modal.FetchServer(Qwen);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const response = yield* qwen.fetch(
+ *           HttpClientRequest.post("/v1/chat/completions").pipe(
+ *             HttpClientRequest.bodyJsonUnsafe({
+ *               model: "Qwen/Qwen3-8B",
+ *               messages: [{ role: "user", content: "hi" }],
+ *             }),
+ *           ),
+ *         );
+ *         return HttpServerResponse.json(yield* response.json);
+ *       }).pipe(Effect.orDie),
+ *     };
+ *   }).pipe(Effect.provide(Modal.FetchServerHttp)),
+ * ) {}
+ * ```
+ *
+ * @resource
+ * @product Endpoint
+ */
+export declare const Endpoint: import("alchemy/Resource").ResourceConstructor<Endpoint, Providers> & Effect.Effect<import("alchemy/Resource").ResourceConstructor<Endpoint, never>, never, never> & {
+    Self: import("alchemy/Self").Self<Endpoint>;
+    Provider: Provider.Provider<Endpoint>;
+    Aliases: readonly string[] | undefined;
+    ref(id: string, options?: {
+        stage?: string;
+        stack?: string;
+    }): Effect.Effect<Endpoint, never, never>;
+} & ((id: string, props: import("./internal/Declared.ts").DeclaredProps<EndpointProps>) => Effect.Effect<Endpoint, never, Providers>);
+export type Endpoint = Resource<"Modal.Endpoint", EndpointProps, EndpointAttributes, never, Providers>;
+export declare const EndpointProvider: () => import("effect/Layer").Layer<Provider.Provider<Endpoint>, never, import("alchemy/Stack").Stack | import("alchemy/Stage").Stage | endpoint.ModalOpContext>;
+export {};
+//# sourceMappingURL=Endpoint.d.ts.map

package/lib/Endpoint.d.ts.map

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