@moinulmoin/eden 0.1.4 → 0.2.0

package/NOTICE

@@ -1,24 +1,6 @@
-eve
-Copyright 2026 Vercel, Inc. and contributors
-
-This product includes software developed at Vercel, Inc.
-(https://vercel.com/).
-
 Eden
 Copyright 2026 Eden contributors
 
-This repository contains Eden-owned modified derivative implementations
-informed by portable concepts from the Eve framework:
-
-  Eve, version 0.31.3
-  https://github.com/vercel/eve
-  reference commit: 0b102bc90e7cf2c3e294f6ca3af86c307d449b1a
-
-Eve is distributed under the Apache License, Version 2.0. The applicable
-Apache-2.0 terms are included in LICENSE. This notice is retained for the
-Eve attribution obligation; it does not grant ownership of Eden's original
-implementation.
-
 Cloudflare Containers
   @cloudflare/containers, version 0.3.7
   https://github.com/cloudflare/containers
@@ -27,16 +9,3 @@ Eden's generated Worker host bundle includes software from
 `@cloudflare/containers`, distributed under MIT OR Apache-2.0. Eden
 redistributes that bundled software under the Apache-2.0 option included in
 LICENSE.
-
-The following Eden source files are marked in-file as modified derivatives of
-portable Eve concepts:
-
-  packages/definitions/src/index.ts
-  packages/compiler/src/index.ts
-  packages/client/src/protocol.ts
-  packages/runtime-cloudflare/src/session-journal.ts
-  packages/runtime-cloudflare/src/model-normalizers.ts
-
-Eden does not include unmodified Eve source. The listed files are Eden-owned
-modifications and must retain their in-file modified-derivative notices when
-redistributed.

package/README.md

@@ -1,31 +1,26 @@
 # Eden
 
-Eden is a CLI for running AI agents on Cloudflare.
+Eden deploys an existing [Vercel Eve](https://github.com/vercel/eve) project to
+your own Cloudflare account through one CLI.
 
-It has two deliberately separate workflows:
+![eden deploy: an Eve project live on workers.dev, a real model reply, then eden destroy](https://raw.githubusercontent.com/moinulmoin/eden/main/docs/assets/eden-deploy.gif)
 
-- **Eden Deploy** hosts an existing [Vercel Eve](https://github.com/vercel/eve)
-  project on Cloudflare without rewriting the project or replacing Eve.
-- **Eden Agent** creates and runs a smaller Cloudflare-native durable agent from
-  an `agent/` directory.
-
-If you already have an Eve project, start with `eden deploy`. If you want to
-create a new Eden-native agent, start with `eden agent init`.
+If you already have an Eve project, start with `eden deploy`.
 
 ## Install
 
 Use any one of these package managers:
 
 ```sh
-npm install --global @moinulmoin/eden@0.1.4
+npm install --global @moinulmoin/eden@0.2.0
 ```
 
 ```sh
-pnpm add --global @moinulmoin/eden@0.1.4
+pnpm add --global @moinulmoin/eden@0.2.0
 ```
 
 ```sh
-bun add --global @moinulmoin/eden@0.1.4
+bun add --global @moinulmoin/eden@0.2.0
 ```
 
 Then confirm the CLI is available:
@@ -38,19 +33,15 @@ Bun can install Eden, but Eden still runs on Node. Do not use `bunx --bun`.
 
 ## Requirements
 
-For every workflow:
-
 - macOS or Linux
 - Node `>=24.17.0`
-- a Cloudflare account
+- a Cloudflare account on the Workers Paid plan (required for Containers)
 - Wrangler authentication:
 
   ```sh
   npx wrangler@4.120.0 login
   ```
 
-For **Eden Deploy**, also provide:
-
 - Docker or OrbStack with Linux/amd64 container support
 - an existing Eve project with an exact `packageManager: "pnpm@..."` entry
 - the matching root `pnpm-lock.yaml`
@@ -60,15 +51,23 @@ For **Eden Deploy**, also provide:
 Eden Deploy supports pinned pnpm Eve projects in this release. Bun lockfiles and
 native Windows are not currently supported.
 
-For **Eden Agent**, Corepack must be available. The setup below enables the
-generated project's pinned pnpm `11.21.0` version once.
-
 ## Deploy an existing Eve project
 
-Deploy is the primary workflow. It performs its checks inline, installs the
-project's pinned pnpm lockfile, runs its project-local Eve executable, packages
-the real Eve server into one Cloudflare Container, and publishes one Worker in
-front of it.
+From inside the Eve project:
+
+```sh
+npx @moinulmoin/eden deploy
+```
+
+With no flags, `deploy` uses the current directory, the `preview`
+environment, and a target name derived deterministically from the project's
+`package.json` name. Deploy performs its checks inline, installs the
+project's pinned pnpm lockfile, runs its project-local Eve executable,
+packages the real Eve server into one Cloudflare Container, and publishes one
+Worker in front of it.
+
+Explicit selectors still work, and `--name` is required for `--env
+production` and `destroy`:
 
 ```sh
 eden deploy \
@@ -77,8 +76,10 @@ eden deploy \
   --name my-eve-preview
 ```
 
-A successful command prints the deployed generation and its `workers.dev` URL.
-Eden does not change the source directory.
+A successful command prints progress lines followed by a summary with the
+target, the Eve version, and its `workers.dev` URL on its own line. Eden does not
+change the source directory. All three commands accept `--json` for the
+machine-readable result object, for scripts and CI.
 
 If the Eve project needs runtime values, put them in a regular owner-readable
 environment file outside source control:
@@ -104,81 +105,12 @@ eden preflight \
 Remove exactly that deployment when finished:
 
 ```sh
-eden destroy \
-  --project ./my-eve-app \
-  --env preview \
-  --name my-eve-preview
-```
-
-Destroy verifies Eden's ownership record and the current remote identity before
-removing anything. It never deletes by prefix or broad account search.
-
-## Create an Eden Agent
-
-Create a project in an empty directory:
-
-```sh
-mkdir my-agent
-eden agent init --project ./my-agent
-cd my-agent
-corepack enable
-pnpm install
-```
-
-The generated project contains:
-
-```text
-agent/
-├── agent.ts
-├── instructions.md
-└── tools/
-    └── greet.ts
-```
-
-Build the static Worker generation:
-
-```sh
-pnpm run build
-```
-
-Start it locally with an explicit bearer secret:
-
-```sh
-export EDEN_BEARER_SECRET="$(node -e 'process.stdout.write(require("node:crypto").randomBytes(24).toString("hex"))')"
-pnpm run dev
-```
-
-The local endpoints are:
-
-- Worker: `http://127.0.0.1:8797`
-- Wrangler inspector: `http://127.0.0.1:9297`
-
-Leave this terminal running until Eden prints its ready message. Press `Ctrl-C`
-to stop local development before continuing to deployment; the bearer value
-remains in the current shell.
-
-Deploy the Agent to an explicit preview target:
-
-```sh
-pnpm run deploy \
-  --env preview \
-  --name my-agent-preview
-```
-
-After testing, remove the exact preview Worker and its secret:
-
-```sh
-pnpm exec wrangler secret delete EDEN_BEARER_SECRET \
-  --name my-agent-preview \
-  --config "$PWD/wrangler.jsonc"
-pnpm exec wrangler delete my-agent-preview \
-  --env preview \
-  --config "$PWD/wrangler.jsonc" \
-  --force
-unset EDEN_BEARER_SECRET
+eden destroy --name my-eve-preview
 ```
 
-Run these commands only for the explicit preview name you just created.
+Destroy always requires an explicit `--name`. It verifies Eden's ownership
+record and the current remote identity before removing anything. It never
+deletes by prefix or broad account search.
 
 ## Command map
 
@@ -187,22 +119,19 @@ Run these commands only for the explicit preview name you just created.
 | `eden preflight` | Build and inspect an Eve candidate without remote mutation |
 | `eden deploy` | Deploy an existing Eve project to one exact target |
 | `eden destroy` | Remove one exact Eden-owned Eve deployment |
-| `eden agent init` | Create an Eden Agent project |
-| `eden agent build` | Compile an Agent generation |
-| `eden agent dev` | Run the Agent locally |
-| `eden agent deploy` | Deploy the Agent runtime |
 
 Run `eden <command> --help` for command-specific options.
 
 ## What Eden does not do
 
-- Deploy does not translate Eve into an Eden Agent.
 - Deploy does not replace the Eve project's providers, databases, Workflow
   World, authentication, schedules, channels, or sandbox.
-- Container-local memory and disk are disposable. Production Eve durability
-  requires a project-configured durable Workflow World.
-- This release uses one logical Container instance and does not promise
-  horizontal scaling or custom domains.
+- Container disk and memory are wiped when the Container sleeps. Durable
+  state needs a project-configured, Cloudflare-reachable Workflow World such
+  as Postgres (for example `@workflow/world-postgres`).
+- Schedules do not fire while the Container sleeps.
+- This release uses one logical Container instance (`basic`, 1 GiB) and does
+  not promise horizontal scaling or custom domains.
 - Bun is an installer only; Node remains the runtime.
 
 ## Documentation
@@ -210,7 +139,6 @@ Run `eden <command> --help` for command-specific options.
 - [Documentation index](https://github.com/moinulmoin/eden/blob/main/docs/README.md)
 - [Installation](https://github.com/moinulmoin/eden/blob/main/docs/install.md)
 - [Deploying Eve projects](https://github.com/moinulmoin/eden/blob/main/docs/deploy.md)
-- [Eden Agent CLI](https://github.com/moinulmoin/eden/blob/main/docs/agent-cli.md)
 - [Validation and cleanup](https://github.com/moinulmoin/eden/blob/main/docs/validation.md)
 
 ## License

package/dist/eve-control-plane.d.ts

@@ -1,6 +1,6 @@
 import { type EveCliEnvironment, type EveCliExecutionRequest } from "./eve.js";
 import { type EveNodeImage, type EveProjectBuildCandidate, type EveProjectBuilder } from "./eve-packaging.js";
-import { type EveHostRequirements, type EveRuntimeCleanup } from "./eve-runtime-image.js";
+import { type EveHostRequirements, type EveRuntimeCleanup, type EveRuntimeImageDiscardRequest } from "./eve-runtime-image.js";
 import { type EveRuntimeConfig, type EveRuntimeInjection, type EveRuntimeProtectedStore } from "./eve-runtime-config.js";
 import type { EveHostConfig } from "@moinulmoin/eden-runtime-cloudflare";
 export declare const DEFAULT_EVE_HOST_REQUIREMENTS: EveHostRequirements;
@@ -79,6 +79,7 @@ export interface EvePreflightRuntimeRunnerRequest {
     readonly retainImage?: boolean;
 }
 export type EvePreflightRuntimeRunner = (request: EvePreflightRuntimeRunnerRequest) => EvePreflightRuntimeEvidence | Promise<EvePreflightRuntimeEvidence>;
+export type EveRuntimeImageDiscardRunner = (request: EveRuntimeImageDiscardRequest) => boolean | Promise<boolean>;
 export interface EveDeploymentIdentity {
     readonly projectId: string;
     readonly sourceDigest: string;
@@ -189,8 +190,15 @@ export interface EvePreflightOptions {
     readonly compensate?: EveDeploymentCompensationRunner;
     readonly health?: EveDeploymentHealthRunner;
     readonly afterPromotion?: () => void | Promise<void>;
+    readonly discardRuntimeImage?: EveRuntimeImageDiscardRunner;
     readonly retainRuntimeImage?: boolean;
     readonly stdout?: (line: string) => void;
+    /**
+     * "human" prints short progress lines and a summary; "json" prints only the
+     * machine-readable result object. Programmatic callers default to "json";
+     * the CLI passes "human" unless --json was supplied.
+     */
+    readonly outputFormat?: "human" | "json";
     /**
      * Destroy seams. Defaults use only Wrangler reads/deletes plus the
      * immutable local deployment record; tests may inject exact fakes.
@@ -198,11 +206,19 @@ export interface EvePreflightOptions {
     readonly destroyCloudflareRead?: EveDestroyCloudflareReadRunner;
     readonly deleteWorker?: EveWorkerDeleteRunner;
     readonly deleteContainer?: EveContainerDeleteRunner;
+    readonly deleteRegistryImage?: EveRegistryImageDeleteRunner;
 }
 export interface EveDestroyTargetRead {
     readonly workerExists: boolean;
     readonly containerApplicationId?: string;
     readonly accountId?: string;
+    /**
+     * Subset of the request's owned registry image tags (`repository:tag`)
+     * still present in the managed registry. `undefined` means the reader
+     * could not enumerate the registry; destroy then relies on the exact
+     * delete outcomes only.
+     */
+    readonly registryImagesPresent?: readonly string[];
 }
 export type EveDestroyCloudflareReadRunner = (request: EveDestroyCloudflareReadRequest) => EveDestroyTargetRead | Promise<EveDestroyTargetRead>;
 export type EveWorkerDeleteRunner = (request: {
@@ -211,10 +227,15 @@ export type EveWorkerDeleteRunner = (request: {
 export type EveContainerDeleteRunner = (request: {
     readonly applicationId: string;
 }) => "deleted" | "absent" | "indeterminate" | Promise<"deleted" | "absent" | "indeterminate">;
+export type EveRegistryImageDeleteRunner = (request: {
+    readonly image: string;
+}) => "deleted" | "absent" | "indeterminate" | Promise<"deleted" | "absent" | "indeterminate">;
 export type EveRuntimeConfigLoader = (path: string, cwd: string) => EveRuntimeConfig | Promise<EveRuntimeConfig>;
 export interface EveDestroyCloudflareReadRequest {
     readonly workerName: string;
     readonly containerApplicationName: string;
+    /** Exact `repository:tag` image refs recorded for this target. */
+    readonly registryImages?: readonly string[];
 }
 export declare function runEveControlPlane(request: EveCliExecutionRequest, options?: EvePreflightOptions): Promise<void>;
 export interface EveDestroyOutcome {