@vm0/cli 9.22.0 → 9.23.0

package/index.js

@@ -61,7 +61,7 @@ if (DSN) {
     }
   });
   Sentry.setContext("cli", {
-    version: "9.22.0",
+    version: "9.23.0",
     command: process.argv.slice(2).join(" ")
   });
   Sentry.setContext("runtime", {
@@ -72,7 +72,7 @@ if (DSN) {
 }
 
 // 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";
@@ -3138,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",
@@ -3175,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,
@@ -3193,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: {
@@ -3214,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",
@@ -3224,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",
@@ -3303,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,
@@ -3321,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,
@@ -3342,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: {
@@ -3375,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,
@@ -3410,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",
@@ -3422,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,
@@ -3453,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({
@@ -3484,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",
@@ -3499,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,
@@ -3517,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: {
@@ -3536,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,
@@ -3561,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({
@@ -3590,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",
@@ -3605,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,
@@ -3623,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: {
@@ -3642,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,
@@ -4373,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"
 );
@@ -4389,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]
           });
@@ -4398,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"]
     });
@@ -4414,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"]
     });
@@ -4426,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"]
       });
@@ -4436,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"]
         });
@@ -4445,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]
         });
@@ -5614,7 +5711,7 @@ async function finalizeCompose(config, agent, variables, options) {
     );
   }
   if (options.autoUpdate !== false) {
-    await silentUpgradeAfterCommand("9.22.0");
+    await silentUpgradeAfterCommand("9.23.0");
   }
   return result;
 }
@@ -6077,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
@@ -6551,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",
@@ -6707,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;
@@ -8056,7 +8153,7 @@ var mainRunCommand = new Command8().name("run").description("Run an agent").argu
       }
       showNextSteps(result);
       if (options.autoUpdate !== false) {
-        await silentUpgradeAfterCommand("9.22.0");
+        await silentUpgradeAfterCommand("9.23.0");
       }
     } catch (error) {
       handleRunError(error, identifier);
@@ -9563,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.22.0", prompt);
+      const shouldExit = await checkAndUpgrade("9.23.0", prompt);
       if (shouldExit) {
         process.exit(0);
       }
@@ -9763,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())) {
@@ -10278,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(
       "  "
     );
@@ -11252,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,
@@ -11281,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,
@@ -13464,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));
@@ -13659,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.22.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);
@@ -13680,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();
 }

package/package.json

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