@humeai/cli 0.0.10 → 0.0.11

package/README.md

@@ -61,6 +61,7 @@ $ hume tts <text>
 --trailing-silence #0 Seconds of silence to add at the end (0.0-5.0, default is 0.35)
 --streaming Use streaming mode for TTS generation (default: true)
 --instant-mode Enable ultra-low latency mode for significantly faster generation (requires streaming=true, a voice, and incurs 10% higher cost)
+--curl Generate curl command instead of making the API request
 
 ━━━ Details ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -110,6 +111,9 @@ $ hume tts "Hello world" -v narrator --instant-mode
 Setting instant mode in your config (always enable)
 $ hume config set tts.instantMode true
 
+Generating curl command instead of making API request
+$ hume tts "Hello world" -v narrator --curl
+
 ## Voice Management
 
 Save a voice from a previous generation

package/dist/index.js

@@ -50425,6 +50425,33 @@ var getHumeClient = (opts) => {
     environment: opts.baseUrl ?? "https://api.hume.ai"
   });
 };
+var getApiKeyProvenance = (opts, globalConfig, session, env) => {
+  if (opts.apiKey) {
+    return { source: "flag", value: opts.apiKey };
+  }
+  if (env.HUME_API_KEY) {
+    return { source: "env", value: env.HUME_API_KEY };
+  }
+  if (session.apiKey) {
+    return { source: "session", value: session.apiKey };
+  }
+  if (globalConfig.apiKey) {
+    return { source: "global", value: globalConfig.apiKey };
+  }
+  return null;
+};
+var formatApiKeyForCurl = (provenance) => {
+  switch (provenance.source) {
+    case "flag":
+      return provenance.value;
+    case "env":
+      return "$HUME_API_KEY";
+    case "global":
+      return "$(hume config show | jq '.apiKey')";
+    case "session":
+      return "$(hume session show | jq '.apiKey')";
+  }
+};
 
 // src/config.ts
 var CONFIG_FILE = "config.json";
