alchemy 2.0.0-beta.13 → 2.0.0-beta.14

package/lib/index.d.ts

@@ -1,7 +1,7 @@
 export * as AdoptPolicy from "./AdoptPolicy.ts";
+export * from "./AlchemyContext.ts";
 export * from "./Apply.ts";
 export { Service as BindingService, Policy, type ServiceLike as BindingServiceLike, type ServiceShape as BindingServiceShape, type PolicyLike, type PolicyShape, } from "./Binding.ts";
-export * from "./Config.ts";
 export * from "./Destroy.ts";
 export * from "./Diff.ts";
 export * from "./Input.ts";
@@ -20,6 +20,7 @@ export * as Server from "./Server/index.ts";
 export * as Serverless from "./Serverless/index.ts";
 export { Stack } from "./Stack.ts";
 export * from "./Stage.ts";
+export { inMemoryState, localState } from "./State/index.ts";
 export * from "./Trait.ts";
 export * as Construct from "./Construct.ts";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,OAAO,IAAI,cAAc,EACzB,MAAM,EACN,KAAK,WAAW,IAAI,kBAAkB,EACtC,KAAK,YAAY,IAAI,mBAAmB,EACxC,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7D,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,cAAc,eAAe,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,OAAO,IAAI,cAAc,EACzB,MAAM,EACN,KAAK,WAAW,IAAI,kBAAkB,EACtC,KAAK,YAAY,IAAI,mBAAmB,EACxC,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7D,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,cAAc,eAAe,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/lib/index.js

@@ -1,7 +1,7 @@
 export * as AdoptPolicy from "./AdoptPolicy.js";
+export * from "./AlchemyContext.js";
 export * from "./Apply.js";
 export { Service as BindingService, Policy, } from "./Binding.js";
-export * from "./Config.js";
 export * from "./Destroy.js";
 export * from "./Diff.js";
 export * from "./Input.js";
@@ -19,6 +19,7 @@ export * as Server from "./Server/index.js";
 export * as Serverless from "./Serverless/index.js";
 export { Stack } from "./Stack.js";
 export * from "./Stage.js";
+export { inMemoryState, localState } from "./State/index.js";
 export * from "./Trait.js";
 export * as Construct from "./Construct.js";
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,OAAO,IAAI,cAAc,EACzB,MAAM,GAKP,MAAM,cAAc,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7D,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,cAAc,eAAe,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,OAAO,IAAI,cAAc,EACzB,MAAM,GAKP,MAAM,cAAc,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,cAAc,mBAAmB,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7D,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,cAAc,eAAe,CAAC;AAC9B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "2.0.0-beta.13",
+  "version": "2.0.0-beta.14",
   "homepage": "https://alchemy.run",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
@@ -9,6 +9,9 @@
     "url": "git+https://github.com/alchemy-run/alchemy-effect.git",
     "directory": "package/alchemy"
   },
+  "bin": {
+    "alchemy": "./bin/cli.js"
+  },
   "files": [
     "bin",
     "lib",
@@ -43,6 +46,12 @@
       "worker": "./src/Agent/index.ts",
       "import": "./lib/Agent/index.js"
     },
+    "./Auth": {
+      "types": "./src/Auth/index.ts",
+      "bun": "./src/Auth/index.ts",
+      "worker": "./src/Auth/index.ts",
+      "import": "./lib/Auth/index.js"
+    },
     "./AWS": {
       "types": "./src/AWS/index.ts",
       "bun": "./src/AWS/index.ts",
@@ -187,6 +196,12 @@
       "worker": "./src/State/index.ts",
       "import": "./lib/State/index.js"
     },
+    "./State/*": {
+      "types": "./src/State/*.ts",
+      "bun": "./src/State/*.ts",
+      "worker": "./src/State/*.ts",
+      "import": "./lib/State/*.js"
+    },
     "./Test/Bun": {
       "types": "./src/Test/Bun.ts",
       "bun": "./src/Test/Bun.ts",
@@ -199,15 +214,17 @@
       "worker": "./src/Util/index.ts",
       "import": "./lib/Util/index.js"
     },
+    "./Util/Clank": {
+      "types": "./src/Util/Clank.ts",
+      "bun": "./src/Util/Clank.ts",
+      "worker": "./src/Util/Clank.ts",
+      "import": "./lib/Util/Clank.js"
+    },
     "./bin/alchemy.js": "./bin/alchemy.js"
   },
   "publishConfig": {
     "access": "public"
   },
