alchemy.run.ts

import { Buffer } from "node:buffer";
import {
  createECDH,
  createHash,
  generateKeyPairSync,
  randomBytes,
} from "node:crypto";
import { readFileSync } from "node:fs";
import * as Alchemy from "alchemy";
import * as Cloudflare from "alchemy/Cloudflare";
import * as Command from "alchemy/Command";
import * as Output from "alchemy/Output";
import * as Provider from "alchemy/Provider";
import { Stack } from "alchemy/Stack";
import { Config, Effect, Layer, Option, Redacted } from "effect";
import migrationManifest from "./apps/core/migration-manifest.json" with {
  type: "json",
};
import productionBindingContract from "./apps/core/production-bindings.json" with {
  type: "json",
};
import { THREAD_SWEEP_CRON } from "./apps/core/src/notifications/snooze-cron.ts";
import { portalDomainSharesSite } from "./apps/core/src/portals/portal-site.ts";
import {
  E2BProfiles,
  e2bRecipeHash,
  HeldSecret,
  OrbContainers,
  orbRecipeHash,
  previewPublicOrbImage,
  selfhostProviders,
} from "./deploy/selfhost/alchemy-resources.ts";
import CLOUDFLARE_ORB_PROFILES from "./packages/domain/cloudflare-orb-profiles.json" with {
  type: "json",
};
import E2B_ORB_PROFILES from "./packages/domain/e2b-orb-profiles.json" with {
  type: "json",
};
import { decodeGitHubAppDeploymentConfiguration } from "./packages/domain/src/source-control/github-app-configuration.ts";
import {
  attachmentBucketCors,
  attachmentSigningTokenProps,
  workerLogsTokenProps,
} from "./scripts/attachment-deployment.mjs";

type RecordValue<T> = T extends Record<string, infer Value> ? Value : never;
type WorkloadIdentitySigningKey = Alchemy.Resource<
  "Dx.WorkloadIdentitySigningKey",
  Record<string, never>,
  { keyring: Redacted.Redacted<string> }
>;

const WorkloadIdentitySigningKey = Alchemy.Resource<WorkloadIdentitySigningKey>(
  "Dx.WorkloadIdentitySigningKey",
);

const createWorkloadIdentitySigningKeyring = () => {
  const keyPair = generateKeyPairSync("rsa", { modulusLength: 2048 });
  const kid = randomBytes(12).toString("base64url");
  return JSON.stringify({
    version: 1,
    activeKid: kid,
    keys: [
      {
        kid,
        privateKeyPkcs8: keyPair.privateKey.export({
          type: "pkcs8",
          format: "pem",
        }),
        publicJwk: {
          ...keyPair.publicKey.export({ format: "jwk" }),
          use: "sig",
          alg: "RS256",
          kid,
        },
      },
    ],
  });
};

const workloadIdentitySigningKeyProvider = () =>
  Provider.succeed(WorkloadIdentitySigningKey, {
    reconcile: ({ output }) =>
      Effect.sync(() =>
        output?.keyring === undefined
          ? { keyring: Redacted.make(createWorkloadIdentitySigningKeyring()) }
          : output,
      ),
    delete: () => Effect.void,
    read: ({ output }) => Effect.succeed(output),
  });

const sourceControlSchemaVersion = /^\d{4}/.exec(
  migrationManifest.d1.at(-1)?.filename ?? "",
)?.[0];
if (sourceControlSchemaVersion === undefined)
  throw new Error("Migration manifest has no source-control schema version.");

const defaultE2BOrbProfile = E2B_ORB_PROFILES.find(
  ({ id }) => id === "a1.medium",
);
if (defaultE2BOrbProfile === undefined)
  throw new Error("The default E2B Orb profile is missing from the catalog.");
const defaultCloudflareOrbProfile = CLOUDFLARE_ORB_PROFILES.find(
  ({ id }) => id === "cf.standard-2",
);
if (defaultCloudflareOrbProfile === undefined)
  throw new Error(
    "The default Cloudflare Orb profile is missing from the catalog.",
  );
/** What every deployed Orb size offers; see RunnerProfileCatalogConfiguration. */
const deployedOrbCapabilities = [
  "git",
  "environment-variables",
  "internet-access",
  "persistent-workspace",
  "pause-resume",
] as const;
const cloudflareOrbProfiles = CLOUDFLARE_ORB_PROFILES.map((profile) => ({
  ...profile,
  adapter: "cloudflare",
  isolation: "container",
  availability: "available",
  capabilities: deployedOrbCapabilities,
}));

const productionWorkerBindings = <
  Groups extends Record<string, Record<string, unknown>>,
>(
  groups: Groups,
): Record<string, RecordValue<RecordValue<Groups>>> => {
  const contract = productionBindingContract.bindings
    .map(({ name, type }) => ({
      name,
      type,
    }))
    .sort((left, right) => left.name.localeCompare(right.name));
  const actual = Object.entries(groups)
    .flatMap(([type, values]) =>
      Object.keys(values).map((name) => ({ name, type })),
    )
    .sort((left, right) => left.name.localeCompare(right.name));
  const required = productionBindingContract.bindings
    .filter((binding) => !("optional" in binding && binding.optional))
    .map(({ name, type }) => ({ name, type }))
    .sort((left, right) => left.name.localeCompare(right.name));
  if (
    productionBindingContract.version !== 1 ||
    new Set(contract.map(({ name }) => name)).size !== contract.length ||
    required.some(
      (binding) =>
        !actual.some(
          (candidate) =>
            candidate.name === binding.name && candidate.type === binding.type,
        ),
    ) ||
    actual.some(
      (binding) =>
        !contract.some(
          (candidate) =>
            candidate.name === binding.name && candidate.type === binding.type,
        ),
    )
  )
    throw new Error(
      "Alchemy Worker bindings drifted from the production binding contract.",
    );
  return Object.fromEntries(
    productionBindingContract.bindings.flatMap(({ name, type }) =>
      Object.hasOwn(groups[type] ?? {}, name)
        ? [[name, groups[type]?.[name]]]
        : [],
    ),
  ) as Record<string, RecordValue<RecordValue<Groups>>>;
};