@@ -50443,6 +50470,7 @@ var configValidators = {
   "tts.trailingSilence": t.cascade(t.isNumber(), t.isInInclusiveRange(0, 5)),
   "tts.streaming": t.isBoolean(),
   "tts.instantMode": t.isBoolean(),
+  "tts.modelVersion": t.isEnum(["1", "2"]),
   json: t.isBoolean(),
   pretty: t.isBoolean(),
   apiKey: t.isString()
@@ -50618,7 +50646,7 @@ var resetGlobalConfig = clearConfig("global");
 // package.json
 var package_default = {
   name: "@humeai/cli",
-  version: "0.0.10",
+  version: "0.0.11",
   module: "index.ts",
   type: "module",
   description: "CLI for Hume.ai's OCTAVE expressive TTS API",
@@ -50796,6 +50824,7 @@ var withStdinAudioPlayer = async (customCommand, f) => {
 };
 
 // src/tts.ts
+var import_serialization = __toESM(require_serialization(), 1);
 var calculateOutputOpts = (opts) => {
   if (opts.numGenerations > 1 && opts.outputFilePath) {
     throw new Error("Unexpected: cannot specify both --num-generations and --output-file-path");
@@ -50873,7 +50902,8 @@ class Tts {
     speed: null,
     trailingSilence: null,
     streaming: true,
-    instantMode: false
+    instantMode: false,
+    modelVersion: null
   };
   async writeFiles(opts, generations) {
     if (opts.type === "path") {
@@ -50985,6 +51015,8 @@ class Tts {
     const trailingSilence = osgd("trailingSilence").item;
     const streaming = osgd("streaming").item;
     const instantMode = osgd("instantMode").item;
+    const modelVersion = osgd("modelVersion").item;
+    const requestJson = opts.requestJson ?? null;
     const voiceName_ = osgd("voiceName");
     const voiceId_ = osgd("voiceId");
     let voiceName = voiceName_.item;
@@ -51015,7 +51047,9 @@ class Tts {
       speed,
       trailingSilence,
       streaming,
-      instantMode
+      instantMode,
+      modelVersion,
+      requestJson
     };
   }
   async readStdin() {
@@ -51035,6 +51069,12 @@ class Tts {
   async synthesize(rawOpts) {
     const { session, globalConfig, env, reporter, hume } = await this.getSettings(rawOpts);
     const opts = Tts.resolveOpts(env, globalConfig, session, rawOpts);
+    if (!opts.text && !opts.requestJson) {
+      throw new Error("Either text parameter or --request-json must be provided");
+    }
+    if (opts.text && opts.requestJson) {
+      throw new Error("Cannot specify both text parameter and --request-json. Use one or the other.");
+    }
     const outputOpts = calculateOutputOpts(opts);
     if (opts.presetVoice) {
       reporter.warn("Please use --provider HUME_AI instead of --preset-voice. --preset-voice will be removed in a future version");
@@ -51045,19 +51085,33 @@ class Tts {
     }
     const utterance = calculateUtterance({
       ...opts,
-      text,
+      text: text || "",
       speed: opts.speed,
       trailingSilence: opts.trailingSilence,
       provider: opts.provider
     });
-    const tts = {
-      utterances: [utterance],
-      numGenerations: outputOpts.numGenerations,
-      format: { type: opts.format },
-      version: opts.modelVersion ?? undefined
-    };
-    await this.maybeAddContext(opts, tts);
-    if (opts.instantMode) {
+    let tts;
+    if (opts.requestJson) {
+      try {
+        tts = JSON.parse(String(opts.requestJson));
+        debug2("Using hardcoded request body: %O", JSON.stringify(tts, null, 2));
+      } catch (error) {
+        throw new Error(`Invalid JSON in --request-json: ${error instanceof Error ? error.message : "Unknown error"}`);
+      }
+    } else {
+      const baseTts = {
+        utterances: [utterance],
+        numGenerations: outputOpts.numGenerations,
+        format: { type: opts.format }
+      };
+      if (opts.modelVersion !== null) {
+        tts = { ...baseTts, version: opts.modelVersion };
+      } else {
+        tts = baseTts;
+      }
+      await this.maybeAddContext(opts, tts);
+    }
+    if (opts.instantMode && !opts.requestJson) {
       if (!opts.streaming) {
         throw new Error("Instant mode requires streaming to be enabled");
       }
@@ -51072,6 +51126,9 @@ class Tts {
     if (!hume) {
       throw new ApiKeyNotSetError;
     }
+    if (opts.curl) {
+      return this.generateCurlCommand(opts, env, globalConfig, session, reporter, tts);
+    }
     if (opts.streaming) {
       return this.synthesizeStreaming(reporter, tts, hume, opts, outputOpts);
     }
@@ -51172,6 +51229,24 @@ class Tts {
     reporter.json({ result, written_files: writtenFiles });
     await this.playAudios(opts.play, writtenFiles, reporter, opts.playCommand ?? null);
   }
+  async generateCurlCommand(opts, env, globalConfig, session, reporter, tts) {
+    const apiKeyProvenance = getApiKeyProvenance(opts, globalConfig, session, env);
+    if (!apiKeyProvenance) {
+      throw new ApiKeyNotSetError;
+    }
+    const baseUrl = opts.baseUrl ?? env.HUME_BASE_URL ?? session.baseUrl ?? globalConfig.baseUrl ?? "https://api.hume.ai";
+    const apiKey = formatApiKeyForCurl(apiKeyProvenance);
+    const endpoint = opts.streaming ? "/v0/tts/stream/json" : "/v0/tts";
+    const url = `${baseUrl}${endpoint}`;
+    const serialized = import_serialization.default.tts.PostedTts.jsonOrThrow(tts);
+    const curlCommand = [
+      `curl "${url}"`,
+      `  -H "X-Hume-Api-Key: ${apiKey}"`,
+      `  --json '${JSON.stringify(serialized)}'`
+    ].join(" \\\n");
+    reporter.info("Generated curl command:");
+    console.log(curlCommand);
+  }
 }
 
 // src/index.ts
@@ -51269,6 +51344,7 @@ var usageDescriptions = {
   "tts.streaming": "Use streaming mode for TTS generation (default: true)",
   "tts.instantMode": "Enable ultra-low latency mode for significantly faster generation (requires streaming=true, a voice, and incurs 10% higher cost)",
   "tts.modelVersion": "Either '1' for Octave 1 or '2' for Octave 2.",
+  "tts.curl": "Generate curl command instead of making the API request",
   apiKey: "Override the default API key",
   json: "Output in JSON format",
   pretty: "Output in human-readable format"
@@ -51571,7 +51647,7 @@ class TtsCommand extends Command2 {
   }), {
     usage: `$ hume tts <text>`
   });
-  text = exports_options.String({ required: true, name: "text" });
+  text = exports_options.String({ required: false, name: "text" });
   description = exports_options.String("-d,--description", {
     description: usageDescriptions["tts.description"]
   });
@@ -51647,6 +51723,12 @@ class TtsCommand extends Command2 {
     description: usageDescriptions["tts.modelVersion"],
     validator: t2.isEnum(["1", "2"])
   });
+  requestJson = exports_options.String("--request-json", {
+    description: "Override the request body with a hardcoded JSON string instead of generating it from options"
+  });
+  curl = exports_options.Boolean("--curl", {
+    description: usageDescriptions["tts.curl"]
+  });
   async execute() {
     const tts = new Tts;
     await tts.synthesize(this);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@humeai/cli",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "module": "index.ts",
   "type": "module",
   "description": "CLI for Hume.ai's OCTAVE expressive TTS API",