@vm0/cli 4.29.0 → 4.30.0

package/index.js

@@ -2759,7 +2759,7 @@ var $ZodBase64 = /* @__PURE__ */ $constructor("$ZodBase64", (inst, def) => {
 function isValidBase64URL(data) {
   if (!base64url.test(data))
     return false;
-  const base643 = data.replace(/[-_]/g, (c11) => c11 === "-" ? "+" : "/");
+  const base643 = data.replace(/[-_]/g, (c10) => c10 === "-" ? "+" : "/");
   const padded = base643.padEnd(Math.ceil(base643.length / 4) * 4, "=");
   return isValidBase64(padded);
 }
@@ -11671,9 +11671,9 @@ var ZodDate = /* @__PURE__ */ $constructor("ZodDate", (inst, def) => {
   ZodType.init(inst, def);
   inst.min = (value, params) => inst.check(_gte(value, params));
   inst.max = (value, params) => inst.check(_lte(value, params));
-  const c11 = inst._zod.bag;
-  inst.minDate = c11.minimum ? new Date(c11.minimum) : null;
-  inst.maxDate = c11.maximum ? new Date(c11.maximum) : null;
+  const c10 = inst._zod.bag;
+  inst.minDate = c10.minimum ? new Date(c10.minimum) : null;
+  inst.maxDate = c10.maximum ? new Date(c10.maximum) : null;
 });
 function date3(params) {
   return _date(ZodDate, params);
@@ -12266,87 +12266,8 @@ var apiErrorSchema = external_exports.object({
   })
 });
 
-// ../../packages/core/src/contracts/secrets.ts
-var c = initContract();
-var secretNameSchema = external_exports.string().min(1, "Secret name is required").max(255, "Secret name must be 255 characters or less").regex(
-  /^[a-zA-Z][a-zA-Z0-9_]*$/,
-  "Secret name must start with a letter and contain only letters, numbers, and underscores"
-);
-var secretValueSchema = external_exports.string().min(1, "Secret value is required").refine(
-  (value) => Buffer.byteLength(value, "utf8") <= 48 * 1024,
-  "Secret value must be 48 KB or less"
-);
-var secretInfoSchema = external_exports.object({
-  name: external_exports.string(),
-  createdAt: external_exports.string(),
-  updatedAt: external_exports.string()
-});
-var secretsContract = c.router({
-  /**
-   * GET /api/secrets
-   * List all secrets for the authenticated user (names only, not values)
-   */
-  list: {
-    method: "GET",
-    path: "/api/secrets",
-    responses: {
-      200: external_exports.object({
-        secrets: external_exports.array(secretInfoSchema)
-      }),
-      401: apiErrorSchema
-    },
-    summary: "List all secrets"
-  },
-  /**
-   * POST /api/secrets
-   * Create or update a secret
-   */
-  create: {
-    method: "POST",
-    path: "/api/secrets",
-    body: external_exports.object({
-      name: secretNameSchema,
-      value: secretValueSchema
-    }),
-    responses: {
-      200: external_exports.object({
-        name: external_exports.string(),
-        action: external_exports.literal("updated")
-      }),
-      201: external_exports.object({
-        name: external_exports.string(),
-        action: external_exports.literal("created")
-      }),
-      400: apiErrorSchema,
-      401: apiErrorSchema
-    },
-    summary: "Create or update a secret"
-  },
-  /**
-   * DELETE /api/secrets?name={name}
-   * Delete a secret by name
-   */
-  delete: {
-    method: "DELETE",
-    path: "/api/secrets",
-    query: external_exports.object({
-      name: external_exports.string().min(1, "Missing name query parameter")
-    }),
-    responses: {
-      200: external_exports.object({
-        name: external_exports.string(),
-        deleted: external_exports.literal(true)
-      }),
-      400: apiErrorSchema,
-      401: apiErrorSchema,
-      404: apiErrorSchema
-    },
-    summary: "Delete a secret"
-  }
-});
-
 // ../../packages/core/src/contracts/composes.ts
-var c2 = initContract();
+var c = initContract();
 var agentNameSchema = external_exports.string().min(3, "Agent name must be at least 3 characters").max(64, "Agent name must be 64 characters or less").regex(
   /^[a-zA-Z0-9][a-zA-Z0-9-]{1,62}[a-zA-Z0-9]$/,
   "Agent name must start and end with letter or number, and contain only letters, numbers, and hyphens"
@@ -12402,7 +12323,7 @@ var createComposeResponseSchema = external_exports.object({
   action: external_exports.enum(["created", "existing"]),
   updatedAt: external_exports.string()
 });
-var composesMainContract = c2.router({
+var composesMainContract = c.router({
   /**
    * GET /api/agent/composes?name={name}&scope={scope}
    * Get agent compose by name with HEAD version content
@@ -12444,7 +12365,7 @@ var composesMainContract = c2.router({
     summary: "Create or update agent compose version"
   }
 });
-var composesByIdContract = c2.router({
+var composesByIdContract = c.router({
   /**
    * GET /api/agent/composes/:id
    * Get agent compose by ID with HEAD version content
@@ -12463,7 +12384,7 @@ var composesByIdContract = c2.router({
     summary: "Get agent compose by ID"
   }
 });
-var composesVersionsContract = c2.router({
+var composesVersionsContract = c.router({
   /**
    * GET /api/agent/composes/versions?composeId={id}&version={hash|tag}
    * Resolve a version specifier to a full version ID
@@ -12489,7 +12410,7 @@ var composesVersionsContract = c2.router({
 });
 
 // ../../packages/core/src/contracts/runs.ts
-var c3 = initContract();
+var c2 = initContract();
 var runStatusSchema = external_exports.enum([
   "pending",
   "running",
@@ -12564,7 +12485,7 @@ var eventsResponseSchema = external_exports.object({
   run: runStateSchema,
   provider: external_exports.string()
 });
-var runsMainContract = c3.router({
+var runsMainContract = c2.router({
   /**
    * POST /api/agent/runs
    * Create and execute a new agent run
@@ -12582,7 +12503,7 @@ var runsMainContract = c3.router({
     summary: "Create and execute agent run"
   }
 });
-var runsByIdContract = c3.router({
+var runsByIdContract = c2.router({
   /**
    * GET /api/agent/runs/:id
    * Get agent run status and results
@@ -12602,7 +12523,7 @@ var runsByIdContract = c3.router({
     summary: "Get agent run by ID"
   }
 });
-var runEventsContract = c3.router({
+var runEventsContract = c2.router({
   /**
    * GET /api/agent/runs/:id/events
    * Poll for agent run events with pagination
@@ -12663,7 +12584,7 @@ var telemetryResponseSchema = external_exports.object({
   systemLog: external_exports.string(),
   metrics: external_exports.array(telemetryMetricSchema)
 });
-var runTelemetryContract = c3.router({
+var runTelemetryContract = c2.router({
   /**
    * GET /api/agent/runs/:id/telemetry
    * Get aggregated telemetry data for a run (legacy combined format)
@@ -12682,7 +12603,7 @@ var runTelemetryContract = c3.router({
     summary: "Get run telemetry data"
   }
 });
-var runSystemLogContract = c3.router({
+var runSystemLogContract = c2.router({
   /**
    * GET /api/agent/runs/:id/telemetry/system-log
    * Get system log with pagination
@@ -12695,7 +12616,8 @@ var runSystemLogContract = c3.router({
     }),
     query: external_exports.object({
       since: external_exports.coerce.number().optional(),
-      limit: external_exports.coerce.number().min(1).max(100).default(5)
+      limit: external_exports.coerce.number().min(1).max(100).default(5),
+      order: external_exports.enum(["asc", "desc"]).default("desc")
     }),
     responses: {
       200: systemLogResponseSchema,
@@ -12705,7 +12627,7 @@ var runSystemLogContract = c3.router({
     summary: "Get system log with pagination"
   }
 });
-var runMetricsContract = c3.router({
+var runMetricsContract = c2.router({
   /**
    * GET /api/agent/runs/:id/telemetry/metrics
    * Get metrics with pagination
@@ -12718,7 +12640,8 @@ var runMetricsContract = c3.router({
     }),
     query: external_exports.object({
       since: external_exports.coerce.number().optional(),
-      limit: external_exports.coerce.number().min(1).max(100).default(5)
+      limit: external_exports.coerce.number().min(1).max(100).default(5),
+      order: external_exports.enum(["asc", "desc"]).default("desc")
     }),
     responses: {
       200: metricsResponseSchema,
@@ -12728,7 +12651,7 @@ var runMetricsContract = c3.router({
     summary: "Get metrics with pagination"
   }
 });
-var runAgentEventsContract = c3.router({
+var runAgentEventsContract = c2.router({
   /**
    * GET /api/agent/runs/:id/telemetry/agent
    * Get agent events with pagination (for vm0 logs default)
@@ -12741,7 +12664,8 @@ var runAgentEventsContract = c3.router({
     }),
     query: external_exports.object({
       since: external_exports.coerce.number().optional(),
-      limit: external_exports.coerce.number().min(1).max(100).default(5)
+      limit: external_exports.coerce.number().min(1).max(100).default(5),
+      order: external_exports.enum(["asc", "desc"]).default("desc")
     }),
     responses: {
       200: agentEventsResponseSchema,
@@ -12751,7 +12675,7 @@ var runAgentEventsContract = c3.router({
     summary: "Get agent events with pagination"
   }
 });
-var runNetworkLogsContract = c3.router({
+var runNetworkLogsContract = c2.router({
   /**
    * GET /api/agent/runs/:id/telemetry/network
    * Get network logs with pagination (for vm0 logs --network)
@@ -12764,7 +12688,8 @@ var runNetworkLogsContract = c3.router({
     }),
     query: external_exports.object({
       since: external_exports.coerce.number().optional(),
-      limit: external_exports.coerce.number().min(1).max(100).default(5)
+      limit: external_exports.coerce.number().min(1).max(100).default(5),
+      order: external_exports.enum(["asc", "desc"]).default("desc")
     }),
     responses: {
       200: networkLogsResponseSchema,
@@ -12776,7 +12701,7 @@ var runNetworkLogsContract = c3.router({
 });
 
 // ../../packages/core/src/contracts/storages.ts
-var c4 = initContract();
+var c3 = initContract();
 var storageTypeSchema = external_exports.enum(["volume", "artifact"]);
 var uploadStorageResponseSchema = external_exports.object({
   name: external_exports.string(),
@@ -12786,7 +12711,7 @@ var uploadStorageResponseSchema = external_exports.object({
   type: storageTypeSchema,
   deduplicated: external_exports.boolean()
 });
-var storagesContract = c4.router({
+var storagesContract = c3.router({
   /**
    * POST /api/storages
    * Upload a storage (tar.gz file)
@@ -12802,7 +12727,7 @@ var storagesContract = c4.router({
     method: "POST",
     path: "/api/storages",
     contentType: "multipart/form-data",
-    body: c4.type(),
+    body: c3.type(),
     responses: {
       200: uploadStorageResponseSchema,
       400: apiErrorSchema,
@@ -12830,9 +12755,9 @@ var storagesContract = c4.router({
     }),
     responses: {
       // Binary response - actual handling done at route level
-      200: c4.otherResponse({
+      200: c3.otherResponse({
         contentType: "application/gzip",
-        body: c4.type()
+        body: c3.type()
       }),
       400: apiErrorSchema,
       401: apiErrorSchema,
@@ -12842,9 +12767,120 @@ var storagesContract = c4.router({
     summary: "Download storage archive"
   }
 });
+var fileEntryWithHashSchema = external_exports.object({
+  path: external_exports.string().min(1, "File path is required"),
+  hash: external_exports.string().length(64, "Hash must be SHA-256 (64 hex chars)"),
+  size: external_exports.number().int().min(0, "Size must be non-negative")
+});
+var storageChangesSchema = external_exports.object({
+  added: external_exports.array(external_exports.string()),
+  modified: external_exports.array(external_exports.string()),
+  deleted: external_exports.array(external_exports.string())
+});
+var presignedUploadSchema = external_exports.object({
+  key: external_exports.string(),
+  presignedUrl: external_exports.string().url()
+});
+var storagesPrepareContract = c3.router({
+  prepare: {
+    method: "POST",
+    path: "/api/storages/prepare",
+    body: external_exports.object({
+      storageName: external_exports.string().min(1, "Storage name is required"),
+      storageType: storageTypeSchema,
+      files: external_exports.array(fileEntryWithHashSchema),
+      force: external_exports.boolean().optional(),
+      runId: external_exports.string().optional(),
+      // For sandbox auth
+      baseVersion: external_exports.string().optional(),
+      // For incremental uploads
+      changes: storageChangesSchema.optional()
+    }),
+    responses: {
+      200: external_exports.object({
+        versionId: external_exports.string(),
+        existing: external_exports.boolean(),
+        uploads: external_exports.object({
+          archive: presignedUploadSchema,
+          manifest: presignedUploadSchema
+        }).optional()
+      }),
+      400: apiErrorSchema,
+      401: apiErrorSchema,
+      404: apiErrorSchema,
+      500: apiErrorSchema
+    },
+    summary: "Prepare for direct S3 upload"
+  }
+});
+var storagesCommitContract = c3.router({
+  commit: {
+    method: "POST",
+    path: "/api/storages/commit",
+    body: external_exports.object({
+      storageName: external_exports.string().min(1, "Storage name is required"),
+      storageType: storageTypeSchema,
+      versionId: external_exports.string().min(1, "Version ID is required"),
+      files: external_exports.array(fileEntryWithHashSchema),
+      runId: external_exports.string().optional(),
+      message: external_exports.string().optional()
+    }),
+    responses: {
+      200: external_exports.object({
+        success: external_exports.literal(true),
+        versionId: external_exports.string(),
+        storageName: external_exports.string(),
+        size: external_exports.number(),
+        fileCount: external_exports.number(),
+        deduplicated: external_exports.boolean().optional()
+      }),
+      400: apiErrorSchema,
+      401: apiErrorSchema,
+      404: apiErrorSchema,
+      409: apiErrorSchema,
+      // S3 files missing
+      500: apiErrorSchema
+    },
+    summary: "Commit uploaded storage"
+  }
+});
+var storagesDownloadContract = c3.router({
+  download: {
+    method: "GET",
+    path: "/api/storages/download",
+    query: external_exports.object({
+      name: external_exports.string().min(1, "Storage name is required"),
+      type: storageTypeSchema,
+      version: external_exports.string().optional()
+    }),
+    responses: {
+      // Normal response with presigned URL
+      200: external_exports.union([
+        external_exports.object({
+          url: external_exports.string().url(),
+          versionId: external_exports.string(),
+          fileCount: external_exports.number(),
+          size: external_exports.number()
+        }),
+        // Empty artifact response
+        external_exports.object({
+          empty: external_exports.literal(true),
+          versionId: external_exports.string(),
+          fileCount: external_exports.literal(0),
+          size: external_exports.literal(0)
+        })
+      ]),
+      400: apiErrorSchema,
+      401: apiErrorSchema,
+      404: apiErrorSchema,
+      500: apiErrorSchema
+    },
+    summary: "Get presigned download URL"
+  }
+});
 
 // ../../packages/core/src/contracts/webhooks.ts
-var c5 = initContract();
+var c4 = initContract();
 var agentEventSchema = external_exports.object({
   type: external_exports.string(),
   sequenceNumber: external_exports.number().int().positive()
@@ -12856,7 +12892,7 @@ var artifactSnapshotSchema = external_exports.object({
 var volumeVersionsSnapshotSchema = external_exports.object({
   versions: external_exports.record(external_exports.string(), external_exports.string())
 });
-var webhookEventsContract = c5.router({
+var webhookEventsContract = c4.router({
   /**
    * POST /api/webhooks/agent/events
    * Receive agent events from E2B sandbox
@@ -12882,7 +12918,7 @@ var webhookEventsContract = c5.router({
     summary: "Receive agent events from sandbox"
   }
 });
-var webhookCompleteContract = c5.router({
+var webhookCompleteContract = c4.router({
   /**
    * POST /api/webhooks/agent/complete
    * Handle agent run completion (success or failure)
@@ -12908,7 +12944,7 @@ var webhookCompleteContract = c5.router({
     summary: "Handle agent run completion"
   }
 });
-var webhookCheckpointsContract = c5.router({
+var webhookCheckpointsContract = c4.router({
   /**
    * POST /api/webhooks/agent/checkpoints
    * Create checkpoint for completed agent run
@@ -12940,7 +12976,7 @@ var webhookCheckpointsContract = c5.router({
     summary: "Create checkpoint for agent run"
   }
 });
-var webhookHeartbeatContract = c5.router({
+var webhookHeartbeatContract = c4.router({
   /**
    * POST /api/webhooks/agent/heartbeat
    * Receive heartbeat signals from E2B sandbox
@@ -12963,7 +12999,7 @@ var webhookHeartbeatContract = c5.router({
     summary: "Receive heartbeat from sandbox"
   }
 });
-var webhookStoragesContract = c5.router({
+var webhookStoragesContract = c4.router({
   /**
    * POST /api/webhooks/agent/storages
    * Create a new version of a storage from sandbox
@@ -12978,7 +13014,7 @@ var webhookStoragesContract = c5.router({
     method: "POST",
     path: "/api/webhooks/agent/storages",
     contentType: "multipart/form-data",
-    body: c5.type(),
+    body: c4.type(),
     responses: {
       200: external_exports.object({
         versionId: external_exports.string(),
@@ -12994,7 +13030,7 @@ var webhookStoragesContract = c5.router({
     summary: "Upload storage version from sandbox"
   }
 });
-var webhookStoragesIncrementalContract = c5.router({
+var webhookStoragesIncrementalContract = c4.router({
   /**
    * POST /api/webhooks/agent/storages/incremental
    * Create a new version using incremental upload
@@ -13011,7 +13047,7 @@ var webhookStoragesIncrementalContract = c5.router({
     method: "POST",
     path: "/api/webhooks/agent/storages/incremental",
     contentType: "multipart/form-data",
-    body: c5.type(),
+    body: c4.type(),
     responses: {
       200: external_exports.object({
         versionId: external_exports.string(),
@@ -13051,7 +13087,7 @@ var networkLogSchema = external_exports.object({
   request_size: external_exports.number(),
   response_size: external_exports.number()
 });
-var webhookTelemetryContract = c5.router({
+var webhookTelemetryContract = c4.router({
   /**
    * POST /api/webhooks/agent/telemetry
    * Receive telemetry data (system log, metrics, and network logs) from sandbox
@@ -13078,14 +13114,77 @@ var webhookTelemetryContract = c5.router({
     summary: "Receive telemetry data from sandbox"
   }
 });
+var webhookStoragesPrepareContract = c4.router({
+  prepare: {
+    method: "POST",
+    path: "/api/webhooks/agent/storages/prepare",
+    body: external_exports.object({
+      runId: external_exports.string().min(1, "runId is required"),
+      // Required for webhook auth
+      storageName: external_exports.string().min(1, "Storage name is required"),
+      storageType: storageTypeSchema,
+      files: external_exports.array(fileEntryWithHashSchema),
+      force: external_exports.boolean().optional(),
+      baseVersion: external_exports.string().optional(),
+      changes: storageChangesSchema.optional()
+    }),
+    responses: {
+      200: external_exports.object({
+        versionId: external_exports.string(),
+        existing: external_exports.boolean(),
+        uploads: external_exports.object({
+          archive: presignedUploadSchema,
+          manifest: presignedUploadSchema
+        }).optional()
+      }),
+      400: apiErrorSchema,
+      401: apiErrorSchema,
+      404: apiErrorSchema,
+      500: apiErrorSchema
+    },
+    summary: "Prepare for direct S3 upload from sandbox"
+  }
+});
+var webhookStoragesCommitContract = c4.router({
+  commit: {
+    method: "POST",
+    path: "/api/webhooks/agent/storages/commit",
+    body: external_exports.object({
+      runId: external_exports.string().min(1, "runId is required"),
+      // Required for webhook auth
+      storageName: external_exports.string().min(1, "Storage name is required"),
+      storageType: storageTypeSchema,
+      versionId: external_exports.string().min(1, "Version ID is required"),
+      files: external_exports.array(fileEntryWithHashSchema),
+      message: external_exports.string().optional()
+    }),
+    responses: {
+      200: external_exports.object({
+        success: external_exports.literal(true),
+        versionId: external_exports.string(),
+        storageName: external_exports.string(),
+        size: external_exports.number(),
+        fileCount: external_exports.number(),
+        deduplicated: external_exports.boolean().optional()
+      }),
+      400: apiErrorSchema,
+      401: apiErrorSchema,
+      404: apiErrorSchema,
+      409: apiErrorSchema,
+      // S3 files missing
+      500: apiErrorSchema
+    },
+    summary: "Commit uploaded storage from sandbox"
+  }
+});
 
 // ../../packages/core/src/contracts/cli-auth.ts
-var c6 = initContract();
+var c5 = initContract();
 var oauthErrorSchema = external_exports.object({
   error: external_exports.string(),
   error_description: external_exports.string()
 });
-var cliAuthDeviceContract = c6.router({
+var cliAuthDeviceContract = c5.router({
   /**
    * POST /api/cli/auth/device
    * Initiate device authorization flow
@@ -13107,7 +13206,7 @@ var cliAuthDeviceContract = c6.router({
     summary: "Initiate device authorization flow"
   }
 });
-var cliAuthTokenContract = c6.router({
+var cliAuthTokenContract = c5.router({
   /**
    * POST /api/cli/auth/token
    * Exchange device code for access token
@@ -13137,8 +13236,8 @@ var cliAuthTokenContract = c6.router({
 });
 
 // ../../packages/core/src/contracts/auth.ts
-var c7 = initContract();
-var authContract = c7.router({
+var c6 = initContract();
+var authContract = c6.router({
   /**
    * GET /api/auth/me
    * Get current user information
@@ -13160,7 +13259,7 @@ var authContract = c7.router({
 });
 
 // ../../packages/core/src/contracts/images.ts
-var c8 = initContract();
+var c7 = initContract();
 var buildStatusSchema = external_exports.enum(["building", "ready", "error"]);
 var imageInfoSchema = external_exports.object({
   id: external_exports.string(),
@@ -13196,7 +13295,7 @@ var buildStatusResponseSchema = external_exports.object({
   logsOffset: external_exports.number(),
   error: external_exports.string().optional()
 });
-var imagesMainContract = c8.router({
+var imagesMainContract = c7.router({
   /**
    * GET /api/images
    * List all images for authenticated user
@@ -13230,7 +13329,7 @@ var imagesMainContract = c8.router({
     summary: "Create image build"
   }
 });
-var imagesByIdContract = c8.router({
+var imagesByIdContract = c7.router({
   /**
    * DELETE /api/images/:imageId
    * Delete an image by ID
@@ -13254,7 +13353,7 @@ var imagesByIdContract = c8.router({
     summary: "Delete image"
   }
 });
-var imageBuildsContract = c8.router({
+var imageBuildsContract = c7.router({
   /**
    * GET /api/images/:imageId/builds/:buildId
    * Query build status with incremental logs
@@ -13281,7 +13380,7 @@ var imageBuildsContract = c8.router({
 });
 
 // ../../packages/core/src/contracts/cron.ts
-var c9 = initContract();
+var c8 = initContract();
 var cleanupResultSchema = external_exports.object({
   runId: external_exports.string(),
   sandboxId: external_exports.string().nullable(),
@@ -13293,7 +13392,7 @@ var cleanupResponseSchema = external_exports.object({
   errors: external_exports.number(),
   results: external_exports.array(cleanupResultSchema)
 });
-var cronCleanupSandboxesContract = c9.router({
+var cronCleanupSandboxesContract = c8.router({
   /**
    * GET /api/cron/cleanup-sandboxes
    * Cron job to cleanup sandboxes that have stopped sending heartbeats
@@ -13325,7 +13424,7 @@ var proxyErrorSchema = external_exports.object({
 });
 
 // ../../packages/core/src/contracts/scopes.ts
-var c10 = initContract();
+var c9 = initContract();
 var scopeTypeSchema = external_exports.enum(["personal", "organization", "system"]);
 var scopeSlugSchema = external_exports.string().min(3, "Scope slug must be at least 3 characters").max(64, "Scope slug must be at most 64 characters").regex(
   /^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]{1,2}$/,
@@ -13350,7 +13449,7 @@ var updateScopeRequestSchema = external_exports.object({
   slug: scopeSlugSchema,
   force: external_exports.boolean().optional().default(false)
 });
-var scopeContract = c10.router({
+var scopeContract = c9.router({
   /**
    * GET /api/scope
    * Get current user's scope
@@ -13654,6 +13753,9 @@ var ApiClient = class {
     if (options?.limit !== void 0) {
       params.set("limit", String(options.limit));
     }
+    if (options?.order !== void 0) {
+      params.set("order", options.order);
+    }
     const queryString = params.toString();
     const url2 = `${baseUrl}/api/agent/runs/${runId}/telemetry/system-log${queryString ? `?${queryString}` : ""}`;
     const response = await fetch(url2, {
@@ -13676,6 +13778,9 @@ var ApiClient = class {
     if (options?.limit !== void 0) {
       params.set("limit", String(options.limit));
     }
+    if (options?.order !== void 0) {
+      params.set("order", options.order);
+    }
     const queryString = params.toString();
     const url2 = `${baseUrl}/api/agent/runs/${runId}/telemetry/metrics${queryString ? `?${queryString}` : ""}`;
     const response = await fetch(url2, {
@@ -13698,6 +13803,9 @@ var ApiClient = class {
     if (options?.limit !== void 0) {
       params.set("limit", String(options.limit));
     }
+    if (options?.order !== void 0) {
+      params.set("order", options.order);
+    }
     const queryString = params.toString();
     const url2 = `${baseUrl}/api/agent/runs/${runId}/telemetry/agent${queryString ? `?${queryString}` : ""}`;
     const response = await fetch(url2, {
@@ -13720,6 +13828,9 @@ var ApiClient = class {
     if (options?.limit !== void 0) {
       params.set("limit", String(options.limit));
     }
+    if (options?.order !== void 0) {
+      params.set("order", options.order);
+    }
     const queryString = params.toString();
     const url2 = `${baseUrl}/api/agent/runs/${runId}/telemetry/network${queryString ? `?${queryString}` : ""}`;
     const response = await fetch(url2, {
@@ -14969,9 +15080,9 @@ var CodexEventParser = class {
       }
     }
     if (itemType === "file_change" && item.changes && item.changes.length > 0) {
-      const changes = item.changes.map((c11) => {
-        const action = c11.kind === "add" ? "Created" : c11.kind === "modify" ? "Modified" : "Deleted";
-        return `${action}: ${c11.path}`;
+      const changes = item.changes.map((c10) => {
+        const action = c10.kind === "add" ? "Created" : c10.kind === "modify" ? "Modified" : "Deleted";
+        return `${action}: ${c10.path}`;
       }).join("\n");
       return {
         type: "text",
@@ -15312,9 +15423,9 @@ var CodexEventRenderer = class {
       return;
     }
     if (itemType === "file_change" && item.changes && item.changes.length > 0) {
-      const summary = item.changes.map((c11) => {
-        const icon = c11.kind === "add" ? "+" : c11.kind === "delete" ? "-" : "~";
-        return `${icon}${c11.path}`;
+      const summary = item.changes.map((c10) => {
+        const icon = c10.kind === "add" ? "+" : c10.kind === "delete" ? "-" : "~";
+        return `${icon}${c10.path}`;
       }).join(", ");
       console.log(chalk4.green("[files]") + ` ${summary}`);
       return;
@@ -16814,7 +16925,7 @@ async function autoPullArtifact(runOutput, artifactDir) {
 }
 var cookCmd = new Command13().name("cook").description("One-click agent preparation and execution from vm0.yaml");
 cookCmd.argument("[prompt]", "Prompt for the agent").action(async (prompt) => {
-  const shouldExit = await checkAndUpgrade("4.29.0", prompt);
+  const shouldExit = await checkAndUpgrade("4.30.0", prompt);
   if (shouldExit) {
     process.exit(0);
   }
@@ -16987,7 +17098,7 @@ cookCmd.argument("[prompt]", "Prompt for the agent").action(async (prompt) => {
 cookCmd.command("logs").description("View logs from the last cook run").option("-a, --agent", "Show agent events (default)").option("-s, --system", "Show system log").option("-m, --metrics", "Show metrics").option("-n, --network", "Show network logs (proxy traffic)").option(
   "--since <time>",
   "Show logs since timestamp (e.g., 5m, 2h, 1d, 2024-01-15T10:30:00Z)"
-).option("--limit <n>", "Maximum number of entries to show (default: 5)").action(
+).option("--tail <n>", "Show last N entries (default: 5, max: 100)").option("--head <n>", "Show first N entries (max: 100)").action(
   async (options) => {
     const state = await loadCookState();
     if (!state.lastRunId) {
@@ -17017,9 +17128,13 @@ cookCmd.command("logs").description("View logs from the last cook run").option("
       args.push("--since", options.since);
       displayArgs.push(`--since ${options.since}`);
     }
-    if (options.limit) {
-      args.push("--limit", options.limit);
-      displayArgs.push(`--limit ${options.limit}`);
+    if (options.tail) {
+      args.push("--tail", options.tail);
+      displayArgs.push(`--tail ${options.tail}`);
+    }
+    if (options.head) {
+      args.push("--head", options.head);
+      displayArgs.push(`--head ${options.head}`);
     }
     printCommand(displayArgs.join(" "));
     await execVm0Command(args);
@@ -17609,34 +17724,38 @@ function getLogType(options) {
 var logsCommand = new Command19().name("logs").description("View logs for an agent run").argument("<runId>", "Run ID to fetch logs for").option("-a, --agent", "Show agent events (default)").option("-s, --system", "Show system log").option("-m, --metrics", "Show metrics").option("-n, --network", "Show network logs (proxy traffic)").option(
   "--since <time>",
   "Show logs since timestamp (e.g., 5m, 2h, 1d, 2024-01-15T10:30:00Z, 1705312200)"
-).option(
-  "--limit <n>",
-  "Maximum number of entries to show (default: 5, max: 100)",
-  "5"
-).action(
+).option("--tail <n>", "Show last N entries (default: 5, max: 100)").option("--head <n>", "Show first N entries (max: 100)").action(
   async (runId, options) => {
     try {
       const logType = getLogType(options);
+      if (options.tail !== void 0 && options.head !== void 0) {
+        console.error(
+          chalk21.red("Options --tail and --head are mutually exclusive")
+        );
+        process.exit(1);
+      }
       let since;
       if (options.since) {
         since = parseTime(options.since);
       }
+      const isHead = options.head !== void 0;
       const limit = Math.min(
-        Math.max(1, parseInt(options.limit || "5", 10)),
+        Math.max(1, parseInt(options.head || options.tail || "5", 10)),
         100
       );
+      const order = isHead ? "asc" : "desc";
       switch (logType) {
         case "agent":
-          await showAgentEvents(runId, { since, limit });
+          await showAgentEvents(runId, { since, limit, order });
           break;
         case "system":
-          await showSystemLog(runId, { since, limit });
+          await showSystemLog(runId, { since, limit, order });
           break;
         case "metrics":
-          await showMetrics(runId, { since, limit });
+          await showMetrics(runId, { since, limit, order });
           break;
         case "network":
-          await showNetworkLogs(runId, { since, limit });
+          await showNetworkLogs(runId, { since, limit, order });
           break;
       }
     } catch (error43) {
@@ -17651,14 +17770,15 @@ async function showAgentEvents(runId, options) {
     console.log(chalk21.yellow("No agent events found for this run."));
     return;
   }
-  for (const event of response.events) {
+  const events = options.order === "desc" ? [...response.events].reverse() : response.events;
+  for (const event of events) {
     renderAgentEvent(event, response.provider);
   }
   if (response.hasMore) {
     console.log();
     console.log(
       chalk21.dim(
-        `Showing ${response.events.length} events. Use --limit to see more.`
+        `Showing ${response.events.length} events. Use --tail to see more.`
       )
     );
   }
@@ -17673,7 +17793,7 @@ async function showSystemLog(runId, options) {
   if (response.hasMore) {
     console.log();
     console.log(
-      chalk21.dim("More log entries available. Use --limit to see more.")
+      chalk21.dim("More log entries available. Use --tail to see more.")
     );
   }
 }
@@ -17683,14 +17803,15 @@ async function showMetrics(runId, options) {
     console.log(chalk21.yellow("No metrics found for this run."));
     return;
   }
-  for (const metric of response.metrics) {
+  const metrics = options.order === "desc" ? [...response.metrics].reverse() : response.metrics;
+  for (const metric of metrics) {
     console.log(formatMetric(metric));
   }
   if (response.hasMore) {
     console.log();
     console.log(
       chalk21.dim(
-        `Showing ${response.metrics.length} metrics. Use --limit to see more.`
+        `Showing ${response.metrics.length} metrics. Use --tail to see more.`
       )
     );
   }
@@ -17705,14 +17826,15 @@ async function showNetworkLogs(runId, options) {
     );
     return;
   }
-  for (const entry of response.networkLogs) {
+  const networkLogs = options.order === "desc" ? [...response.networkLogs].reverse() : response.networkLogs;
+  for (const entry of networkLogs) {
     console.log(formatNetworkLog(entry));
   }
   if (response.hasMore) {
     console.log();
     console.log(
       chalk21.dim(
-        `Showing ${response.networkLogs.length} network logs. Use --limit to see more.`
+        `Showing ${response.networkLogs.length} network logs. Use --tail to see more.`
       )
     );
   }
@@ -18416,7 +18538,7 @@ var setupGithubCommand = new Command24().name("setup-github").description("Initi
 
 // src/index.ts
 var program = new Command25();
-program.name("vm0").description("VM0 CLI - A modern build tool").version("4.29.0");
+program.name("vm0").description("VM0 CLI - A modern build tool").version("4.30.0");
 program.command("info").description("Display environment information").action(async () => {
   console.log(chalk26.bold("System Information:"));
   console.log(`Node Version: ${process.version}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vm0/cli",
-  "version": "4.29.0",
+  "version": "4.30.0",
   "description": "CLI application",
   "repository": {
     "type": "git",