@vm0/cli 4.38.0 → 4.38.1

package/index.js

@@ -12267,8 +12267,123 @@ var apiErrorSchema = external_exports.object({
   })
 });
 
-// ../../packages/core/src/contracts/composes.ts
+// ../../packages/core/src/contracts/runners.ts
 var c = initContract();
+var firewallRuleSchema = external_exports.object({
+  domain: external_exports.string().optional(),
+  ip: external_exports.string().optional(),
+  /** Terminal rule - value is the action (ALLOW or DENY) */
+  final: external_exports.enum(["ALLOW", "DENY"]).optional(),
+  /** Action for domain/ip rules */
+  action: external_exports.enum(["ALLOW", "DENY"]).optional()
+});
+var experimentalFirewallSchema = external_exports.object({
+  enabled: external_exports.boolean(),
+  rules: external_exports.array(firewallRuleSchema).optional(),
+  experimental_mitm: external_exports.boolean().optional(),
+  experimental_seal_secrets: external_exports.boolean().optional()
+});
+var runnerGroupSchema = external_exports.string().regex(
+  /^[a-z0-9-]+\/[a-z0-9-]+$/,
+  "Runner group must be in scope/name format (e.g., acme/production)"
+);
+var jobSchema = external_exports.object({
+  runId: external_exports.string().uuid(),
+  prompt: external_exports.string(),
+  agentComposeVersionId: external_exports.string(),
+  vars: external_exports.record(external_exports.string(), external_exports.string()).nullable(),
+  secretNames: external_exports.array(external_exports.string()).nullable(),
+  checkpointId: external_exports.string().uuid().nullable()
+});
+var runnersPollContract = c.router({
+  poll: {
+    method: "POST",
+    path: "/api/runners/poll",
+    body: external_exports.object({
+      group: runnerGroupSchema
+    }),
+    responses: {
+      200: external_exports.object({
+        job: jobSchema.nullable()
+      }),
+      400: apiErrorSchema,
+      401: apiErrorSchema,
+      500: apiErrorSchema
+    },
+    summary: "Poll for pending jobs (long-polling with 30s timeout)"
+  }
+});
+var storageEntrySchema = external_exports.object({
+  mountPath: external_exports.string(),
+  archiveUrl: external_exports.string().nullable()
+});
+var artifactEntrySchema = external_exports.object({
+  mountPath: external_exports.string(),
+  archiveUrl: external_exports.string().nullable(),
+  vasStorageName: external_exports.string(),
+  vasVersionId: external_exports.string()
+});
+var storageManifestSchema = external_exports.object({
+  storages: external_exports.array(storageEntrySchema),
+  artifact: artifactEntrySchema.nullable()
+});
+var resumeSessionSchema = external_exports.object({
+  sessionId: external_exports.string(),
+  sessionHistory: external_exports.string()
+});
+var storedExecutionContextSchema = external_exports.object({
+  workingDir: external_exports.string(),
+  storageManifest: storageManifestSchema.nullable(),
+  environment: external_exports.record(external_exports.string(), external_exports.string()).nullable(),
+  resumeSession: resumeSessionSchema.nullable(),
+  encryptedSecrets: external_exports.string().nullable(),
+  // AES-256-GCM encrypted secrets
+  cliAgentType: external_exports.string(),
+  experimentalFirewall: experimentalFirewallSchema.optional()
+});
+var executionContextSchema = external_exports.object({
+  runId: external_exports.string().uuid(),
+  prompt: external_exports.string(),
+  agentComposeVersionId: external_exports.string(),
+  vars: external_exports.record(external_exports.string(), external_exports.string()).nullable(),
+  secretNames: external_exports.array(external_exports.string()).nullable(),
+  checkpointId: external_exports.string().uuid().nullable(),
+  sandboxToken: external_exports.string(),
+  // New fields for E2B parity:
+  workingDir: external_exports.string(),
+  storageManifest: storageManifestSchema.nullable(),
+  environment: external_exports.record(external_exports.string(), external_exports.string()).nullable(),
+  resumeSession: resumeSessionSchema.nullable(),
+  secretValues: external_exports.array(external_exports.string()).nullable(),
+  cliAgentType: external_exports.string(),
+  // Experimental firewall configuration
+  experimentalFirewall: experimentalFirewallSchema.optional()
+});
+var runnersJobClaimContract = c.router({
+  claim: {
+    method: "POST",
+    path: "/api/runners/jobs/:id/claim",
+    pathParams: external_exports.object({
+      id: external_exports.string().uuid()
+    }),
+    body: external_exports.object({}),
+    responses: {
+      200: executionContextSchema,
+      400: apiErrorSchema,
+      401: apiErrorSchema,
+      403: apiErrorSchema,
+      // Job does not belong to user
+      404: apiErrorSchema,
+      409: apiErrorSchema,
+      // Already claimed
+      500: apiErrorSchema
+    },
+    summary: "Claim a pending job for execution"
+  }
+});
+
+// ../../packages/core/src/contracts/composes.ts
+var c2 = initContract();
 var composeVersionQuerySchema = external_exports.preprocess(
   (val) => val === void 0 || val === null ? void 0 : String(val),
   external_exports.string().min(1, "Missing version query parameter").regex(
@@ -12341,7 +12456,13 @@ var agentDefinitionSchema = external_exports.object({
       /^[a-z0-9-]+\/[a-z0-9-]+$/,
       "Runner group must be in scope/name format (e.g., acme/production)"
     )
-  }).optional()
+  }).optional(),
+  /**
+   * Experimental firewall configuration for network egress control.
+   * Requires experimental_runner to be configured.
+   * When enabled, filters outbound traffic by domain/IP rules.
+   */
+  experimental_firewall: experimentalFirewallSchema.optional()
 });
 var agentComposeContentSchema = external_exports.object({
   version: external_exports.string().min(1, "Version is required"),
@@ -12363,7 +12484,7 @@ var createComposeResponseSchema = external_exports.object({
   action: external_exports.enum(["created", "existing"]),
   updatedAt: external_exports.string()
 });
-var composesMainContract = c.router({
+var composesMainContract = c2.router({
   /**
    * GET /api/agent/composes?name={name}&scope={scope}
    * Get agent compose by name with HEAD version content
@@ -12405,7 +12526,7 @@ var composesMainContract = c.router({
     summary: "Create or update agent compose version"
   }
 });
-var composesByIdContract = c.router({
+var composesByIdContract = c2.router({
   /**
    * GET /api/agent/composes/:id
    * Get agent compose by ID with HEAD version content
@@ -12424,7 +12545,7 @@ var composesByIdContract = c.router({
     summary: "Get agent compose by ID"
   }
 });
-var composesVersionsContract = c.router({
+var composesVersionsContract = c2.router({
   /**
    * GET /api/agent/composes/versions?composeId={id}&version={hash|tag}
    * Resolve a version specifier to a full version ID
@@ -12453,7 +12574,7 @@ var composeListItemSchema = external_exports.object({
   headVersionId: external_exports.string().nullable(),
   updatedAt: external_exports.string()
 });
-var composesListContract = c.router({
+var composesListContract = c2.router({
   /**
    * GET /api/agent/composes/list?scope={scope}
    * List all agent composes for a scope
@@ -12477,7 +12598,7 @@ var composesListContract = c.router({
 });
 
 // ../../packages/core/src/contracts/runs.ts
-var c2 = initContract();
+var c3 = initContract();
 var runStatusSchema = external_exports.enum([
   "pending",
   "running",
@@ -12552,7 +12673,7 @@ var eventsResponseSchema = external_exports.object({
   run: runStateSchema,
   provider: external_exports.string()
 });
-var runsMainContract = c2.router({
+var runsMainContract = c3.router({
   /**
    * POST /api/agent/runs
    * Create and execute a new agent run
@@ -12570,7 +12691,7 @@ var runsMainContract = c2.router({
     summary: "Create and execute agent run"
   }
 });
-var runsByIdContract = c2.router({
+var runsByIdContract = c3.router({
   /**
    * GET /api/agent/runs/:id
    * Get agent run status and results
@@ -12590,7 +12711,7 @@ var runsByIdContract = c2.router({
     summary: "Get agent run by ID"
   }
 });
-var runEventsContract = c2.router({
+var runEventsContract = c3.router({
   /**
    * GET /api/agent/runs/:id/events
    * Poll for agent run events with pagination
@@ -12651,7 +12772,7 @@ var telemetryResponseSchema = external_exports.object({
   systemLog: external_exports.string(),
   metrics: external_exports.array(telemetryMetricSchema)
 });
-var runTelemetryContract = c2.router({
+var runTelemetryContract = c3.router({
   /**
    * GET /api/agent/runs/:id/telemetry
    * Get aggregated telemetry data for a run (legacy combined format)
@@ -12670,7 +12791,7 @@ var runTelemetryContract = c2.router({
     summary: "Get run telemetry data"
   }
 });
-var runSystemLogContract = c2.router({
+var runSystemLogContract = c3.router({
   /**
    * GET /api/agent/runs/:id/telemetry/system-log
    * Get system log with pagination
@@ -12694,7 +12815,7 @@ var runSystemLogContract = c2.router({
     summary: "Get system log with pagination"
   }
 });
-var runMetricsContract = c2.router({
+var runMetricsContract = c3.router({
   /**
    * GET /api/agent/runs/:id/telemetry/metrics
    * Get metrics with pagination
@@ -12718,7 +12839,7 @@ var runMetricsContract = c2.router({
     summary: "Get metrics with pagination"
   }
 });
-var runAgentEventsContract = c2.router({
+var runAgentEventsContract = c3.router({
   /**
    * GET /api/agent/runs/:id/telemetry/agent
    * Get agent events with pagination (for vm0 logs default)
@@ -12742,7 +12863,7 @@ var runAgentEventsContract = c2.router({
     summary: "Get agent events with pagination"
   }
 });
-var runNetworkLogsContract = c2.router({
+var runNetworkLogsContract = c3.router({
   /**
    * GET /api/agent/runs/:id/telemetry/network
    * Get network logs with pagination (for vm0 logs --network)
@@ -12768,7 +12889,7 @@ var runNetworkLogsContract = c2.router({
 });
 
 // ../../packages/core/src/contracts/storages.ts
-var c3 = initContract();
+var c4 = initContract();
 var storageTypeSchema = external_exports.enum(["volume", "artifact"]);
 var versionQuerySchema = external_exports.preprocess(
   (val) => val === void 0 || val === null ? void 0 : String(val),
@@ -12782,7 +12903,7 @@ var uploadStorageResponseSchema = external_exports.object({
   type: storageTypeSchema,
   deduplicated: external_exports.boolean()
 });
-var storagesContract = c3.router({
+var storagesContract = c4.router({
   /**
    * POST /api/storages
    * Upload a storage (tar.gz file)
@@ -12798,7 +12919,7 @@ var storagesContract = c3.router({
     method: "POST",
     path: "/api/storages",
     contentType: "multipart/form-data",
-    body: c3.type(),
+    body: c4.type(),
     responses: {
       200: uploadStorageResponseSchema,
       400: apiErrorSchema,
@@ -12826,9 +12947,9 @@ var storagesContract = c3.router({
     }),
     responses: {
       // Binary response - actual handling done at route level
-      200: c3.otherResponse({
+      200: c4.otherResponse({
         contentType: "application/gzip",
-        body: c3.type()
+        body: c4.type()
       }),
       400: apiErrorSchema,
       401: apiErrorSchema,
@@ -12852,7 +12973,7 @@ var presignedUploadSchema = external_exports.object({
   key: external_exports.string(),
   presignedUrl: external_exports.string().url()
 });
-var storagesPrepareContract = c3.router({
+var storagesPrepareContract = c4.router({
   prepare: {
     method: "POST",
     path: "/api/storages/prepare",
@@ -12884,7 +13005,7 @@ var storagesPrepareContract = c3.router({
     summary: "Prepare for direct S3 upload"
   }
 });
-var storagesCommitContract = c3.router({
+var storagesCommitContract = c4.router({
   commit: {
     method: "POST",
     path: "/api/storages/commit",
@@ -12915,7 +13036,7 @@ var storagesCommitContract = c3.router({
     summary: "Commit uploaded storage"
   }
 });
-var storagesDownloadContract = c3.router({
+var storagesDownloadContract = c4.router({
   download: {
     method: "GET",
     path: "/api/storages/download",
@@ -12949,7 +13070,7 @@ var storagesDownloadContract = c3.router({
     summary: "Get presigned download URL"
   }
 });
-var storagesListContract = c3.router({
+var storagesListContract = c4.router({
   list: {
     method: "GET",
     path: "/api/storages/list",
@@ -12973,7 +13094,7 @@ var storagesListContract = c3.router({
 });
 
 // ../../packages/core/src/contracts/webhooks.ts
-var c4 = initContract();
+var c5 = initContract();
 var agentEventSchema = external_exports.object({
   type: external_exports.string(),
   sequenceNumber: external_exports.number().int().positive()
@@ -12985,7 +13106,7 @@ var artifactSnapshotSchema = external_exports.object({
 var volumeVersionsSnapshotSchema = external_exports.object({
   versions: external_exports.record(external_exports.string(), external_exports.string())
 });
-var webhookEventsContract = c4.router({
+var webhookEventsContract = c5.router({
   /**
    * POST /api/webhooks/agent/events
    * Receive agent events from E2B sandbox
@@ -13011,7 +13132,7 @@ var webhookEventsContract = c4.router({
     summary: "Receive agent events from sandbox"
   }
 });
-var webhookCompleteContract = c4.router({
+var webhookCompleteContract = c5.router({
   /**
    * POST /api/webhooks/agent/complete
    * Handle agent run completion (success or failure)
@@ -13037,7 +13158,7 @@ var webhookCompleteContract = c4.router({
     summary: "Handle agent run completion"
   }
 });
-var webhookCheckpointsContract = c4.router({
+var webhookCheckpointsContract = c5.router({
   /**
    * POST /api/webhooks/agent/checkpoints
    * Create checkpoint for completed agent run
@@ -13069,7 +13190,7 @@ var webhookCheckpointsContract = c4.router({
     summary: "Create checkpoint for agent run"
   }
 });
-var webhookHeartbeatContract = c4.router({
+var webhookHeartbeatContract = c5.router({
   /**
    * POST /api/webhooks/agent/heartbeat
    * Receive heartbeat signals from E2B sandbox
@@ -13092,7 +13213,7 @@ var webhookHeartbeatContract = c4.router({
     summary: "Receive heartbeat from sandbox"
   }
 });
-var webhookStoragesContract = c4.router({
+var webhookStoragesContract = c5.router({
   /**
    * POST /api/webhooks/agent/storages
    * Create a new version of a storage from sandbox
@@ -13107,7 +13228,7 @@ var webhookStoragesContract = c4.router({
     method: "POST",
     path: "/api/webhooks/agent/storages",
     contentType: "multipart/form-data",
-    body: c4.type(),
+    body: c5.type(),
     responses: {
       200: external_exports.object({
         versionId: external_exports.string(),
@@ -13123,7 +13244,7 @@ var webhookStoragesContract = c4.router({
     summary: "Upload storage version from sandbox"
   }
 });
-var webhookStoragesIncrementalContract = c4.router({
+var webhookStoragesIncrementalContract = c5.router({
   /**
    * POST /api/webhooks/agent/storages/incremental
    * Create a new version using incremental upload
@@ -13140,7 +13261,7 @@ var webhookStoragesIncrementalContract = c4.router({
     method: "POST",
     path: "/api/webhooks/agent/storages/incremental",
     contentType: "multipart/form-data",
-    body: c4.type(),
+    body: c5.type(),
     responses: {
       200: external_exports.object({
         versionId: external_exports.string(),
@@ -13180,7 +13301,7 @@ var networkLogSchema = external_exports.object({
   request_size: external_exports.number(),
   response_size: external_exports.number()
 });
-var webhookTelemetryContract = c4.router({
+var webhookTelemetryContract = c5.router({
   /**
    * POST /api/webhooks/agent/telemetry
    * Receive telemetry data (system log, metrics, and network logs) from sandbox
@@ -13207,7 +13328,7 @@ var webhookTelemetryContract = c4.router({
     summary: "Receive telemetry data from sandbox"
   }
 });
-var webhookStoragesPrepareContract = c4.router({
+var webhookStoragesPrepareContract = c5.router({
   prepare: {
     method: "POST",
     path: "/api/webhooks/agent/storages/prepare",
@@ -13238,7 +13359,7 @@ var webhookStoragesPrepareContract = c4.router({
     summary: "Prepare for direct S3 upload from sandbox"
   }
 });
-var webhookStoragesCommitContract = c4.router({
+var webhookStoragesCommitContract = c5.router({
   commit: {
     method: "POST",
     path: "/api/webhooks/agent/storages/commit",
@@ -13272,12 +13393,12 @@ var webhookStoragesCommitContract = c4.router({
 });
 
 // ../../packages/core/src/contracts/cli-auth.ts
-var c5 = initContract();
+var c6 = initContract();
 var oauthErrorSchema = external_exports.object({
   error: external_exports.string(),
   error_description: external_exports.string()
 });
-var cliAuthDeviceContract = c5.router({
+var cliAuthDeviceContract = c6.router({
   /**
    * POST /api/cli/auth/device
    * Initiate device authorization flow
@@ -13299,7 +13420,7 @@ var cliAuthDeviceContract = c5.router({
     summary: "Initiate device authorization flow"
   }
 });
-var cliAuthTokenContract = c5.router({
+var cliAuthTokenContract = c6.router({
   /**
    * POST /api/cli/auth/token
    * Exchange device code for access token
@@ -13329,8 +13450,8 @@ var cliAuthTokenContract = c5.router({
 });
 
 // ../../packages/core/src/contracts/auth.ts
-var c6 = initContract();
-var authContract = c6.router({
+var c7 = initContract();
+var authContract = c7.router({
   /**
    * GET /api/auth/me
    * Get current user information
@@ -13352,7 +13473,7 @@ var authContract = c6.router({
 });
 
 // ../../packages/core/src/contracts/cron.ts
-var c7 = initContract();
+var c8 = initContract();
 var cleanupResultSchema = external_exports.object({
   runId: external_exports.string(),
   sandboxId: external_exports.string().nullable(),
@@ -13364,7 +13485,7 @@ var cleanupResponseSchema = external_exports.object({
   errors: external_exports.number(),
   results: external_exports.array(cleanupResultSchema)
 });
-var cronCleanupSandboxesContract = c7.router({
+var cronCleanupSandboxesContract = c8.router({
   /**
    * GET /api/cron/cleanup-sandboxes
    * Cron job to cleanup sandboxes that have stopped sending heartbeats
@@ -13396,7 +13517,7 @@ var proxyErrorSchema = external_exports.object({
 });
 
 // ../../packages/core/src/contracts/scopes.ts
-var c8 = 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}$/,
@@ -13421,7 +13542,7 @@ var updateScopeRequestSchema = external_exports.object({
   slug: scopeSlugSchema,
   force: external_exports.boolean().optional().default(false)
 });
-var scopeContract = c8.router({
+var scopeContract = c9.router({
   /**
    * GET /api/scope
    * Get current user's scope
@@ -13476,7 +13597,7 @@ var scopeContract = c8.router({
 });
 
 // ../../packages/core/src/contracts/sessions.ts
-var c9 = initContract();
+var c10 = initContract();
 var sessionResponseSchema = external_exports.object({
   id: external_exports.string(),
   agentComposeId: external_exports.string(),
@@ -13510,7 +13631,7 @@ var checkpointResponseSchema = external_exports.object({
   volumeVersionsSnapshot: volumeVersionsSnapshotSchema2.nullable(),
   createdAt: external_exports.string()
 });
-var sessionsByIdContract = c9.router({
+var sessionsByIdContract = c10.router({
   /**
    * GET /api/agent/sessions/:id
    * Get session by ID
@@ -13530,7 +13651,7 @@ var sessionsByIdContract = c9.router({
     summary: "Get session by ID"
   }
 });
-var checkpointsByIdContract = c9.router({
+var checkpointsByIdContract = c10.router({
   /**
    * GET /api/agent/checkpoints/:id
    * Get checkpoint by ID
@@ -13551,107 +13672,6 @@ var checkpointsByIdContract = c9.router({
   }
 });
 
-// ../../packages/core/src/contracts/runners.ts
-var c10 = initContract();
-var runnerGroupSchema = external_exports.string().regex(
-  /^[a-z0-9-]+\/[a-z0-9-]+$/,
-  "Runner group must be in scope/name format (e.g., acme/production)"
-);
-var jobSchema = external_exports.object({
-  runId: external_exports.string().uuid(),
-  prompt: external_exports.string(),
-  agentComposeVersionId: external_exports.string(),
-  vars: external_exports.record(external_exports.string(), external_exports.string()).nullable(),
-  secretNames: external_exports.array(external_exports.string()).nullable(),
-  checkpointId: external_exports.string().uuid().nullable()
-});
-var runnersPollContract = c10.router({
-  poll: {
-    method: "POST",
-    path: "/api/runners/poll",
-    body: external_exports.object({
-      group: runnerGroupSchema
-    }),
-    responses: {
-      200: external_exports.object({
-        job: jobSchema.nullable()
-      }),
-      400: apiErrorSchema,
-      401: apiErrorSchema,
-      500: apiErrorSchema
-    },
-    summary: "Poll for pending jobs (long-polling with 30s timeout)"
-  }
-});
-var storageEntrySchema = external_exports.object({
-  mountPath: external_exports.string(),
-  archiveUrl: external_exports.string().nullable()
-});
-var artifactEntrySchema = external_exports.object({
-  mountPath: external_exports.string(),
-  archiveUrl: external_exports.string().nullable(),
-  vasStorageName: external_exports.string(),
-  vasVersionId: external_exports.string()
-});
-var storageManifestSchema = external_exports.object({
-  storages: external_exports.array(storageEntrySchema),
-  artifact: artifactEntrySchema.nullable()
-});
-var resumeSessionSchema = external_exports.object({
-  sessionId: external_exports.string(),
-  sessionHistory: external_exports.string()
-});
-var storedExecutionContextSchema = external_exports.object({
-  workingDir: external_exports.string(),
-  storageManifest: storageManifestSchema.nullable(),
-  environment: external_exports.record(external_exports.string(), external_exports.string()).nullable(),
-  resumeSession: resumeSessionSchema.nullable(),
-  encryptedSecrets: external_exports.string().nullable(),
-  // AES-256-GCM encrypted secrets
-  cliAgentType: external_exports.string(),
-  experimentalNetworkSecurity: external_exports.boolean().optional()
-});
-var executionContextSchema = external_exports.object({
-  runId: external_exports.string().uuid(),
-  prompt: external_exports.string(),
-  agentComposeVersionId: external_exports.string(),
-  vars: external_exports.record(external_exports.string(), external_exports.string()).nullable(),
-  secretNames: external_exports.array(external_exports.string()).nullable(),
-  checkpointId: external_exports.string().uuid().nullable(),
-  sandboxToken: external_exports.string(),
-  // New fields for E2B parity:
-  workingDir: external_exports.string(),
-  storageManifest: storageManifestSchema.nullable(),
-  environment: external_exports.record(external_exports.string(), external_exports.string()).nullable(),
-  resumeSession: resumeSessionSchema.nullable(),
-  secretValues: external_exports.array(external_exports.string()).nullable(),
-  cliAgentType: external_exports.string(),
-  // Network security mode flag
-  experimentalNetworkSecurity: external_exports.boolean().optional()
-});
-var runnersJobClaimContract = c10.router({
-  claim: {
-    method: "POST",
-    path: "/api/runners/jobs/:id/claim",
-    pathParams: external_exports.object({
-      id: external_exports.string().uuid()
-    }),
-    body: external_exports.object({}),
-    responses: {
-      200: executionContextSchema,
-      400: apiErrorSchema,
-      401: apiErrorSchema,
-      403: apiErrorSchema,
-      // Job does not belong to user
-      404: apiErrorSchema,
-      409: apiErrorSchema,
-      // Already claimed
-      500: apiErrorSchema
-    },
-    summary: "Claim a pending job for execution"
-  }
-});
-
 // ../../packages/core/src/contracts/public/common.ts
 var publicApiErrorTypeSchema = external_exports.enum([
   "api_error",
@@ -13725,18 +13745,21 @@ var updateAgentRequestSchema = external_exports.object({
   config: external_exports.unknown()
   // New agent configuration (creates new version)
 });
+var agentListQuerySchema = listQuerySchema.extend({
+  name: external_exports.string().optional()
+});
 var publicAgentsListContract = c11.router({
   list: {
     method: "GET",
     path: "/v1/agents",
-    query: listQuerySchema,
+    query: agentListQuerySchema,
     responses: {
       200: paginatedAgentsSchema,
       401: publicApiErrorSchema,
       500: publicApiErrorSchema
     },
     summary: "List agents",
-    description: "List all agents in the current scope with pagination"
+    description: "List all agents in the current scope with pagination. Use the `name` query parameter to filter by agent name."
   },
   create: {
     method: "POST",
@@ -18628,7 +18651,7 @@ async function autoPullArtifact(runOutput, artifactDir) {
 }
 var cookCmd = new Command17().name("cook").description("One-click agent preparation and execution from vm0.yaml");
 cookCmd.argument("[prompt]", "Prompt for the agent").option("-y, --yes", "Skip confirmation prompts").action(async (prompt, options) => {
-  const shouldExit = await checkAndUpgrade("4.38.0", prompt);
+  const shouldExit = await checkAndUpgrade("4.38.1", prompt);
   if (shouldExit) {
     process.exit(0);
   }
@@ -20182,7 +20205,7 @@ var setupGithubCommand = new Command26().name("setup-github").description("Initi
 
 // src/index.ts
 var program = new Command27();
-program.name("vm0").description("VM0 CLI - A modern build tool").version("4.38.0");
+program.name("vm0").description("VM0 CLI - A modern build tool").version("4.38.1");
 program.command("info").description("Display environment information").action(async () => {
   console.log(chalk29.bold("System Information:"));
   console.log(`Node Version: ${process.version}`);

package/package.json

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