@vm0/cli 9.208.1 → 9.209.0

package/index.js

@@ -74,7 +74,7 @@ import {
   uo,
   volumeConfigSchema,
   withErrorHandler
-} from "./chunk-HJC27CUJ.js";
+} from "./chunk-QXLY7TX2.js";
 import {
   external_exports
 } from "./chunk-NUMM3WMG.js";
@@ -411,7 +411,7 @@ function getConfigPath() {
   return join(os.homedir(), ".vm0", "config.json");
 }
 var infoCommand = new Command().name("info").description("Display environment and debug information").action(async () => {
-  console.log(source_default.bold(`VM0 CLI v${"9.208.1"}`));
+  console.log(source_default.bold(`VM0 CLI v${"9.209.0"}`));
   console.log();
   const config = await loadConfig();
   const hasEnvToken = !!process.env.VM0_TOKEN;
@@ -1113,7 +1113,7 @@ var composeCommand = new Command().name("compose").description("Create or update
         options.autoUpdate = false;
       }
       if (options.autoUpdate !== false) {
-        await startSilentUpgrade("9.208.1");
+        await startSilentUpgrade("9.209.0");
       }
       try {
         const { config, agentName, agent, basePath } = await loadAndValidateConfig(resolvedConfigFile);
@@ -1210,7 +1210,7 @@ var mainRunCommand = new Command().name("run").description("Run an agent").argum
   withErrorHandler(
     async (identifier, prompt, options) => {
       if (options.autoUpdate !== false) {
-        await startSilentUpgrade("9.208.1");
+        await startSilentUpgrade("9.209.0");
       }
       const { name, version } = parseIdentifier(identifier);
       let composeId;
@@ -3016,13 +3016,13 @@ var upgradeCommand = new Command().name("upgrade").description("Upgrade vm0 CLI
     if (latestVersion === null) {
       throw new Error("Could not check for updates. Please try again later.");
     }
-    if (latestVersion === "9.208.1") {
-      console.log(source_default.green(`\u2713 Already up to date (${"9.208.1"})`));
+    if (latestVersion === "9.209.0") {
+      console.log(source_default.green(`\u2713 Already up to date (${"9.209.0"})`));
       return;
     }
     console.log(
       source_default.yellow(
-        `Current version: ${"9.208.1"} -> Latest version: ${latestVersion}`
+        `Current version: ${"9.209.0"} -> Latest version: ${latestVersion}`
       )
     );
     console.log();
@@ -3049,7 +3049,7 @@ var upgradeCommand = new Command().name("upgrade").description("Upgrade vm0 CLI
     const success = await performUpgrade(packageManager);
     if (success) {
       console.log(
-        source_default.green(`\u2713 Upgraded from ${"9.208.1"} to ${latestVersion}`)
+        source_default.green(`\u2713 Upgraded from ${"9.209.0"} to ${latestVersion}`)
       );
       return;
     }
@@ -3116,7 +3116,7 @@ var whoamiCommand = new Command().name("whoami").description("Show current ident
 
 // src/index.ts
 var program = new Command();
-program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.208.1");
+program.name("vm0").description("VM0 CLI - Build and run agents with natural language").version("9.209.0");
 program.addCommand(authCommand);
 program.addCommand(infoCommand);
 program.addCommand(composeCommand);

package/package.json

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

package/zero.js

@@ -178,7 +178,7 @@ import {
   uploadWebFile,
   upsertZeroOrgModelProvider,
   withErrorHandler
-} from "./chunk-HJC27CUJ.js";
+} from "./chunk-QXLY7TX2.js";
 import {
   CONNECTOR_TYPES,
   CONNECTOR_TYPE_KEYS,
@@ -14962,9 +14962,13 @@ Notes:
 
 // src/commands/zero/maps/index.ts
 init_esm_shims();
+import { mkdir as mkdir3, writeFile as writeFile3 } from "fs/promises";
+import { dirname as dirname3 } from "path";
 var TRAVEL_MODES = ["driving", "walking", "bicycling", "transit"];
 var PLACE_SEARCH_FIELDSETS = ["pro", "enterprise"];
 var PLACE_DETAIL_FIELDSETS = ["essentials", "pro", "enterprise"];
+var OSM_LAYERS = ["roads", "buildings", "water", "parks"];
+var OSM_STYLES = ["standard", "guide"];
 function parseLatitude(value) {
   const latitude = Number(value);
   if (!Number.isFinite(latitude) || latitude < -90 || latitude > 90) {
@@ -14995,6 +14999,15 @@ function parseLimit4(value) {
   }
   return limit;
 }
+function parseIntegerInRange(value, min, max) {
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed < min || parsed > max) {
+    throw new InvalidArgumentError(
+      `value must be an integer from ${min} to ${max}`
+    );
+  }
+  return parsed;
+}
 function parseTravelMode(value) {
   if (TRAVEL_MODES.includes(value)) {
     return value;
@@ -15019,8 +15032,142 @@ function parsePlaceDetailFields(value) {
     `fields must be one of: ${PLACE_DETAIL_FIELDSETS.join(", ")}`
   );
 }
-function renderMapsResponse(label, response) {
-  console.log(source_default.green(`\u2713 ${label}`));
+function parseBBox(value) {
+  const parts = value.split(",").map((part) => {
+    return part.trim();
+  });
+  if (parts.length !== 4) {
+    throw new InvalidArgumentError("bbox must be west,south,east,north");
+  }
+  const [westRaw, southRaw, eastRaw, northRaw] = parts;
+  if (!westRaw || !southRaw || !eastRaw || !northRaw) {
+    throw new InvalidArgumentError("bbox must be west,south,east,north");
+  }
+  const bbox = {
+    west: parseLongitude(westRaw),
+    south: parseLatitude(southRaw),
+    east: parseLongitude(eastRaw),
+    north: parseLatitude(northRaw)
+  };
+  if (bbox.east <= bbox.west || bbox.north <= bbox.south) {
+    throw new InvalidArgumentError(
+      "bbox east/north must be greater than west/south"
+    );
+  }
+  return bbox;
+}
+function parseLatLng(value) {
+  const parts = value.split(",").map((part) => {
+    return part.trim();
+  });
+  if (parts.length !== 2 || !parts[0] || !parts[1]) {
+    throw new InvalidArgumentError("coordinates must be lat,lng");
+  }
+  return {
+    lat: parseLatitude(parts[0]),
+    lng: parseLongitude(parts[1])
+  };
+}
+function parseOsmLayers(value) {
+  const layers = [
+    ...new Set(
+      value.split(",").map((layer) => {
+        return layer.trim();
+      }).filter(Boolean)
+    )
+  ];
+  if (layers.length === 0) {
+    throw new InvalidArgumentError("layers must include at least one value");
+  }
+  const invalid = layers.find((layer) => {
+    return !OSM_LAYERS.includes(layer);
+  });
+  if (invalid) {
+    throw new InvalidArgumentError(
+      `layers must be drawn from: ${OSM_LAYERS.join(", ")}`
+    );
+  }
+  return layers;
+}
+function parseOsmStyle(value) {
+  if (OSM_STYLES.includes(value)) {
+    return value;
+  }
+  throw new InvalidArgumentError(
+    `style must be one of: ${OSM_STYLES.join(", ")}`
+  );
+}
+function parseOsmMarker(value) {
+  const [latRaw, lngRaw, ...labelParts] = value.split(",");
+  if (!latRaw?.trim() || !lngRaw?.trim()) {
+    throw new InvalidArgumentError("marker must be lat,lng or lat,lng,label");
+  }
+  const label = labelParts.join(",").trim();
+  return {
+    lat: parseLatitude(latRaw.trim()),
+    lng: parseLongitude(lngRaw.trim()),
+    ...label ? { label } : {}
+  };
+}
+function collectOsmMarker(value, previous) {
+  return [...previous, parseOsmMarker(value)];
+}
+function osmAreaPayload(options) {
+  const hasBbox = options.bbox !== void 0;
+  const hasCenterRadius = options.center !== void 0 && options.radius !== void 0;
+  if (hasBbox === hasCenterRadius) {
+    throw new Error("Provide either --bbox or --center with --radius");
+  }
+  return {
+    ...options.bbox ? { bbox: options.bbox } : {},
+    ...options.center ? { center: options.center } : {},
+    ...options.radius !== void 0 ? { radiusMeters: options.radius } : {},
+    layers: options.layers
+  };
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resultRecord(response) {
+  if (!isRecord3(response.result)) {
+    throw new Error("Zero Maps response did not include an object result");
+  }
+  return response.result;
+}
+function stringField2(value, key) {
+  const field = value[key];
+  return typeof field === "string" ? field : void 0;
+}
+function numberField(value, key) {
+  const field = value[key];
+  return typeof field === "number" ? field : void 0;
+}
+async function writeOutputFile(outputPath, content) {
+  await mkdir3(dirname3(outputPath), { recursive: true });
+  await writeFile3(outputPath, content);
+}
+async function writeOsmGeoJson(outputPath, response) {
+  const result = resultRecord(response);
+  if (!("geojson" in result)) {
+    throw new Error("Zero Maps OSM download response did not include geojson");
+  }
+  await writeOutputFile(
+    outputPath,
+    `${JSON.stringify(result.geojson, null, 2)}
+`
+  );
+}
+async function writeOsmPng(outputPath, response) {
+  const result = resultRecord(response);
+  const image = result.image;
+  if (!isRecord3(image) || typeof image.base64 !== "string") {
+    throw new Error(
+      "Zero Maps OSM render response did not include a PNG image"
+    );
+  }
+  await writeOutputFile(outputPath, Buffer.from(image.base64, "base64"));
+}
+function renderMapsMetadata(response) {
   if (response.provider) {
     console.log(source_default.dim(`  Provider: ${response.provider}`));
   }
@@ -15033,9 +15180,27 @@ function renderMapsResponse(label, response) {
   if (response.creditsCharged !== void 0) {
     console.log(source_default.dim(`  Credits charged: ${response.creditsCharged}`));
   }
+}
+function renderMapsResponse(label, response) {
+  console.log(source_default.green(`\u2713 ${label}`));
+  renderMapsMetadata(response);
   const result = response.result ?? response;
   console.log(JSON.stringify(result, null, 2));
 }
+function renderOsmFileResponse(label, response, outputPath) {
+  console.log(source_default.green(`\u2713 ${label}`));
+  renderMapsMetadata(response);
+  const result = isRecord3(response.result) ? response.result : {};
+  const featureCount = numberField(result, "featureCount");
+  const attribution = stringField2(result, "attribution");
+  if (featureCount !== void 0) {
+    console.log(source_default.dim(`  Features: ${featureCount}`));
+  }
+  if (attribution) {
+    console.log(source_default.dim(`  Attribution: ${attribution}`));
+  }
+  console.log(source_default.dim(`  Output: ${outputPath}`));
+}
 async function runMapsRequest(label, endpoint, payload, options) {
   const response = await callZeroMaps(endpoint, payload);
   if (options.json) {
@@ -15136,8 +15301,109 @@ var placesDetailsCommand = new Command().name("details").description("Get detail
     );
   })
 );
+var osmDownloadCommand = new Command().name("download").description("Download OpenStreetMap vector features as GeoJSON").option(
+  "--bbox <west,south,east,north>",
+  "Bounding box in WGS84 coordinates",
+  parseBBox
+).option(
+  "--center <lat,lng>",
+  "Center point in WGS84 coordinates",
+  parseLatLng
+).option(
+  "--radius <meters>",
+  "Radius in meters when using --center",
+  parsePositiveInteger3
+).option(
+  "--layers <layers>",
+  "Comma-separated layers: roads, buildings, water, parks",
+  parseOsmLayers,
+  OSM_LAYERS
+).option("--output <path>", "Write GeoJSON to a file").option("--json", "Print the raw maps response as JSON").action(
+  withErrorHandler(async (options) => {
+    const response = await callZeroMaps(
+      "osm/download",
+      osmAreaPayload(options)
+    );
+    if (options.output) {
+      await writeOsmGeoJson(options.output, response);
+    }
+    if (options.json) {
+      console.log(JSON.stringify(response));
+      return;
+    }
+    if (options.output) {
+      renderOsmFileResponse(
+        "OSM download completed",
+        response,
+        options.output
+      );
+      return;
+    }
+    renderMapsResponse("OSM download completed", response);
+  })
+);
+var osmRenderCommand = new Command().name("render").description("Render OpenStreetMap vector features to PNG").option(
+  "--bbox <west,south,east,north>",
+  "Bounding box in WGS84 coordinates",
+  parseBBox
+).option(
+  "--center <lat,lng>",
+  "Center point in WGS84 coordinates",
+  parseLatLng
+).option(
+  "--radius <meters>",
+  "Radius in meters when using --center",
+  parsePositiveInteger3
+).option(
+  "--layers <layers>",
+  "Comma-separated layers: roads, buildings, water, parks",
+  parseOsmLayers,
+  OSM_LAYERS
+).option(
+  "--width <px>",
+  "PNG width in pixels, from 320 to 2048",
+  (value) => {
+    return parseIntegerInRange(value, 320, 2048);
+  },
+  1536
+).option(
+  "--height <px>",
+  "PNG height in pixels, from 240 to 2048",
+  (value) => {
+    return parseIntegerInRange(value, 240, 2048);
+  },
+  1024
+).option(
+  "--style <style>",
+  "Render style: standard or guide",
+  parseOsmStyle,
+  "standard"
+).option("--title <text>", "Optional title drawn onto the PNG").option(
+  "--marker <lat,lng[,label]>",
+  "Marker to draw; repeat for multiple markers",
+  collectOsmMarker,
+  []
+).requiredOption("--output <path>", "Write PNG to a file").option("--json", "Print the raw maps response as JSON").action(
+  withErrorHandler(async (options) => {
+    const response = await callZeroMaps("osm/render", {
+      ...osmAreaPayload(options),
+      width: options.width,
+      height: options.height,
+      style: options.style,
+      title: options.title,
+      markers: options.marker
+    });
+    await writeOsmPng(options.output, response);
+    if (options.json) {
+      console.log(JSON.stringify(response));
+      return;
+    }
+    renderOsmFileResponse("OSM render completed", response, options.output);
+  })
+);
+var osmCommand = new Command().name("osm").description("Download and render OpenStreetMap data").addCommand(osmDownloadCommand).addCommand(osmRenderCommand);
 var placesCommand = new Command().name("places").description("Search places and fetch place details").addCommand(placesSearchCommand).addCommand(placesDetailsCommand);
-var zeroMapsCommand = new Command().name("maps").description("Use managed zero maps services").addCommand(geocodeCommand).addCommand(reverseGeocodeCommand).addCommand(directionsCommand).addCommand(placesCommand).addHelpText(
+var zeroMapsCommand = new Command().name("maps").description("Use managed zero maps services").addCommand(geocodeCommand).addCommand(reverseGeocodeCommand).addCommand(directionsCommand).addCommand(placesCommand).addCommand(osmCommand).addHelpText(
   "after",
   `
 Examples:
@@ -15147,10 +15413,12 @@ Examples:
   Enterprise search:   zero maps places search --query "restaurants in SoMa" --fields enterprise --json
   Place details:       zero maps places details --place-id <id> --fields essentials --json
   Enterprise details:  zero maps places details --place-id <id> --fields enterprise --json
+  Download OSM data:    zero maps osm download --bbox -122.43,37.76,-122.40,37.79 --output map.geojson
+  Render OSM PNG:       zero maps osm render --center 37.7749,-122.4194 --radius 1200 --output map.png
 
 Notes:
   - Authenticates via ZERO_TOKEN (requires maps:read capability) or a CLI token
-  - Google Maps calls and credit billing happen on the vm0 API server
+  - Google Maps and OpenStreetMap calls and credit billing happen on the vm0 API server
   - Use --fields essentials for place details unless paid fields are required`
 );
 
@@ -15613,7 +15881,7 @@ Tip (video understanding):
 // src/commands/zero/resource/index.ts
 init_esm_shims();
 import { createHash as createHash3 } from "crypto";
-import { mkdir as mkdir3, mkdtemp, rm, writeFile as writeFile3 } from "fs/promises";
+import { mkdir as mkdir4, mkdtemp, rm, writeFile as writeFile4 } from "fs/promises";
 import { tmpdir as tmpdir8 } from "os";
 import path from "path";
 function candidateIds(id) {
@@ -15691,8 +15959,8 @@ var zeroResourceCommand = new Command().name("resource").description("Pull regis
       const outputDir3 = path.resolve(options.dir);
       const tmpDir = await mkdtemp(path.join(tmpdir8(), "zero-resource-"));
       const archivePath = path.join(tmpDir, "resource.tar.gz");
-      await mkdir3(outputDir3, { recursive: true });
-      await writeFile3(archivePath, buffer);
+      await mkdir4(outputDir3, { recursive: true });
+      await writeFile4(archivePath, buffer);
       try {
         await uo({
           file: archivePath,
@@ -15837,7 +16105,7 @@ function registerZeroCommands(prog, commands) {
 var program = new Command();
 program.name("zero").description(
   "Zero CLI \u2014 interact with the zero platform from inside the sandbox"
-).version("9.208.1").addHelpText("after", () => {
+).version("9.209.0").addHelpText("after", () => {
   return buildZeroHelpText();
 });
 if (process.argv[1]?.endsWith("zero.js") || process.argv[1]?.endsWith("zero.ts") || process.argv[1]?.endsWith("zero")) {