-  "optionalDependencies": {
-    "@alchemy.run/cli-posix": "2.0.0-beta.13",
-    "@alchemy.run/cli-win32": "2.0.0-beta.13"
-  },
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0.31",
     "@ai-sdk/openai": "^3.0.23",
@@ -233,6 +250,7 @@
     "cloudflare": "^5.2.0",
     "fast-glob": "^3.3.2",
     "fast-xml-parser": "^5.3.4",
+    "foreground-child": "^4.0.3",
     "ignore": "^7.0.5",
     "jszip": "^3.10.1",
     "libsodium-wrappers": "^0.8.3",
@@ -265,9 +283,9 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@effect/platform-bun": "*",
-    "@effect/platform-node": "*",
-    "effect": "*",
+    "@effect/platform-bun": "4.0.0-beta.48",
+    "@effect/platform-node": "4.0.0-beta.48",
+    "effect": "4.0.0-beta.48",
     "vite": "^8.0.7"
   },
   "peerDependenciesMeta": {
@@ -277,9 +295,6 @@
     "@effect/platform-bun": {
       "optional": true
     },
-    "effect": {
-      "optional": true
-    },
     "vite": {
       "optional": true
     }

package/src/AWS/ECS/Task.ts

@@ -8,6 +8,7 @@ import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as FileSystem from "effect/FileSystem";
 import type * as rolldown from "rolldown";
+import { AlchemyContext } from "../../AlchemyContext.ts";
 import * as Bundle from "../../Bundle/Bundle.ts";
 import {
   dockerBuild,
@@ -19,20 +20,19 @@ import {
   findCwdForBundle,
   getStableContextDir,
 } from "../../Bundle/TempRoot.ts";
-import { DotAlchemy } from "../../Config.ts";
 import { isResolved } from "../../Diff.ts";
 import * as Output from "../../Output.ts";
 import { createPhysicalName } from "../../PhysicalName.ts";
 import { Platform, type Main, type PlatformProps } from "../../Platform.ts";
 import * as Provider from "../../Provider.ts";
 import { Resource, type ResourceBinding } from "../../Resource.ts";
-import type { Providers } from "../Providers.ts";
 import type { ProcessContext, ServerHost } from "../../Server/Process.ts";
 import { Stack } from "../../Stack.ts";
 import { createInternalTags, createTagsList, hasTags } from "../../Tags.ts";
-import { AWSEnvironment } from "../Environment.ts";
 import type { Credentials } from "../Credentials.ts";
+import { AWSEnvironment } from "../Environment.ts";
 import type { PolicyStatement } from "../IAM/Policy.ts";
+import type { Providers } from "../Providers.ts";
 
 export const isTask = (value: any): value is Task => {
   return (
@@ -225,7 +225,7 @@ export const TaskProvider = () =>
       const stack = yield* Stack;
       const { accountId } = yield* AWSEnvironment;
       const region = yield* Region;
-      const dotAlchemy = yield* DotAlchemy;
+      const { dotAlchemy } = yield* AlchemyContext;
       const fs = yield* FileSystem.FileSystem;
       const virtualEntryPlugin = yield* Bundle.virtualEntryPlugin;
 

package/src/AWS/Lambda/Function.ts

@@ -23,16 +23,16 @@ import { Platform, type Main, type PlatformProps } from "../../Platform.ts";
 import type { LogLine, LogsInput } from "../../Provider.ts";
 import * as Provider from "../../Provider.ts";
 import { Resource, type ResourceBinding } from "../../Resource.ts";
-import type { Providers } from "../Providers.ts";
 import * as Serverless from "../../Serverless/index.ts";
 import { Stack } from "../../Stack.ts";
 import { createInternalTags, createTagsList, hasTags } from "../../Tags.ts";
 import { sha256 } from "../../Util/sha256.ts";
 import { zipCode } from "../../Util/zip.ts";
-import { AWSEnvironment } from "../Environment.ts";
 import { Assets } from "../Assets.ts";
+import { AWSEnvironment } from "../Environment.ts";
 import * as IAM from "../IAM/index.ts";
 import type { PolicyStatement } from "../IAM/Policy.ts";
+import type { Providers } from "../Providers.ts";
 import { makeFunctionHttpHandler } from "./HttpServer.ts";
 
 export const FunctionTypeId = "AWS.Lambda.Function" as const;
@@ -403,7 +403,6 @@ export const Function: Platform<
           }),
           (handlers) =>
             async (event: any, context: lambda.Context): Promise<any> => {
-              console.log({ event, handlers });
               for (const handler of handlers) {
                 const eff = handler(event);
                 if (Effect.isEffect(eff)) {

package/src/AWS/SQS/QueueSink.ts

@@ -1,4 +1,3 @@
-import * as Console from "effect/Console";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Sink from "effect/Sink";
@@ -30,7 +29,7 @@ export const QueueSinkLive = Layer.effect(
             Id: `${i}`,
             MessageBody: message,
           })),
-        }).pipe(Effect.tapError(Console.log), Effect.orDie, Effect.asVoid),
+        }).pipe(Effect.orDie, Effect.asVoid),
       );
     });
   }),

