alchemy 2.0.0-beta.74 → 2.0.0-beta.76

package/lib/Railway/Catalog.d.ts

@@ -0,0 +1,37 @@
+import type { RegionsResultItem } from "@distilled.cloud/railway";
+import * as railway from "@distilled.cloud/railway";
+import * as Effect from "effect/Effect";
+export type CatalogKind = "region" | "workspace";
+declare const CatalogNotFound_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Railway.CatalogNotFound";
+} & Readonly<A>;
+export declare class CatalogNotFound extends CatalogNotFound_base<{
+    kind: CatalogKind;
+    ref: string;
+}> {
+}
+/**
+ * Current token workspace (`me.workspace ?? me.workspaces[0]`).
+ * Feeds `projectCreate({ input: { workspaceId } })`. Not a resource.
+ */
+export declare const currentWorkspace: () => Effect.Effect<{
+    id: string;
+    name: string;
+}, railway.BadGateway | railway.BadRequest | railway.Conflict | railway.Forbidden | railway.GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | railway.InternalServerError | railway.Locked | railway.NotFound | railway.RailwayForbidden | railway.RailwayInternalError | railway.RailwayNotFound | railway.RailwayParseError | railway.RailwayPlanLimitExceeded | railway.RailwayRateLimited | railway.RailwayServiceDomainCreateFailed | railway.RailwayUnauthenticated | railway.RailwayValidationError | import("./Environment.ts").RailwayWorkspaceNotFound | railway.ServiceUnavailable | railway.TooManyRequests | railway.Unauthorized | railway.UnknownRailwayError | railway.UnprocessableEntity, railway.RailwayOpContext>;
+/**
+ * List Railway regions via `regions`. Pass `projectId` to scope the
+ * catalog to a project; omit it for the workspace default set.
+ */
+export declare const listRegions: (projectId?: string | undefined) => Effect.Effect<railway.RegionsResultList, railway.RailwayOpError, railway.RailwayOpContext>;
+/**
+ * Resolve a Railway region by code (`us-west2`, `us-east4`, …), display
+ * name, or id.
+ */
+export declare const findRegion: (ref: string) => Effect.Effect<RegionsResultItem, CatalogNotFound | railway.RailwayOpError, railway.RailwayOpContext>;
+export type RailwayRegion = RegionsResultItem;
+/**
+ * Workspace audit logs. Query-only — Railway has no audit-log
+ * create/update/delete, so this is not a resource.
+ */
+export { AuditLog, getAuditLog, listAuditLogEventTypes, listAuditLogs, type AuditLogEntry, type AuditLogEnvironment, type AuditLogEventType, type AuditLogProject, type ListAuditLogsOptions, } from "./AuditLog.ts";
+//# sourceMappingURL=Catalog.d.ts.map

package/lib/Railway/Catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Catalog.d.ts","sourceRoot":"","sources":["../../src/Railway/Catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AAEpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;;;;AAEjD,qBAAa,eAAgB,SAAQ,qBAEnC;IACA,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;CAAG;AAKL;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;quBAAmB,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,WAAW,gIAKtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAS,MAAM,yGAUlC,CAAC;AAEL,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,OAAO,EACL,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC"}

package/lib/Railway/Catalog.js

@@ -0,0 +1,38 @@
+import * as railway from "@distilled.cloud/railway";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import { resolveWorkspace } from "./Environment.js";
+export class CatalogNotFound extends Data.TaggedError("Railway.CatalogNotFound") {
+}
+const notFound = (kind, ref) => new CatalogNotFound({ kind, ref });
+/**
+ * Current token workspace (`me.workspace ?? me.workspaces[0]`).
+ * Feeds `projectCreate({ input: { workspaceId } })`. Not a resource.
+ */
+export const currentWorkspace = resolveWorkspace;
+/**
+ * List Railway regions via `regions`. Pass `projectId` to scope the
+ * catalog to a project; omit it for the workspace default set.
+ */
+export const listRegions = Effect.fn(function* (projectId) {
+    const regions = yield* railway.regions(projectId === undefined ? {} : { projectId });
+    return regions ?? [];
+});
+/**
+ * Resolve a Railway region by code (`us-west2`, `us-east4`, …), display
+ * name, or id.
+ */
+export const findRegion = (ref) => Effect.gen(function* () {
+    const regions = yield* listRegions();
+    const found = regions.find((item) => item.region === ref || item.name === ref || item.id === ref);
+    if (found === undefined) {
+        return yield* notFound("region", ref);
+    }
+    return found;
+});
+/**
+ * Workspace audit logs. Query-only — Railway has no audit-log
+ * create/update/delete, so this is not a resource.
+ */
+export { AuditLog, getAuditLog, listAuditLogEventTypes, listAuditLogs, } from "./AuditLog.js";
+//# sourceMappingURL=Catalog.js.map

