@moinulmoin/eden 0.1.4 → 0.1.5

package/README.md

@@ -17,15 +17,15 @@ create a new Eden-native agent, start with `eden agent init`.
 Use any one of these package managers:
 
 ```sh
-npm install --global @moinulmoin/eden@0.1.4
+npm install --global @moinulmoin/eden@0.1.5
 ```
 
 ```sh
-pnpm add --global @moinulmoin/eden@0.1.4
+pnpm add --global @moinulmoin/eden@0.1.5
 ```
 
 ```sh
-bun add --global @moinulmoin/eden@0.1.4
+bun add --global @moinulmoin/eden@0.1.5
 ```
 
 Then confirm the CLI is available:

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,6 +190,7 @@ 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;
     /**

package/dist/eve-control-plane.js

@@ -9,7 +9,7 @@ import { fileURLToPath, } from "node:url";
 import { promisify, } from "node:util";
 import { EveCliError, } from "./eve.js";
 import { buildEveProjectSnapshot, createDockerEveProjectBuilder, revalidateEveProjectCandidateInputs, EvePackagingError, } from "./eve-packaging.js";
-import { buildEveRuntimeImage, revalidateEveRuntimeCandidate, validateEveHostRequirements, } from "./eve-runtime-image.js";
+import { buildEveRuntimeImage, discardEveRuntimeImage, revalidateEveRuntimeCandidate, validateEveHostRequirements, } from "./eve-runtime-image.js";
 import { EveRuntimeConfigError, prepareEveRuntimeInjection, redactEveRuntimeOutput, } from "./eve-runtime-config.js";
 const execFileAsync = promisify(execFile);
 const require = createRequire(import.meta.url);
@@ -1341,9 +1341,35 @@ async function runEveDeployment(request, options, collected) {
     });
     await promoteEveTargetPointer(join(request.projectRoot, ".eden", "eve-deploy"), targetKey, candidate.generationRoot);
     await options.afterPromotion?.();
+    let runtimeImageCleanup;
+    if (runtimeEvidence.cleanup.imageRetained) {
+        if (options.retainRuntimeImage === true) {
+            runtimeImageCleanup = check("VAL-CROSS-004", "skipped", "The exact local runtime image was intentionally retained by the programmatic caller.");
+        }
+        else {
+            let discarded = false;
+            try {
+                discarded = await (options.discardRuntimeImage ??
+                    discardEveRuntimeImage)({
+                    imageId: imageDigest,
+                    generationId: candidate.generationId,
+                    generationRoot: candidate.generationRoot,
+                });
+            }
+            catch {
+                discarded = false;
+            }
+            runtimeImageCleanup = discarded
+                ? check("VAL-CROSS-004", "passed", "The exact local runtime image and its publication tags were removed after the healthy deployment was promoted.")
+                : check("VAL-CROSS-004", "failed", "The remote deployment is healthy, but exact local runtime-image cleanup could not be verified.", `Remove only the recorded image ${imageDigest}; do not retry or run broad Docker cleanup.`);
+        }
+    }
     return {
         ...collected.result,
-        ok: true,
+        ok: runtimeImageCleanup?.status !== "failed",
+        ...(runtimeImageCleanup === undefined
+            ? {}
+            : { checks: [...collected.result.checks, runtimeImageCleanup] }),
         deployment: deploymentMetadata(identity, targetKey, "deployed"),
     };
 }
@@ -1696,10 +1722,14 @@ export async function runEveControlPlane(request, options = {}) {
                 throw new EveCliError({
                     code: status === "indeterminate"
                         ? "DEPLOY_INDETERMINATE"
-                        : "EVE_DEPLOYMENT_FAILED",
+                        : status === "deployed"
+                            ? "EVE_RUNTIME_IMAGE_CLEANUP_FAILED"
+                            : "EVE_DEPLOYMENT_FAILED",
                     message: status === "indeterminate"
                         ? "The Eve deployment outcome is indeterminate; inspect the retained exact ownership evidence before retrying."
-                        : "The Eve deployment failed before exact target promotion.",
+                        : status === "deployed"
+                            ? "The Eve deployment is healthy and promoted, but exact local runtime-image cleanup failed; do not retry the deployment."
+                            : "The Eve deployment failed before exact target promotion.",
                 });
             }
         }

package/dist/eve-runtime-image.d.ts

@@ -92,6 +92,12 @@ export interface EveRuntimeImageRequest {
      */
     readonly retainImage?: boolean;
 }
+export interface EveRuntimeImageDiscardRequest {
+    readonly imageId: string;
+    readonly generationId: string;
+    readonly generationRoot: string;
+    readonly dockerCommand?: string;
+}
 export interface EveRuntimeImageResult {
     readonly schemaVersion: 1;
     readonly worker: "eve-packaging-worker";
@@ -116,6 +122,7 @@ export interface EveRuntimeImageResult {
 }
 export declare function validateEveHostRequirements(requirements: EveHostRequirements): void;
 export declare function revalidateEveRuntimeCandidate(candidate: EveProjectBuildCandidate): Promise<EveRuntimeClosure>;
+export declare function discardEveRuntimeImage(request: EveRuntimeImageDiscardRequest): Promise<boolean>;
 export declare function buildEveRuntimeImage(request: EveRuntimeImageRequest): Promise<EveRuntimeImageResult>;
 export {};
 //# sourceMappingURL=eve-runtime-image.d.ts.map

package/dist/eve-runtime-image.js

@@ -743,6 +743,46 @@ async function removeOwnedImage(state) {
     }
     return verified;
 }