package/src/Agent/coding/bash.ts

@@ -2,7 +2,6 @@ import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as S from "effect/Schema";
 import { ChildProcess } from "effect/unstable/process";
-import { cwd } from "../../Config.ts";
 import { AspectConfig } from "../Aspect.ts";
 import { Tool } from "../tool/tool.ts";
 import { CommandValidator } from "../util/command-validator.ts";
@@ -18,7 +17,7 @@ export class timeout extends Tool.input(
 export class workdir extends Tool.input(
   "workdir",
   S.optional(S.String),
-)`The working directory to run the command in. Defaults to ${cwd}. Use this instead of 'cd' commands.` {}
+)`The working directory to run the command in. Defaults to cwd. Use this instead of 'cd' commands.` {}
 
 export class description extends Tool.input(
   "description",
@@ -51,7 +50,7 @@ export class bash extends Tool("bash", {
 Returns the ${exitCode} and ${stdout} containing both stdout and stderr.
 If the command is invalid, an error message will be returned as a ${S.String}.
 
-All commands run in ${cwd} by default. Use the ${workdir} parameter if you need to run a command in a different directory. AVOID using \`cd <directory> && <command>\` patterns - use \`workdir\` instead.
+All commands run in cwd by default. Use the ${workdir} parameter if you need to run a command in a different directory. AVOID using \`cd <directory> && <command>\` patterns - use \`workdir\` instead.
 
 IMPORTANT: This tool is for terminal operations like git, npm, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files) - use the specialized tools for this instead.
 

package/src/Agent/coding/glob.ts

@@ -3,7 +3,6 @@ import * as FileSystem from "effect/FileSystem";
 import * as Option from "effect/Option";
 import * as Path from "effect/Path";
 import * as S from "effect/Schema";
-import { cwd } from "../../Config.ts";
 import { AspectConfig } from "../Aspect.ts";
 import { Tool } from "../tool/tool.ts";
 import * as Ripgrep from "../util/ripgrep.ts";
@@ -21,7 +20,7 @@ Examples:
 export class path extends Tool.input(
   "path",
   S.optional(S.String),
-)`The directory to search in. Defaults to ${cwd} if not specified.` {}
+)`The directory to search in. Defaults to cwd if not specified.` {}
 
 export class files extends Tool.output(
   "files",

package/src/Agent/coding/grep.ts

@@ -3,7 +3,6 @@ import * as FileSystem from "effect/FileSystem";
 import * as Option from "effect/Option";
 import * as S from "effect/Schema";
 import { ChildProcess } from "effect/unstable/process";
-import { cwd } from "../../Config.ts";
 import { AspectConfig } from "../Aspect.ts";
 import { Tool } from "../tool/tool.ts";
 import { exec } from "../util/exec.ts";
@@ -18,7 +17,7 @@ Supports full regex syntax (e.g., "log.*Error", "function\\s+\\w+", etc.)` {}
 class path extends Tool.input(
   "path",
   S.optional(S.String),
-)`The directory to search in. Defaults to ${cwd} if not specified.` {}
+)`The directory to search in. Defaults to cwd if not specified.` {}
 
 class include extends Tool.input(
   "include",

package/src/AlchemyContext.ts

@@ -0,0 +1,27 @@
+import * as EffectContext from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+
+export class AlchemyContext extends EffectContext.Service<
+  AlchemyContext,
+  {
+    dotAlchemy: string;
+    updateStateStore: boolean;
+  }
+>()("alchemy/Context") {}
+
+export const AlchemyContextLive = Layer.effect(
+  AlchemyContext,
+  Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const dir = path.join(process.cwd(), ".alchemy");
+    yield* fs.makeDirectory(dir, { recursive: true });
+    return {
+      dotAlchemy: dir,
+      updateStateStore: false,
+    };
+  }),
+);

package/src/Auth/AuthProvider.ts

@@ -206,7 +206,7 @@ export const getAuthProvider = <
     registry[name] == null
       ? Effect.fail(
           new AuthError({
-            message: `AuthProvider '${name}' is not registered. Make sure its layer has been built.`,
+            message: `AuthProvider '${name}' is not registered. Make sure its layer has been provided.`,
           }),
         )
       : Effect.succeed(registry[name] as AuthProvider<Config, Credentials>),

package/src/Auth/index.ts

@@ -1,2 +1,4 @@
 export * from "./AuthProvider.ts";
-export type * from "./Profile.ts";
+export * from "./Credentials.ts";
+export * from "./Env.ts";
+export * from "./Profile.ts";

package/src/Cli/InkCLI.tsx

@@ -19,6 +19,16 @@ export const inkCLI = () =>
     }),
   );
 