package/lib/Railway/Catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Catalog.js","sourceRoot":"","sources":["../../src/Railway/Catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CACnD,yBAAyB,CAIzB;CAAG;AAEL,MAAM,QAAQ,GAAG,CAAC,IAAiB,EAAE,GAAW,EAAE,EAAE,CAClD,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,SAAkB;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,CACpC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAC7C,CAAC;IACF,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CACxC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CACxB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG,CACtE,CAAC;IACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,CAAC;AAIL;;;GAGG;AACH,OAAO,EACL,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,aAAa,GAMd,MAAM,eAAe,CAAC"}

package/lib/Railway/CloudAgent.d.ts

@@ -0,0 +1,179 @@
+import type { CloudAgentSleepResponse, CloudAgentStatus, CloudAgentWakeResponse } from "@distilled.cloud/railway";
+import * as railway from "@distilled.cloud/railway";
+import * as Effect from "effect/Effect";
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import type { Providers } from "./Providers.ts";
+/**
+ * A resource-valued prop: the resource itself, or an Effect that produces
+ * it (so `yield* Project(...)` and `Project(...)` both type-check).
+ */
+type Ref<T> = T | Effect.Effect<T, never, Providers>;
+/**
+ * Environment identity a cloud agent is created in. Accepts a
+ * `Railway.Project` (its primary environment), a `Railway.Environment`,
+ * or an `{ environmentId }` stub.
+ */
+export type CloudAgentEnvironment = {
+    readonly environmentId: string;
+    readonly projectId?: string;
+};
+export interface CloudAgentProps {
+    /**
+     * Environment the agent VM lives in. Accepts a `Railway.Project`
+     * (primary environment), a `Railway.Environment`, or `{ environmentId }`.
+     * Changing it replaces the agent.
+     */
+    environment: Ref<CloudAgentEnvironment>;
+    /**
+     * Agent name. Unique per environment for this user. If omitted, a
+     * unique name is generated from the stack, stage and logical ID.
+     * Changing it replaces the agent — Railway has no rename API.
+     */
+    name?: string;
+    /**
+     * Variables written to the agent at create time. Values may be
+     * Railway reference templates (`Railway.ref(...)`). Create-only;
+     * ignored on update. Never persisted in attributes.
+     */
+    variables?: Record<string, string>;
+}
+export type CloudAgent = Resource<"Railway.CloudAgent", CloudAgentProps, {
+    /** Railway cloud agent id. */
+    cloudAgentId: string;
+    /** Physical agent name. */
+    name: string;
+    /** Environment the agent lives in. */
+    environmentId: string;
+    /** Parent Railway project id. */
+    projectId: string;
+    /** Observed lifecycle status (`STARTING`, `RUNNING`, `SLEEPING`, …). */
+    status: CloudAgentStatus;
+    /**
+     * Public hostname serving port 8080. Stable across sleep and wake;
+     * `undefined` while the machine is asleep.
+     */
+    domain: string | undefined;
+    /** Every public domain on the machine, one per port. */
+    domains: ReadonlyArray<{
+        domain: string;
+        port: number;
+        prefix: string;
+    }>;
+    /** Console / exec target id. `undefined` while unavailable. */
+    consoleTargetId: string | undefined;
+    /** RFC3339 creation timestamp. */
+    createdAt: string;
+}, never, Providers>;
+/**
+ * A Railway.CloudAgent is a persistent coding-agent VM in an
+ * environment. Sleep keeps the disk; wake re-runs the entrypoint.
+ * Cloud agents are Priority Boarding and bill at VM rates while
+ * running.
+ *
+ * @see https://docs.railway.com/cloud-agents
+ *
+ * ### Create a CloudAgent
+ * Pass the Project (or an Environment). Alchemy generates a unique
+ * name unless you pass one. `domain` is the public URL for port 8080.
+ *
+ * **Example:** Next to a Project
+ * ```typescript
+ * const site = yield* Railway.Project("Site");
+ * const agent = yield* Railway.CloudAgent("Coder", {
+ *   environment: site,
+ * });
+ * ```
+ *
+ * :::caution[Changing `environment` or `name` replaces the agent]
+ * Railway has no cloud-agent update API. A new VM is created, then
+ * the old one is deleted — the disk is not copied.
+ * :::
+ *
+ * ### A stable name
+ * Pass `name` when you need a stable agent name. Changing it later
+ * replaces the agent.
+ *
+ * **Example:** Explicit name
+ * ```typescript
+ * const agent = yield* Railway.CloudAgent("Coder", {
+ *   environment: site,
+ *   name: "reviews",
+ * });
+ * ```
+ *
+ * ### Variables
+ * `variables` are create-only. Pair them with a new agent — Railway
+ * does not update variables on an existing VM. Values may reference
+ * other services via `Railway.ref`.
+ *
+ * **Example:** Variables at create
+ * ```typescript
+ * const agent = yield* Railway.CloudAgent("Coder", {
+ *   environment: site,
+ *   variables: {
+ *     DATABASE_URL: Railway.ref(db, "DATABASE_URL"),
+ *   },
+ * });
+ * ```
+ *
+ * ### Sleep and wake
+ * Sleep stops compute billing and keeps the disk. Wake re-runs the
+ * entrypoint with files in place. These are not reconciler steps —
+ * call {@link sleepCloudAgent} / {@link wakeCloudAgent}.
+ *
+ * **Example:** Sleep then wake
+ * ```typescript
+ * yield* Railway.sleepCloudAgent(agent);
+ * yield* Railway.wakeCloudAgent(agent);
+ * ```
+ *
+ * ### Module-scope declarations
+ * Resource-valued props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope CloudAgent
+ * ```typescript
+ * // src/agent.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * export const Coder = Railway.CloudAgent("Coder", {
+ *   environment: Site,
+ * });
+ * ```
+ *
+ * @resource
+ */
+export declare const CloudAgent: import("../Resource.ts").ResourceClass<CloudAgent>;
+declare const CloudAgentNotCreated_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Railway.CloudAgentNotCreated";
+} & Readonly<A>;
+export declare class CloudAgentNotCreated extends CloudAgentNotCreated_base<{
+    name: string;
+    environmentId: string;
+}> {
+}
+declare const CloudAgentEnvironmentRequired_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Railway.CloudAgentEnvironmentRequired";
+} & Readonly<A>;
+export declare class CloudAgentEnvironmentRequired extends CloudAgentEnvironmentRequired_base<{
+    message: string;
+}> {
+}
+/**
+ * Sleep a running cloud agent. Compute billing stops; the disk is
+ * kept. Waking re-runs the entrypoint.
+ */
+export declare const sleepCloudAgent: (agent: string | {
+    readonly cloudAgentId: string;
+}) => Effect.Effect<CloudAgentSleepResponse, railway.RailwayOpError, railway.RailwayOpContext>;
+/**
+ * Wake a sleeping cloud agent. Crashed or failed agents cannot be
+ * woken — create a new one instead.
+ */
+export declare const wakeCloudAgent: (agent: string | {
+    readonly cloudAgentId: string;
+}) => Effect.Effect<CloudAgentWakeResponse, railway.RailwayOpError, railway.RailwayOpContext>;
+export declare const CloudAgentProvider: () => import("effect/Layer").Layer<Provider.Provider<CloudAgent>, never, import("./Environment.ts").RailwayEnvironment | import("../Stack.ts").Stack | import("../Stage.ts").Stage | railway.RailwayOpContext>;
+export {};
+//# sourceMappingURL=CloudAgent.d.ts.map