+export async function discardEveRuntimeImage(request) {
+    if (!IMAGE_ID_PATTERN.test(request.imageId) ||
+        !/^[a-z0-9][a-z0-9._-]{0,127}$/u.test(request.generationId)) {
+        return false;
+    }
+    const state = {
+        command: request.dockerCommand ?? "docker",
+        env: safeDockerEnvironment(),
+        generationRoot: request.generationRoot,
+        imageIdPath: join(request.generationRoot, "runtime-image-id"),
+        imageLabel: `eden.eve.generation=${request.generationId}`,
+        imageBuilt: true,
+        imageId: request.imageId,
+        containerId: undefined,
+        imageRetained: true,
+    };
+    let inspected;
+    try {
+        inspected = await docker(state, [
+            "image",
+            "inspect",
+            request.imageId,
+            "--format",
+            "{{.Id}} {{index .Config.Labels \"eden.eve.generation\"}}",
+        ]);
+    }
+    catch (error) {
+        const stderr = typeof error === "object" &&
+            error !== null &&
+            "stderr" in error &&
+            typeof error.stderr === "string"
+            ? error.stderr
+            : "";
+        return /(?:no such|not found|does not exist)/iu.test(stderr);
+    }
+    if (inspected.stdout.trim() !== `${request.imageId} ${request.generationId}`) {
+        return false;
+    }
+    return removeOwnedImage(state);
+}
 function healthReady(value) {
     if (value === "ready")
         return true;

package/dist/index.d.ts

@@ -6,12 +6,12 @@ export { EVE_CLI_COMMANDS, EVE_USAGE, EveCliError, eveHelpText, parseEveArgument
 export { EvePackagingError, buildEveProjectSnapshot, createDockerEveProjectBuilder, revalidateEveProjectCandidateInputs, } from "./eve-packaging.js";
 export { EVE_RESERVED_HOST_VARIABLES, EVE_START_COMMAND, EveRuntimeConfig, EveRuntimeConfigError, loadEveRuntimeConfig, parseEveRuntimeConfig, prepareEveRuntimeInjection, readEveRuntimeConfig, redactEveRuntimeOutput, } from "./eve-runtime-config.js";
 export type { EveReservedHostVariable, EveRuntimeConfigErrorCode, EveRuntimeInjection, EveRuntimeInjectionMode, EveRuntimeInjectionOptions, EveRuntimeInputIdentity, EveRuntimeProtectedPutRequest, EveRuntimeProtectedPutResult, EveRuntimeProtectedStore, EveStartProcessRequest, RedactedRuntimeConfigSeam, } from "./eve-runtime-config.js";
-export { buildEveRuntimeImage, revalidateEveRuntimeCandidate, validateEveHostRequirements, } from "./eve-runtime-image.js";
+export { buildEveRuntimeImage, discardEveRuntimeImage, revalidateEveRuntimeCandidate, validateEveHostRequirements, } from "./eve-runtime-image.js";
 export type { EveCliCommand, EveCliEnvironment, EveCliExecutionRequest, EveCliHelp, EveCliInvocation, EveCliRunner, ParsedEveInvocation, } from "./eve.js";
 export type { EveNodeImage, EvePackagingCheck, EvePackagingCode, EveProjectBuilder, EveProjectBuilderRequest, EveProjectBuilderResult, EveProjectBuildCandidate, EveProjectFile, EveProjectImage, EveProjectInputManifest, EveProjectOutput, EveProjectPackagingResult, EveProjectRuntime, EveProjectSnapshot, EveProjectSnapshotOptions, EveProjectToolchain, EveRuntimeConfigExclusion, } from "./eve-packaging.js";
-export type { EveHostRequirements, EveRuntimeClosure, EveRuntimeClosureFile, EveRuntimeCleanup, EveRuntimeImage, EveRuntimeImageMetadata, EveRuntimeImageRequest, EveRuntimeImageResult, EveRuntimeNativeModule, EveRuntimeStatus, } from "./eve-runtime-image.js";
+export type { EveHostRequirements, EveRuntimeClosure, EveRuntimeClosureFile, EveRuntimeCleanup, EveRuntimeImage, EveRuntimeImageDiscardRequest, EveRuntimeImageMetadata, EveRuntimeImageRequest, EveRuntimeImageResult, EveRuntimeNativeModule, EveRuntimeStatus, } from "./eve-runtime-image.js";
 export { DEFAULT_EVE_HOST_REQUIREMENTS, DEFAULT_EVE_NODE_IMAGE, runEveControlPlane, runEveDestroy, } from "./eve-control-plane.js";
-export type { EveCloudflareReadRequest, EveCloudflareReadResult, EveCloudflareReadRunner, EveCloudflareTargetState, EveContainerDeleteRunner, EveDeploymentCompensationRequest, EveDeploymentCompensationRunner, EveDeploymentHealthRequest, EveDeploymentHealthResult, EveDeploymentHealthRunner, EveDeploymentIdentity, EveDeploymentIdentityProof, EveDeploymentMetadata, EveDeploymentPublicationRequest, EveDeploymentPublicationResult, EveDeploymentPublicationRunner, EveDeploymentStatus, EveDestroyCloudflareReadRequest, EveDestroyCloudflareReadRunner, EveDestroyOutcome, EveDestroyTargetRead, EveImagePublicationRequest, EveImagePublicationResult, EveImagePublicationRunner, EvePreflightCandidate, EvePreflightCheck, EvePreflightCheckStatus, EvePreflightOptions, EvePreflightResult, EvePreflightRuntimeEvidence, EvePreflightRuntimeRunner, EvePreflightRuntimeRunnerRequest, EveRuntimeConfigLoader, EveWorkerDeleteRunner, } from "./eve-control-plane.js";
+export type { EveCloudflareReadRequest, EveCloudflareReadResult, EveCloudflareReadRunner, EveCloudflareTargetState, EveContainerDeleteRunner, EveDeploymentCompensationRequest, EveDeploymentCompensationRunner, EveDeploymentHealthRequest, EveDeploymentHealthResult, EveDeploymentHealthRunner, EveDeploymentIdentity, EveDeploymentIdentityProof, EveDeploymentMetadata, EveDeploymentPublicationRequest, EveDeploymentPublicationResult, EveDeploymentPublicationRunner, EveDeploymentStatus, EveDestroyCloudflareReadRequest, EveDestroyCloudflareReadRunner, EveDestroyOutcome, EveDestroyTargetRead, EveImagePublicationRequest, EveImagePublicationResult, EveImagePublicationRunner, EvePreflightCandidate, EvePreflightCheck, EvePreflightCheckStatus, EvePreflightOptions, EvePreflightResult, EvePreflightRuntimeEvidence, EvePreflightRuntimeRunner, EvePreflightRuntimeRunnerRequest, EveRuntimeConfigLoader, EveRuntimeImageDiscardRunner, EveWorkerDeleteRunner, } from "./eve-control-plane.js";
 export declare const EDEN_CLI_COMMANDS: readonly ["preflight", "deploy", "destroy", "agent"];
 export type EdenCliCommand = (typeof EDEN_CLI_COMMANDS)[number];
 export declare const EDEN_AGENT_COMMANDS: readonly ["init", "dev", "build", "deploy"];

package/dist/index.js

@@ -16,7 +16,7 @@ import { DEFAULT_EVE_HOST_REQUIREMENTS, runEveControlPlane, runEveDestroy, } fro
 export { EVE_CLI_COMMANDS, EVE_USAGE, EveCliError, eveHelpText, parseEveArguments, } from "./eve.js";
 export { EvePackagingError, buildEveProjectSnapshot, createDockerEveProjectBuilder, revalidateEveProjectCandidateInputs, } from "./eve-packaging.js";
 export { EVE_RESERVED_HOST_VARIABLES, EVE_START_COMMAND, EveRuntimeConfig, EveRuntimeConfigError, loadEveRuntimeConfig, parseEveRuntimeConfig, prepareEveRuntimeInjection, readEveRuntimeConfig, redactEveRuntimeOutput, } from "./eve-runtime-config.js";
-export { buildEveRuntimeImage, revalidateEveRuntimeCandidate, validateEveHostRequirements, } from "./eve-runtime-image.js";
+export { buildEveRuntimeImage, discardEveRuntimeImage, revalidateEveRuntimeCandidate, validateEveHostRequirements, } from "./eve-runtime-image.js";
 export { DEFAULT_EVE_HOST_REQUIREMENTS, DEFAULT_EVE_NODE_IMAGE, runEveControlPlane, runEveDestroy, } from "./eve-control-plane.js";
 const require = createRequire(import.meta.url);
 export const EDEN_CLI_COMMANDS = [
@@ -128,8 +128,8 @@ export default greet;
     "deploy": "eden agent deploy"
   },
   "devDependencies": {
-    "@moinulmoin/eden": "0.1.4",
-    "@moinulmoin/eden-definitions": "0.1.4",
+    "@moinulmoin/eden": "0.1.5",
+    "@moinulmoin/eden-definitions": "0.1.5",
     "typescript": "5.9.3",
     "wrangler": "4.120.0"
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moinulmoin/eden",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Deploy existing Eve agents to Cloudflare and author Cloudflare-native Eden Agents.",
   "keywords": [
     "ai",
@@ -31,8 +31,8 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@moinulmoin/eden-compiler": "0.1.4",
-    "@moinulmoin/eden-runtime-cloudflare": "0.1.4",
+    "@moinulmoin/eden-compiler": "0.1.5",
+    "@moinulmoin/eden-runtime-cloudflare": "0.1.5",
     "chokidar": "5.0.0",
     "wrangler": "4.120.0"
   },