+export const inkCLIAutoApprove = () =>
+  Layer.succeed(
+    Cli,
+    Cli.of({
+      approvePlan: () => Effect.succeed(true),
+      displayPlan,
+      startApplySession,
+    }),
+  );
+
 const approvePlan = Effect.fn(function* <P extends Plan>(plan: P) {
   let approved = false;
   const { waitUntilExit } = render(

package/src/{Test/TestCli.ts → Cli/LoggingCli.ts}

@@ -1,8 +1,8 @@
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import { Cli } from "../Cli/Cli.ts";
+import { Cli } from "./Cli.ts";
 
-export const TestCli = Layer.succeed(
+export const LoggingCli = Layer.succeed(
   Cli,
   Cli.of({
     approvePlan: () => Effect.succeed(true),

package/src/Cloudflare/Container/ContainerApplication.ts

@@ -5,6 +5,7 @@ import * as Option from "effect/Option";
 import * as Schedule from "effect/Schedule";
 import type * as rolldown from "rolldown";
 import { AdoptPolicy } from "../../AdoptPolicy.ts";
+import { AlchemyContext } from "../../AlchemyContext.ts";
 import * as Bundle from "../../Bundle/Bundle.ts";
 import {
   dockerBuild,
@@ -16,7 +17,6 @@ import {
   findCwdForBundle,
   getStableContextDir,
 } from "../../Bundle/TempRoot.ts";
-import { DotAlchemy } from "../../Config.ts";
 import { deepEqual, isResolved } from "../../Diff.ts";
 import { createPhysicalName } from "../../PhysicalName.ts";
 import {
@@ -359,7 +359,7 @@ export const ContainerProvider = () =>
       const adoptPolicy = yield* Effect.serviceOption(AdoptPolicy).pipe(
         Effect.map(Option.getOrElse(() => false)),
       );
-      const dotAlchemy = yield* DotAlchemy;
+      const { dotAlchemy } = yield* AlchemyContext;
       const fs = yield* FileSystem.FileSystem;
       const virtualEntryPlugin = yield* Bundle.virtualEntryPlugin;
       const createContainerApplication =
@@ -498,6 +498,12 @@ export const ContainerProvider = () =>
                 ...external,
               ],
               platform: "node",
+              resolve: {
+                conditionNames:
+                  runtime === "bun"
+                    ? ["bun", "import", "module", "default"]
+                    : ["node", "import", "module", "default"],
+              },
               plugins,
               treeshake: true,
             },

package/src/Cloudflare/EdgeSession.ts

@@ -0,0 +1,144 @@
+import { Credentials } from "@distilled.cloud/cloudflare/Credentials";
+import * as workers from "@distilled.cloud/cloudflare/workers";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import { CloudflareEnvironment } from "./CloudflareEnvironment.ts";
+
+/**
+ * A "remote binding" as understood by the Cloudflare Workers
+ * edge-preview API. We reuse the distilled request schema so the
+ * shape tracks Cloudflare's surface.
+ */
+type EdgeMetadata = NonNullable<
+  NonNullable<workers.CreateScriptEdgePreviewRequest["metadata"]>
+>;
+export type EdgeBinding = NonNullable<
+  NonNullable<EdgeMetadata["bindings"]>
+>[number];
+
+export class EdgeSessionError extends Data.TaggedError("EdgeSessionError")<{
+  readonly message: string;
+  readonly cause?: unknown;
+}> {}
+
+export interface EdgeSessionOptions {
+  /**
+   * Name used as the preview script identifier on Cloudflare's side.
+   * Shows up as the hostname: `{scriptName}.{subdomain}.workers.dev`.
+   */
+  readonly scriptName: string;
+  /** ES-module worker script(s). The first file is the entrypoint. */
+  readonly files: ReadonlyArray<File>;
+  /** Remote bindings attached to the preview worker. */
+  readonly bindings: ReadonlyArray<EdgeBinding>;
+  /** @default "2025-04-28" */
+  readonly compatibilityDate?: string;
+}
+
+/**
+ * Information needed to call a running edge-preview worker. Attach
+ * `headers` (including the `cf-workers-preview-token`) and fetch
+ * `url` or a path under it.
+ */
+export interface EdgeSessionHandle {
+  readonly url: string;
+  readonly headers: Record<string, string>;
+}
+
+const DEFAULT_COMPATIBILITY_DATE = "2025-04-28";
+
+const wrap = <A, E, R>(effect: Effect.Effect<A, E, R>, message: string) =>
+  effect.pipe(
+    Effect.mapError((cause) => new EdgeSessionError({ message, cause })),
+  );
+
+/**
+ * Ask Cloudflare for a preview upload token. Some accounts return an
+ * `exchangeUrl` that must be GET'd to swap the session token for a
+ * short-lived upload token; when present we do the swap, falling back
+ * to the original if the exchange fails.
+ */
+const createUploadToken = Effect.gen(function* () {
+  const env = yield* CloudflareEnvironment;
+  const http = yield* HttpClient.HttpClient;
+  const createSubdomainEdgePreviewSession =
+    yield* workers.createSubdomainEdgePreviewSession;
+  const { token, exchangeUrl } = yield* createSubdomainEdgePreviewSession({
+    accountId: env.accountId,
+  });
+  if (!exchangeUrl) return token;
+  const json = yield* http.get(exchangeUrl).pipe(
+    Effect.flatMap((r) => r.json),
+    Effect.timeout(30_000),
+    Effect.catch(() => Effect.succeed(null as unknown)),
+  );
+  if (
+    typeof json === "object" &&
+    json !== null &&
+    "token" in json &&
+    typeof (json as Record<string, unknown>).token === "string"
+  ) {
+    return (json as { token: string }).token;
+  }
+  return token;
+});
+
+const uploadScript = (options: EdgeSessionOptions, uploadToken: string) =>
+  Effect.gen(function* () {
+    const env = yield* CloudflareEnvironment;
+    const createScriptEdgePreview = yield* workers.createScriptEdgePreview;
+    return yield* createScriptEdgePreview({
+      accountId: env.accountId,
+      scriptName: options.scriptName,
+      cfPreviewUploadConfigToken: uploadToken,
+      wranglerSessionConfig: { workersDev: true, minimalMode: true },
+      metadata: {
+        compatibilityDate:
+          options.compatibilityDate ?? DEFAULT_COMPATIBILITY_DATE,
+        bindings: options.bindings as EdgeMetadata["bindings"],
+        mainModule: options.files[0]!.name,
+      },
+      // Distilled's generated schema expects a mutable array; our
+      // public surface keeps `readonly` so callers can pass a frozen
+      // tuple without a cast on their side.
+      files: options.files.slice(),
+    }).pipe(Effect.timeout(30_000));
+  });
+
+const workerHost = (scriptName: string) =>
+  Effect.gen(function* () {
+    const env = yield* CloudflareEnvironment;
+    const getSubdomain = yield* workers.getSubdomain;
+    const { subdomain } = yield* getSubdomain({ accountId: env.accountId });
+    return `${scriptName}.${subdomain}.workers.dev`;
+  });
+
+/**
+ * Upload a short-lived preview worker to Cloudflare's edge and
+ * return its URL plus the headers needed to reach it.
+ *
+ * Preview workers are ephemeral: they live only while a client keeps
+ * sending requests with the returned preview token and expire soon
+ * after. Nothing is deployed or billed.
+ */
+export const createEdgeSession = (
+  options: EdgeSessionOptions,
+): Effect.Effect<
+  EdgeSessionHandle,
+  EdgeSessionError,
+  CloudflareEnvironment | HttpClient.HttpClient | Credentials
+> =>
+  Effect.gen(function* () {
+    const [{ previewToken }, host] = yield* Effect.all(
+      [
+        createUploadToken.pipe(Effect.flatMap((t) => uploadScript(options, t))),
+        workerHost(options.scriptName),
+      ],
+      { concurrency: "unbounded" },
+    );
+    return {
+      url: `https://${host}`,
+      headers: { "cf-workers-preview-token": previewToken },
+    } satisfies EdgeSessionHandle;
+  }).pipe((e) => wrap(e, "Failed to create edge preview session"));