package/lib/Railway/CloudAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudAgent.d.ts","sourceRoot":"","sources":["../../src/Railway/CloudAgent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AAEpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,WAAW,EAAE,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACxC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAC/B,oBAAoB,EACpB,eAAe,EACf;IACE,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,wDAAwD;IACxD,OAAO,EAAE,aAAa,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,+DAA+D;IAC/D,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,KAAK,EACL,SAAS,CACV,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,eAAO,MAAM,UAAU,oDAA6C,CAAC;;;;AAErE,qBAAa,oBAAqB,SAAQ,0BAExC;IACA,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;CAAG;;;;AAEL,qBAAa,6BAA8B,SAAQ,mCAEjD;IACA,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;CAAG;AAqHL;;;GAGG;AACH,eAAO,MAAM,eAAe;2BACM,MAAM;8FAGtC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;2BACO,MAAM;6FAGtC,CAAC;AAEH,eAAO,MAAM,kBAAkB,gNA6I3B,CAAC"}

package/lib/Railway/CloudAgent.js

@@ -0,0 +1,283 @@
+import * as railway from "@distilled.cloud/railway";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+import * as Stream from "effect/Stream";
+import { Unowned } from "../AdoptPolicy.js";
+import { isResolved } from "../Diff.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+import { createRailwayName, matchesAlchemyPhysicalName, sanitizeRailwayName, } from "./Metadata.js";
+import { ownedProjects, projectEnvironmentIds } from "./Project.js";
+/**
+ * A Railway.CloudAgent is a persistent coding-agent VM in an
+ * environment. Sleep keeps the disk; wake re-runs the entrypoint.
+ * Cloud agents are Priority Boarding and bill at VM rates while
+ * running.
+ *
+ * @see https://docs.railway.com/cloud-agents
+ *
+ * ### Create a CloudAgent
+ * Pass the Project (or an Environment). Alchemy generates a unique
+ * name unless you pass one. `domain` is the public URL for port 8080.
+ *
+ * **Example:** Next to a Project
+ * ```typescript
+ * const site = yield* Railway.Project("Site");
+ * const agent = yield* Railway.CloudAgent("Coder", {
+ *   environment: site,
+ * });
+ * ```
+ *
+ * :::caution[Changing `environment` or `name` replaces the agent]
+ * Railway has no cloud-agent update API. A new VM is created, then
+ * the old one is deleted — the disk is not copied.
+ * :::
+ *
+ * ### A stable name
+ * Pass `name` when you need a stable agent name. Changing it later
+ * replaces the agent.
+ *
+ * **Example:** Explicit name
+ * ```typescript
+ * const agent = yield* Railway.CloudAgent("Coder", {
+ *   environment: site,
+ *   name: "reviews",
+ * });
+ * ```
+ *
+ * ### Variables
+ * `variables` are create-only. Pair them with a new agent — Railway
+ * does not update variables on an existing VM. Values may reference
+ * other services via `Railway.ref`.
+ *
+ * **Example:** Variables at create
+ * ```typescript
+ * const agent = yield* Railway.CloudAgent("Coder", {
+ *   environment: site,
+ *   variables: {
+ *     DATABASE_URL: Railway.ref(db, "DATABASE_URL"),
+ *   },
+ * });
+ * ```
+ *
+ * ### Sleep and wake
+ * Sleep stops compute billing and keeps the disk. Wake re-runs the
+ * entrypoint with files in place. These are not reconciler steps —
+ * call {@link sleepCloudAgent} / {@link wakeCloudAgent}.
+ *
+ * **Example:** Sleep then wake
+ * ```typescript
+ * yield* Railway.sleepCloudAgent(agent);
+ * yield* Railway.wakeCloudAgent(agent);
+ * ```
+ *
+ * ### Module-scope declarations
+ * Resource-valued props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope CloudAgent
+ * ```typescript
+ * // src/agent.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * export const Coder = Railway.CloudAgent("Coder", {
+ *   environment: Site,
+ * });
+ * ```
+ *
+ * @resource
+ */
+export const CloudAgent = Resource("Railway.CloudAgent");
+export class CloudAgentNotCreated extends Data.TaggedError("Railway.CloudAgentNotCreated") {
+}
+export class CloudAgentEnvironmentRequired extends Data.TaggedError("Railway.CloudAgentEnvironmentRequired") {
+}
+const toAttrs = (agent, fallback) => ({
+    cloudAgentId: agent.id,
+    name: agent.name || fallback?.name || "",
+    environmentId: agent.environmentId || fallback?.environmentId || "",
+    projectId: agent.projectId || fallback?.projectId || "",
+    status: agent.status,
+    domain: agent.domain ?? undefined,
+    domains: agent.domains.map((item) => ({
+        domain: item.domain,
+        port: item.port,
+        prefix: item.prefix,
+    })),
+    consoleTargetId: agent.consoleTargetId ?? undefined,
+    createdAt: agent.createdAt,
+});
+const resolveName = (id, name, existing) => Effect.gen(function* () {
+    if (name !== undefined)
+        return sanitizeRailwayName(name);
+    if (existing !== undefined)
+        return existing;
+    return yield* createRailwayName(id);
+});
+const isGone = (agent) => agent === undefined || agent.status === "DELETING";
+const environmentIdOf = (value) => {
+    if (value === null || typeof value !== "object")
+        return undefined;
+    const rec = value;
+    return typeof rec.environmentId === "string" && rec.environmentId.length > 0
+        ? rec.environmentId
+        : undefined;
+};
+const projectIdOf = (value) => {
+    if (value === null || typeof value !== "object")
+        return undefined;
+    const rec = value;
+    return typeof rec.projectId === "string" && rec.projectId.length > 0
+        ? rec.projectId
+        : undefined;
+};
+const listAgents = (environmentId) => railway
+    .cloudAgents({ environmentId, mine: true })
+    .pipe(Effect.catchTag([
+    "RailwayNotFound",
+    "NotFound",
+    "RailwayForbidden",
+    "RailwayPlanLimitExceeded",
+], () => Effect.succeed([])));
+const findById = (environmentId, id) => listAgents(environmentId).pipe(Effect.map((items) => items.find((agent) => agent.id === id)));
+const findByName = (environmentId, name) => listAgents(environmentId).pipe(Effect.map((items) => items.find((agent) => !isGone(agent) && agent.name === name)));
+const listEnvironmentIds = (project) => railway.environments.items({ projectId: project.projectId, first: 50 }).pipe(Stream.filter((env) => env.deletedAt == null), Stream.map((env) => env.id), Stream.runCollect, Effect.map((ids) => {
+    const set = new Set(Array.from(ids));
+    if (project.environmentId.length > 0) {
+        set.add(project.environmentId);
+    }
+    return Array.from(set);
+}), Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.succeed(project.environmentId.length > 0 ? [project.environmentId] : [])));
+const waitUntilGone = (environmentId, cloudAgentId) => findById(environmentId, cloudAgentId).pipe(Effect.map((agent) => isGone(agent)), Effect.repeat({
+    schedule: Schedule.spaced("1 second"),
+    until: (gone) => gone,
+    times: 8,
+}));
+const cloudAgentIdOf = (agent) => (typeof agent === "string" ? agent : agent.cloudAgentId);
+/**
+ * Sleep a running cloud agent. Compute billing stops; the disk is
+ * kept. Waking re-runs the entrypoint.
+ */
+export const sleepCloudAgent = Effect.fn(function* (agent) {
+    return yield* railway.cloudAgentSleep({ id: cloudAgentIdOf(agent) });
+});
+/**
+ * Wake a sleeping cloud agent. Crashed or failed agents cannot be
+ * woken — create a new one instead.
+ */
+export const wakeCloudAgent = Effect.fn(function* (agent) {
+    return yield* railway.cloudAgentWake({ id: cloudAgentIdOf(agent) });
+});
+export const CloudAgentProvider = () => Provider.succeed(CloudAgent, {
+    stables: ["cloudAgentId", "environmentId", "projectId", "createdAt"],
+    nuke: { dependsOn: ["Railway.Project"] },
+    diff: Effect.fn(function* ({ news, output }) {
+        if (news === undefined || !isResolved(news))
+            return undefined;
+        if (output === undefined)
+            return undefined;
+        const nextEnvironmentId = environmentIdOf(news.environment);
+        const environmentChanged = nextEnvironmentId !== undefined &&
+            nextEnvironmentId !== output.environmentId;
+        const nameChanged = news.name !== undefined &&
+            sanitizeRailwayName(news.name) !== output.name;
+        if (environmentChanged || nameChanged) {
+            return { action: "replace" };
+        }
+        return undefined;
+    }),
+    read: Effect.fn(function* ({ id, olds, output }) {
+        const name = yield* resolveName(id, olds?.name, output?.name);
+        const environmentId = output?.environmentId ??
+            (olds !== undefined ? environmentIdOf(olds.environment) : undefined);
+        if (environmentId === undefined)
+            return undefined;
+        const found = (output?.cloudAgentId !== undefined
+            ? yield* findById(environmentId, output.cloudAgentId)
+            : undefined) ?? (yield* findByName(environmentId, name));
+        if (found === undefined || isGone(found))
+            return undefined;
+        const attrs = toAttrs(found, {
+            name,
+            environmentId,
+            projectId: output?.projectId ??
+                (olds !== undefined ? projectIdOf(olds.environment) : undefined),
+        });
+        if (output !== undefined)
+            return attrs;
+        return matchesAlchemyPhysicalName(found.name) ? attrs : Unowned(attrs);
+    }),
+    list: Effect.fn(function* () {
+        const projects = yield* ownedProjects();
+        const rows = yield* Effect.forEach(projects, (project) => Effect.gen(function* () {
+            const envIds = yield* projectEnvironmentIds(project);
+            const nested = yield* Effect.forEach(envIds, (environmentId) => listAgents(environmentId).pipe(Effect.map((agents) => agents
+                .filter((agent) => !isGone(agent) && matchesAlchemyPhysicalName(agent.name))
+                .map((agent) => toAttrs(agent, {
+                environmentId,
+                projectId: project.projectId,
+            })))));
+            return nested.flat();
+        }));
+        const seen = new Set();
+        const unique = [];
+        for (const row of rows.flat()) {
+            if (seen.has(row.cloudAgentId))
+                continue;
+            seen.add(row.cloudAgentId);
+            unique.push(row);
+        }
+        return unique;
+    }),
+    reconcile: Effect.fn(function* ({ id, news, output }) {
+        const props = news ?? {};
+        const environmentId = environmentIdOf(props.environment) ?? output?.environmentId;
+        if (environmentId === undefined) {
+            return yield* new CloudAgentEnvironmentRequired({
+                message: "CloudAgent requires a resolved Railway.Project or Railway.Environment",
+            });
+        }
+        const name = yield* resolveName(id, props.name, output?.name);
+        const projectId = projectIdOf(props.environment) ?? output?.projectId ?? "";
+        let current = output?.cloudAgentId !== undefined
+            ? yield* findById(environmentId, output.cloudAgentId)
+            : undefined;
+        if (current === undefined || isGone(current)) {
+            current = yield* findByName(environmentId, name);
+        }
+        if (current === undefined || isGone(current)) {
+            const created = yield* railway
+                .cloudAgentCreate({
+                input: {
+                    environmentId,
+                    name,
+                    ...(props.variables !== undefined
+                        ? { variables: props.variables }
+                        : {}),
+                },
+            })
+                .pipe(Effect.catchTag("RailwayValidationError", () => Effect.succeed(undefined)));
+            current =
+                created !== undefined && !isGone(created)
+                    ? created
+                    : yield* findByName(environmentId, name);
+        }
+        if (current === undefined || isGone(current)) {
+            return yield* new CloudAgentNotCreated({ name, environmentId });
+        }
+        return toAttrs(current, { name, environmentId, projectId });
+    }),
+    delete: Effect.fn(function* ({ output }) {
+        const cloudAgentId = output.cloudAgentId;
+        if (cloudAgentId.length === 0)
+            return;
+        yield* railway
+            .cloudAgentDelete({ id: cloudAgentId })
+            .pipe(Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.void));
+        if (output.environmentId.length > 0) {
+            yield* waitUntilGone(output.environmentId, cloudAgentId);
+        }
+    }),
+});
+//# sourceMappingURL=CloudAgent.js.map

