@vm0/cli 9.21.0 → 9.23.0

package/index.js

@@ -3,13 +3,7 @@
 // src/instrument.ts
 import * as Sentry from "@sentry/node";
 import * as os from "os";
-var TELEMETRY_DISABLED = process.env.VM0_TELEMETRY === "false";
-var IS_CI = Boolean(process.env.CI || process.env.GITHUB_ACTIONS);
-var IS_DEV = process.env.NODE_ENV === "development";
-var PRODUCTION_API_URL = "https://www.vm0.ai";
-var API_URL = process.env.VM0_API_URL ?? "";
-var IS_PRODUCTION_API = API_URL === "" || API_URL === PRODUCTION_API_URL;
-var DSN = "https://268d9b4cd051531805af76a5b3934dca@o4510583739777024.ingest.us.sentry.io/4510832047947776";
+var DSN = process.env.SENTRY_DSN ?? "https://268d9b4cd051531805af76a5b3934dca@o4510583739777024.ingest.us.sentry.io/4510832047947776";
 var OPERATIONAL_ERROR_PATTERNS = [
   // Authentication errors (user needs to login)
   /not authenticated/i,
@@ -46,7 +40,7 @@ function isOperationalError(error) {
   const message = error.message;
   return OPERATIONAL_ERROR_PATTERNS.some((pattern) => pattern.test(message));
 }
-if (!TELEMETRY_DISABLED && !IS_CI && !IS_DEV && IS_PRODUCTION_API) {
+if (DSN) {
   Sentry.init({
     dsn: DSN,
     sendDefaultPii: false,
@@ -67,7 +61,7 @@ if (!TELEMETRY_DISABLED && !IS_CI && !IS_DEV && IS_PRODUCTION_API) {
     }
   });
   Sentry.setContext("cli", {
-    version: "9.21.0",
+    version: "9.23.0",
     command: process.argv.slice(2).join(" ")
   });
   Sentry.setContext("runtime", {
@@ -78,7 +72,7 @@ if (!TELEMETRY_DISABLED && !IS_CI && !IS_DEV && IS_PRODUCTION_API) {
 }
 
 // src/index.ts
-import { Command as Command68 } from "commander";
+import { Command as Command70 } from "commander";
 
 // src/commands/auth/index.ts
 import { Command as Command5 } from "commander";
@@ -2323,7 +2317,7 @@ var MODEL_PROVIDER_TYPES = {
   "aws-bedrock": {
     framework: "claude-code",
     label: "AWS Bedrock",
-    helpText: "Run Claude on AWS Bedrock.\nSetup guide: https://docs.anthropic.com/en/docs/claude-code/bedrock",
+    helpText: "Run Claude on AWS Bedrock.\nSetup guide: https://code.claude.com/docs/en/amazon-bedrock",
     authMethods: {
       "api-key": {
         label: "Bedrock API Key",
@@ -3144,29 +3138,126 @@ var llmChatContract = c18.router({
   }
 });
 
-// ../../packages/core/src/contracts/public/agents.ts
+// ../../packages/core/src/contracts/compose-jobs.ts
 import { z as z23 } from "zod";
 var c19 = initContract();
-var publicAgentSchema = z23.object({
-  id: z23.string(),
-  name: z23.string(),
-  currentVersionId: z23.string().nullable(),
+var composeJobStatusSchema = z23.enum([
+  "pending",
+  "running",
+  "completed",
+  "failed"
+]);
+var composeJobResultSchema = z23.object({
+  composeId: z23.string(),
+  composeName: z23.string(),
+  versionId: z23.string(),
+  warnings: z23.array(z23.string())
+});
+var createComposeJobRequestSchema = z23.object({
+  githubUrl: z23.string().url().startsWith("https://github.com/"),
+  overwrite: z23.boolean().optional().default(false)
+});
+var composeJobResponseSchema = z23.object({
+  jobId: z23.string(),
+  status: composeJobStatusSchema,
+  githubUrl: z23.string(),
+  result: composeJobResultSchema.optional(),
+  error: z23.string().optional(),
+  createdAt: z23.string(),
+  startedAt: z23.string().optional(),
+  completedAt: z23.string().optional()
+});
+var composeJobsMainContract = c19.router({
+  /**
+   * POST /api/compose/from-github
+   * Create a new compose job from GitHub URL
+   */
+  create: {
+    method: "POST",
+    path: "/api/compose/from-github",
+    headers: authHeadersSchema,
+    body: createComposeJobRequestSchema,
+    responses: {
+      201: composeJobResponseSchema,
+      200: composeJobResponseSchema,
+      // Returned when existing job found (idempotency)
+      400: apiErrorSchema,
+      401: apiErrorSchema
+    },
+    summary: "Create compose job from GitHub URL"
+  }
+});
+var composeJobsByIdContract = c19.router({
+  /**
+   * GET /api/compose/from-github/:jobId
+   * Get compose job status and result
+   */
+  getById: {
+    method: "GET",
+    path: "/api/compose/from-github/:jobId",
+    headers: authHeadersSchema,
+    pathParams: z23.object({
+      jobId: z23.string().uuid()
+    }),
+    responses: {
+      200: composeJobResponseSchema,
+      401: apiErrorSchema,
+      404: apiErrorSchema
+    },
+    summary: "Get compose job status"
+  }
+});
+var webhookComposeCompleteContract = c19.router({
+  /**
+   * POST /api/webhooks/compose/complete
+   * Handle compose job completion from sandbox
+   */
+  complete: {
+    method: "POST",
+    path: "/api/webhooks/compose/complete",
+    headers: authHeadersSchema,
+    body: z23.object({
+      jobId: z23.string().uuid(),
+      success: z23.boolean(),
+      // Result from CLI compose command
+      result: composeJobResultSchema.optional(),
+      error: z23.string().optional()
+    }),
+    responses: {
+      200: z23.object({
+        success: z23.boolean()
+      }),
+      400: apiErrorSchema,
+      401: apiErrorSchema,
+      404: apiErrorSchema
+    },
+    summary: "Handle compose job completion"
+  }
+});
+
+// ../../packages/core/src/contracts/public/agents.ts
+import { z as z24 } from "zod";
+var c20 = initContract();
+var publicAgentSchema = z24.object({
+  id: z24.string(),
+  name: z24.string(),
+  currentVersionId: z24.string().nullable(),
   createdAt: timestampSchema,
   updatedAt: timestampSchema
 });
-var agentVersionSchema = z23.object({
-  id: z23.string(),
-  agentId: z23.string(),
-  versionNumber: z23.number(),
+var agentVersionSchema = z24.object({
+  id: z24.string(),
+  agentId: z24.string(),
+  versionNumber: z24.number(),
   createdAt: timestampSchema
 });
 var publicAgentDetailSchema = publicAgentSchema;
 var paginatedAgentsSchema = createPaginatedResponseSchema(publicAgentSchema);
 var paginatedAgentVersionsSchema = createPaginatedResponseSchema(agentVersionSchema);
 var agentListQuerySchema = listQuerySchema.extend({
-  name: z23.string().optional()
+  name: z24.string().optional()
 });
-var publicAgentsListContract = c19.router({
+var publicAgentsListContract = c20.router({
   list: {
     method: "GET",
     path: "/v1/agents",
@@ -3181,13 +3272,13 @@ var publicAgentsListContract = c19.router({
     description: "List all agents in the current scope with pagination. Use the `name` query parameter to filter by agent name."
   }
 });
-var publicAgentByIdContract = c19.router({
+var publicAgentByIdContract = c20.router({
   get: {
     method: "GET",
     path: "/v1/agents/:id",
     headers: authHeadersSchema,
-    pathParams: z23.object({
-      id: z23.string().min(1, "Agent ID is required")
+    pathParams: z24.object({
+      id: z24.string().min(1, "Agent ID is required")
     }),
     responses: {
       200: publicAgentDetailSchema,
@@ -3199,13 +3290,13 @@ var publicAgentByIdContract = c19.router({
     description: "Get agent details by ID"
   }
 });
-var publicAgentVersionsContract = c19.router({
+var publicAgentVersionsContract = c20.router({
   list: {
     method: "GET",
     path: "/v1/agents/:id/versions",
     headers: authHeadersSchema,
-    pathParams: z23.object({
-      id: z23.string().min(1, "Agent ID is required")
+    pathParams: z24.object({
+      id: z24.string().min(1, "Agent ID is required")
     }),
     query: listQuerySchema,
     responses: {
@@ -3220,9 +3311,9 @@ var publicAgentVersionsContract = c19.router({
 });
 
 // ../../packages/core/src/contracts/public/runs.ts
-import { z as z24 } from "zod";
-var c20 = initContract();
-var publicRunStatusSchema = z24.enum([
+import { z as z25 } from "zod";
+var c21 = initContract();
+var publicRunStatusSchema = z25.enum([
   "pending",
   "running",
   "completed",
@@ -3230,54 +3321,54 @@ var publicRunStatusSchema = z24.enum([
   "timeout",
   "cancelled"
 ]);
-var publicRunSchema = z24.object({
-  id: z24.string(),
-  agentId: z24.string(),
-  agentName: z24.string(),
+var publicRunSchema = z25.object({
+  id: z25.string(),
+  agentId: z25.string(),
+  agentName: z25.string(),
   status: publicRunStatusSchema,
-  prompt: z24.string(),
+  prompt: z25.string(),
   createdAt: timestampSchema,
   startedAt: timestampSchema.nullable(),
   completedAt: timestampSchema.nullable()
 });
 var publicRunDetailSchema = publicRunSchema.extend({
-  error: z24.string().nullable(),
-  executionTimeMs: z24.number().nullable(),
-  checkpointId: z24.string().nullable(),
-  sessionId: z24.string().nullable(),
-  artifactName: z24.string().nullable(),
-  artifactVersion: z24.string().nullable(),
-  volumes: z24.record(z24.string(), z24.string()).optional()
+  error: z25.string().nullable(),
+  executionTimeMs: z25.number().nullable(),
+  checkpointId: z25.string().nullable(),
+  sessionId: z25.string().nullable(),
+  artifactName: z25.string().nullable(),
+  artifactVersion: z25.string().nullable(),
+  volumes: z25.record(z25.string(), z25.string()).optional()
 });
 var paginatedRunsSchema = createPaginatedResponseSchema(publicRunSchema);
-var createRunRequestSchema = z24.object({
+var createRunRequestSchema = z25.object({
   // Agent identification (one of: agent, agentId, sessionId, checkpointId)
-  agent: z24.string().optional(),
+  agent: z25.string().optional(),
   // Agent name
-  agentId: z24.string().optional(),
+  agentId: z25.string().optional(),
   // Agent ID
-  agentVersion: z24.string().optional(),
+  agentVersion: z25.string().optional(),
   // Version specifier (e.g., "latest", "v1", specific ID)
   // Continue session
-  sessionId: z24.string().optional(),
+  sessionId: z25.string().optional(),
   // Resume from checkpoint
-  checkpointId: z24.string().optional(),
+  checkpointId: z25.string().optional(),
   // Required
-  prompt: z24.string().min(1, "Prompt is required"),
+  prompt: z25.string().min(1, "Prompt is required"),
   // Optional configuration
-  variables: z24.record(z24.string(), z24.string()).optional(),
-  secrets: z24.record(z24.string(), z24.string()).optional(),
-  artifactName: z24.string().optional(),
+  variables: z25.record(z25.string(), z25.string()).optional(),
+  secrets: z25.record(z25.string(), z25.string()).optional(),
+  artifactName: z25.string().optional(),
   // Artifact name to mount
-  artifactVersion: z24.string().optional(),
+  artifactVersion: z25.string().optional(),
   // Artifact version (defaults to latest)
-  volumes: z24.record(z24.string(), z24.string()).optional()
+  volumes: z25.record(z25.string(), z25.string()).optional()
   // volume_name -> version
 });
 var runListQuerySchema = listQuerySchema.extend({
   status: publicRunStatusSchema.optional()
 });
-var publicRunsListContract = c20.router({
+var publicRunsListContract = c21.router({
   list: {
     method: "GET",
     path: "/v1/runs",
@@ -3309,13 +3400,13 @@ var publicRunsListContract = c20.router({
     description: "Create and execute a new agent run. Returns 202 Accepted as runs execute asynchronously."
   }
 });
-var publicRunByIdContract = c20.router({
+var publicRunByIdContract = c21.router({
   get: {
     method: "GET",
     path: "/v1/runs/:id",
     headers: authHeadersSchema,
-    pathParams: z24.object({
-      id: z24.string().min(1, "Run ID is required")
+    pathParams: z25.object({
+      id: z25.string().min(1, "Run ID is required")
     }),
     responses: {
       200: publicRunDetailSchema,
@@ -3327,15 +3418,15 @@ var publicRunByIdContract = c20.router({
     description: "Get run details by ID"
   }
 });
-var publicRunCancelContract = c20.router({
+var publicRunCancelContract = c21.router({
   cancel: {
     method: "POST",
     path: "/v1/runs/:id/cancel",
     headers: authHeadersSchema,
-    pathParams: z24.object({
-      id: z24.string().min(1, "Run ID is required")
+    pathParams: z25.object({
+      id: z25.string().min(1, "Run ID is required")
     }),
-    body: z24.undefined(),
+    body: z25.undefined(),
     responses: {
       200: publicRunDetailSchema,
       400: publicApiErrorSchema,
@@ -3348,27 +3439,27 @@ var publicRunCancelContract = c20.router({
     description: "Cancel a pending or running execution"
   }
 });
-var logEntrySchema = z24.object({
+var logEntrySchema = z25.object({
   timestamp: timestampSchema,
-  type: z24.enum(["agent", "system", "network"]),
-  level: z24.enum(["debug", "info", "warn", "error"]),
-  message: z24.string(),
-  metadata: z24.record(z24.string(), z24.unknown()).optional()
+  type: z25.enum(["agent", "system", "network"]),
+  level: z25.enum(["debug", "info", "warn", "error"]),
+  message: z25.string(),
+  metadata: z25.record(z25.string(), z25.unknown()).optional()
 });
 var paginatedLogsSchema = createPaginatedResponseSchema(logEntrySchema);
 var logsQuerySchema = listQuerySchema.extend({
-  type: z24.enum(["agent", "system", "network", "all"]).default("all"),
+  type: z25.enum(["agent", "system", "network", "all"]).default("all"),
   since: timestampSchema.optional(),
   until: timestampSchema.optional(),
-  order: z24.enum(["asc", "desc"]).default("asc")
+  order: z25.enum(["asc", "desc"]).default("asc")
 });
-var publicRunLogsContract = c20.router({
+var publicRunLogsContract = c21.router({
   getLogs: {
     method: "GET",
     path: "/v1/runs/:id/logs",
     headers: authHeadersSchema,
-    pathParams: z24.object({
-      id: z24.string().min(1, "Run ID is required")
+    pathParams: z25.object({
+      id: z25.string().min(1, "Run ID is required")
     }),
     query: logsQuerySchema,
     responses: {
@@ -3381,30 +3472,30 @@ var publicRunLogsContract = c20.router({
     description: "Get unified logs for a run. Combines agent, system, and network logs."
   }
 });
-var metricPointSchema = z24.object({
+var metricPointSchema = z25.object({
   timestamp: timestampSchema,
-  cpuPercent: z24.number(),
-  memoryUsedMb: z24.number(),
-  memoryTotalMb: z24.number(),
-  diskUsedMb: z24.number(),
-  diskTotalMb: z24.number()
-});
-var metricsSummarySchema = z24.object({
-  avgCpuPercent: z24.number(),
-  maxMemoryUsedMb: z24.number(),
-  totalDurationMs: z24.number().nullable()
-});
-var metricsResponseSchema2 = z24.object({
-  data: z24.array(metricPointSchema),
+  cpuPercent: z25.number(),
+  memoryUsedMb: z25.number(),
+  memoryTotalMb: z25.number(),
+  diskUsedMb: z25.number(),
+  diskTotalMb: z25.number()
+});
+var metricsSummarySchema = z25.object({
+  avgCpuPercent: z25.number(),
+  maxMemoryUsedMb: z25.number(),
+  totalDurationMs: z25.number().nullable()
+});
+var metricsResponseSchema2 = z25.object({
+  data: z25.array(metricPointSchema),
   summary: metricsSummarySchema
 });
-var publicRunMetricsContract = c20.router({
+var publicRunMetricsContract = c21.router({
   getMetrics: {
     method: "GET",
     path: "/v1/runs/:id/metrics",
     headers: authHeadersSchema,
-    pathParams: z24.object({
-      id: z24.string().min(1, "Run ID is required")
+    pathParams: z25.object({
+      id: z25.string().min(1, "Run ID is required")
     }),
     responses: {
       200: metricsResponseSchema2,
@@ -3416,7 +3507,7 @@ var publicRunMetricsContract = c20.router({
     description: "Get CPU, memory, and disk metrics for a run"
   }
 });
-var sseEventTypeSchema = z24.enum([
+var sseEventTypeSchema = z25.enum([
   "status",
   // Run status change
   "output",
@@ -3428,26 +3519,26 @@ var sseEventTypeSchema = z24.enum([
   "heartbeat"
   // Keep-alive
 ]);
-var sseEventSchema = z24.object({
+var sseEventSchema = z25.object({
   event: sseEventTypeSchema,
-  data: z24.unknown(),
-  id: z24.string().optional()
+  data: z25.unknown(),
+  id: z25.string().optional()
   // For Last-Event-ID reconnection
 });
-var publicRunEventsContract = c20.router({
+var publicRunEventsContract = c21.router({
   streamEvents: {
     method: "GET",
     path: "/v1/runs/:id/events",
     headers: authHeadersSchema,
-    pathParams: z24.object({
-      id: z24.string().min(1, "Run ID is required")
+    pathParams: z25.object({
+      id: z25.string().min(1, "Run ID is required")
     }),
-    query: z24.object({
-      lastEventId: z24.string().optional()
+    query: z25.object({
+      lastEventId: z25.string().optional()
       // For reconnection
     }),
     responses: {
-      200: z24.any(),
+      200: z25.any(),
       // SSE stream - actual content is text/event-stream
       401: publicApiErrorSchema,
       404: publicApiErrorSchema,
@@ -3459,28 +3550,28 @@ var publicRunEventsContract = c20.router({
 });
 
 // ../../packages/core/src/contracts/public/artifacts.ts
-import { z as z25 } from "zod";
-var c21 = initContract();
-var publicArtifactSchema = z25.object({
-  id: z25.string(),
-  name: z25.string(),
-  currentVersionId: z25.string().nullable(),
-  size: z25.number(),
+import { z as z26 } from "zod";
+var c22 = initContract();
+var publicArtifactSchema = z26.object({
+  id: z26.string(),
+  name: z26.string(),
+  currentVersionId: z26.string().nullable(),
+  size: z26.number(),
   // Total size in bytes
-  fileCount: z25.number(),
+  fileCount: z26.number(),
   createdAt: timestampSchema,
   updatedAt: timestampSchema
 });
-var artifactVersionSchema = z25.object({
-  id: z25.string(),
+var artifactVersionSchema = z26.object({
+  id: z26.string(),
   // SHA-256 content hash
-  artifactId: z25.string(),
-  size: z25.number(),
+  artifactId: z26.string(),
+  size: z26.number(),
   // Size in bytes
-  fileCount: z25.number(),
-  message: z25.string().nullable(),
+  fileCount: z26.number(),
+  message: z26.string().nullable(),
   // Optional commit message
-  createdBy: z25.string(),
+  createdBy: z26.string(),
   createdAt: timestampSchema
 });
 var publicArtifactDetailSchema = publicArtifactSchema.extend({
@@ -3490,7 +3581,7 @@ var paginatedArtifactsSchema = createPaginatedResponseSchema(publicArtifactSchem
 var paginatedArtifactVersionsSchema = createPaginatedResponseSchema(
   artifactVersionSchema
 );
-var publicArtifactsListContract = c21.router({
+var publicArtifactsListContract = c22.router({
   list: {
     method: "GET",
     path: "/v1/artifacts",
@@ -3505,13 +3596,13 @@ var publicArtifactsListContract = c21.router({
     description: "List all artifacts in the current scope with pagination"
   }
 });
-var publicArtifactByIdContract = c21.router({
+var publicArtifactByIdContract = c22.router({
   get: {
     method: "GET",
     path: "/v1/artifacts/:id",
     headers: authHeadersSchema,
-    pathParams: z25.object({
-      id: z25.string().min(1, "Artifact ID is required")
+    pathParams: z26.object({
+      id: z26.string().min(1, "Artifact ID is required")
     }),
     responses: {
       200: publicArtifactDetailSchema,
@@ -3523,13 +3614,13 @@ var publicArtifactByIdContract = c21.router({
     description: "Get artifact details by ID"
   }
 });
-var publicArtifactVersionsContract = c21.router({
+var publicArtifactVersionsContract = c22.router({
   list: {
     method: "GET",
     path: "/v1/artifacts/:id/versions",
     headers: authHeadersSchema,
-    pathParams: z25.object({
-      id: z25.string().min(1, "Artifact ID is required")
+    pathParams: z26.object({
+      id: z26.string().min(1, "Artifact ID is required")
     }),
     query: listQuerySchema,
     responses: {
@@ -3542,20 +3633,20 @@ var publicArtifactVersionsContract = c21.router({
     description: "List all versions of an artifact with pagination"
   }
 });
-var publicArtifactDownloadContract = c21.router({
+var publicArtifactDownloadContract = c22.router({
   download: {
     method: "GET",
     path: "/v1/artifacts/:id/download",
     headers: authHeadersSchema,
-    pathParams: z25.object({
-      id: z25.string().min(1, "Artifact ID is required")
+    pathParams: z26.object({
+      id: z26.string().min(1, "Artifact ID is required")
     }),
-    query: z25.object({
-      versionId: z25.string().optional()
+    query: z26.object({
+      versionId: z26.string().optional()
       // Defaults to current version
     }),
     responses: {
-      302: z25.undefined(),
+      302: z26.undefined(),
       // Redirect to presigned URL
       401: publicApiErrorSchema,
       404: publicApiErrorSchema,
@@ -3567,28 +3658,28 @@ var publicArtifactDownloadContract = c21.router({
 });
 
 // ../../packages/core/src/contracts/public/volumes.ts
-import { z as z26 } from "zod";
-var c22 = initContract();
-var publicVolumeSchema = z26.object({
-  id: z26.string(),
-  name: z26.string(),
-  currentVersionId: z26.string().nullable(),
-  size: z26.number(),
+import { z as z27 } from "zod";
+var c23 = initContract();
+var publicVolumeSchema = z27.object({
+  id: z27.string(),
+  name: z27.string(),
+  currentVersionId: z27.string().nullable(),
+  size: z27.number(),
   // Total size in bytes
-  fileCount: z26.number(),
+  fileCount: z27.number(),
   createdAt: timestampSchema,
   updatedAt: timestampSchema
 });
-var volumeVersionSchema = z26.object({
-  id: z26.string(),
+var volumeVersionSchema = z27.object({
+  id: z27.string(),
   // SHA-256 content hash
-  volumeId: z26.string(),
-  size: z26.number(),
+  volumeId: z27.string(),
+  size: z27.number(),
   // Size in bytes
-  fileCount: z26.number(),
-  message: z26.string().nullable(),
+  fileCount: z27.number(),
+  message: z27.string().nullable(),
   // Optional commit message
-  createdBy: z26.string(),
+  createdBy: z27.string(),
   createdAt: timestampSchema
 });
 var publicVolumeDetailSchema = publicVolumeSchema.extend({
@@ -3596,7 +3687,7 @@ var publicVolumeDetailSchema = publicVolumeSchema.extend({
 });
 var paginatedVolumesSchema = createPaginatedResponseSchema(publicVolumeSchema);
 var paginatedVolumeVersionsSchema = createPaginatedResponseSchema(volumeVersionSchema);
-var publicVolumesListContract = c22.router({
+var publicVolumesListContract = c23.router({
   list: {
     method: "GET",
     path: "/v1/volumes",
@@ -3611,13 +3702,13 @@ var publicVolumesListContract = c22.router({
     description: "List all volumes in the current scope with pagination"
   }
 });
-var publicVolumeByIdContract = c22.router({
+var publicVolumeByIdContract = c23.router({
   get: {
     method: "GET",
     path: "/v1/volumes/:id",
     headers: authHeadersSchema,
-    pathParams: z26.object({
-      id: z26.string().min(1, "Volume ID is required")
+    pathParams: z27.object({
+      id: z27.string().min(1, "Volume ID is required")
     }),
     responses: {
       200: publicVolumeDetailSchema,
@@ -3629,13 +3720,13 @@ var publicVolumeByIdContract = c22.router({
     description: "Get volume details by ID"
   }
 });
-var publicVolumeVersionsContract = c22.router({
+var publicVolumeVersionsContract = c23.router({
   list: {
     method: "GET",
     path: "/v1/volumes/:id/versions",
     headers: authHeadersSchema,
-    pathParams: z26.object({
-      id: z26.string().min(1, "Volume ID is required")
+    pathParams: z27.object({
+      id: z27.string().min(1, "Volume ID is required")
     }),
     query: listQuerySchema,
     responses: {
@@ -3648,20 +3739,20 @@ var publicVolumeVersionsContract = c22.router({
     description: "List all versions of a volume with pagination"
   }
 });
-var publicVolumeDownloadContract = c22.router({
+var publicVolumeDownloadContract = c23.router({
   download: {
     method: "GET",
     path: "/v1/volumes/:id/download",
     headers: authHeadersSchema,
-    pathParams: z26.object({
-      id: z26.string().min(1, "Volume ID is required")
+    pathParams: z27.object({
+      id: z27.string().min(1, "Volume ID is required")
     }),
-    query: z26.object({
-      versionId: z26.string().optional()
+    query: z27.object({
+      versionId: z27.string().optional()
       // Defaults to current version
     }),
     responses: {
-      302: z26.undefined(),
+      302: z27.undefined(),
       // Redirect to presigned URL
       401: publicApiErrorSchema,
       404: publicApiErrorSchema,
@@ -4379,8 +4470,8 @@ async function getUsage(options) {
 }
 
 // src/lib/domain/yaml-validator.ts
-import { z as z27 } from "zod";
-var cliAgentNameSchema = z27.string().min(3, "Agent name must be at least 3 characters").max(64, "Agent name must be 64 characters or less").regex(
+import { z as z28 } from "zod";
+var cliAgentNameSchema = z28.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-]{0,62}[a-zA-Z0-9])?$/,
   "Agent name must start and end with letter or number, and contain only letters, numbers, and hyphens"
 );
@@ -4395,7 +4486,7 @@ var cliAgentDefinitionSchema = agentDefinitionSchema.superRefine(
         const skillUrl = agent.skills[i];
         if (skillUrl && !validateGitHubTreeUrl(skillUrl)) {
           ctx.addIssue({
-            code: z27.ZodIssueCode.custom,
+            code: z28.ZodIssueCode.custom,
             message: `Invalid skill URL: ${skillUrl}. Expected format: https://github.com/{owner}/{repo}/tree/{branch}/{path}`,
             path: ["skills", i]
           });
@@ -4404,15 +4495,15 @@ var cliAgentDefinitionSchema = agentDefinitionSchema.superRefine(
     }
   }
 );
-var cliComposeSchema = z27.object({
-  version: z27.string().min(1, "Missing config.version"),
-  agents: z27.record(cliAgentNameSchema, cliAgentDefinitionSchema),
-  volumes: z27.record(z27.string(), volumeConfigSchema).optional()
+var cliComposeSchema = z28.object({
+  version: z28.string().min(1, "Missing config.version"),
+  agents: z28.record(cliAgentNameSchema, cliAgentDefinitionSchema),
+  volumes: z28.record(z28.string(), volumeConfigSchema).optional()
 }).superRefine((config, ctx) => {
   const agentKeys = Object.keys(config.agents);
   if (agentKeys.length === 0) {
     ctx.addIssue({
-      code: z27.ZodIssueCode.custom,
+      code: z28.ZodIssueCode.custom,
       message: "agents must have at least one agent defined",
       path: ["agents"]
     });
@@ -4420,7 +4511,7 @@ var cliComposeSchema = z27.object({
   }
   if (agentKeys.length > 1) {
     ctx.addIssue({
-      code: z27.ZodIssueCode.custom,
+      code: z28.ZodIssueCode.custom,
       message: "Multiple agents not supported yet. Only one agent allowed.",
       path: ["agents"]
     });
@@ -4432,7 +4523,7 @@ var cliComposeSchema = z27.object({
   if (agentVolumes && agentVolumes.length > 0) {
     if (!config.volumes) {
       ctx.addIssue({
-        code: z27.ZodIssueCode.custom,
+        code: z28.ZodIssueCode.custom,
         message: "Agent references volumes but no volumes section defined. Each volume must have explicit name and version.",
         path: ["volumes"]
       });
@@ -4442,7 +4533,7 @@ var cliComposeSchema = z27.object({
       const parts = volDeclaration.split(":");
       if (parts.length !== 2) {
         ctx.addIssue({
-          code: z27.ZodIssueCode.custom,
+          code: z28.ZodIssueCode.custom,
           message: `Invalid volume declaration: ${volDeclaration}. Expected format: volume-key:/mount/path`,
           path: ["agents", agentName, "volumes"]
         });
@@ -4451,7 +4542,7 @@ var cliComposeSchema = z27.object({
       const volumeKey = parts[0].trim();
       if (!config.volumes[volumeKey]) {
         ctx.addIssue({
-          code: z27.ZodIssueCode.custom,
+          code: z28.ZodIssueCode.custom,
           message: `Volume "${volumeKey}" is not defined in volumes section. Each volume must have explicit name and version.`,
           path: ["volumes", volumeKey]
         });
@@ -5362,9 +5453,15 @@ function getSecretsFromComposeContent(content) {
   const grouped = groupVariablesBySource(refs);
   return new Set(grouped.secrets.map((r) => r.name));
 }
-async function loadAndValidateConfig(configFile) {
+async function loadAndValidateConfig(configFile, porcelainMode) {
   if (!existsSync4(configFile)) {
-    console.error(chalk4.red(`\u2717 Config file not found: ${configFile}`));
+    if (porcelainMode) {
+      console.log(
+        JSON.stringify({ error: `Config file not found: ${configFile}` })
+      );
+    } else {
+      console.error(chalk4.red(`\u2717 Config file not found: ${configFile}`));
+    }
     process.exit(1);
   }
   const content = await readFile4(configFile, "utf8");
@@ -5372,15 +5469,22 @@ async function loadAndValidateConfig(configFile) {
   try {
     config = parseYaml2(content);
   } catch (error) {
-    console.error(chalk4.red("\u2717 Invalid YAML format"));
-    if (error instanceof Error) {
-      console.error(chalk4.dim(`  ${error.message}`));
+    const message = error instanceof Error ? error.message : "Unknown error";
+    if (porcelainMode) {
+      console.log(JSON.stringify({ error: `Invalid YAML format: ${message}` }));
+    } else {
+      console.error(chalk4.red("\u2717 Invalid YAML format"));
+      console.error(chalk4.dim(`  ${message}`));
     }
     process.exit(1);
   }
   const validation = validateAgentCompose(config);
   if (!validation.valid) {
-    console.error(chalk4.red(`\u2717 ${validation.error}`));
+    if (porcelainMode) {
+      console.log(JSON.stringify({ error: validation.error }));
+    } else {
+      console.error(chalk4.red(`\u2717 ${validation.error}`));
+    }
     process.exit(1);
   }
   const cfg = config;
@@ -5416,33 +5520,43 @@ function checkLegacyImageFormat(config) {
     }
   }
 }
-async function uploadAssets(agentName, agent, basePath) {
+async function uploadAssets(agentName, agent, basePath, porcelainMode) {
   if (agent.instructions) {
-    console.log(`Uploading instructions: ${agent.instructions}`);
+    if (!porcelainMode) {
+      console.log(`Uploading instructions: ${agent.instructions}`);
+    }
     const result = await uploadInstructions(
       agentName,
       agent.instructions,
       basePath,
       agent.framework
     );
-    console.log(
-      chalk4.green(
-        `\u2713 Instructions ${result.action === "deduplicated" ? "(unchanged)" : "uploaded"}: ${result.versionId.slice(0, 8)}`
-      )
-    );
+    if (!porcelainMode) {
+      console.log(
+        chalk4.green(
+          `\u2713 Instructions ${result.action === "deduplicated" ? "(unchanged)" : "uploaded"}: ${result.versionId.slice(0, 8)}`
+        )
+      );
+    }
   }
   const skillResults = [];
   if (agent.skills && Array.isArray(agent.skills)) {
-    console.log(`Uploading ${agent.skills.length} skill(s)...`);
+    if (!porcelainMode) {
+      console.log(`Uploading ${agent.skills.length} skill(s)...`);
+    }
     for (const skillUrl of agent.skills) {
-      console.log(chalk4.dim(`  Downloading: ${skillUrl}`));
+      if (!porcelainMode) {
+        console.log(chalk4.dim(`  Downloading: ${skillUrl}`));
+      }
       const result = await uploadSkill(skillUrl);
       skillResults.push(result);
-      console.log(
-        chalk4.green(
-          `  \u2713 Skill ${result.action === "deduplicated" ? "(unchanged)" : "uploaded"}: ${result.skillName} (${result.versionId.slice(0, 8)})`
-        )
-      );
+      if (!porcelainMode) {
+        console.log(
+          chalk4.green(
+            `  \u2713 Skill ${result.action === "deduplicated" ? "(unchanged)" : "uploaded"}: ${result.skillName} (${result.versionId.slice(0, 8)})`
+          )
+        );
+      }
     }
   }
   return skillResults;
@@ -5488,36 +5602,48 @@ async function displayAndConfirmVariables(variables, options) {
   if (newSecrets.length === 0 && newVars.length === 0) {
     return true;
   }
-  console.log();
-  console.log(
-    chalk4.bold("Skills require the following environment variables:")
-  );
-  console.log();
-  if (newSecrets.length > 0) {
-    console.log(chalk4.cyan("  Secrets:"));
-    for (const [name, skills] of newSecrets) {
-      const isNew = trulyNewSecrets.includes(name);
-      const newMarker = isNew ? chalk4.yellow(" (new)") : "";
-      console.log(`    ${name.padEnd(24)}${newMarker} <- ${skills.join(", ")}`);
+  if (!options.porcelain) {
+    console.log();
+    console.log(
+      chalk4.bold("Skills require the following environment variables:")
+    );
+    console.log();
+    if (newSecrets.length > 0) {
+      console.log(chalk4.cyan("  Secrets:"));
+      for (const [name, skills] of newSecrets) {
+        const isNew = trulyNewSecrets.includes(name);
+        const newMarker = isNew ? chalk4.yellow(" (new)") : "";
+        console.log(
+          `    ${name.padEnd(24)}${newMarker} <- ${skills.join(", ")}`
+        );
+      }
     }
-  }
-  if (newVars.length > 0) {
-    console.log(chalk4.cyan("  Vars:"));
-    for (const [name, skills] of newVars) {
-      console.log(`    ${name.padEnd(24)} <- ${skills.join(", ")}`);
+    if (newVars.length > 0) {
+      console.log(chalk4.cyan("  Vars:"));
+      for (const [name, skills] of newVars) {
+        console.log(`    ${name.padEnd(24)} <- ${skills.join(", ")}`);
+      }
     }
+    console.log();
   }
-  console.log();
   if (trulyNewSecrets.length > 0 && !options.yes) {
     if (!isInteractive()) {
-      console.error(
-        chalk4.red(`\u2717 New secrets detected: ${trulyNewSecrets.join(", ")}`)
-      );
-      console.error(
-        chalk4.dim(
-          "  Use --yes flag to approve new secrets in non-interactive mode."
-        )
-      );
+      if (options.porcelain) {
+        console.log(
+          JSON.stringify({
+            error: `New secrets detected: ${trulyNewSecrets.join(", ")}. Use --yes flag to approve.`
+          })
+        );
+      } else {
+        console.error(
+          chalk4.red(`\u2717 New secrets detected: ${trulyNewSecrets.join(", ")}`)
+        );
+        console.error(
+          chalk4.dim(
+            "  Use --yes flag to approve new secrets in non-interactive mode."
+          )
+        );
+      }
       process.exit(1);
     }
     const confirmed = await promptConfirm(
@@ -5525,7 +5651,9 @@ async function displayAndConfirmVariables(variables, options) {
       true
     );
     if (!confirmed) {
-      console.log(chalk4.yellow("Compose cancelled"));
+      if (!options.porcelain) {
+        console.log(chalk4.yellow("Compose cancelled"));
+      }
       return false;
     }
   }
@@ -5553,57 +5681,94 @@ async function finalizeCompose(config, agent, variables, options) {
     process.exit(0);
   }
   mergeSkillVariables(agent, variables);
-  console.log("Uploading compose...");
+  if (!options.porcelain) {
+    console.log("Uploading compose...");
+  }
   const response = await createOrUpdateCompose({ content: config });
   const scopeResponse = await getScope();
   const shortVersionId = response.versionId.slice(0, 8);
   const displayName = `${scopeResponse.slug}/${response.name}`;
-  if (response.action === "created") {
-    console.log(chalk4.green(`\u2713 Compose created: ${displayName}`));
-  } else {
-    console.log(chalk4.green(`\u2713 Compose version exists: ${displayName}`));
+  const result = {
+    composeId: response.composeId,
+    composeName: response.name,
+    versionId: response.versionId,
+    action: response.action,
+    displayName
+  };
+  if (!options.porcelain) {
+    if (response.action === "created") {
+      console.log(chalk4.green(`\u2713 Compose created: ${displayName}`));
+    } else {
+      console.log(chalk4.green(`\u2713 Compose version exists: ${displayName}`));
+    }
+    console.log(chalk4.dim(`  Version: ${shortVersionId}`));
+    console.log();
+    console.log("  Run your agent:");
+    console.log(
+      chalk4.cyan(
+        `    vm0 run ${displayName}:${shortVersionId} --artifact-name <artifact> "your prompt"`
+      )
+    );
   }
-  console.log(chalk4.dim(`  Version: ${shortVersionId}`));
-  console.log();
-  console.log("  Run your agent:");
-  console.log(
-    chalk4.cyan(
-      `    vm0 run ${displayName}:${shortVersionId} --artifact-name <artifact> "your prompt"`
-    )
-  );
   if (options.autoUpdate !== false) {
-    await silentUpgradeAfterCommand("9.21.0");
+    await silentUpgradeAfterCommand("9.23.0");
   }
+  return result;
 }
 async function handleGitHubCompose(url, options) {
-  console.log(`Downloading from GitHub: ${url}`);
+  if (!options.porcelain) {
+    console.log(`Downloading from GitHub: ${url}`);
+  }
   const { dir: downloadedDir, tempRoot } = await downloadGitHubDirectory(url);
   const configFile = join6(downloadedDir, "vm0.yaml");
   try {
     if (!existsSync4(configFile)) {
-      console.error(chalk4.red(`\u2717 vm0.yaml not found in the GitHub directory`));
-      console.error(chalk4.dim(`  URL: ${url}`));
+      if (options.porcelain) {
+        console.log(
+          JSON.stringify({
+            error: "vm0.yaml not found in the GitHub directory"
+          })
+        );
+      } else {
+        console.error(
+          chalk4.red(`\u2717 vm0.yaml not found in the GitHub directory`)
+        );
+        console.error(chalk4.dim(`  URL: ${url}`));
+      }
       process.exit(1);
     }
-    const { config, agentName, agent, basePath } = await loadAndValidateConfig(configFile);
+    const { config, agentName, agent, basePath } = await loadAndValidateConfig(
+      configFile,
+      options.porcelain
+    );
     const existingCompose = await getComposeByName(agentName);
     if (existingCompose) {
-      console.log();
-      console.log(
-        chalk4.yellow(`\u26A0 An agent named "${agentName}" already exists.`)
-      );
+      if (!options.porcelain) {
+        console.log();
+        console.log(
+          chalk4.yellow(`\u26A0 An agent named "${agentName}" already exists.`)
+        );
+      }
       if (!isInteractive()) {
         if (!options.yes) {
-          console.error(
-            chalk4.red(
-              `\u2717 Cannot overwrite existing agent in non-interactive mode`
-            )
-          );
-          console.error(
-            chalk4.dim(
-              `  Use --yes flag to confirm overwriting the existing agent.`
-            )
-          );
+          if (options.porcelain) {
+            console.log(
+              JSON.stringify({
+                error: "Cannot overwrite existing agent in non-interactive mode"
+              })
+            );
+          } else {
+            console.error(
+              chalk4.red(
+                `\u2717 Cannot overwrite existing agent in non-interactive mode`
+              )
+            );
+            console.error(
+              chalk4.dim(
+                `  Use --yes flag to confirm overwriting the existing agent.`
+              )
+            );
+          }
           process.exit(1);
         }
       } else {
@@ -5612,31 +5777,48 @@ async function handleGitHubCompose(url, options) {
           false
         );
         if (!confirmed) {
-          console.log(chalk4.yellow("Compose cancelled."));
+          if (!options.porcelain) {
+            console.log(chalk4.yellow("Compose cancelled."));
+          }
           process.exit(0);
         }
       }
     }
     if (hasVolumes(config)) {
-      console.error(
-        chalk4.red(`\u2717 Volumes are not supported for GitHub URL compose`)
-      );
-      console.error(
-        chalk4.dim(
-          `  Clone the repository locally and run: vm0 compose ./path/to/vm0.yaml`
-        )
-      );
+      if (options.porcelain) {
+        console.log(
+          JSON.stringify({
+            error: "Volumes are not supported for GitHub URL compose"
+          })
+        );
+      } else {
+        console.error(
+          chalk4.red(`\u2717 Volumes are not supported for GitHub URL compose`)
+        );
+        console.error(
+          chalk4.dim(
+            `  Clone the repository locally and run: vm0 compose ./path/to/vm0.yaml`
+          )
+        );
+      }
       process.exit(1);
     }
-    checkLegacyImageFormat(config);
-    const skillResults = await uploadAssets(agentName, agent, basePath);
+    if (!options.porcelain) {
+      checkLegacyImageFormat(config);
+    }
+    const skillResults = await uploadAssets(
+      agentName,
+      agent,
+      basePath,
+      options.porcelain
+    );
     const environment = agent.environment || {};
     const variables = await collectSkillVariables(
       skillResults,
       environment,
       agentName
     );
-    await finalizeCompose(config, agent, variables, options);
+    return await finalizeCompose(config, agent, variables, options);
   } finally {
     await rm3(tempRoot, { recursive: true, force: true });
   }
@@ -5647,42 +5829,73 @@ var composeCommand = new Command7().name("compose").description("Create or updat
 ).option("-y, --yes", "Skip confirmation prompts for skill requirements").option(
   "--experimental-shared-compose",
   "Enable GitHub URL compose (experimental)"
+).option(
+  "--porcelain",
+  "Output stable JSON for scripts (suppresses interactive output)"
 ).addOption(new Option("--no-auto-update").hideHelp()).action(
   async (configFile, options) => {
     const resolvedConfigFile = configFile ?? DEFAULT_CONFIG_FILE;
+    if (options.porcelain) {
+      options.yes = true;
+      options.autoUpdate = false;
+    }
     try {
+      let result;
       if (isGitHubUrl(resolvedConfigFile)) {
         if (!options.experimentalSharedCompose) {
-          console.error(
-            chalk4.red(
-              "\u2717 Composing shared agents requires --experimental-shared-compose flag"
-            )
-          );
-          console.error();
-          console.error(
-            chalk4.dim(
-              "  Composing agents from other users carries security risks."
-            )
-          );
-          console.error(
-            chalk4.dim("  Only compose agents from users you trust.")
-          );
+          if (options.porcelain) {
+            console.log(
+              JSON.stringify({
+                error: "Composing shared agents requires --experimental-shared-compose flag"
+              })
+            );
+          } else {
+            console.error(
+              chalk4.red(
+                "\u2717 Composing shared agents requires --experimental-shared-compose flag"
+              )
+            );
+            console.error();
+            console.error(
+              chalk4.dim(
+                "  Composing agents from other users carries security risks."
+              )
+            );
+            console.error(
+              chalk4.dim("  Only compose agents from users you trust.")
+            );
+          }
           process.exit(1);
         }
-        await handleGitHubCompose(resolvedConfigFile, options);
+        result = await handleGitHubCompose(resolvedConfigFile, options);
       } else {
-        const { config, agentName, agent, basePath } = await loadAndValidateConfig(resolvedConfigFile);
-        checkLegacyImageFormat(config);
-        const skillResults = await uploadAssets(agentName, agent, basePath);
+        const { config, agentName, agent, basePath } = await loadAndValidateConfig(resolvedConfigFile, options.porcelain);
+        if (!options.porcelain) {
+          checkLegacyImageFormat(config);
+        }
+        const skillResults = await uploadAssets(
+          agentName,
+          agent,
+          basePath,
+          options.porcelain
+        );
         const environment = agent.environment || {};
         const variables = await collectSkillVariables(
           skillResults,
           environment,
           agentName
         );
-        await finalizeCompose(config, agent, variables, options);
+        result = await finalizeCompose(config, agent, variables, options);
+      }
+      if (options.porcelain) {
+        console.log(JSON.stringify(result));
       }
     } catch (error) {
+      if (options.porcelain) {
+        const message = error instanceof Error ? error.message : "An unexpected error occurred";
+        console.log(JSON.stringify({ error: message }));
+        process.exit(1);
+      }
       if (error instanceof Error) {
         if (error.message.includes("Not authenticated")) {
           console.error(
@@ -5961,8 +6174,8 @@ var EventRenderer = class _EventRenderer {
   /**
    * Format timestamp for display (without milliseconds, matching metrics format)
    */
-  static formatTimestamp(timestamp) {
-    return timestamp.toISOString().replace(/\.\d{3}Z$/, "Z");
+  static formatTimestamp(timestamp2) {
+    return timestamp2.toISOString().replace(/\.\d{3}Z$/, "Z");
   }
   /**
    * Render a parsed event to console
@@ -6435,9 +6648,9 @@ var CodexEventParser = class {
       }
     }
     if (itemType === "file_change" && item.changes && item.changes.length > 0) {
-      const changes = item.changes.map((c23) => {
-        const action = c23.kind === "add" ? "Created" : c23.kind === "modify" ? "Modified" : "Deleted";
-        return `${action}: ${c23.path}`;
+      const changes = item.changes.map((c24) => {
+        const action = c24.kind === "add" ? "Created" : c24.kind === "modify" ? "Modified" : "Deleted";
+        return `${action}: ${c24.path}`;
       }).join("\n");
       return {
         type: "text",
@@ -6591,9 +6804,9 @@ var CodexEventRenderer = class {
       return;
     }
     if (itemType === "file_change" && item.changes && item.changes.length > 0) {
-      const summary = item.changes.map((c23) => {
-        const icon = c23.kind === "add" ? "+" : c23.kind === "delete" ? "-" : "~";
-        return `${icon}${c23.path}`;
+      const summary = item.changes.map((c24) => {
+        const icon = c24.kind === "add" ? "+" : c24.kind === "delete" ? "-" : "~";
+        return `${icon}${c24.path}`;
       }).join(", ");
       console.log(chalk7.green("[files]") + ` ${summary}`);
       return;
@@ -7940,7 +8153,7 @@ var mainRunCommand = new Command8().name("run").description("Run an agent").argu
       }
       showNextSteps(result);
       if (options.autoUpdate !== false) {
-        await silentUpgradeAfterCommand("9.21.0");
+        await silentUpgradeAfterCommand("9.23.0");
       }
     } catch (error) {
       handleRunError(error, identifier);
@@ -9447,7 +9660,7 @@ var cookAction = new Command27().name("cook").description("Quick start: prepare,
 ).option("-y, --yes", "Skip confirmation prompts").option("-v, --verbose", "Show full tool inputs and outputs").addOption(new Option5("--debug-no-mock-claude").hideHelp()).addOption(new Option5("--no-auto-update").hideHelp()).action(
   async (prompt, options) => {
     if (options.autoUpdate !== false) {
-      const shouldExit = await checkAndUpgrade("9.21.0", prompt);
+      const shouldExit = await checkAndUpgrade("9.23.0", prompt);
       if (shouldExit) {
         process.exit(0);
       }
@@ -9647,11 +9860,11 @@ function parseTime(timeStr) {
     return parseRelativeTime(value, unit);
   }
   if (/^\d+$/.test(timeStr)) {
-    const timestamp = parseInt(timeStr, 10);
-    if (timestamp < 1e10) {
-      return timestamp * 1e3;
+    const timestamp2 = parseInt(timeStr, 10);
+    if (timestamp2 < 1e10) {
+      return timestamp2 * 1e3;
     }
-    return timestamp;
+    return timestamp2;
   }
   const date = new Date(timeStr);
   if (!isNaN(date.getTime())) {
@@ -10162,7 +10375,7 @@ var listCommand4 = new Command36().name("list").alias("ls").description("List al
       );
       return;
     }
-    const nameWidth = Math.max(4, ...data.composes.map((c23) => c23.name.length));
+    const nameWidth = Math.max(4, ...data.composes.map((c24) => c24.name.length));
     const header = ["NAME".padEnd(nameWidth), "VERSION", "UPDATED"].join(
       "  "
     );
@@ -11136,7 +11349,7 @@ async function gatherFrequency(optionFrequency, existingFrequency) {
     );
     process.exit(1);
   }
-  const defaultIndex = existingFrequency ? FREQUENCY_CHOICES.findIndex((c23) => c23.value === existingFrequency) : 0;
+  const defaultIndex = existingFrequency ? FREQUENCY_CHOICES.findIndex((c24) => c24.value === existingFrequency) : 0;
   frequency = await promptSelect(
     "Schedule frequency",
     FREQUENCY_CHOICES,
@@ -11165,7 +11378,7 @@ async function gatherDay(frequency, optionDay, existingDay) {
     process.exit(1);
   }
   if (frequency === "weekly") {
-    const defaultDayIndex = existingDay !== void 0 ? DAY_OF_WEEK_CHOICES.findIndex((c23) => c23.value === existingDay) : 0;
+    const defaultDayIndex = existingDay !== void 0 ? DAY_OF_WEEK_CHOICES.findIndex((c24) => c24.value === existingDay) : 0;
     const day2 = await promptSelect(
       "Day of week",
       DAY_OF_WEEK_CHOICES,
@@ -13348,16 +13561,16 @@ async function handleModelProvider(ctx) {
     const providerType = await step.prompt(
       () => promptSelect(
         "Select provider type:",
-        choices.map((c23) => ({
-          title: c23.label,
-          value: c23.type
+        choices.map((c24) => ({
+          title: c24.label,
+          value: c24.type
         }))
       )
     );
     if (!providerType) {
       process.exit(0);
     }
-    const selectedChoice = choices.find((c23) => c23.type === providerType);
+    const selectedChoice = choices.find((c24) => c24.type === providerType);
     if (selectedChoice?.helpText) {
       for (const line of selectedChoice.helpText.split("\n")) {
         step.detail(chalk66.dim(line));
@@ -13543,9 +13756,168 @@ var setupClaudeCommand = new Command67().name("setup-claude").description("Insta
   );
 });
 
+// src/commands/dev-tool/index.ts
+import { Command as Command69 } from "commander";
+
+// src/commands/dev-tool/compose.ts
+import { Command as Command68 } from "commander";
+import chalk68 from "chalk";
+import { initClient as initClient11 } from "@ts-rest/core";
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function timestamp() {
+  return (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
+}
+async function createComposeJob(githubUrl, overwrite) {
+  const config = await getClientConfig();
+  const client = initClient11(composeJobsMainContract, config);
+  const result = await client.create({
+    body: { githubUrl, overwrite }
+  });
+  if (result.status === 200 || result.status === 201) {
+    return {
+      jobId: result.body.jobId,
+      status: result.body.status
+    };
+  }
+  if (result.status === 400 || result.status === 401) {
+    throw new Error(result.body.error.message);
+  }
+  throw new Error(`Unexpected response: ${result.status}`);
+}
+async function getComposeJobStatus(jobId) {
+  const config = await getClientConfig();
+  const client = initClient11(composeJobsByIdContract, config);
+  const result = await client.getById({
+    params: { jobId }
+  });
+  if (result.status === 200) {
+    return {
+      status: result.body.status,
+      result: result.body.result,
+      error: result.body.error
+    };
+  }
+  if (result.status === 404) {
+    throw new Error(`Job not found: ${jobId}`);
+  }
+  if (result.status === 401) {
+    throw new Error(result.body.error.message);
+  }
+  throw new Error(`Unexpected response: ${result.status}`);
+}
+async function pollUntilComplete(jobId, intervalMs, timeoutMs, jsonMode) {
+  const startTime = Date.now();
+  while (Date.now() - startTime < timeoutMs) {
+    const job = await getComposeJobStatus(jobId);
+    if (!jsonMode) {
+      console.log(
+        chalk68.dim(`[${timestamp()}] Polling... status=${job.status}`)
+      );
+    }
+    if (job.status === "completed" || job.status === "failed") {
+      return job;
+    }
+    await sleep2(intervalMs);
+  }
+  throw new Error(`Timeout after ${timeoutMs / 1e3} seconds`);
+}
+var composeCommand2 = new Command68().name("compose").description("Test server-side GitHub compose API").argument("<github-url>", "GitHub URL to compose from").option("--overwrite", "Overwrite existing compose", false).option(
+  "--interval <seconds>",
+  "Polling interval in seconds",
+  (v) => parseInt(v, 10),
+  5
+).option(
+  "--timeout <seconds>",
+  "Maximum wait time in seconds",
+  (v) => parseInt(v, 10),
+  300
+).option("--json", "Output result as JSON").action(
+  async (githubUrl, options) => {
+    const intervalMs = options.interval * 1e3;
+    const timeoutMs = options.timeout * 1e3;
+    try {
+      if (!options.json) {
+        console.log("Creating compose job...");
+      }
+      const { jobId, status: initialStatus } = await createComposeJob(
+        githubUrl,
+        options.overwrite
+      );
+      if (!options.json) {
+        console.log(`Job ID: ${chalk68.cyan(jobId)}`);
+        console.log();
+      }
+      if (initialStatus === "completed" || initialStatus === "failed") {
+        const finalJob2 = await getComposeJobStatus(jobId);
+        if (options.json) {
+          console.log(JSON.stringify(finalJob2, null, 2));
+        } else {
+          displayResult(finalJob2);
+        }
+        process.exit(finalJob2.status === "completed" ? 0 : 1);
+      }
+      const finalJob = await pollUntilComplete(
+        jobId,
+        intervalMs,
+        timeoutMs,
+        !!options.json
+      );
+      if (options.json) {
+        console.log(JSON.stringify(finalJob, null, 2));
+      } else {
+        console.log();
+        displayResult(finalJob);
+      }
+      process.exit(finalJob.status === "completed" ? 0 : 1);
+    } catch (error) {
+      if (options.json) {
+        console.log(
+          JSON.stringify({
+            error: error instanceof Error ? error.message : String(error)
+          })
+        );
+      } else {
+        console.error(
+          chalk68.red(
+            `\u2717 ${error instanceof Error ? error.message : String(error)}`
+          )
+        );
+      }
+      process.exit(1);
+    }
+  }
+);
+function displayResult(job) {
+  if (job.status === "completed" && job.result) {
+    console.log(chalk68.green("\u2713 Compose completed!"));
+    console.log(`  Compose ID: ${chalk68.cyan(job.result.composeId)}`);
+    console.log(`  Name: ${chalk68.cyan(job.result.composeName)}`);
+    console.log(`  Version: ${chalk68.cyan(job.result.versionId.slice(0, 8))}`);
+    if (job.result.warnings.length > 0) {
+      console.log();
+      console.log(chalk68.yellow("  Warnings:"));
+      for (const warning of job.result.warnings) {
+        console.log(chalk68.yellow(`    - ${warning}`));
+      }
+    }
+  } else if (job.status === "failed") {
+    console.log(chalk68.red("\u2717 Compose failed!"));
+    if (job.error) {
+      console.log(`  Error: ${chalk68.red(job.error)}`);
+    }
+  } else {
+    console.log(`Status: ${job.status}`);
+  }
+}
+
+// src/commands/dev-tool/index.ts
+var devToolCommand = new Command69().name("dev-tool").description("Developer tools for testing and debugging").addCommand(composeCommand2);
+
 // src/index.ts
-var program = new Command68();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.21.0");
+var program = new Command70();
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.23.0");
 program.addCommand(authCommand);
 program.addCommand(infoCommand);
 program.addCommand(composeCommand);
@@ -13564,6 +13936,7 @@ program.addCommand(variableCommand);
 program.addCommand(modelProviderCommand);
 program.addCommand(onboardCommand);
 program.addCommand(setupClaudeCommand);
+program.addCommand(devToolCommand, { hidden: true });
 if (process.argv[1]?.endsWith("index.js") || process.argv[1]?.endsWith("index.ts") || process.argv[1]?.endsWith("vm0")) {
   program.parse();
 }