const productionBindingByType = (type: string) => {
  const matches = productionBindingContract.bindings.filter(
    (binding) => binding.type === type,
  );
  if (matches.length !== 1)
    throw new Error(`Production binding contract must contain one ${type}.`);
  return matches[0];
};

const requiredHostedAuthenticationValue = <Value>(
  value: Value | undefined,
): Value => {
  if (value === undefined)
    throw new Error("Hosted authentication resource is unavailable.");
  return value;
};

const durableObjectBindingContract = () => {
  const contractBindings = productionBindingContract.bindings.filter(
    ({ type }) => type === "durable-object",
  );
  const authoredWrangler = JSON.parse(
    readFileSync(
      new URL("./apps/core/wrangler.jsonc", import.meta.url),
      "utf8",
    ),
  ) as {
    durable_objects?: {
      bindings?: Array<{ name: string; class_name: string }>;
    };
  };
  const authoredBindings = authoredWrangler.durable_objects?.bindings ?? [];
  const authoredContractNames = contractBindings
    .filter(({ provenance }) => provenance === "authored-wrangler")
    .map(({ name }) => name)
    .sort();
  const authoredNames = authoredBindings.map(({ name }) => name).sort();
  const generatedBindings = contractBindings.filter(
    ({ provenance }) => provenance === "generated-flue",
  );
  const canonicalClasses = migrationManifest.durableObjects.flatMap(
    ({ newSqliteClasses }) => newSqliteClasses,
  );
  const authoredClasses = authoredBindings.map(({ class_name }) => class_name);
  const generatedClasses = canonicalClasses.filter(
    (className) => !authoredClasses.includes(className),
  );

  if (
    JSON.stringify(authoredNames) !== JSON.stringify(authoredContractNames) ||
    new Set(canonicalClasses).size !== canonicalClasses.length ||
    authoredClasses.some(
      (className) => !canonicalClasses.includes(className),
    ) ||
    generatedBindings.length !== 1 ||
    generatedClasses.length !== 1
  )
    throw new Error(
      "Production Durable Object bindings do not match Wrangler and migration authorities.",
    );

  return [
    ...authoredBindings.map(({ name, class_name: className }) => ({
      name,
      className,
    })),
    { name: generatedBindings[0].name, className: generatedClasses[0] },
  ];
};