package/lib/Railway/CloudAgent.js.map

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

package/lib/Railway/ConnectMongo.d.ts

@@ -0,0 +1,73 @@
+import type * as Effect from "effect/Effect";
+import type * as Redacted from "effect/Redacted";
+import * as Binding from "../Binding.ts";
+import type { RuntimeContext } from "../RuntimeContext.ts";
+import type { Mongo } from "./Mongo.ts";
+/**
+ * Bind a {@link Mongo} service to a Railway {@link Service} and obtain
+ * the Effect-native connection string for the MongoDB driver.
+ *
+ * `ConnectMongo` is the Context tag, the type, and the callable —
+ * `yield* Railway.ConnectMongo(Db)`. Provide {@link ConnectMongoHttp}.
+ *
+ * **Example:** Bind Mongo in a Service
+ * ```typescript
+ * import * as Redacted from "effect/Redacted";
+ *
+ * const conn = yield* Railway.ConnectMongo(Db);
+ *
+ * fetch: Effect.gen(function* () {
+ *   const url = yield* conn.connectionString;
+ *   const ping = yield* Railway.pingMongo(Redacted.value(url));
+ * });
+ * ```
+ *
+ * ### Variable references
+ * `ConnectMongo` packs a typed private URI onto the Service. To store
+ * Railway's template instead of a resolved URI (IaC `db.env.MONGO_URL`),
+ * pass `Railway.ref(Db, "MONGO_URL")` as a {@link Variable} `value` or
+ * `Service.env` entry.
+ *
+ * **Example:** Railway.ref
+ * ```typescript
+ * const db = yield* Railway.mongo("Db", { project: site });
+ * yield* Railway.Variable("MongoUrl", {
+ *   project: site,
+ *   service: api,
+ *   name: "MONGO_URL",
+ *   value: Railway.ref(db, "MONGO_URL"),
+ * });
+ * ```
+ *
+ * @binding
+ * @product Railway
+ * @category Storage & Databases
+ */
+export interface ConnectMongo extends Binding.Service<ConnectMongo, "Railway.ConnectMongo", (mongo: Mongo) => Effect.Effect<ConnectMongoClient>> {
+}
+export declare const ConnectMongo: ConnectMongo;
+export declare const connectEnvKeys: (mongo: Pick<Mongo, "LogicalId">) => {
+    pooled: string;
+    direct: string;
+};
+declare const MongoUrlMissing_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Railway.MongoUrlMissing";
+} & Readonly<A>;
+export declare class MongoUrlMissing extends MongoUrlMissing_base<{
+    name: string;
+}> {
+}
+export interface ConnectMongoClient {
+    /**
+     * Private (`{name}.railway.internal`) connection string. Pass this to
+     * the MongoDB driver from a {@link Service}.
+     */
+    connectionString: Effect.Effect<Redacted.Redacted<string>, MongoUrlMissing, RuntimeContext>;
+    /**
+     * Same private URI. Kept so callers matching the Postgres
+     * `ConnectPostgres` shape keep working.
+     */
+    directConnectionString: Effect.Effect<Redacted.Redacted<string>, MongoUrlMissing, RuntimeContext>;
+}
+export {};
+//# sourceMappingURL=ConnectMongo.d.ts.map

