effect-cf 0.16.0 → 0.17.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # effect-cf
 
+## 0.17.1
+
+### Patch Changes
+
+- [#56](https://github.com/danieljvdm/effect-cf/pull/56) [`38df8ed`](https://github.com/danieljvdm/effect-cf/commit/38df8ed3153a77df117810e67a34cf039871c08c) Thanks [@danieljvdm](https://github.com/danieljvdm)! - Treat Cloudflare Workflow status responses with a null error as having no error.
+
+## 0.17.0
+
+### Minor Changes
+
+- [#53](https://github.com/danieljvdm/effect-cf/pull/53) [`b36fc21`](https://github.com/danieljvdm/effect-cf/commit/b36fc2111670c6404a80d51a3c12b10080260256) Thanks [@danieljvdm](https://github.com/danieljvdm)! - Add `ContainerNamespace` services for named Cloudflare Container request forwarding and lifecycle operations.
+
 ## 0.16.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,6 @@
 # effect-cf
 
-Effect-native Cloudflare primitives for Workers, Durable Objects, bindings, KV, D1, Queues, Email, Analytics Engine, Workflows, and Durable Object storage.
+Effect-native Cloudflare primitives for Workers, Durable Objects, Containers, bindings, KV, D1, Queues, Email, Analytics Engine, Workflows, and Durable Object storage.
 
 ## Install
 
@@ -30,6 +30,7 @@ Runtime creation belongs at Cloudflare entrypoints, not inside binding helpers.
 - `DurableObject` - Durable Object entrypoint factory and typed namespace helpers
 - `DurableObjectState` / `DurableObjectStorage` - Effect wrappers for state, alarms, SQL, and embedded KV
 - `DurableObjectWebSocket` - WebSocket upgrade helpers for Durable Objects
+- `ContainerNamespace` - named Cloudflare Container instances with Effect-wrapped request and lifecycle operations
 - `Kv` - typed KV namespace helper
 - `D1` - typed D1 database binding helper with an `@effect/sql-d1` backed SQL layer
 - `R2` - typed R2 bucket binding helper with Effect-wrapped object and multipart operations
@@ -85,6 +86,46 @@ export const readCounter = Effect.gen(function* () {
 
 Define Wrangler bindings and migrations in the consuming application. Durable Object namespace bindings are provided with `YourObject.layer({ binding })`, and consumers use `const namespace = yield* YourObject`.
 
+## Container Example
+
+Container entrypoints remain owned by `@cloudflare/containers`; `effect-cf`
+wraps the Container namespace used by a calling Worker.
+
+```ts
+import { Container, switchPort } from "@cloudflare/containers";
+import { Effect, Layer } from "effect";
+import { ContainerNamespace, Worker } from "effect-cf";
+
+export class RendererContainer extends Container {
+  defaultPort = 8080;
+  sleepAfter = "10m";
+}
+
+class Renderers extends ContainerNamespace.Tag<Renderers>()("Renderers") {}
+
+const RenderersLive = Renderers.layer({ binding: "RENDERERS" });
+
+export default Worker.make(RenderersLive, {
+  fetch: Effect.gen(function* () {
+    const request = yield* Worker.NativeRequest;
+    const renderer = Renderers.byName(new URL(request.url).pathname);
+
+    yield* renderer.startAndWaitForPorts({ ports: 8080 });
+    return yield* renderer.fetch(switchPort(request, 8080));
+  }),
+});
+```
+
+The instance client exposes `state`, `fetch`, `start`,
+`startAndWaitForPorts`, `stop`, `destroy`, and the Effect-valued native
+`unsafeRaw` stub.
+Responses are returned unchanged, including non-2xx and WebSocket upgrade
+responses. If the Container uses outbound interception, also export
+`ContainerProxy` from `@cloudflare/containers`.
+
+See [`examples/containers/README.md`](../../examples/containers/README.md) for
+the corresponding Wrangler configuration and entrypoint responsibilities.
+
 ## Queue Example
 
 Queues define the message contract once. The same class is the producer service tag and the consumer Worker definition: use `YourQueue.layer({ binding })` to provide a Cloudflare producer binding from `WorkerEnvironment`, and use `.make(...)` for the consumer Worker entrypoint.

package/dist/index.d.mts

@@ -16,7 +16,7 @@ import * as _$effect_Config0 from "effect/Config";
 
 //#region src/WorkersAi.d.ts
 declare namespace WorkersAi_d_exports {
-  export { LayerOptions$18 as LayerOptions, Tag$17 as Tag, TagClass$16 as TagClass, WorkersAiAsyncBatchResponse, WorkersAiBinding, WorkersAiClient, WorkersAiDefinition, WorkersAiEmbeddingInput, WorkersAiEmbeddingResponse, WorkersAiModelsSearchObject, WorkersAiModelsSearchParams, WorkersAiOperationError, WorkersAiOptions, WorkersAiService, embeddingResponse, isWorkersAiBinding, layer$15 as layer, make$16 as make, makeClient$12 as makeClient };
+  export { LayerOptions$19 as LayerOptions, Tag$18 as Tag, TagClass$17 as TagClass, WorkersAiAsyncBatchResponse, WorkersAiBinding, WorkersAiClient, WorkersAiDefinition, WorkersAiEmbeddingInput, WorkersAiEmbeddingResponse, WorkersAiModelsSearchObject, WorkersAiModelsSearchParams, WorkersAiOperationError, WorkersAiOptions, WorkersAiService, embeddingResponse, isWorkersAiBinding, layer$16 as layer, make$17 as make, makeClient$13 as makeClient };
 }
 declare const WorkersAiOperationError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
   readonly _tag: "WorkersAiOperationError";
@@ -75,24 +75,24 @@ interface WorkersAiService<Id extends string> {
     readonly id: Id;
   };
 }
-type LayerOptions$18 = {
+type LayerOptions$19 = {
   readonly binding: string;
 };
-interface TagClass$16<Self, Id extends string, ModelList extends AiModelListType = AiModels> extends Context.ServiceClass<Self, Id, WorkersAiClient<ModelList>> {
+interface TagClass$17<Self, Id extends string, ModelList extends AiModelListType = AiModels> extends Context.ServiceClass<Self, Id, WorkersAiClient<ModelList>> {
   readonly id: Id;
-  readonly layer: (options: LayerOptions$18) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+  readonly layer: (options: LayerOptions$19) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 }
 declare const isWorkersAiBinding: (value: unknown) => value is WorkersAiBinding;
 declare const embeddingResponse: (value: {
   readonly data?: ReadonlyArray<ReadonlyArray<number>>;
   readonly shape?: ReadonlyArray<number>;
 }) => WorkersAiEmbeddingResponse;
-declare const makeClient$12: <ModelList extends AiModelListType = AiModels>(definition: WorkersAiDefinition) => (ai: WorkersAiBinding<ModelList>) => WorkersAiClient<ModelList>;
-declare const layer$15: <Self, ModelList extends AiModelListType = AiModels>(tag: Context.Service<Self, WorkersAiClient<ModelList>>, definition: WorkersAiDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
-declare const make$16: <Id extends string>(id: Id) => TagClass$16<WorkersAiService<Id>, Id, AiModels>;
-declare const Tag$17: <Self>() => <Id extends string, ModelList extends AiModelListType = AiModels>(id: Id) => TagClass$16<Self, Id, ModelList>;
+declare const makeClient$13: <ModelList extends AiModelListType = AiModels>(definition: WorkersAiDefinition) => (ai: WorkersAiBinding<ModelList>) => WorkersAiClient<ModelList>;
+declare const layer$16: <Self, ModelList extends AiModelListType = AiModels>(tag: Context.Service<Self, WorkersAiClient<ModelList>>, definition: WorkersAiDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const make$17: <Id extends string>(id: Id) => TagClass$17<WorkersAiService<Id>, Id, AiModels>;
+declare const Tag$18: <Self>() => <Id extends string, ModelList extends AiModelListType = AiModels>(id: Id) => TagClass$17<Self, Id, ModelList>;
 declare namespace AiGateway_d_exports {
-  export { AiGatewayBinding, AiGatewayClient, AiGatewayDefinition, AiGatewayFetchOptions, AiGatewayHeaders, AiGatewayLog, AiGatewayOperationError, AiGatewayPatchLog, AiGatewayProvider, AiGatewayRunOptions, AiGatewayService, AiGatewayUniversalRequest, LayerOptions$17 as LayerOptions, Tag$16 as Tag, TagClass$15 as TagClass, isAiGatewayBinding, layer$14 as layer, make$15 as make, makeClient$11 as makeClient, makeClientFromAi, makeHttpClient };
+  export { AiGatewayBinding, AiGatewayClient, AiGatewayDefinition, AiGatewayFetchOptions, AiGatewayHeaders, AiGatewayLog, AiGatewayOperationError, AiGatewayPatchLog, AiGatewayProvider, AiGatewayRunOptions, AiGatewayService, AiGatewayUniversalRequest, LayerOptions$18 as LayerOptions, Tag$17 as Tag, TagClass$16 as TagClass, isAiGatewayBinding, layer$15 as layer, make$16 as make, makeClient$12 as makeClient, makeClientFromAi, makeHttpClient };
 }
 declare const AiGatewayOperationError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
   readonly _tag: "AiGatewayOperationError";
@@ -141,17 +141,17 @@ interface AiGatewayService<Id extends string> {
     readonly id: Id;
   };
 }
-type LayerOptions$17 = {
+type LayerOptions$18 = {
   readonly binding: string;
   readonly gatewayId: string;
   readonly accountId?: string;
 };
-interface TagClass$15<Self, Id extends string> extends Context.ServiceClass<Self, Id, AiGatewayClient> {
+interface TagClass$16<Self, Id extends string> extends Context.ServiceClass<Self, Id, AiGatewayClient> {
   readonly id: Id;
-  readonly layer: (options: LayerOptions$17) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError | AiGatewayOperationError, WorkerEnvironment>;
+  readonly layer: (options: LayerOptions$18) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError | AiGatewayOperationError, WorkerEnvironment>;
 }
 declare const isAiGatewayBinding: (value: unknown) => value is WorkersAiBinding;
-declare const makeClient$11: (definition: AiGatewayDefinition, gateway: AiGatewayBinding) => {
+declare const makeClient$12: (definition: AiGatewayDefinition, gateway: AiGatewayBinding) => {
   definition: AiGatewayDefinition;
   run: (data: _$_cloudflare_workers_types0.AIGatewayUniversalRequest | readonly _$_cloudflare_workers_types0.AIGatewayUniversalRequest[], options: {
     gateway?: _$_cloudflare_workers_types0.UniversalGatewayOptions;
@@ -169,11 +169,11 @@ declare const makeHttpClient: (definition: Omit<AiGatewayDefinition, "binding">
   readonly accountId: string;
   readonly binding?: string;
 }, request?: typeof fetch) => AiGatewayClient;
-declare const layer$14: <Self>(tag: Context.Service<Self, AiGatewayClient>, definition: AiGatewayDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
-declare const make$15: <Id extends string>(id: Id) => TagClass$15<AiGatewayService<Id>, Id>;
-declare const Tag$16: <Self>() => <Id extends string>(id: Id) => TagClass$15<Self, Id>;
+declare const layer$15: <Self>(tag: Context.Service<Self, AiGatewayClient>, definition: AiGatewayDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const make$16: <Id extends string>(id: Id) => TagClass$16<AiGatewayService<Id>, Id>;
+declare const Tag$17: <Self>() => <Id extends string>(id: Id) => TagClass$16<Self, Id>;
 declare namespace AnalyticsEngine_d_exports {
-  export { AnalyticsEngineBinding, AnalyticsEngineClient, AnalyticsEngineDataPoint, AnalyticsEngineDataPointSchema, AnalyticsEngineDefinition, AnalyticsEngineFieldValue, AnalyticsEngineFieldValueSchema, AnalyticsEngineInvalidWritePolicy, AnalyticsEngineOperationError, AnalyticsEngineQueryClient, AnalyticsEngineQueryColumn, AnalyticsEngineQueryDefinition, AnalyticsEngineQueryError, AnalyticsEngineQueryOptions, AnalyticsEngineQueryResult, AnalyticsEngineQueryRow, AnalyticsEngineQueryService, AnalyticsEngineService, AnalyticsEngineWriteBatchOptions, AnalyticsEngineWriteError, AnalyticsEngineWriteOptions, AnalyticsEngineWritePolicy, AnalyticsEngineWriteValidationError, AnalyticsEngineWriteViolation, LayerOptions$16 as LayerOptions, QueryConfigOptions, QueryTag, QueryTagClass, Tag$15 as Tag, TagClass$14 as TagClass, isAnalyticsEngineDataset, layer$13 as layer, make$14 as make, makeClient$10 as makeClient, makeQuery, makeQueryClient, queryConfig, queryFetchLayer, queryFetchLayerConfig, queryLayer, queryLayerConfig, writeLimits };
+  export { AnalyticsEngineBinding, AnalyticsEngineClient, AnalyticsEngineDataPoint, AnalyticsEngineDataPointSchema, AnalyticsEngineDefinition, AnalyticsEngineFieldValue, AnalyticsEngineFieldValueSchema, AnalyticsEngineInvalidWritePolicy, AnalyticsEngineOperationError, AnalyticsEngineQueryClient, AnalyticsEngineQueryColumn, AnalyticsEngineQueryDefinition, AnalyticsEngineQueryError, AnalyticsEngineQueryOptions, AnalyticsEngineQueryResult, AnalyticsEngineQueryRow, AnalyticsEngineQueryService, AnalyticsEngineService, AnalyticsEngineWriteBatchOptions, AnalyticsEngineWriteError, AnalyticsEngineWriteOptions, AnalyticsEngineWritePolicy, AnalyticsEngineWriteValidationError, AnalyticsEngineWriteViolation, LayerOptions$17 as LayerOptions, QueryConfigOptions, QueryTag, QueryTagClass, Tag$16 as Tag, TagClass$15 as TagClass, isAnalyticsEngineDataset, layer$14 as layer, make$15 as make, makeClient$11 as makeClient, makeQuery, makeQueryClient, queryConfig, queryFetchLayer, queryFetchLayerConfig, queryLayer, queryLayerConfig, writeLimits };
 }
 declare const writeLimits: {
   readonly maxBlobs: 20;
@@ -306,7 +306,7 @@ interface AnalyticsEngineQueryService<Id extends string> {
     readonly id: Id;
   };
 }
-type LayerOptions$16 = {
+type LayerOptions$17 = {
   readonly binding: string;
   readonly write?: AnalyticsEngineWritePolicy;
 };
@@ -315,9 +315,9 @@ type QueryConfigOptions = {
   readonly apiToken?: Config.Config<Redacted.Redacted<string>>;
   readonly apiBaseUrl?: Config.Config<string>;
 };
-interface TagClass$14<Self, Id extends string> extends Context.ServiceClass<Self, Id, AnalyticsEngineClient> {
+interface TagClass$15<Self, Id extends string> extends Context.ServiceClass<Self, Id, AnalyticsEngineClient> {
   readonly id: Id;
-  readonly layer: (options: LayerOptions$16) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+  readonly layer: (options: LayerOptions$17) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 }
 interface QueryTagClass<Self, Id extends string> extends Context.ServiceClass<Self, Id, AnalyticsEngineQueryClient> {
   readonly id: Id;
@@ -328,7 +328,7 @@ interface QueryTagClass<Self, Id extends string> extends Context.ServiceClass<Se
 }
 declare const makeQueryClient: (definition: AnalyticsEngineQueryDefinition) => Effect.Effect<AnalyticsEngineQueryClient, never, HttpClient.HttpClient>;
 declare const isAnalyticsEngineDataset: (value: unknown) => value is AnalyticsEngineBinding;
-declare const makeClient$10: (definition: AnalyticsEngineDefinition, defaults?: AnalyticsEngineWritePolicy) => (dataset: AnalyticsEngineBinding) => AnalyticsEngineClient;
+declare const makeClient$11: (definition: AnalyticsEngineDefinition, defaults?: AnalyticsEngineWritePolicy) => (dataset: AnalyticsEngineBinding) => AnalyticsEngineClient;
 declare const queryConfig: (options?: QueryConfigOptions) => Config.Config<{
   accountId: string;
   apiToken: Redacted.Redacted<string>;
@@ -338,13 +338,13 @@ declare const queryLayer: <Self>(tag: Context.Service<Self, AnalyticsEngineQuery
 declare const queryFetchLayer: <Self>(tag: Context.Service<Self, AnalyticsEngineQueryClient>, definition: AnalyticsEngineQueryDefinition) => Layer.Layer<Self, never, never>;
 declare const queryLayerConfig: <Self>(tag: Context.Service<Self, AnalyticsEngineQueryClient>, config?: Config.Config<AnalyticsEngineQueryDefinition>) => Layer.Layer<Self, Config.ConfigError, HttpClient.HttpClient>;
 declare const queryFetchLayerConfig: <Self>(tag: Context.Service<Self, AnalyticsEngineQueryClient>, config?: Config.Config<AnalyticsEngineQueryDefinition>) => Layer.Layer<Self, Config.ConfigError, never>;
-declare const layer$13: <Self>(tag: Context.Service<Self, AnalyticsEngineClient>, definition: LayerOptions$16) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
-declare const make$14: <Id extends string>(id: Id) => TagClass$14<AnalyticsEngineService<Id>, Id>;
+declare const layer$14: <Self>(tag: Context.Service<Self, AnalyticsEngineClient>, definition: LayerOptions$17) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const make$15: <Id extends string>(id: Id) => TagClass$15<AnalyticsEngineService<Id>, Id>;
 declare const makeQuery: <Id extends string>(id: Id) => QueryTagClass<AnalyticsEngineQueryService<Id>, Id>;
-declare const Tag$15: <Self>() => <Id extends string>(id: Id) => TagClass$14<Self, Id>;
+declare const Tag$16: <Self>() => <Id extends string>(id: Id) => TagClass$15<Self, Id>;
 declare const QueryTag: <Self>() => <Id extends string>(id: Id) => QueryTagClass<Self, Id>;
 declare namespace BrowserRendering_d_exports {
-  export { BrowserRenderingBinding, BrowserRenderingBrowserClient, BrowserRenderingBrowserLike, BrowserRenderingClient, BrowserRenderingConnect, BrowserRenderingDefinition, BrowserRenderingLaunch, BrowserRenderingOperationError, BrowserRenderingPageClient, BrowserRenderingPageLike, BrowserRenderingService, LayerOptions$15 as LayerOptions, Tag$14 as Tag, TagClass$13 as TagClass, isBrowserRenderingBinding, layer$12 as layer, make$13 as make, makeClient$9 as makeClient };
+  export { BrowserRenderingBinding, BrowserRenderingBrowserClient, BrowserRenderingBrowserLike, BrowserRenderingClient, BrowserRenderingConnect, BrowserRenderingDefinition, BrowserRenderingLaunch, BrowserRenderingOperationError, BrowserRenderingPageClient, BrowserRenderingPageLike, BrowserRenderingService, LayerOptions$16 as LayerOptions, Tag$15 as Tag, TagClass$14 as TagClass, isBrowserRenderingBinding, layer$13 as layer, make$14 as make, makeClient$10 as makeClient };
 }
 declare const BrowserRenderingOperationError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
   readonly _tag: "BrowserRenderingOperationError";
@@ -408,18 +408,18 @@ interface BrowserRenderingService<Id extends string> {
     readonly id: Id;
   };
 }
-type LayerOptions$15 = {
+type LayerOptions$16 = {
   readonly binding: string;
 };
-interface TagClass$13<Self, Id extends string> extends Context.ServiceClass<Self, Id, BrowserRenderingClient> {
+interface TagClass$14<Self, Id extends string> extends Context.ServiceClass<Self, Id, BrowserRenderingClient> {
   readonly id: Id;
-  readonly layer: (options: LayerOptions$15) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+  readonly layer: (options: LayerOptions$16) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
 }
 declare const isBrowserRenderingBinding: (value: unknown) => value is BrowserRenderingBinding;
-declare const makeClient$9: <RawBinding extends BrowserRenderingBinding = BrowserRenderingBinding>(definition: BrowserRenderingDefinition) => (binding: RawBinding) => BrowserRenderingClient<RawBinding>;
-declare const layer$12: <Self>(tag: Context.Service<Self, BrowserRenderingClient>, definition: BrowserRenderingDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
-declare const make$13: <Id extends string>(id: Id) => TagClass$13<BrowserRenderingService<Id>, Id>;
-declare const Tag$14: <Self>() => <Id extends string>(id: Id) => TagClass$13<Self, Id>;
+declare const makeClient$10: <RawBinding extends BrowserRenderingBinding = BrowserRenderingBinding>(definition: BrowserRenderingDefinition) => (binding: RawBinding) => BrowserRenderingClient<RawBinding>;
+declare const layer$13: <Self>(tag: Context.Service<Self, BrowserRenderingClient>, definition: BrowserRenderingDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const make$14: <Id extends string>(id: Id) => TagClass$14<BrowserRenderingService<Id>, Id>;
+declare const Tag$15: <Self>() => <Id extends string>(id: Id) => TagClass$14<Self, Id>;
 declare namespace DurableObjectStorage_d_exports {
   export { DurableObjectStorage, DurableObjectTransaction, SchemaBackedSyncKvStorage, SqlCursor, SqlStorage, SqlStorageValue, StorageOperationError, SyncKvDefinition, SyncKvStorage, fromDurableObjectStorage };
 }
@@ -722,7 +722,7 @@ declare class DurableObjectState extends DurableObjectState_base {}
  */
 declare const fromDurableObjectState: (state: globalThis.DurableObjectState) => DurableObjectStateService;
 declare namespace CloudflareOtlp_d_exports {
-  export { DurableObjectLayerOptions, LayerOptions$14 as LayerOptions, ResourceOptions, Serialization, Signal, WorkerLayerOptions, durableObjectLayer, layer$11 as layer, layerJson, layerProtobuf, workerLayer };
+  export { DurableObjectLayerOptions, LayerOptions$15 as LayerOptions, ResourceOptions, Serialization, Signal, WorkerLayerOptions, durableObjectLayer, layer$12 as layer, layerJson, layerProtobuf, workerLayer };
 }
 /** Telemetry signal groups supported by the Cloudflare OTLP layers. */
 type Signal = "logs" | "traces" | "metrics";
@@ -738,7 +738,7 @@ interface ResourceOptions {
   readonly attributes?: Record<string, unknown>;
 }
 /** Options shared by all Cloudflare OTLP telemetry layers. */
-interface LayerOptions$14 {
+interface LayerOptions$15 {
   /**
    * Telemetry signals to export. Defaults to logs, traces, and metrics.
    *
@@ -765,12 +765,12 @@ interface LayerOptions$14 {
   readonly tracerContext?: <X>(primitive: Tracer.EffectPrimitive<X>, span: Tracer.AnySpan) => X;
 }
 /** Resource metadata specific to Cloudflare Workers. */
-interface WorkerLayerOptions extends LayerOptions$14 {
+interface WorkerLayerOptions extends LayerOptions$15 {
   /** Cloudflare Worker name to attach as `cloudflare.worker.name`. */
   readonly workerName?: string;
 }
 /** Resource metadata specific to Cloudflare Durable Objects. */
-interface DurableObjectLayerOptions extends LayerOptions$14 {
+interface DurableObjectLayerOptions extends LayerOptions$15 {
   /** Durable Object class name to attach as `cloudflare.durable_object.class`. */
   readonly className?: string;
   /**
@@ -788,11 +788,11 @@ interface DurableObjectLayerOptions extends LayerOptions$14 {
  * installed as the primary `ConfigProvider`; outside Cloudflare, the ambient
  * Effect `ConfigProvider` remains the fallback.
  */
-declare const layer$11: (options?: LayerOptions$14) => Layer.Layer<never, never, never>;
+declare const layer$12: (options?: LayerOptions$15) => Layer.Layer<never, never, never>;
 /** Base OTLP telemetry layer forced to JSON serialization. */
-declare const layerJson: (options?: Omit<LayerOptions$14, "serialization">) => Layer.Layer<never, never, never>;
+declare const layerJson: (options?: Omit<LayerOptions$15, "serialization">) => Layer.Layer<never, never, never>;
 /** Base OTLP telemetry layer forced to protobuf serialization. */
-declare const layerProtobuf: (options?: Omit<LayerOptions$14, "serialization">) => Layer.Layer<never, never, never>;
+declare const layerProtobuf: (options?: Omit<LayerOptions$15, "serialization">) => Layer.Layer<never, never, never>;
 /**
  * OTLP layer with Cloudflare Worker resource attributes.
  *
@@ -808,6 +808,130 @@ declare const workerLayer: (options?: WorkerLayerOptions) => Layer.Layer<never,
  * backend can tolerate high-cardinality resource attributes.
  */
 declare const durableObjectLayer: (options?: DurableObjectLayerOptions) => Layer.Layer<never, never, DurableObjectState>;
+declare namespace ContainerNamespace_d_exports {
+  export { ContainerInstanceClient, ContainerNamespace, ContainerNamespaceClient, ContainerNamespaceDefinition, ContainerNamespaceResource, ContainerNamespaceService, ContainerNamespaceStaticClient, ContainerOperationError, ContainerReadinessOptions, ContainerSignal, ContainerStartAndWaitForPortsOptions, ContainerStartOptions, ContainerState, ContainerStub, ContainerWaitOptions, LayerOptions$14 as LayerOptions, Tag$14 as Tag, TagClass$13 as TagClass, isContainerNamespaceResource, layer$11 as layer, make$13 as make, makeClient$9 as makeClient };
+}
+/** Signal accepted by Cloudflare Container instances. */
+type ContainerSignal = "SIGKILL" | "SIGINT" | "SIGTERM";
+/** Per-instance Container startup configuration. */
+interface ContainerStartOptions {
+  readonly envVars?: Record<string, string>;
+  readonly entrypoint?: Array<string>;
+  readonly enableInternet?: boolean;
+  readonly labels?: Record<string, string>;
+}
+/** Serializable retry settings used while starting a Container. */
+interface ContainerWaitOptions {
+  readonly portToCheck: number;
+  readonly retries?: number;
+  readonly waitInterval?: number;
+}
+/** Serializable timeout settings used while waiting for Container ports. */
+interface ContainerReadinessOptions {
+  readonly instanceGetTimeoutMS?: number;
+  readonly portReadyTimeoutMS?: number;
+  readonly waitInterval?: number;
+}
+/** Options for starting a Container and waiting for its ports. */
+interface ContainerStartAndWaitForPortsOptions {
+  readonly startOptions?: ContainerStartOptions;
+  readonly ports?: number | Array<number>;
+  readonly cancellationOptions?: ContainerReadinessOptions;
+}
+/** Serializable state reported by a Cloudflare Container instance. */
+declare const ContainerState: Schema.Union<readonly [Schema.Struct<{
+  readonly lastChange: Schema.Finite;
+  readonly status: Schema.Literals<readonly ["running", "stopping", "stopped", "healthy"]>;
+}>, Schema.Struct<{
+  readonly lastChange: Schema.Finite;
+  readonly status: Schema.Literal<"stopped_with_code">;
+  readonly exitCode: Schema.optionalKey<Schema.Int>;
+}>]>;
+type ContainerState = typeof ContainerState.Type;
+/**
+ * Native Container stub shape exposed by a Container namespace binding.
+ *
+ * This is structural so using Container bindings does not make
+ * `@cloudflare/containers` a runtime dependency of effect-cf.
+ */
+interface ContainerStub {
+  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+  getState(): Promise<ContainerState>;
+  start(options?: ContainerStartOptions, waitOptions?: ContainerWaitOptions): Promise<void>;
+  startAndWaitForPorts(options?: ContainerStartAndWaitForPortsOptions): Promise<void>;
+  stop(signal?: ContainerSignal): Promise<void>;
+  destroy(): Promise<void>;
+}
+/** Native Container namespace binding shape. */
+interface ContainerNamespaceResource {
+  getByName(name: string, options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions): ContainerStub;
+}
+/** Container namespace binding metadata. */
+interface ContainerNamespaceDefinition {
+  /** Binding name as configured in `wrangler.jsonc`. */
+  readonly binding: string;
+}
+declare const ContainerOperationError_base: new <A extends Record<string, any> = {}>(args: _$effect_Types0.VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => _$effect_Cause0.YieldableError & {
+  readonly _tag: "ContainerOperationError";
+} & Readonly<A>;
+/** Failure raised when invoking a named Container operation. */
+declare class ContainerOperationError extends ContainerOperationError_base<{
+  readonly binding: string;
+  readonly instance: string;
+  readonly operation: string;
+  readonly cause: unknown;
+}> {}
+/** Effect-wrapped client for one named Container instance. */
+interface ContainerInstanceClient {
+  readonly unsafeRaw: Effect.Effect<ContainerStub, ContainerOperationError>;
+  readonly state: Effect.Effect<ContainerState, ContainerOperationError>;
+  readonly fetch: (input: RequestInfo | URL, init?: RequestInit) => Effect.Effect<Response, ContainerOperationError>;
+  readonly start: (options?: ContainerStartOptions, waitOptions?: ContainerWaitOptions) => Effect.Effect<void, ContainerOperationError>;
+  readonly startAndWaitForPorts: (options?: ContainerStartAndWaitForPortsOptions) => Effect.Effect<void, ContainerOperationError>;
+  readonly stop: (signal?: ContainerSignal) => Effect.Effect<void, ContainerOperationError>;
+  readonly destroy: Effect.Effect<void, ContainerOperationError>;
+}
+/** Effect client for a Container namespace binding. */
+interface ContainerNamespaceClient {
+  readonly definition: ContainerNamespaceDefinition;
+  readonly getByName: (name: string, options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions) => Effect.Effect<ContainerInstanceClient, ContainerOperationError>;
+  readonly byName: (name: string, options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions) => ContainerInstanceClient;
+  readonly unsafeRaw: Effect.Effect<ContainerNamespaceResource>;
+}
+type ContainerNamespaceStaticClient<R> = {
+  readonly getByName: (name: string, options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions) => Effect.Effect<ContainerInstanceClient, ContainerOperationError, R>;
+  readonly byName: (name: string, options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions) => {
+    readonly state: Effect.Effect<ContainerState, ContainerOperationError, R>;
+    readonly fetch: (input: RequestInfo | URL, init?: RequestInit) => Effect.Effect<Response, ContainerOperationError, R>;
+    readonly start: (options?: ContainerStartOptions, waitOptions?: ContainerWaitOptions) => Effect.Effect<void, ContainerOperationError, R>;
+    readonly startAndWaitForPorts: (options?: ContainerStartAndWaitForPortsOptions) => Effect.Effect<void, ContainerOperationError, R>;
+    readonly stop: (signal?: ContainerSignal) => Effect.Effect<void, ContainerOperationError, R>;
+    readonly destroy: Effect.Effect<void, ContainerOperationError, R>;
+    readonly unsafeRaw: Effect.Effect<ContainerStub, ContainerOperationError, R>;
+  };
+  readonly unsafeRaw: () => Effect.Effect<ContainerNamespaceResource, never, R>;
+};
+type LayerOptions$14 = {
+  readonly binding: string;
+};
+interface TagClass$13<Self, Id extends string> extends Context.ServiceClass<Self, Id, ContainerNamespaceClient>, ContainerNamespaceStaticClient<Self> {
+  readonly id: Id;
+  readonly layer: (options: LayerOptions$14) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+}
+declare const isContainerNamespaceResource: (value: unknown) => value is ContainerNamespaceResource;
+declare const makeClient$9: (definition: ContainerNamespaceDefinition) => (namespace: ContainerNamespaceResource) => ContainerNamespaceClient;
+declare const layer$11: <Self>(tag: Context.Service<Self, ContainerNamespaceClient>, definition: ContainerNamespaceDefinition) => Layer.Layer<Self, BindingNotFoundError | BindingValidationError, WorkerEnvironment>;
+declare const make$13: <Id extends string>(id: Id) => TagClass$13<ContainerNamespaceService<Id>, Id>;
+declare const ContainerNamespaceServiceTypeId: unique symbol;
+/** Nominal service marker for Container namespaces created with {@link make}. */
+interface ContainerNamespaceService<Id extends string> {
+  readonly [ContainerNamespaceServiceTypeId]: {
+    readonly id: Id;
+  };
+}
+/** Creates a typed Effect service for a Cloudflare Container namespace. */
+declare const Tag$14: <Self>() => <Id extends string>(id: Id) => TagClass$13<Self, Id>;
+declare const ContainerNamespace: <Self>() => <Id extends string>(id: Id) => TagClass$13<Self, Id>;
 declare namespace D1_d_exports {
   export { D1Definition, D1Service, D1SqlLayerOptions, Service$1 as Service, make$12 as make };
 }
@@ -1480,7 +1604,7 @@ declare const method$2: {
   <Success extends ServiceFreeSchema$2>(definition: {
     readonly success: Success;
   }): Method$3<readonly [], Success>;
-  <const Args extends ReadonlyArray<ServiceFreeSchema$2>, Success extends ServiceFreeSchema$2>(definition: {
+  <const Args extends readonly ServiceFreeSchema$2[], Success extends ServiceFreeSchema$2>(definition: {
     readonly args: Args;
     readonly success: Success;
   }): Method$3<Args, Success>;
@@ -2809,4 +2933,4 @@ declare const layer: <Self>(tag: Context.Service<Self, VectorizeClient>, definit
 declare const make: <Id extends string>(id: Id) => TagClass<VectorizeService<Id>, Id>;
 declare const Tag$1: <Self>() => <Id extends string>(id: Id) => TagClass<Self, Id>;
 //#endregion
-export { AiGateway_d_exports as AiGateway, AnalyticsEngine_d_exports as AnalyticsEngine, Binding_d_exports as Binding, BrowserRendering_d_exports as BrowserRendering, CloudflareOtlp_d_exports as CloudflareOtlp, D1_d_exports as D1, DurableObject_d_exports as DurableObject, DurableObjectAlarm_d_exports as DurableObjectAlarm, DurableObjectDefinition_d_exports as DurableObjectDefinition, DurableObjectNamespace_d_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_d_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_d_exports as DurableObjectSqlite, DurableObjectState_d_exports as DurableObjectState, DurableObjectStorage_d_exports as DurableObjectStorage, DurableObjectWebSocket_d_exports as DurableObjectWebSocket, Email_d_exports as Email, Hyperdrive_d_exports as Hyperdrive, Images_d_exports as Images, Kv_d_exports as Kv, Queue_d_exports as Queue, QueueBinding_d_exports as QueueBinding, QueueDefinition_d_exports as QueueDefinition, R2_d_exports as R2, Rpc_d_exports as Rpc, RpcDefinition_d_exports as RpcDefinition, ServiceBinding_d_exports as ServiceBinding, Vectorize_d_exports as Vectorize, Worker_d_exports as Worker, WorkerConfig, WorkerDefinition_d_exports as WorkerDefinition, type WorkerEnv, WorkerEnvironment, WorkersAi_d_exports as WorkersAi, Workflow_d_exports as Workflow, WorkflowBinding_d_exports as WorkflowBinding, WorkflowDefinition_d_exports as WorkflowDefinition };
+export { AiGateway_d_exports as AiGateway, AnalyticsEngine_d_exports as AnalyticsEngine, Binding_d_exports as Binding, BrowserRendering_d_exports as BrowserRendering, CloudflareOtlp_d_exports as CloudflareOtlp, ContainerNamespace_d_exports as ContainerNamespace, D1_d_exports as D1, DurableObject_d_exports as DurableObject, DurableObjectAlarm_d_exports as DurableObjectAlarm, DurableObjectDefinition_d_exports as DurableObjectDefinition, DurableObjectNamespace_d_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_d_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_d_exports as DurableObjectSqlite, DurableObjectState_d_exports as DurableObjectState, DurableObjectStorage_d_exports as DurableObjectStorage, DurableObjectWebSocket_d_exports as DurableObjectWebSocket, Email_d_exports as Email, Hyperdrive_d_exports as Hyperdrive, Images_d_exports as Images, Kv_d_exports as Kv, Queue_d_exports as Queue, QueueBinding_d_exports as QueueBinding, QueueDefinition_d_exports as QueueDefinition, R2_d_exports as R2, Rpc_d_exports as Rpc, RpcDefinition_d_exports as RpcDefinition, ServiceBinding_d_exports as ServiceBinding, Vectorize_d_exports as Vectorize, Worker_d_exports as Worker, WorkerConfig, WorkerDefinition_d_exports as WorkerDefinition, type WorkerEnv, WorkerEnvironment, WorkersAi_d_exports as WorkersAi, Workflow_d_exports as Workflow, WorkflowBinding_d_exports as WorkflowBinding, WorkflowDefinition_d_exports as WorkflowDefinition };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { a as WorkerConfig, i as layer$17, n as Binding_exports, o as WorkerEnvironment, r as Service$2, t as Hyperdrive_exports } from "./Hyperdrive-89hg_Fck.mjs";
+import { a as WorkerConfig, i as layer$18, n as Binding_exports, o as WorkerEnvironment, r as Service$2, t as Hyperdrive_exports } from "./Hyperdrive-89hg_Fck.mjs";
 import { Cause, Clock, Config, ConfigProvider, Context, Data, DateTime, Duration, Effect, Exit, Layer, ManagedRuntime, Option, Queue, Result, Schema } from "effect";
 import { FetchHttpClient, HttpClient, HttpClientRequest, HttpServerRequest, HttpServerResponse } from "effect/unstable/http";
 import { OtlpLogger, OtlpMetrics, OtlpSerialization, OtlpTracer } from "effect/unstable/observability";
@@ -11,13 +11,13 @@ import * as RpcServer from "effect/unstable/rpc/RpcServer";
 import { SqliteClient } from "@effect/sql-sqlite-do";
 //#region src/WorkersAi.ts
 var WorkersAi_exports = /* @__PURE__ */ __exportAll({
-	Tag: () => Tag$16,
+	Tag: () => Tag$17,
 	WorkersAiOperationError: () => WorkersAiOperationError,
 	embeddingResponse: () => embeddingResponse,
 	isWorkersAiBinding: () => isWorkersAiBinding,
-	layer: () => layer$16,
-	make: () => make$16,
-	makeClient: () => makeClient$12
+	layer: () => layer$17,
+	make: () => make$17,
+	makeClient: () => makeClient$13
 });
 const expectedWorkersAiBinding = "Workers AI binding with run(), gateway(), and models()";
 /** Error raised when a Workers AI operation fails. */
@@ -41,7 +41,7 @@ const embeddingResponse = (value) => ({
 	data: value.data ?? [],
 	shape: value.shape ?? []
 });
-const makeClient$12 = (definition) => (ai) => {
+const makeClient$13 = (definition) => (ai) => {
 	const run = ((model, input, options) => tryWorkersAiPromise(definition.binding, "run", () => ai.run(model, input, options)));
 	return {
 		definition,
@@ -53,11 +53,11 @@ const makeClient$12 = (definition) => (ai) => {
 		unsafeRaw: Effect.succeed(ai)
 	};
 };
-const layer$16 = (tag, definition) => layer$17(tag, definition.binding, (value) => isWorkersAiBinding(value), makeClient$12(definition), { expected: expectedWorkersAiBinding });
-const make$16 = (id) => Tag$16()(id);
-const Tag$16 = () => (id) => {
+const layer$17 = (tag, definition) => layer$18(tag, definition.binding, (value) => isWorkersAiBinding(value), makeClient$13(definition), { expected: expectedWorkersAiBinding });
+const make$17 = (id) => Tag$17()(id);
+const Tag$17 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$16(tag, definition);
+	const makeLayer = (definition) => layer$17(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -67,11 +67,11 @@ const Tag$16 = () => (id) => {
 //#region src/AiGateway.ts
 var AiGateway_exports = /* @__PURE__ */ __exportAll({
 	AiGatewayOperationError: () => AiGatewayOperationError,
-	Tag: () => Tag$15,
+	Tag: () => Tag$16,
 	isAiGatewayBinding: () => isAiGatewayBinding,
-	layer: () => layer$15,
-	make: () => make$15,
-	makeClient: () => makeClient$11,
+	layer: () => layer$16,
+	make: () => make$16,
+	makeClient: () => makeClient$12,
 	makeClientFromAi: () => makeClientFromAi,
 	makeHttpClient: () => makeHttpClient
 });
@@ -98,7 +98,7 @@ const providerUrl = (baseUrl, path = "") => {
 };
 const gatewayUrl = (definition) => `https://gateway.ai.cloudflare.com/v1/${definition.accountId}/${definition.gatewayId}/`;
 const isAiGatewayBinding = (value) => isWorkersAiBinding(value);
-const makeClient$11 = (definition, gateway) => ({
+const makeClient$12 = (definition, gateway) => ({
 	definition,
 	run: (data, options) => tryAiGatewayPromise(definition.binding, "run", () => gateway.run(Array.isArray(data) ? [...data] : data, options)),
 	getUrl: (provider) => tryAiGatewayPromise(definition.binding, "getUrl", () => gateway.getUrl(provider)),
@@ -115,11 +115,11 @@ const makeClientFromAi = (definition, ai) => {
 	const withGateway = (operation) => gateway.pipe(Effect.flatMap(operation));
 	return {
 		definition,
-		run: (data, options) => withGateway((raw) => makeClient$11(definition, raw).run(data, options)),
-		getUrl: (provider) => withGateway((raw) => makeClient$11(definition, raw).getUrl(provider)),
-		fetch: (options) => withGateway((raw) => makeClient$11(definition, raw).fetch(options)),
-		patchLog: (logId, data) => withGateway((raw) => makeClient$11(definition, raw).patchLog(logId, data)),
-		getLog: (logId) => withGateway((raw) => makeClient$11(definition, raw).getLog(logId)),
+		run: (data, options) => withGateway((raw) => makeClient$12(definition, raw).run(data, options)),
+		getUrl: (provider) => withGateway((raw) => makeClient$12(definition, raw).getUrl(provider)),
+		fetch: (options) => withGateway((raw) => makeClient$12(definition, raw).fetch(options)),
+		patchLog: (logId, data) => withGateway((raw) => makeClient$12(definition, raw).patchLog(logId, data)),
+		getLog: (logId) => withGateway((raw) => makeClient$12(definition, raw).getLog(logId)),
 		unsafeRaw: gateway
 	};
 };
@@ -159,11 +159,11 @@ const makeHttpClient = (definition, request = fetch) => {
 		unsafeRaw: Effect.fail(aiGatewayError(binding, "unsafeRaw", /* @__PURE__ */ new TypeError("HTTP AI Gateway clients have no raw binding")))
 	};
 };
-const layer$15 = (tag, definition) => layer$17(tag, definition.binding, isAiGatewayBinding, (ai) => makeClientFromAi(definition, ai), { expected: expectedAiGatewayBinding });
-const make$15 = (id) => Tag$15()(id);
-const Tag$15 = () => (id) => {
+const layer$16 = (tag, definition) => layer$18(tag, definition.binding, isAiGatewayBinding, (ai) => makeClientFromAi(definition, ai), { expected: expectedAiGatewayBinding });
+const make$16 = (id) => Tag$16()(id);
+const Tag$16 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$15(tag, definition);
+	const makeLayer = (definition) => layer$16(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -178,11 +178,11 @@ var AnalyticsEngine_exports = /* @__PURE__ */ __exportAll({
 	AnalyticsEngineQueryError: () => AnalyticsEngineQueryError,
 	AnalyticsEngineWriteValidationError: () => AnalyticsEngineWriteValidationError,
 	QueryTag: () => QueryTag,
-	Tag: () => Tag$14,
+	Tag: () => Tag$15,
 	isAnalyticsEngineDataset: () => isAnalyticsEngineDataset,
-	layer: () => layer$14,
-	make: () => make$14,
-	makeClient: () => makeClient$10,
+	layer: () => layer$15,
+	make: () => make$15,
+	makeClient: () => makeClient$11,
 	makeQuery: () => makeQuery,
 	makeQueryClient: () => makeQueryClient,
 	queryConfig: () => queryConfig,
@@ -375,7 +375,7 @@ const isAnalyticsEngineDataset = (value) => {
 	if (typeof value !== "object" || value === null) return false;
 	return typeof Reflect.get(value, "writeDataPoint") === "function";
 };
-const makeClient$10 = (definition, defaults) => (dataset) => {
+const makeClient$11 = (definition, defaults) => (dataset) => {
 	const writeDataPoint = (dataPoint, options) => {
 		const policy = resolveWritePolicy(defaults, options);
 		return validateOptionalDataPoint(definition.binding, "writeDataPoint", dataPoint).pipe(Effect.matchEffect({
@@ -410,12 +410,12 @@ const queryLayerConfig = (tag, config = queryConfig()) => Layer.effect(tag, Effe
 	return yield* makeQueryClient(yield* config);
 }));
 const queryFetchLayerConfig = (tag, config = queryConfig()) => queryLayerConfig(tag, config).pipe(Layer.provide(FetchHttpClient.layer));
-const layer$14 = (tag, definition) => layer$17(tag, definition.binding, isAnalyticsEngineDataset, makeClient$10(definition, definition.write), { expected: expectedAnalyticsEngineDataset });
-const make$14 = (id) => Tag$14()(id);
+const layer$15 = (tag, definition) => layer$18(tag, definition.binding, isAnalyticsEngineDataset, makeClient$11(definition, definition.write), { expected: expectedAnalyticsEngineDataset });
+const make$15 = (id) => Tag$15()(id);
 const makeQuery = (id) => QueryTag()(id);
-const Tag$14 = () => (id) => {
+const Tag$15 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$14(tag, definition);
+	const makeLayer = (definition) => layer$15(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -439,11 +439,11 @@ const QueryTag = () => (id) => {
 //#region src/BrowserRendering.ts
 var BrowserRendering_exports = /* @__PURE__ */ __exportAll({
 	BrowserRenderingOperationError: () => BrowserRenderingOperationError,
-	Tag: () => Tag$13,
+	Tag: () => Tag$14,
 	isBrowserRenderingBinding: () => isBrowserRenderingBinding,
-	layer: () => layer$13,
-	make: () => make$13,
-	makeClient: () => makeClient$9
+	layer: () => layer$14,
+	make: () => make$14,
+	makeClient: () => makeClient$10
 });
 const expectedBrowserRenderingBinding = "Browser Rendering binding resource";
 /** Error raised when a Browser Rendering operation fails. */
@@ -480,17 +480,17 @@ const wrapBrowser = (binding, browser) => ({
 	disconnect: browser.disconnect === void 0 ? Effect.void : tryBrowserRenderingSync(binding, "disconnect", () => browser.disconnect())
 });
 const isBrowserRenderingBinding = (value) => (typeof value === "object" || typeof value === "function") && value !== null;
-const makeClient$9 = (definition) => (binding) => ({
+const makeClient$10 = (definition) => (binding) => ({
 	definition,
 	launchWith: (launch, options) => tryBrowserRenderingPromise(definition.binding, "launch", () => launch(binding, options)).pipe(Effect.map((browser) => wrapBrowser(definition.binding, browser))),
 	connectWith: (connect, options) => tryBrowserRenderingPromise(definition.binding, "connect", () => connect(binding, options)).pipe(Effect.map((browser) => wrapBrowser(definition.binding, browser))),
 	unsafeRaw: Effect.succeed(binding)
 });
-const layer$13 = (tag, definition) => layer$17(tag, definition.binding, isBrowserRenderingBinding, makeClient$9(definition), { expected: expectedBrowserRenderingBinding });
-const make$13 = (id) => Tag$13()(id);
-const Tag$13 = () => (id) => {
+const layer$14 = (tag, definition) => layer$18(tag, definition.binding, isBrowserRenderingBinding, makeClient$10(definition), { expected: expectedBrowserRenderingBinding });
+const make$14 = (id) => Tag$14()(id);
+const Tag$14 = () => (id) => {
 	const tag = Context.Service()(id);
-	const makeLayer = (definition) => layer$13(tag, definition);
+	const makeLayer = (definition) => layer$14(tag, definition);
 	return Object.assign(tag, {
 		id,
 		layer: makeLayer
@@ -789,7 +789,7 @@ const runPromiseExitPreservingTypedFailures = async (effect) => {
 //#region src/CloudflareOtlp.ts
 var CloudflareOtlp_exports = /* @__PURE__ */ __exportAll({
 	durableObjectLayer: () => durableObjectLayer,
-	layer: () => layer$12,
+	layer: () => layer$13,
 	layerJson: () => layerJson,
 	layerProtobuf: () => layerProtobuf,
 	workerLayer: () => workerLayer
@@ -851,14 +851,14 @@ const makeLayer = (options = {}, runtimeAttributes = {}) => {
 * installed as the primary `ConfigProvider`; outside Cloudflare, the ambient
 * Effect `ConfigProvider` remains the fallback.
 */
-const layer$12 = (options = {}) => makeLayer(options);
+const layer$13 = (options = {}) => makeLayer(options);
 /** Base OTLP telemetry layer forced to JSON serialization. */
-const layerJson = (options = {}) => layer$12({
+const layerJson = (options = {}) => layer$13({
 	...options,
 	serialization: "json"
 });
 /** Base OTLP telemetry layer forced to protobuf serialization. */
-const layerProtobuf = (options = {}) => layer$12({
+const layerProtobuf = (options = {}) => layer$13({
 	...options,
 	serialization: "protobuf"
 });
@@ -885,6 +885,118 @@ const durableObjectLayer = (options = {}) => Layer.unwrap(Effect.map(DurableObje
 	"cloudflare.durable_object.id": options.includeObjectId ? state.id.toString() : void 0
 })));
 //#endregion
+//#region src/ContainerNamespace.ts
+var ContainerNamespace_exports = /* @__PURE__ */ __exportAll({
+	ContainerNamespace: () => ContainerNamespace,
+	ContainerOperationError: () => ContainerOperationError,
+	ContainerState: () => ContainerState,
+	Tag: () => Tag$13,
+	isContainerNamespaceResource: () => isContainerNamespaceResource,
+	layer: () => layer$12,
+	make: () => make$13,
+	makeClient: () => makeClient$9
+});
+const expectedContainerNamespace = "Container namespace binding with getByName()";
+/** Serializable state reported by a Cloudflare Container instance. */
+const ContainerState = Schema.Union([Schema.Struct({
+	lastChange: Schema.Finite,
+	status: Schema.Literals([
+		"running",
+		"stopping",
+		"stopped",
+		"healthy"
+	])
+}), Schema.Struct({
+	lastChange: Schema.Finite,
+	status: Schema.Literal("stopped_with_code"),
+	exitCode: Schema.optionalKey(Schema.Int)
+})]);
+/** Failure raised when invoking a named Container operation. */
+var ContainerOperationError = class extends Data.TaggedError("ContainerOperationError") {};
+const tryContainerPromise = (definition, instance, operation, evaluate) => Effect.tryPromise({
+	try: evaluate,
+	catch: (cause) => new ContainerOperationError({
+		binding: definition.binding,
+		instance,
+		operation,
+		cause
+	})
+});
+const makeInstanceClient = (definition, instance, stub) => ({
+	unsafeRaw: Effect.succeed(stub),
+	state: tryContainerPromise(definition, instance, "state", () => stub.getState()).pipe(Effect.flatMap(Schema.decodeUnknownEffect(ContainerState)), Effect.mapError((cause) => cause instanceof ContainerOperationError ? cause : new ContainerOperationError({
+		binding: definition.binding,
+		instance,
+		operation: "state",
+		cause
+	}))),
+	fetch: (input, init) => tryContainerPromise(definition, instance, "fetch", () => stub.fetch(input, init)),
+	start: (options, waitOptions) => tryContainerPromise(definition, instance, "start", () => stub.start(options, waitOptions)),
+	startAndWaitForPorts: (options) => tryContainerPromise(definition, instance, "startAndWaitForPorts", () => stub.startAndWaitForPorts(options)),
+	stop: (signal) => tryContainerPromise(definition, instance, "stop", () => stub.stop(signal)),
+	destroy: tryContainerPromise(definition, instance, "destroy", () => stub.destroy())
+});
+const isContainerNamespaceResource = (value) => typeof value === "object" && value !== null && typeof Reflect.get(value, "getByName") === "function";
+const makeClient$9 = (definition) => (namespace) => {
+	const getByName = (name, options) => Effect.try({
+		try: () => makeInstanceClient(definition, name, namespace.getByName(name, options)),
+		catch: (cause) => new ContainerOperationError({
+			binding: definition.binding,
+			instance: name,
+			operation: "getByName",
+			cause
+		})
+	});
+	const byName = (name, options) => {
+		const instance = getByName(name, options);
+		return {
+			unsafeRaw: Effect.flatMap(instance, (client) => client.unsafeRaw),
+			state: Effect.flatMap(instance, (client) => client.state),
+			fetch: (input, init) => Effect.flatMap(instance, (client) => client.fetch(input, init)),
+			start: (startOptions, waitOptions) => Effect.flatMap(instance, (client) => client.start(startOptions, waitOptions)),
+			startAndWaitForPorts: (startOptions) => Effect.flatMap(instance, (client) => client.startAndWaitForPorts(startOptions)),
+			stop: (signal) => Effect.flatMap(instance, (client) => client.stop(signal)),
+			destroy: Effect.flatMap(instance, (client) => client.destroy)
+		};
+	};
+	return {
+		definition,
+		getByName,
+		byName,
+		unsafeRaw: Effect.succeed(namespace)
+	};
+};
+const layer$12 = (tag, definition) => layer$18(tag, definition.binding, isContainerNamespaceResource, makeClient$9(definition), { expected: expectedContainerNamespace });
+const make$13 = (id) => Tag$13()(id);
+/** Creates a typed Effect service for a Cloudflare Container namespace. */
+const Tag$13 = () => (id) => {
+	const tag = Context.Service()(id);
+	const makeLayer = (definition) => layer$12(tag, definition);
+	const getByName = (name, options) => Effect.gen(function* () {
+		return yield* (yield* tag).getByName(name, options);
+	});
+	const byName = (name, options) => ({
+		state: Effect.flatMap(getByName(name, options), (instance) => instance.state),
+		fetch: (input, init) => Effect.flatMap(getByName(name, options), (instance) => instance.fetch(input, init)),
+		start: (startOptions, waitOptions) => Effect.flatMap(getByName(name, options), (instance) => instance.start(startOptions, waitOptions)),
+		startAndWaitForPorts: (startOptions) => Effect.flatMap(getByName(name, options), (instance) => instance.startAndWaitForPorts(startOptions)),
+		stop: (signal) => Effect.flatMap(getByName(name, options), (instance) => instance.stop(signal)),
+		destroy: Effect.flatMap(getByName(name, options), (instance) => instance.destroy),
+		unsafeRaw: Effect.flatMap(getByName(name, options), (instance) => instance.unsafeRaw)
+	});
+	const unsafeRaw = Effect.fn(function* () {
+		return yield* (yield* tag).unsafeRaw;
+	});
+	return Object.assign(tag, {
+		id,
+		layer: makeLayer,
+		getByName,
+		byName,
+		unsafeRaw
+	});
+};
+const ContainerNamespace = Tag$13;
+//#endregion
 //#region src/D1.ts
 var D1_exports = /* @__PURE__ */ __exportAll({
 	Service: () => Service$1,
@@ -992,7 +1104,7 @@ const makeClient$8 = (definition) => {
 		unsafeRaw: Effect.succeed(queue)
 	});
 };
-const layer$11 = (tag, definition) => layer$17(tag, definition.binding, (value) => isQueue(value), makeClient$8(definition), { expected: expectedQueueProducer });
+const layer$11 = (tag, definition) => layer$18(tag, definition.binding, (value) => isQueue(value), makeClient$8(definition), { expected: expectedQueueProducer });
 //#endregion
 //#region src/QueueDefinition.ts
 var QueueDefinition_exports = /* @__PURE__ */ __exportAll({
@@ -1335,7 +1447,7 @@ const makeClient$7 = (definition) => {
 		});
 	};
 };
-const layer$10 = (tag, definition) => layer$17(tag, definition.binding, (value) => isServiceBindingClient(value), makeClient$7(definition), { expected: expectedServiceBinding });
+const layer$10 = (tag, definition) => layer$18(tag, definition.binding, (value) => isServiceBindingClient(value), makeClient$7(definition), { expected: expectedServiceBinding });
 /**
 * Creates a typed Effect service for a Worker service binding.
 *
@@ -1712,7 +1824,7 @@ const makeClient$6 = (definition) => {
 		});
 	};
 };
-const layer$8 = (tag, definition) => layer$17(tag, definition.binding, (value) => isDurableObjectNamespaceClient(value), makeClient$6(definition), { expected: expectedDurableObjectNamespace });
+const layer$8 = (tag, definition) => layer$18(tag, definition.binding, (value) => isDurableObjectNamespaceClient(value), makeClient$6(definition), { expected: expectedDurableObjectNamespace });
 const makeDirectMethods = (rpcDefinition, helpers) => {
 	const methods = {};
 	if (rpcDefinition !== void 0) {
@@ -2427,7 +2539,7 @@ const makeClient$5 = (definition) => (email) => {
 		unsafeRaw: Effect.succeed(email)
 	};
 };
-const layer$5 = (tag, definition) => layer$17(tag, definition.binding, isEmailBinding, makeClient$5(definition), { expected: expectedSendEmailBinding });
+const layer$5 = (tag, definition) => layer$18(tag, definition.binding, isEmailBinding, makeClient$5(definition), { expected: expectedSendEmailBinding });
 const make$5 = (id) => Tag$6()(id);
 const Tag$6 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2534,7 +2646,7 @@ const makeClient$4 = (definition) => (images) => {
 		unsafeRaw: Effect.succeed(images)
 	};
 };
-const layer$4 = (tag, definition) => layer$17(tag, definition.binding, isImagesBinding, makeClient$4(definition), { expected: expectedImagesBinding });
+const layer$4 = (tag, definition) => layer$18(tag, definition.binding, isImagesBinding, makeClient$4(definition), { expected: expectedImagesBinding });
 const make$4 = (id) => Tag$5()(id);
 const Tag$5 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2629,7 +2741,7 @@ const makeClient$3 = (definition) => {
 		unsafeRaw: Effect.succeed(kv)
 	});
 };
-const layer$3 = (tag, definition) => layer$17(tag, definition.binding, isKvNamespace, makeClient$3(definition), { expected: expectedKvNamespace });
+const layer$3 = (tag, definition) => layer$18(tag, definition.binding, isKvNamespace, makeClient$3(definition), { expected: expectedKvNamespace });
 const makeDefinition$1 = (id, definition) => {
 	const kvDefinition = {
 		id,
@@ -2746,7 +2858,7 @@ const makeClient$2 = (definition) => {
 		};
 	};
 };
-const layer$2 = (tag, definition) => layer$17(tag, definition.binding, isR2Bucket, makeClient$2(definition), { expected: expectedR2Bucket });
+const layer$2 = (tag, definition) => layer$18(tag, definition.binding, isR2Bucket, makeClient$2(definition), { expected: expectedR2Bucket });
 const make$3 = (id) => Tag$3()(id);
 const Tag$3 = () => (id) => {
 	const tag = Context.Service()(id);
@@ -2803,7 +2915,7 @@ const makeClient$1 = (definition) => {
 				return {
 					status: status.status,
 					output,
-					error: status.error === void 0 ? Option.none() : Option.some(status.error)
+					error: status.error == null ? Option.none() : Option.some(status.error)
 				};
 			}))),
 			sendEvent: (event) => operation("sendEvent", () => raw.sendEvent(event))
@@ -2832,7 +2944,7 @@ const makeClient$1 = (definition) => {
 		unsafeRaw: Effect.succeed(workflow)
 	});
 };
-const layer$1 = (tag, definition) => layer$17(tag, definition.binding, (value) => isWorkflow(value), makeClient$1(definition), { expected: expectedWorkflow });
+const layer$1 = (tag, definition) => layer$18(tag, definition.binding, (value) => isWorkflow(value), makeClient$1(definition), { expected: expectedWorkflow });
 //#endregion
 //#region src/WorkflowDefinition.ts
 var WorkflowDefinition_exports = /* @__PURE__ */ __exportAll({
@@ -3006,7 +3118,7 @@ const makeClient = (definition) => (index) => {
 		unsafeRaw: Effect.succeed(index)
 	};
 };
-const layer = (tag, definition) => layer$17(tag, definition.binding, isVectorizeBinding, makeClient(definition), { expected: expectedVectorizeBinding });
+const layer = (tag, definition) => layer$18(tag, definition.binding, isVectorizeBinding, makeClient(definition), { expected: expectedVectorizeBinding });
 const make = (id) => Tag()(id);
 const Tag = () => (id) => {
 	const tag = Context.Service()(id);
@@ -3017,4 +3129,4 @@ const Tag = () => (id) => {
 	});
 };
 //#endregion
-export { AiGateway_exports as AiGateway, AnalyticsEngine_exports as AnalyticsEngine, Binding_exports as Binding, BrowserRendering_exports as BrowserRendering, CloudflareOtlp_exports as CloudflareOtlp, D1_exports as D1, DurableObject_exports as DurableObject, DurableObjectAlarm_exports as DurableObjectAlarm, DurableObjectDefinition_exports as DurableObjectDefinition, DurableObjectNamespace_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_exports as DurableObjectSqlite, DurableObjectState_exports as DurableObjectState, DurableObjectStorage_exports as DurableObjectStorage, DurableObjectWebSocket_exports as DurableObjectWebSocket, Email_exports as Email, Hyperdrive_exports as Hyperdrive, Images_exports as Images, Kv_exports as Kv, Queue_exports as Queue, QueueBinding_exports as QueueBinding, QueueDefinition_exports as QueueDefinition, R2_exports as R2, Rpc_exports as Rpc, RpcDefinition_exports as RpcDefinition, ServiceBinding_exports as ServiceBinding, Vectorize_exports as Vectorize, Worker_exports as Worker, WorkerConfig, WorkerDefinition_exports as WorkerDefinition, WorkerEnvironment, WorkersAi_exports as WorkersAi, Workflow_exports as Workflow, WorkflowBinding_exports as WorkflowBinding, WorkflowDefinition_exports as WorkflowDefinition };
+export { AiGateway_exports as AiGateway, AnalyticsEngine_exports as AnalyticsEngine, Binding_exports as Binding, BrowserRendering_exports as BrowserRendering, CloudflareOtlp_exports as CloudflareOtlp, ContainerNamespace_exports as ContainerNamespace, D1_exports as D1, DurableObject_exports as DurableObject, DurableObjectAlarm_exports as DurableObjectAlarm, DurableObjectDefinition_exports as DurableObjectDefinition, DurableObjectNamespace_exports as DurableObjectNamespace, DurableObjectRpcWebSocket_exports as DurableObjectRpcWebSocket, DurableObjectSqlite_exports as DurableObjectSqlite, DurableObjectState_exports as DurableObjectState, DurableObjectStorage_exports as DurableObjectStorage, DurableObjectWebSocket_exports as DurableObjectWebSocket, Email_exports as Email, Hyperdrive_exports as Hyperdrive, Images_exports as Images, Kv_exports as Kv, Queue_exports as Queue, QueueBinding_exports as QueueBinding, QueueDefinition_exports as QueueDefinition, R2_exports as R2, Rpc_exports as Rpc, RpcDefinition_exports as RpcDefinition, ServiceBinding_exports as ServiceBinding, Vectorize_exports as Vectorize, Worker_exports as Worker, WorkerConfig, WorkerDefinition_exports as WorkerDefinition, WorkerEnvironment, WorkersAi_exports as WorkersAi, Workflow_exports as Workflow, WorkflowBinding_exports as WorkflowBinding, WorkflowDefinition_exports as WorkflowDefinition };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-cf",
-  "version": "0.16.0",
+  "version": "0.17.1",
   "description": "Effect-native primitives for Cloudflare Workers and bindings.",
   "license": "MIT",
   "repository": {
@@ -39,6 +39,7 @@
     "prepublishOnly": "vp run build"
   },
   "devDependencies": {
+    "@cloudflare/containers": "catalog:",
     "@cloudflare/vitest-pool-workers": "catalog:",
     "@cloudflare/workers-types": "catalog:",
     "@effect/platform-node": "4.0.0-beta.77",

package/src/ContainerNamespace.ts

@@ -0,0 +1,337 @@
+import { Context, Data, Effect, Schema, type Layer } from "effect";
+
+import * as Binding from "./Binding";
+import type { WorkerEnvironment } from "./Environment";
+
+const expectedContainerNamespace = "Container namespace binding with getByName()";
+
+/** Signal accepted by Cloudflare Container instances. */
+export type ContainerSignal = "SIGKILL" | "SIGINT" | "SIGTERM";
+
+/** Per-instance Container startup configuration. */
+export interface ContainerStartOptions {
+  readonly envVars?: Record<string, string>;
+  readonly entrypoint?: Array<string>;
+  readonly enableInternet?: boolean;
+  readonly labels?: Record<string, string>;
+}
+
+/** Serializable retry settings used while starting a Container. */
+export interface ContainerWaitOptions {
+  readonly portToCheck: number;
+  readonly retries?: number;
+  readonly waitInterval?: number;
+}
+
+/** Serializable timeout settings used while waiting for Container ports. */
+export interface ContainerReadinessOptions {
+  readonly instanceGetTimeoutMS?: number;
+  readonly portReadyTimeoutMS?: number;
+  readonly waitInterval?: number;
+}
+
+/** Options for starting a Container and waiting for its ports. */
+export interface ContainerStartAndWaitForPortsOptions {
+  readonly startOptions?: ContainerStartOptions;
+  readonly ports?: number | Array<number>;
+  readonly cancellationOptions?: ContainerReadinessOptions;
+}
+
+/** Serializable state reported by a Cloudflare Container instance. */
+export const ContainerState = Schema.Union([
+  Schema.Struct({
+    lastChange: Schema.Finite,
+    status: Schema.Literals(["running", "stopping", "stopped", "healthy"]),
+  }),
+  Schema.Struct({
+    lastChange: Schema.Finite,
+    status: Schema.Literal("stopped_with_code"),
+    exitCode: Schema.optionalKey(Schema.Int),
+  }),
+]);
+export type ContainerState = typeof ContainerState.Type;
+
+/**
+ * Native Container stub shape exposed by a Container namespace binding.
+ *
+ * This is structural so using Container bindings does not make
+ * `@cloudflare/containers` a runtime dependency of effect-cf.
+ */
+export interface ContainerStub {
+  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+  getState(): Promise<ContainerState>;
+  start(options?: ContainerStartOptions, waitOptions?: ContainerWaitOptions): Promise<void>;
+  startAndWaitForPorts(options?: ContainerStartAndWaitForPortsOptions): Promise<void>;
+  stop(signal?: ContainerSignal): Promise<void>;
+  destroy(): Promise<void>;
+}
+
+/** Native Container namespace binding shape. */
+export interface ContainerNamespaceResource {
+  getByName(
+    name: string,
+    options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+  ): ContainerStub;
+}
+
+/** Container namespace binding metadata. */
+export interface ContainerNamespaceDefinition {
+  /** Binding name as configured in `wrangler.jsonc`. */
+  readonly binding: string;
+}
+
+/** Failure raised when invoking a named Container operation. */
+export class ContainerOperationError extends Data.TaggedError("ContainerOperationError")<{
+  readonly binding: string;
+  readonly instance: string;
+  readonly operation: string;
+  readonly cause: unknown;
+}> {}
+
+/** Effect-wrapped client for one named Container instance. */
+export interface ContainerInstanceClient {
+  readonly unsafeRaw: Effect.Effect<ContainerStub, ContainerOperationError>;
+  readonly state: Effect.Effect<ContainerState, ContainerOperationError>;
+  readonly fetch: (
+    input: RequestInfo | URL,
+    init?: RequestInit,
+  ) => Effect.Effect<Response, ContainerOperationError>;
+  readonly start: (
+    options?: ContainerStartOptions,
+    waitOptions?: ContainerWaitOptions,
+  ) => Effect.Effect<void, ContainerOperationError>;
+  readonly startAndWaitForPorts: (
+    options?: ContainerStartAndWaitForPortsOptions,
+  ) => Effect.Effect<void, ContainerOperationError>;
+  readonly stop: (signal?: ContainerSignal) => Effect.Effect<void, ContainerOperationError>;
+  readonly destroy: Effect.Effect<void, ContainerOperationError>;
+}
+
+/** Effect client for a Container namespace binding. */
+export interface ContainerNamespaceClient {
+  readonly definition: ContainerNamespaceDefinition;
+  readonly getByName: (
+    name: string,
+    options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+  ) => Effect.Effect<ContainerInstanceClient, ContainerOperationError>;
+  readonly byName: (
+    name: string,
+    options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+  ) => ContainerInstanceClient;
+  readonly unsafeRaw: Effect.Effect<ContainerNamespaceResource>;
+}
+
+export type ContainerNamespaceStaticClient<R> = {
+  readonly getByName: (
+    name: string,
+    options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+  ) => Effect.Effect<ContainerInstanceClient, ContainerOperationError, R>;
+  readonly byName: (
+    name: string,
+    options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+  ) => {
+    readonly state: Effect.Effect<ContainerState, ContainerOperationError, R>;
+    readonly fetch: (
+      input: RequestInfo | URL,
+      init?: RequestInit,
+    ) => Effect.Effect<Response, ContainerOperationError, R>;
+    readonly start: (
+      options?: ContainerStartOptions,
+      waitOptions?: ContainerWaitOptions,
+    ) => Effect.Effect<void, ContainerOperationError, R>;
+    readonly startAndWaitForPorts: (
+      options?: ContainerStartAndWaitForPortsOptions,
+    ) => Effect.Effect<void, ContainerOperationError, R>;
+    readonly stop: (signal?: ContainerSignal) => Effect.Effect<void, ContainerOperationError, R>;
+    readonly destroy: Effect.Effect<void, ContainerOperationError, R>;
+    readonly unsafeRaw: Effect.Effect<ContainerStub, ContainerOperationError, R>;
+  };
+  readonly unsafeRaw: () => Effect.Effect<ContainerNamespaceResource, never, R>;
+};
+
+export type LayerOptions = {
+  readonly binding: string;
+};
+
+export interface TagClass<Self, Id extends string>
+  extends
+    Context.ServiceClass<Self, Id, ContainerNamespaceClient>,
+    ContainerNamespaceStaticClient<Self> {
+  readonly id: Id;
+  readonly layer: (
+    options: LayerOptions,
+  ) => Layer.Layer<
+    Self,
+    Binding.BindingNotFoundError | Binding.BindingValidationError,
+    WorkerEnvironment
+  >;
+}
+
+const tryContainerPromise = <A>(
+  definition: ContainerNamespaceDefinition,
+  instance: string,
+  operation: string,
+  evaluate: () => Promise<A>,
+): Effect.Effect<A, ContainerOperationError> =>
+  Effect.tryPromise({
+    try: evaluate,
+    catch: (cause) =>
+      new ContainerOperationError({
+        binding: definition.binding,
+        instance,
+        operation,
+        cause,
+      }),
+  });
+
+const makeInstanceClient = (
+  definition: ContainerNamespaceDefinition,
+  instance: string,
+  stub: ContainerStub,
+): ContainerInstanceClient => ({
+  unsafeRaw: Effect.succeed(stub),
+  state: tryContainerPromise(definition, instance, "state", () => stub.getState()).pipe(
+    Effect.flatMap(Schema.decodeUnknownEffect(ContainerState)),
+    Effect.mapError((cause) =>
+      cause instanceof ContainerOperationError
+        ? cause
+        : new ContainerOperationError({
+            binding: definition.binding,
+            instance,
+            operation: "state",
+            cause,
+          }),
+    ),
+  ),
+  fetch: (input, init) =>
+    tryContainerPromise(definition, instance, "fetch", () => stub.fetch(input, init)),
+  start: (options, waitOptions) =>
+    tryContainerPromise(definition, instance, "start", () => stub.start(options, waitOptions)),
+  startAndWaitForPorts: (options) =>
+    tryContainerPromise(definition, instance, "startAndWaitForPorts", () =>
+      stub.startAndWaitForPorts(options),
+    ),
+  stop: (signal) => tryContainerPromise(definition, instance, "stop", () => stub.stop(signal)),
+  destroy: tryContainerPromise(definition, instance, "destroy", () => stub.destroy()),
+});
+
+export const isContainerNamespaceResource = (value: unknown): value is ContainerNamespaceResource =>
+  typeof value === "object" &&
+  value !== null &&
+  typeof Reflect.get(value, "getByName") === "function";
+
+export const makeClient =
+  (definition: ContainerNamespaceDefinition) =>
+  (namespace: ContainerNamespaceResource): ContainerNamespaceClient => {
+    const getByName = (
+      name: string,
+      options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+    ) =>
+      Effect.try({
+        try: () => makeInstanceClient(definition, name, namespace.getByName(name, options)),
+        catch: (cause) =>
+          new ContainerOperationError({
+            binding: definition.binding,
+            instance: name,
+            operation: "getByName",
+            cause,
+          }),
+      });
+
+    const byName = (
+      name: string,
+      options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+    ): ContainerInstanceClient => {
+      const instance = getByName(name, options);
+      return {
+        unsafeRaw: Effect.flatMap(instance, (client) => client.unsafeRaw),
+        state: Effect.flatMap(instance, (client) => client.state),
+        fetch: (input, init) => Effect.flatMap(instance, (client) => client.fetch(input, init)),
+        start: (startOptions, waitOptions) =>
+          Effect.flatMap(instance, (client) => client.start(startOptions, waitOptions)),
+        startAndWaitForPorts: (startOptions) =>
+          Effect.flatMap(instance, (client) => client.startAndWaitForPorts(startOptions)),
+        stop: (signal) => Effect.flatMap(instance, (client) => client.stop(signal)),
+        destroy: Effect.flatMap(instance, (client) => client.destroy),
+      };
+    };
+
+    return {
+      definition,
+      getByName,
+      byName,
+      unsafeRaw: Effect.succeed(namespace),
+    };
+  };
+
+export const layer = <Self>(
+  tag: Context.Service<Self, ContainerNamespaceClient>,
+  definition: ContainerNamespaceDefinition,
+) =>
+  Binding.layer(tag, definition.binding, isContainerNamespaceResource, makeClient(definition), {
+    expected: expectedContainerNamespace,
+  });
+
+export const make = <Id extends string>(id: Id) => Tag<ContainerNamespaceService<Id>>()<Id>(id);
+
+declare const ContainerNamespaceServiceTypeId: unique symbol;
+
+/** Nominal service marker for Container namespaces created with {@link make}. */
+export interface ContainerNamespaceService<Id extends string> {
+  readonly [ContainerNamespaceServiceTypeId]: {
+    readonly id: Id;
+  };
+}
+
+/** Creates a typed Effect service for a Cloudflare Container namespace. */
+export const Tag =
+  <Self>() =>
+  <Id extends string>(id: Id) => {
+    const tag = Context.Service<Self, ContainerNamespaceClient>()(id);
+    const makeLayer = (definition: LayerOptions) => layer(tag, definition);
+
+    const getByName = (
+      name: string,
+      options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+    ) =>
+      Effect.gen(function* () {
+        const namespace = yield* tag;
+        return yield* namespace.getByName(name, options);
+      });
+
+    const byName = (
+      name: string,
+      options?: globalThis.DurableObjectNamespaceGetDurableObjectOptions,
+    ) => ({
+      state: Effect.flatMap(getByName(name, options), (instance) => instance.state),
+      fetch: (input: RequestInfo | URL, init?: RequestInit) =>
+        Effect.flatMap(getByName(name, options), (instance) => instance.fetch(input, init)),
+      start: (startOptions?: ContainerStartOptions, waitOptions?: ContainerWaitOptions) =>
+        Effect.flatMap(getByName(name, options), (instance) =>
+          instance.start(startOptions, waitOptions),
+        ),
+      startAndWaitForPorts: (startOptions?: ContainerStartAndWaitForPortsOptions) =>
+        Effect.flatMap(getByName(name, options), (instance) =>
+          instance.startAndWaitForPorts(startOptions),
+        ),
+      stop: (signal?: ContainerSignal) =>
+        Effect.flatMap(getByName(name, options), (instance) => instance.stop(signal)),
+      destroy: Effect.flatMap(getByName(name, options), (instance) => instance.destroy),
+      unsafeRaw: Effect.flatMap(getByName(name, options), (instance) => instance.unsafeRaw),
+    });
+
+    const unsafeRaw = Effect.fn(function* () {
+      const namespace = yield* tag;
+      return yield* namespace.unsafeRaw;
+    });
+
+    return Object.assign(tag, {
+      id,
+      layer: makeLayer,
+      getByName,
+      byName,
+      unsafeRaw,
+    }) as TagClass<Self, Id>;
+  };
+
+export const ContainerNamespace = Tag;

package/src/WorkflowBinding.ts

@@ -187,7 +187,7 @@ export const makeClient = <
             return {
               status: status.status,
               output,
-              error: status.error === undefined ? Option.none() : Option.some(status.error),
+              error: status.error == null ? Option.none() : Option.some(status.error),
             };
           }),
         ),

package/src/index.ts

@@ -3,6 +3,7 @@ export * as AnalyticsEngine from "./AnalyticsEngine";
 export * as Binding from "./Binding";
 export * as BrowserRendering from "./BrowserRendering";
 export * as CloudflareOtlp from "./CloudflareOtlp";
+export * as ContainerNamespace from "./ContainerNamespace";
 export * as D1 from "./D1";
 export * as DurableObject from "./DurableObject";
 export * as DurableObjectAlarm from "./DurableObjectAlarm";