export default Alchemy.Stack(
  "dx-cloudflare",
  {
    providers: Layer.mergeAll(
      Cloudflare.providers(),
      Command.providers(),
      workloadIdentitySigningKeyProvider(),
      selfhostProviders(),
    ),
    state: Cloudflare.state(),
  },
  Effect.gen(function* () {
    const stack = yield* Stack;
    const configuration = yield* Config.all({
      environment: Config.String("DX_DEPLOYMENT_ENVIRONMENT"),
      deploymentTarget: Config.String("DX_DEPLOYMENT_TARGET"),
      deploymentLabel: Config.String("DX_DEPLOYMENT_LABEL"),
      deploymentName: Config.option(
        Config.NonEmptyString("DX_DEPLOYMENT_NAME"),
      ),
      adminEmail: Config.option(Config.NonEmptyString("DX_ADMIN_EMAIL")),
      adminPassword: Config.option(Config.Redacted("DX_ADMIN_PASSWORD")),
      adminPasswordReset: Config.withDefault(
        Config.Boolean("DX_ADMIN_PASSWORD_RESET"),
        false,
      ),
      integrations: Config.withDefault(
        Config.String("DX_DEPLOYMENT_INTEGRATIONS"),
        "",
      ),
      origin: Config.String("DX_DEPLOYMENT_ORIGIN"),
      authEmailFrom: Config.option(
        Config.NonEmptyString("DX_DEPLOYMENT_AUTH_EMAIL_FROM"),
      ),
      revision: Config.String("DX_DEPLOYMENT_REVISION"),
      workerName: Config.String("DX_DEPLOYMENT_WORKER_NAME"),
      databaseName: Config.String("DX_DEPLOYMENT_DATABASE_NAME"),
      bucketName: Config.String("DX_DEPLOYMENT_BUCKET_NAME"),
      credentialsFile: Config.String("DX_DEPLOYMENT_CREDENTIALS_FILE"),
      bootstrapRepository: Config.withDefault(
        Config.String("DX_DEPLOYMENT_BOOTSTRAP_REPOSITORY"),
        "",
      ),
      packageDirectory: Config.String("DX_DEPLOYMENT_PACKAGE_DIR"),
      dxdChecksum: Config.String("DX_DEPLOYMENT_DXD_CHECKSUM"),
      dxdReleaseUrl: Config.String("DX_DEPLOYMENT_DXD_RELEASE_URL"),
      sourceShallowClone: Config.withDefault(
        Config.Boolean("DX_DEPLOYMENT_SOURCE_SHALLOW_CLONE"),
        true,
      ),
      workspaceInactivityMs: Config.option(
        Config.Number("DX_DEPLOYMENT_WORKSPACE_INACTIVITY_MS"),
      ),
      turnstileTestKeys: Config.withDefault(
        Config.Boolean("DX_DEPLOYMENT_TURNSTILE_TEST_KEYS"),
        false,
      ),
      // Self-host only: whether magic link needs a Turnstile widget. Hosted
      // targets derive it from their sender.
      turnstile: Config.option(Config.Boolean("DX_DEPLOYMENT_TURNSTILE")),
      e2bApiKey: Config.option(Config.Redacted("E2B_API_KEY")),
      githubApp: Config.option(Config.Redacted("DX_INTEGRATION_GITHUB_APP")),
      sarvamApiKey: Config.option(Config.Redacted("SARVAM_API_KEY")),
      // Where the R2 S3 credentials Core signs attachment URLs with come
      // from: "token" deployments mint a bucket-scoped token; "operator"
      // self-hosts (Alchemy OAuth, which cannot create tokens) hold the R2
      // API token the operator created. Attachments move the same way.
      attachmentSigning: Config.withDefault(
        Config.Literals(
          ["token", "operator"] as const,
          "DX_DEPLOYMENT_ATTACHMENT_SIGNING",
        ),
        "token",
      ),
      attachmentR2Credentials: Config.option(
        Config.Redacted("DX_ATTACHMENT_R2_CREDENTIALS"),
      ),
      cloudflareAccountId: Config.option(
        Config.NonEmptyString("CLOUDFLARE_ACCOUNT_ID"),
      ),
      exaApiKey: Config.option(Config.Redacted("EXA_API_KEY")),
      // Optional: Boat on the deployment's own account. Self-host opts in
      // with the `boat` integration.
      boatApiKey: Config.option(Config.Redacted("BOAT_API_KEY")),
      // Self-host sign-in providers and admission, validated by the runner.
      signIn: Config.option(Config.NonEmptyString("DX_DEPLOYMENT_SIGN_IN")),
      googleClientSecret: Config.option(
        Config.Redacted("DX_GOOGLE_CLIENT_SECRET"),
      ),
      plugins: Config.withDefault(Config.String("DX_DEPLOYMENT_PLUGINS"), ""),
      // Orb providers the deployment offers on its own account: e2b,
      // cloudflare, both, or none (people and workspaces connect their own).
      orbProviders: Config.withDefault(
        Config.String("DX_DEPLOYMENT_ORB_PROVIDERS"),
        "e2b",
      ),
      orbWorkerName: Config.option(
        Config.NonEmptyString("DX_DEPLOYMENT_ORB_WORKER_NAME"),
      ),
      workloadIdentitySigningKeys: Config.option(
        Config.Redacted("DX_WORKLOAD_IDENTITY_SIGNING_KEYS"),
      ),
      bitbucketOAuth: Config.option(
        Config.Redacted("DX_INTEGRATION_BITBUCKET_OAUTH"),
      ),
      deploymentZone: Config.option(
        Config.NonEmptyString("DX_DEPLOYMENT_ZONE"),
      ),
      workersDevSubdomain: Config.option(
        Config.NonEmptyString("DX_DEPLOYMENT_WORKERS_DEV_SUBDOMAIN"),
      ),
      daemonIngressName: Config.withDefault(
        Config.NonEmptyString("DX_DEPLOYMENT_DAEMON_INGRESS_NAME"),
        "dx-dxd",
      ),
      signupEnabled: Config.withDefault(
        Config.Boolean("DX_SIGNUP_ENABLED"),
        false,
      ),
      githubCopilotClientId: Config.option(
        Config.NonEmptyString("DX_GITHUB_COPILOT_CLIENT_ID"),
      ),
      // Who may read every in-app bug report, in the app and through their
      // agents; see wiki/product-architecture.md.
      bugReportReaders: Config.option(
        Config.NonEmptyString("DX_BUG_REPORT_READERS"),
      ),
      // Optional: the central dx deployment this one shares each bug report
      // with, and the intake key it issued; both, or nothing is shared.
      bugReportDestination: Config.option(
        Config.NonEmptyString("DX_BUG_REPORT_DESTINATION"),
      ),
      bugReportDestinationKey: Config.option(
        Config.Redacted("DX_BUG_REPORT_DESTINATION_KEY"),
      ),
      // Optional: makes this the central deployment, whose intake takes
      // reports from senders holding a key this secret derives.
      bugReportIntakeSecret: Config.option(
        Config.Redacted("DX_BUG_REPORT_INTAKE_SECRET"),
      ),
      modelDeploymentProviders: Config.option(
        Config.NonEmptyString("DX_MODEL_DEPLOYMENT_PROVIDERS"),
      ),
      modelEndpointAllowlist: Config.option(
        Config.NonEmptyString("DX_MODEL_ENDPOINT_ALLOWLIST"),
      ),
      workersAiEnabled: Config.withDefault(
        Config.Boolean("DX_MODEL_WORKERS_AI_ENABLED"),
        true,
      ),
      workerTraces: Config.withDefault(
        Config.Boolean("DX_DEPLOYMENT_WORKER_TRACES"),
        false,
      ),
      // Portals: a dedicated zone (never the app's registrable domain) whose
      // first-level labels `t-<uuid>-p<port>` serve guest ports. Universal
      // SSL covers one wildcard level, so the domain is the zone apex.
      portalDomain: Config.option(
        Config.NonEmptyString("DX_DEPLOYMENT_PORTAL_DOMAIN"),
      ),
      portalZoneId: Config.option(
        Config.NonEmptyString("DX_DEPLOYMENT_PORTAL_ZONE_ID"),
      ),
      // The deployment runner names it within the 63-character script limit.
      portalWorkerName: Config.option(
        Config.NonEmptyString("DX_DEPLOYMENT_PORTAL_WORKER_NAME"),
      ),
    });

    const hostedAuthentication = Option.isSome(configuration.authEmailFrom);
    const signIn = Option.isSome(configuration.signIn)
      ? (JSON.parse(configuration.signIn.value) as {
          readonly providers: ReadonlyArray<string>;
          readonly admission: string;
          readonly allowedEmailDomains: ReadonlyArray<string>;
          readonly googleClientId?: string;
          readonly termsUrl?: string;
          readonly privacyUrl?: string;
        })
      : undefined;
    // Without a recorded signIn, a sender meant magic link only.
    const passwordSignIn =
      signIn?.providers.includes("email-password") ?? !hostedAuthentication;
    const googleSignIn = signIn?.providers.includes("google") ?? false;
    const expectedEnvironment =
      configuration.deploymentTarget === "branch"
        ? "preview"
        : configuration.deploymentTarget === "staging" ||
            configuration.deploymentTarget === "selfhost"
          ? configuration.deploymentTarget
          : undefined;
    if (
      expectedEnvironment === undefined ||
      configuration.environment !== expectedEnvironment
    )
      return yield* Effect.die(
        "DX_DEPLOYMENT_TARGET does not match DX_DEPLOYMENT_ENVIRONMENT.",
      );
    const authEmailFrom = Option.getOrUndefined(configuration.authEmailFrom);
    const selfhost = configuration.environment === "selfhost";
    const integrations = new Set(
      configuration.integrations.split(",").filter(Boolean),
    );
    const orbProviders = new Set(
      configuration.orbProviders.trim() === "none"
        ? []
        : configuration.orbProviders.split(",").filter(Boolean),
    );
    if (
      (orbProviders.size === 0 &&
        configuration.orbProviders.trim() !== "none") ||
      [...orbProviders].some(
        (provider) => provider !== "e2b" && provider !== "cloudflare",
      )
    )
      return yield* Effect.die(
        "DX_DEPLOYMENT_ORB_PROVIDERS must name e2b, cloudflare, both, or none.",
      );
    const e2bInstalled = orbProviders.has("e2b");
    const cloudflareInstalled = orbProviders.has("cloudflare");
    const e2bApiKey = !e2bInstalled
      ? undefined
      : selfhost
        ? (yield* HeldSecret("E2BApiKey", {
            value: Option.getOrUndefined(configuration.e2bApiKey),
          })).value
        : Option.isSome(configuration.e2bApiKey)
          ? configuration.e2bApiKey.value
          : yield* Effect.die("E2B_API_KEY is required.");
    const githubApp = selfhost
      ? integrations.has("github")
        ? (yield* HeldSecret("GitHubAppSecret", {
            value: Option.getOrUndefined(configuration.githubApp),
          })).value
        : Redacted.make("{}")
      : Option.isSome(configuration.githubApp)
        ? configuration.githubApp.value
        : yield* Effect.die("DX_INTEGRATION_GITHUB_APP is required.");
    const adminPassword =
      selfhost && passwordSignIn
        ? (yield* HeldSecret("AdminPassword", {
            value: Option.getOrUndefined(configuration.adminPassword),
          })).value
        : undefined;
    const bitbucketOAuth =
      selfhost && integrations.has("bitbucket")
        ? (yield* HeldSecret("BitbucketOAuthSecret", {
            value: Option.getOrUndefined(configuration.bitbucketOAuth),
          })).value
        : Option.getOrUndefined(configuration.bitbucketOAuth);
    // The Speech plugin's deployment-scope Sarvam key. The self-host
    // integration keeps its `sarvam` name and HeldSecret ID.
    const sarvamApiKey =
      selfhost && integrations.has("sarvam")
        ? (yield* HeldSecret("SarvamApiKey", {
            value: Option.getOrUndefined(configuration.sarvamApiKey),
          })).value
        : Option.getOrUndefined(configuration.sarvamApiKey);
    const googleClientSecret = !googleSignIn
      ? undefined
      : selfhost
        ? (yield* HeldSecret("GoogleClientSecret", {
            value: Option.getOrUndefined(configuration.googleClientSecret),
          })).value
        : Option.isSome(configuration.googleClientSecret)
          ? configuration.googleClientSecret.value
          : yield* Effect.die("DX_GOOGLE_CLIENT_SECRET is required.");
    // Plugin installation is deployment scope. Hosted targets install every
    // first-party plugin; self-host installs what `pnpm dx:deploy` recorded.
    const installedPlugins = selfhost ? configuration.plugins : "search,speech";
    const exaApiKey = selfhost
      ? integrations.has("exa")
        ? (yield* HeldSecret("ExaApiKey", {
            value: Option.getOrUndefined(configuration.exaApiKey),
          })).value
        : undefined
      : Option.getOrUndefined(configuration.exaApiKey);
    // Boat on the deployment's own account. A self-host's `boat` integration
    // holds the key across deploys, as the other integration keys are held.
    const boatApiKey = selfhost
      ? integrations.has("boat")
        ? (yield* HeldSecret("BoatApiKey", {
            value: Option.getOrUndefined(configuration.boatApiKey),
          })).value
        : undefined
      : Option.getOrUndefined(configuration.boatApiKey);
    // Bug report forwarding (#1661). Hosted targets take both settings from
    // the deploy environment on every deploy. A self-host's
    // `bugReportForwarding` and `bugReportIntake` integrations hold them across
    // deploys, as the other integration keys are held.
    const bugReportDestinationKey = selfhost
      ? integrations.has("bugReportForwarding")
        ? (yield* HeldSecret("BugReportDestinationKey", {
            value: Option.getOrUndefined(configuration.bugReportDestinationKey),
          })).value
        : undefined
      : Option.getOrUndefined(configuration.bugReportDestinationKey);
    const bugReportIntakeSecret = selfhost
      ? integrations.has("bugReportIntake")
        ? (yield* HeldSecret("BugReportIntakeSecret", {
            value: Option.getOrUndefined(configuration.bugReportIntakeSecret),
          })).value
        : undefined
      : Option.getOrUndefined(configuration.bugReportIntakeSecret);
    // Every deployment that installs E2B builds its Orb templates from the
    // recipe at deploy time and rebuilds them when the recipe changes, as
    // OrbContainers does for Cloudflare. Staging and branch previews share
    // one E2B team, so they share one set, named for staging.
    const e2bProfiles =
      e2bApiKey !== undefined
        ? yield* E2BProfiles("E2BProfiles", {
            apiKey: e2bApiKey,
            deploymentName: selfhost
              ? Option.getOrElse(configuration.deploymentName, () => "")
              : "staging",
            recipeHash: yield* Effect.promise(() => e2bRecipeHash()),
          } as never)
        : undefined;
    // Cloudflare Containers runs in this account: the Orb Worker owns one
    // container per Thread, and Core binds its namespace across scripts.
    const orbContainers = !cloudflareInstalled
      ? undefined
      : Option.isSome(configuration.orbWorkerName)
        ? yield* OrbContainers("OrbContainers", {
            workerName: configuration.orbWorkerName.value,
            recipeHash: orbRecipeHash(import.meta.dirname),
          })
        : yield* Effect.die(
            "DX_DEPLOYMENT_ORB_WORKER_NAME is required for Cloudflare Containers.",
          );
    // Hosted stages run on Containers whenever they install it; a self-host
    // keeps E2B first, and a deployment with no provider defaults to an E2B
    // size people connect (scripts/alchemy-deployment.mjs checks the same
    // rule).
    const defaultOrbProfileId =
      cloudflareInstalled && !(e2bInstalled && selfhost)
        ? defaultCloudflareOrbProfile.id
        : defaultE2BOrbProfile.id;
    const runnerProfileCatalog = (e2bProfiles: ReadonlyArray<unknown>) =>
      JSON.stringify({
        version: 1,
        defaultProfileId: defaultOrbProfileId,
        profiles: [
          ...e2bProfiles,
          ...(cloudflareInstalled ? cloudflareOrbProfiles : []),
        ],
      });

    if (
      configuration.turnstileTestKeys &&
      configuration.environment !== "preview"
    )
      return yield* Effect.die(
        "DX_DEPLOYMENT_TURNSTILE_TEST_KEYS is restricted to previews.",
      );

    if (Option.isSome(configuration.workspaceInactivityMs)) {
      const inactivityMs = configuration.workspaceInactivityMs.value;
      if (configuration.environment !== "preview")
        return yield* Effect.die(
          "DX_DEPLOYMENT_WORKSPACE_INACTIVITY_MS is restricted to previews.",
        );
      if (
        !Number.isInteger(inactivityMs) ||
        inactivityMs < 60_000 ||
        inactivityMs > 3_600_000
      )
        return yield* Effect.die(
          "DX_DEPLOYMENT_WORKSPACE_INACTIVITY_MS must be an integer from 60000 through 3600000.",
        );
    }

    if (
      !selfhost &&
      Redacted.value(githubApp as Redacted.Redacted<string>) !== "{}"
    ) {
      const input = yield* Effect.try({
        try: () =>
          JSON.parse(Redacted.value(githubApp as Redacted.Redacted<string>)),
        catch: () => new Error("Invalid GitHub App configuration JSON."),
      }).pipe(Effect.orDie);
      yield* decodeGitHubAppDeploymentConfiguration(
        input,
        configuration.origin,
        configuration.environment,
        configuration.deploymentTarget,
      ).pipe(Effect.orDie);
    }

    const deploymentHostname = new URL(configuration.origin).hostname;
    const portals = yield* Option.isNone(configuration.portalDomain) &&
    Option.isNone(configuration.portalZoneId)
      ? Effect.succeed(undefined)
      : Effect.gen(function* () {
          if (
            Option.isNone(configuration.portalDomain) ||
            Option.isNone(configuration.portalZoneId)
          )
            return yield* Effect.die(
              "DX_DEPLOYMENT_PORTAL_DOMAIN and DX_DEPLOYMENT_PORTAL_ZONE_ID are set together.",
            );
          const domain = configuration.portalDomain.value.toLowerCase();
          // A separate registrable domain: same-site guest pages could set
          // cookies dx reads (apps/core/src/portals/portal-site.ts).
          if (
            !/^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)+$/.test(
              domain,
            ) ||
            portalDomainSharesSite(deploymentHostname, domain)
          )
            return yield* Effect.die(
              "DX_DEPLOYMENT_PORTAL_DOMAIN must be a separate registrable domain from the app.",
            );
          if (!/^[a-f0-9]{32}$/.test(configuration.portalZoneId.value))
            return yield* Effect.die(
              "DX_DEPLOYMENT_PORTAL_ZONE_ID must be a Cloudflare zone ID.",
            );
          return { domain, zoneId: configuration.portalZoneId.value };
        });
    // A resumed guest's daemon reconnects through a dependency-free Worker on
    // the account's workers.dev subdomain. Its isolate starts in milliseconds,
    // where the Core bundle's cold start (about a second) otherwise sits on
    // every wake. Without a workers.dev subdomain Core serves ingress itself.
    const daemonIngressName = configuration.daemonIngressName;
    const daemonIngressOrigin = Option.map(
      configuration.workersDevSubdomain,
      (subdomain) => `https://${daemonIngressName}.${subdomain}.workers.dev/`,
    );
    // Replicas serve each request's D1 session near the person (#1386,
    // persistence/d1-session.ts); writes still go to the primary.
    const database = yield* Cloudflare.D1.Database("Database", {
      name: configuration.databaseName,
      migrations: `apps/core/${migrationManifest.d1Directory}`,
      readReplication: { mode: "auto" },
    });
    // Browsers upload attachment parts and read attachments straight from
    // R2 through presigned URLs, so the bucket admits this origin.
    const bucket = yield* Cloudflare.R2.Bucket("Storage", {
      name: configuration.bucketName,
      forceDestroy: false,
      cors: [attachmentBucketCors(configuration.origin)],
    });
    // The R2 S3 credentials Core signs attachment URLs with. A deployment
    // that can create tokens mints one that can only read and write this
    // stage's bucket: the token id is the access key id and the SHA-256 of
    // its value is the secret, and destroying the stage deletes it. Alchemy
    // OAuth cannot create tokens, so those self-hosts hold the R2 API token
    // the operator created instead. Either way attachments move directly.
    const attachmentSigning = yield* Effect.gen(function* () {
      const accountId = Option.isSome(configuration.cloudflareAccountId)
        ? configuration.cloudflareAccountId.value
        : yield* Effect.die(
            "CLOUDFLARE_ACCOUNT_ID is required to sign attachment URLs.",
          );
      const endpoint = `https://${accountId}.r2.cloudflarestorage.com/${configuration.bucketName}`;
      if (configuration.attachmentSigning === "operator")
        return {
          endpoint,
          credentials: (yield* HeldSecret("AttachmentR2Credentials", {
            value: Option.getOrUndefined(configuration.attachmentR2Credentials),
          })).value,
          workerLogs: undefined,
        };
      const token = yield* Cloudflare.ApiToken.AccountApiToken(
        "AttachmentSigningToken",
        attachmentSigningTokenProps(accountId, configuration.bucketName),
      );
      // Read-only Workers Observability on this account, for the Worker
      // logs a bug report carries. Self-hosts that cannot mint tokens go
      // without, and their reports say Worker logs are unavailable.
      const logsToken = yield* Cloudflare.ApiToken.AccountApiToken(
        "WorkerLogsToken",
        workerLogsTokenProps(accountId, configuration.workerName),
      );
      return {
        endpoint,
        workerLogs: Output.map(logsToken.value, (value) =>
          Redacted.make(
            JSON.stringify({ accountId, token: Redacted.value(value) }),
          ),
        ),
        credentials: Output.map(
          Output.all(token.tokenId, token.value),
          ([tokenId, value]) =>
            Redacted.make(
              JSON.stringify({
                accessKeyId: tokenId,
                secretAccessKey: createHash("sha256")
                  .update(Redacted.value(value))
                  .digest("hex"),
              }),
            ),
        ),
      };
    });
    // Turnstile protects magic-link requests. A self-host sender may serve
    // notification email alone, which needs no widget; hosted targets always
    // offer magic link with their sender.
    const turnstileWanted = Option.getOrElse(
      configuration.turnstile,
      () => hostedAuthentication,
    );
    // Previews may use Cloudflare's published always-pass test keys instead of
    // creating a widget, because the account caps widgets at 20.
    const turnstile = !turnstileWanted
      ? undefined
      : configuration.turnstileTestKeys
        ? {
            sitekey: "1x00000000000000000000AA",
            secret: "1x0000000000000000000000000000000AA",
          }
        : yield* Cloudflare.Turnstile.Widget("AccessTurnstile", {
            name: `dx access · ${deploymentHostname}`,
            domains: [deploymentHostname],
            mode: "managed",
          });
    const email = hostedAuthentication
      ? yield* Cloudflare.Email.SendEmail("MagicLinkEmail", {
          allowedSenderAddresses: [
            requiredHostedAuthenticationValue(authEmailFrom),
          ],
        })
      : undefined;

    const authSecret = yield* Alchemy.Random("BetterAuthSecret", {});
    const encryptionSecret = yield* Alchemy.Random("ConfigEncryptionKey", {});
    const workloadIdentitySigningKeys = Option.isSome(
      configuration.workloadIdentitySigningKeys,
    )
      ? configuration.workloadIdentitySigningKeys.value
      : configuration.environment === "staging"
        ? yield* Effect.die(
            "DX_WORKLOAD_IDENTITY_SIGNING_KEYS is required for staging.",
          )
        : (yield* WorkloadIdentitySigningKey("WorkloadIdentitySigningKey", {}))
            .keyring;
    // Web Push needs one stable P-256 key pair per deployment: browsers
    // subscribe with its public key, so rotating it silently orphans every
    // device. The random seed is the private scalar; the public point is
    // derived from it, exactly as a push key generator would.
    const pushVapidSeed = yield* Alchemy.Random("PushVapidKey", {});
    const pushVapidKeys = Output.map(pushVapidSeed.text, (secret) => {
      const scalar = Buffer.from(Redacted.value(secret), "hex");
      const curve = createECDH("prime256v1");
      curve.setPrivateKey(scalar);
      return {
        publicKey: Redacted.make(curve.getPublicKey().toString("base64url")),
        privateKey: Redacted.make(scalar.toString("base64url")),
      };
    });
    const encryptionKeyring = Output.map(encryptionSecret.text, (secret) =>
      Redacted.make(
        JSON.stringify({
          activeVersion: 1,
          keys: {
            1: Buffer.from(Redacted.value(secret), "hex").toString("base64"),
          },
        }),
      ),
    );
    const d1Binding = productionBindingByType("d1");
    const r2Binding = productionBindingByType("r2");
    const aiBinding = productionBindingByType("workers-ai");
    const durableObjectBindings = Object.fromEntries(
      durableObjectBindingContract().map(({ name, className }) => [
        name,
        Cloudflare.DurableObject(name, { className }),
      ]),
    );

    const workerBindings = productionWorkerBindings({
      text: {
        DX_ENV: configuration.environment,
        DX_DEPLOYMENT_TARGET: configuration.deploymentTarget,
        DX_RUNTIME_MODE: "deployed",
        ...(hostedAuthentication
          ? {
              DX_AUTH_EMAIL_FROM:
                requiredHostedAuthenticationValue(authEmailFrom),
            }
          : {}),
        ...(turnstile === undefined
          ? {}
          : { DX_TURNSTILE_SITE_KEY: turnstile.sitekey }),
        DX_AUTH_URL: configuration.origin,
        DX_AUTH_TRUSTED_ORIGINS: configuration.origin,
        ...(portals === undefined ? {} : { DX_PORTAL_DOMAIN: portals.domain }),
        // A branch preview's Docker and Cloudflare connections boot the
        // branch's Orb image, which the preview workflow copies to Docker
        // Hub (scripts/mirror-preview-orb-image.mjs).
        ...(configuration.deploymentTarget === "branch" &&
        previewPublicOrbImage(import.meta.dirname) !== undefined
          ? { DX_PREVIEW_ORB_IMAGE: previewPublicOrbImage(import.meta.dirname) }
          : {}),
        DX_ATTACHMENT_R2_ENDPOINT: attachmentSigning.endpoint,
        ...(e2bProfiles !== undefined
          ? {
              DX_E2B_TEMPLATE: e2bProfiles.defaultTemplate,
              DX_E2B_TEMPLATE_BUILD_ID: e2bProfiles.defaultBuildId,
              DX_E2B_TIMEOUT_MS: "300000",
            }
          : {}),
        ...(Option.isSome(configuration.workspaceInactivityMs)
          ? {
              DX_WORKSPACE_INACTIVITY_MS: String(
                configuration.workspaceInactivityMs.value,
              ),
            }
          : {}),
        DX_DEPLOYMENT_REVISION: configuration.revision,
        DX_DXD_PUBLIC_URL: Option.getOrElse(
          daemonIngressOrigin,
          () => configuration.origin,
        ),
        DX_DXD_RELEASE_URL: configuration.dxdReleaseUrl,
        DX_DXD_RELEASE_SHA256: configuration.dxdChecksum,
        DX_MIGRATION_MANIFEST_VERSION: String(migrationManifest.version),
        DX_RUNNER_PROFILE_CATALOG:
          e2bProfiles === undefined
            ? runnerProfileCatalog(
                cloudflareInstalled
                  ? []
                  : // No provider: the sizes people's own E2B teams run.
                    E2B_ORB_PROFILES.map((profile) => ({
                      ...profile,
                      adapter: "e2b",
                      template: `dx-orb-${profile.templateSuffix}`,
                      isolation: "sandbox",
                      availability: "available",
                      capabilities: deployedOrbCapabilities,
                    })),
              )
            : Output.map(e2bProfiles.profilesJson, (profilesJson) =>
                runnerProfileCatalog(
                  JSON.parse(profilesJson).map(
                    (profile: Record<string, unknown>) => ({
                      ...profile,
                      adapter: "e2b",
                      isolation: "sandbox",
                      availability: "available",
                      capabilities: deployedOrbCapabilities,
                    }),
                  ),
                ),
              ),
        DX_SOURCE_CONTROL_SCHEMA_VERSION: sourceControlSchemaVersion,
        DX_SOURCE_SHALLOW_CLONE: configuration.sourceShallowClone
          ? "true"
          : "false",
        DX_MANAGED_SSH_SIGNING_ENABLED: "true",
        ...(installedPlugins === ""
          ? {}
          : { DX_INSTALLED_PLUGINS: installedPlugins }),
        ...(configuration.signupEnabled ? { DX_SIGNUP_ENABLED: "true" } : {}),
        ...(signIn === undefined
          ? {}
          : {
              DX_SIGN_IN_PROVIDERS: signIn.providers.join(","),
              DX_SIGN_IN_ADMISSION: signIn.admission,
              ...(signIn.allowedEmailDomains.length === 0
                ? {}
                : {
                    DX_SIGN_IN_ALLOWED_EMAIL_DOMAINS:
                      signIn.allowedEmailDomains.join(","),
                  }),
              ...(signIn.googleClientId === undefined
                ? {}
                : { DX_GOOGLE_CLIENT_ID: signIn.googleClientId }),
              ...(signIn.termsUrl === undefined
                ? {}
                : { DX_TERMS_URL: signIn.termsUrl }),
              ...(signIn.privacyUrl === undefined
                ? {}
                : { DX_PRIVACY_URL: signIn.privacyUrl }),
            }),
        ...(Option.isSome(configuration.githubCopilotClientId)
          ? {
              DX_GITHUB_COPILOT_CLIENT_ID:
                configuration.githubCopilotClientId.value,
            }
          : {}),
        ...(Option.isSome(configuration.bugReportReaders)
          ? { DX_BUG_REPORT_READERS: configuration.bugReportReaders.value }
          : {}),
        ...(Option.isSome(configuration.bugReportDestination) &&
        bugReportDestinationKey !== undefined
          ? {
              DX_BUG_REPORT_DESTINATION:
                configuration.bugReportDestination.value,
            }
          : {}),
        ...(Option.isSome(configuration.modelDeploymentProviders)
          ? {
              DX_MODEL_DEPLOYMENT_PROVIDERS:
                configuration.modelDeploymentProviders.value,
            }
          : {}),
        ...(Option.isSome(configuration.modelEndpointAllowlist)
          ? {
              DX_MODEL_ENDPOINT_ALLOWLIST:
                configuration.modelEndpointAllowlist.value,
            }
          : {}),
        ...(configuration.workersAiEnabled
          ? {}
          : { DX_MODEL_WORKERS_AI_ENABLED: "false" }),
        DX_WORKLOAD_IDENTITY_ISSUER: `${configuration.origin}/api/workload-identity`,
        DX_WORKLOAD_IDENTITY_AUDIENCE_POLICIES: JSON.stringify({
          version: 1,
          // Portable dxd-channel baseline, not an audience allowlist. Recipients
          // authorize claims; native-attestation integrations remain disabled.
          policies: [],
        }),
      },
      secret: {
        BETTER_AUTH_SECRET: authSecret.text,
        DX_PUSH_VAPID_PUBLIC_KEY: Output.map(
          pushVapidKeys,
          ({ publicKey }) => publicKey,
        ),
        DX_PUSH_VAPID_PRIVATE_KEY: Output.map(
          pushVapidKeys,
          ({ privateKey }) => privateKey,
        ),
        ...(turnstile === undefined
          ? {}
          : { DX_TURNSTILE_SECRET_KEY: turnstile.secret }),
        DX_CONFIG_ENCRYPTION_KEYS: encryptionKeyring,
        DX_ATTACHMENT_R2_CREDENTIALS: attachmentSigning.credentials,
        ...(attachmentSigning.workerLogs === undefined
          ? {}
          : { DX_WORKER_LOGS: attachmentSigning.workerLogs }),
        DX_INTEGRATION_GITHUB_APP: githubApp,
        DX_WORKLOAD_IDENTITY_SIGNING_KEYS: workloadIdentitySigningKeys,
        ...(e2bApiKey === undefined ? {} : { E2B_API_KEY: e2bApiKey }),
        ...(sarvamApiKey !== undefined ? { SARVAM_API_KEY: sarvamApiKey } : {}),
        ...(exaApiKey !== undefined ? { EXA_API_KEY: exaApiKey } : {}),
        ...(Option.isSome(configuration.bugReportDestination) &&
        bugReportDestinationKey !== undefined
          ? { DX_BUG_REPORT_DESTINATION_KEY: bugReportDestinationKey }
          : {}),
        ...(bugReportIntakeSecret !== undefined
          ? { DX_BUG_REPORT_INTAKE_SECRET: bugReportIntakeSecret }
          : {}),
        ...(boatApiKey !== undefined ? { BOAT_API_KEY: boatApiKey } : {}),
        ...(googleClientSecret !== undefined
          ? { DX_GOOGLE_CLIENT_SECRET: googleClientSecret }
          : {}),
        ...(bitbucketOAuth !== undefined
          ? {
              DX_INTEGRATION_BITBUCKET_OAUTH: bitbucketOAuth,
            }
          : {}),
      },
      d1: { [d1Binding.name]: database },
      r2: { [r2Binding.name]: bucket },
      "send-email": hostedAuthentication
        ? { EMAIL: requiredHostedAuthenticationValue(email) }
        : {},
      "workers-ai": {
        [aiBinding.name]: Cloudflare.Workers.AI(aiBinding.name),
      },
      "durable-object": {
        ...durableObjectBindings,
        ...(orbContainers === undefined
          ? {}
          : {
              ORB_CONTAINER: Cloudflare.DurableObject("ORB_CONTAINER", {
                className: "OrbContainerObject",
                scriptName: orbContainers.workerName,
              }),
            }),
      },
    });

    const bootstrap = yield* Command.Exec("Bootstrap", {
      command: "node scripts/bootstrap-deployment.mjs",
      cwd: ".",
      env: {
        ...(selfhost && !passwordSignIn
          ? {
              DX_BOOTSTRAP_ADMIN_EMAIL: Option.getOrElse(
                configuration.adminEmail,
                () => "",
              ),
              DX_BOOTSTRAP_HOSTED_AUTH: "true",
              DX_BOOTSTRAP_STAGE: stack.stage,
            }
          : selfhost
            ? {
                DX_BOOTSTRAP_ADMIN_EMAIL: Option.getOrElse(
                  configuration.adminEmail,
                  () => "",
                ),
                DX_BOOTSTRAP_ADMIN_PASSWORD: adminPassword ?? Redacted.make(""),
                DX_BOOTSTRAP_ADMIN_PASSWORD_RESET:
                  configuration.adminPasswordReset ? "true" : "false",
                DX_BOOTSTRAP_STAGE: stack.stage,
              }
            : {
                DX_BOOTSTRAP_CREDENTIALS_FILE: configuration.credentialsFile,
                DX_BOOTSTRAP_REPOSITORY: configuration.bootstrapRepository,
              }),
        DX_BOOTSTRAP_DATABASE_ID: database.databaseId,
        DX_BOOTSTRAP_RUNNER_PROFILE_ID: defaultOrbProfileId,
      },
      memo: false,
      timeout: "3 minutes",
    });

    const deployedWorkerBindings = selfhost
      ? {
          ...workerBindings,
          DX_ENV: Output.map(
            bootstrap.hash.input,
            () => configuration.environment,
          ),
        }
      : workerBindings;

    const worker = yield* Cloudflare.Worker("Worker", {
      // Bootstrap admits the configured first user before exposing the Worker.
      name: configuration.workerName,
      main: `${configuration.packageDirectory}/worker/index.js`,
      bundle: false,
      compatibility: {
        date: "2026-08-20",
        flags: ["nodejs_compat", "global_fetch_strictly_public"],
      },
      version: {
        tag: configuration.revision,
        message: `Git ${configuration.revision.slice(0, 12)}`,
      },
      assets: {
        directory: `${configuration.packageDirectory}/assets`,
        notFoundHandling: "single-page-application",
        runWorkerFirst: ["/api/*", "/v1", "/v1/*", "/healthz", "/readyz"],
      },
      env: deployedWorkerBindings,
      // Logs match Alchemy's default; traces are an explicit operator opt-in.
      observability: {
        enabled: true,
        logs: { enabled: true, invocationLogs: true },
        traces: {
          enabled: configuration.workerTraces,
          headSamplingRate: 1,
          persist: true,
        },
      },
      // Every stage sweeps snoozed Threads, schedules, and GitHub
      // subscriptions each minute, which is how work after a turn starts;
      // only staging also runs the daily retention pass.
      crons:
        configuration.environment === "staging"
          ? ["17 3 * * *", THREAD_SWEEP_CRON]
          : [THREAD_SWEEP_CRON],
      workersDev: !Option.isSome(configuration.deploymentZone),
      ...(Option.isSome(configuration.deploymentZone)
        ? {
            domain: {
              name: new URL(configuration.origin).hostname,
              zoneName: configuration.deploymentZone.value,
            },
          }
        : {}),
    });

    // The Thread execution object checks the key; this Worker only forwards.
    if (Option.isSome(daemonIngressOrigin))
      yield* Cloudflare.Worker("DaemonIngress", {
        name: daemonIngressName,
        main: "apps/core/src/threads/daemon-ingress.ts",
        compatibility: { date: "2026-08-20" },
        env: {
          THREAD_EXECUTION: Cloudflare.DurableObject("THREAD_EXECUTION", {
            className: "ThreadExecutionObject",
            scriptName: worker.workerName,
          }),
        },
        workersDev: true,
        observability: {
          enabled: true,
          logs: { enabled: true, invocationLogs: true },
        },
      });

    // Portals run in their own Worker: Core's static assets answer before its
    // code, so a Portal path would get the dx app. Workers Custom Domains do
    // not take wildcards, so a zone route plus a proxied wildcard record.
    if (portals !== undefined) {
      yield* Cloudflare.Worker("PortalWorker", {
        name: Option.getOrElse(
          configuration.portalWorkerName,
          () => `${configuration.workerName}-portals`,
        ),
        main: "apps/core/src/portals/worker.ts",
        compatibility: { date: "2026-08-20", flags: ["nodejs_compat"] },
        env: {
          DX_ENV: configuration.environment,
          DX_AUTH_URL: configuration.origin,
          DX_PORTAL_DOMAIN: portals.domain,
          BETTER_AUTH_SECRET: authSecret.text,
          DB: database,
          THREAD_EXECUTION: Cloudflare.DurableObject("THREAD_EXECUTION", {
            className: "ThreadExecutionObject",
            scriptName: worker.workerName,
          }),
        },
        workersDev: false,
        routes: [{ pattern: `*.${portals.domain}/*`, zoneId: portals.zoneId }],
        observability: {
          enabled: true,
          logs: { enabled: true, invocationLogs: true },
        },
      });
      yield* Cloudflare.DNS.Record("PortalDns", {
        zoneId: portals.zoneId,
        name: `*.${portals.domain}`,
        type: "AAAA",
        content: "100::",
        proxied: true,
        comment: "dx Portals: served by the Portal Worker route",
      });
    }

    if (!selfhost)
      yield* Command.Exec("Verify", {
        command: "node scripts/verify-alchemy-preview.mjs",
        cwd: ".",
        env: {
          DX_PREVIEW_URL: configuration.origin,
          DX_PREVIEW_DEPLOYMENT_LABEL: configuration.deploymentLabel,
          ...(configuration.environment !== "staging"
            ? { DX_PREVIEW_DXD_SHA256: configuration.dxdChecksum }
            : {}),
          // Alchemy knows a Worker's ID before an update deploys it; pairing
          // it with the hash makes Verify wait for the new version.
          DX_PREVIEW_WORKER_ID: Output.map(
            Output.all(worker.workerId, worker.hash),
            ([workerId]) => workerId,
          ),
          DX_PREVIEW_BOOTSTRAP: Output.map(bootstrap.hash.input, () => "ready"),
        },
        memo: false,
        timeout: "3 minutes",
      });

    return {
      stage: stack.stage,
      url: worker.url,
      workerName: worker.workerName,
      workerId: worker.workerId,
      databaseName: database.databaseName,
      databaseId: database.databaseId,
      bucketName: bucket.bucketName,
      revision: configuration.revision,
    };
  }),
);