package/lib/Railway/ConnectMongo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectMongo.d.ts","sourceRoot":"","sources":["../../src/Railway/ConnectMongo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,OAAO,CACnD,YAAY,EACZ,sBAAsB,EACtB,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CACpD;CAAG;AAEJ,eAAO,MAAM,YAAY,cAExB,CAAC;AAEF,eAAO,MAAM,cAAc,UAAW,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC;IAG1D,MAAM;IACN,MAAM;CAET,CAAC;;;;AAEF,qBAAa,eAAgB,SAAQ,qBAEnC;IACA,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;CAAG;AAEL,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAC7B,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EACzB,eAAe,EACf,cAAc,CACf,CAAC;IACF;;;OAGG;IACH,sBAAsB,EAAE,MAAM,CAAC,MAAM,CACnC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EACzB,eAAe,EACf,cAAc,CACf,CAAC;CACH"}

package/lib/Railway/ConnectMongo.js

@@ -0,0 +1,13 @@
+import * as Data from "effect/Data";
+import * as Binding from "../Binding.js";
+export const ConnectMongo = Binding.Service("Railway.ConnectMongo");
+export const connectEnvKeys = (mongo) => {
+    const id = mongo.LogicalId.replaceAll(/[^a-zA-Z0-9]/g, "_").toUpperCase();
+    return {
+        pooled: `RAILWAY_MONGO_${id}_POOLED`,
+        direct: `RAILWAY_MONGO_${id}_DIRECT`,
+    };
+};
+export class MongoUrlMissing extends Data.TaggedError("Railway.MongoUrlMissing") {
+}
+//# sourceMappingURL=ConnectMongo.js.map