@blinkdotnew/cli 0.3.3 → 0.3.5

package/dist/cli.js

@@ -478,12 +478,12 @@ Supported formats: mp3, wav, m4a, ogg
     if (isJsonMode()) return printJson(result);
     console.log(result?.text ?? result?.transcript ?? JSON.stringify(result));
   });
-  ai.command("call <phone-number> <system-prompt>").description("Make an AI phone call to any number (US/International)").option("--voice <voice>", "Voice: openai:alloy | openai:nova | cartesia:sonic-english", "openai:alloy").option("--max-duration <seconds>", "Max call duration in seconds", "300").option("--no-wait", "Return call_id immediately without waiting for completion").option("--from <number>", "Phone number to call from (E.164 format, e.g. +14155551234). Uses primary number if omitted.").addHelpText("after", `
+  ai.command("call <phone-number> <system-prompt>").description("Make an AI phone call to any number (US/International)").option("--voice <voice>", "Voice: openai:alloy | openai:nova | cartesia:sonic-english", "openai:alloy").option("--first-message <text>", 'What the AI says first when call connects (default: "Hello?")').option("--max-duration <seconds>", "Max call duration in seconds", "300").option("--no-wait", "Return call_id immediately without waiting for completion").option("--from <number>", "Phone number to call from (E.164 format, e.g. +14155551234). Uses primary number if omitted.").addHelpText("after", `
 Examples:
-  $ blink ai call "+14155551234" "You are collecting a payment of $240 from John Smith. Be polite but firm."
-  $ blink ai call "+14155551234" "Confirm John's appointment for tomorrow at 3pm" --voice openai:nova
-  $ blink ai call "+14155551234" "Leave a message about our new product launch" --no-wait
-  $ blink ai call "+14155551234" "Your task" --json | jq '.call_id'
+  $ blink ai call "+14155551234" "You are collecting a $240 payment from John Smith. Be polite." --first-message "Hi John, this is an automated call from Acme."
+  $ blink ai call "+14155551234" "Confirm John's appointment at 3pm" --first-message "Hello, calling to confirm your appointment."
+  $ blink ai call "+14155551234" "Collect feedback on recent order" --voice openai:nova
+  $ blink ai call "+14155551234" "Your task" --no-wait --json | jq '.call_id'
 
 Phone number must be in E.164 format: +1XXXXXXXXXX (US), +44XXXXXXXXXX (UK), etc.
 
@@ -507,6 +507,7 @@ Use --from to specify which of your workspace numbers to call from.
           system_prompt: systemPrompt,
           voice: opts.voice,
           max_duration_seconds: parseInt(opts.maxDuration),
+          ...opts.firstMessage ? { first_message: opts.firstMessage } : {},
           ...opts.from ? { from_number: opts.from } : {}
         }
       })
@@ -1605,7 +1606,7 @@ Commands:
 
 Examples:
   $ blink phone list
-  $ blink phone buy --label "Sales" --country US --area-code 415
+  $ blink phone buy --label "Sales" --area-code 415
   $ blink phone buy --label "Support"
   $ blink phone label wpn_abc123 "Support line"
   $ blink phone release wpn_abc123
@@ -1636,23 +1637,39 @@ Examples:
     if (isJsonMode()) return printJson(records);
     printRecords(records);
   });
-  phone.command("buy").description("Provision a new phone number (10 credits/month)").option("--label <label>", 'Label for this number, e.g. "Sales" or "Support"').option("--country <code>", "Country code: US, GB, CA, AU", "US").option("--area-code <code>", "Preferred area code (US/CA only, e.g. 415)").addHelpText("after", `
+  phone.command("buy").description("Search and buy a phone number (25 credits/month)").option("--label <label>", 'Label for this number, e.g. "Sales" or "Support"').option("--country <code>", "Country code (e.g. US, GB, AU, DE)", "US").option("--area-code <code>", "Preferred area code (e.g. 415, 914, 020)").addHelpText("after", `
 Examples:
-  $ blink phone buy
-  $ blink phone buy --label "Sales" --area-code 415
+  $ blink phone buy --label "Sales" --area-code 914
   $ blink phone buy --label "UK Support" --country GB
+  $ blink phone buy --label "Germany" --country DE
   $ blink phone buy --json | jq '.phone_number'
 
-10 credits charged immediately, then monthly on anniversary.
+Searches real available numbers from Twilio, picks the first result.
+25 credits charged immediately, then monthly on anniversary.
+Supported countries: US, CA, GB, AU, NZ, DE, FR, NL, SE, NO, DK, FI, IE, BE, AT, CH, ES, IT, PT, PL, CZ, RO, HU, GR, JP, SG, HK, BR, MX, CL, CO, ZA, IL, PR
 `).action(async (opts) => {
     requireToken();
+    const searchParams = new URLSearchParams({ country: opts.country ?? "US" });
+    if (opts.areaCode) searchParams.set("area_code", opts.areaCode);
+    const searchResult = await withSpinner(
+      `Searching for ${opts.country ?? "US"} numbers...`,
+      () => resourcesRequest(`/api/v1/phone-numbers/available?${searchParams}`)
+    );
+    if (!searchResult.numbers?.length) {
+      process.stderr.write(`
+No numbers available${opts.areaCode ? ` in area code ${opts.areaCode}` : ""}. Try a different area code.
+`);
+      process.exit(1);
+    }
+    const picked = searchResult.numbers[0];
     const result = await withSpinner(
-      "Provisioning phone number...",
+      `Provisioning ${picked.phone_number}...`,
       () => resourcesRequest("/api/v1/phone-numbers", {
         body: {
+          phone_number: picked.phone_number,
           label: opts.label || void 0,
-          country: opts.country,
-          area_code: opts.areaCode || void 0
+          locality: picked.locality || void 0,
+          country: picked.country
         }
       })
     );
@@ -1660,9 +1677,10 @@ Examples:
     console.log(`\u2713 Phone number provisioned`);
     console.log(`  Number   ${formatPhone(result.phone_number)}`);
     if (result.label) console.log(`  Label    ${result.label}`);
-    console.log(`  Country  ${result.country}${result.area_code ? ` \xB7 Area ${result.area_code}` : ""}`);
+    const loc = result.locality;
+    console.log(`  Location ${loc ? `${loc} \xB7 ` : ""}${result.country}`);
     console.log(`  ID       ${result.id}`);
-    console.log(`  Billing  10 credits/month`);
+    console.log(`  Billing  25 credits/month`);
     console.log();
     console.log(`Use it: blink ai call "+1..." "Your task" --from "${result.phone_number}"`);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/cli",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Blink platform CLI — deploy apps, manage databases, generate AI content",
   "bin": {
     "blink": "dist/cli.js"

package/src/commands/ai.ts

@@ -288,15 +288,16 @@ Supported formats: mp3, wav, m4a, ogg
   ai.command('call <phone-number> <system-prompt>')
     .description('Make an AI phone call to any number (US/International)')
     .option('--voice <voice>', 'Voice: openai:alloy | openai:nova | cartesia:sonic-english', 'openai:alloy')
+    .option('--first-message <text>', 'What the AI says first when call connects (default: "Hello?")')
     .option('--max-duration <seconds>', 'Max call duration in seconds', '300')
     .option('--no-wait', 'Return call_id immediately without waiting for completion')
     .option('--from <number>', 'Phone number to call from (E.164 format, e.g. +14155551234). Uses primary number if omitted.')
     .addHelpText('after', `
 Examples:
-  $ blink ai call "+14155551234" "You are collecting a payment of $240 from John Smith. Be polite but firm."
-  $ blink ai call "+14155551234" "Confirm John's appointment for tomorrow at 3pm" --voice openai:nova
-  $ blink ai call "+14155551234" "Leave a message about our new product launch" --no-wait
-  $ blink ai call "+14155551234" "Your task" --json | jq '.call_id'
+  $ blink ai call "+14155551234" "You are collecting a $240 payment from John Smith. Be polite." --first-message "Hi John, this is an automated call from Acme."
+  $ blink ai call "+14155551234" "Confirm John's appointment at 3pm" --first-message "Hello, calling to confirm your appointment."
+  $ blink ai call "+14155551234" "Collect feedback on recent order" --voice openai:nova
+  $ blink ai call "+14155551234" "Your task" --no-wait --json | jq '.call_id'
 
 Phone number must be in E.164 format: +1XXXXXXXXXX (US), +44XXXXXXXXXX (UK), etc.
 
@@ -320,6 +321,7 @@ Use --from to specify which of your workspace numbers to call from.
             system_prompt: systemPrompt,
             voice: opts.voice,
             max_duration_seconds: parseInt(opts.maxDuration),
+            ...(opts.firstMessage ? { first_message: opts.firstMessage } : {}),
             ...(opts.from ? { from_number: opts.from } : {}),
           },
         })

package/src/commands/phone.ts

@@ -56,7 +56,7 @@ Commands:
 
 Examples:
   $ blink phone list
-  $ blink phone buy --label "Sales" --country US --area-code 415
+  $ blink phone buy --label "Sales" --area-code 415
   $ blink phone buy --label "Support"
   $ blink phone label wpn_abc123 "Support line"
   $ blink phone release wpn_abc123
@@ -95,27 +95,45 @@ Examples:
 
   // blink phone buy
   phone.command('buy')
-    .description('Provision a new phone number (10 credits/month)')
+    .description('Search and buy a phone number (25 credits/month)')
     .option('--label <label>', 'Label for this number, e.g. "Sales" or "Support"')
-    .option('--country <code>', 'Country code: US, GB, CA, AU', 'US')
-    .option('--area-code <code>', 'Preferred area code (US/CA only, e.g. 415)')
+    .option('--country <code>', 'Country code (e.g. US, GB, AU, DE)', 'US')
+    .option('--area-code <code>', 'Preferred area code (e.g. 415, 914, 020)')
     .addHelpText('after', `
 Examples:
-  $ blink phone buy
-  $ blink phone buy --label "Sales" --area-code 415
+  $ blink phone buy --label "Sales" --area-code 914
   $ blink phone buy --label "UK Support" --country GB
+  $ blink phone buy --label "Germany" --country DE
   $ blink phone buy --json | jq '.phone_number'
 
-10 credits charged immediately, then monthly on anniversary.
+Searches real available numbers from Twilio, picks the first result.
+25 credits charged immediately, then monthly on anniversary.
+Supported countries: US, CA, GB, AU, NZ, DE, FR, NL, SE, NO, DK, FI, IE, BE, AT, CH, ES, IT, PT, PL, CZ, RO, HU, GR, JP, SG, HK, BR, MX, CL, CO, ZA, IL, PR
 `)
     .action(async (opts) => {
       requireToken()
-      const result = await withSpinner('Provisioning phone number...', () =>
+      // Step 1: Search for available numbers
+      const searchParams = new URLSearchParams({ country: opts.country ?? 'US' })
+      if (opts.areaCode) searchParams.set('area_code', opts.areaCode)
+      const searchResult = await withSpinner(`Searching for ${opts.country ?? 'US'} numbers...`, () =>
+        resourcesRequest(`/api/v1/phone-numbers/available?${searchParams}`)
+      ) as { numbers: Array<{ phone_number: string; locality?: string; region?: string; country: string }> }
+
+      if (!searchResult.numbers?.length) {
+        process.stderr.write(`\nNo numbers available${opts.areaCode ? ` in area code ${opts.areaCode}` : ''}. Try a different area code.\n`)
+        process.exit(1)
+      }
+
+      const picked = searchResult.numbers[0]
+
+      // Step 2: Provision the picked number
+      const result = await withSpinner(`Provisioning ${picked.phone_number}...`, () =>
         resourcesRequest('/api/v1/phone-numbers', {
           body: {
+            phone_number: picked.phone_number,
             label: opts.label || undefined,
-            country: opts.country,
-            area_code: opts.areaCode || undefined,
+            locality: picked.locality || undefined,
+            country: picked.country,
           },
         })
       ) as PhoneRecord
@@ -123,9 +141,10 @@ Examples:
       console.log(`✓ Phone number provisioned`)
       console.log(`  Number   ${formatPhone(result.phone_number)}`)
       if (result.label) console.log(`  Label    ${result.label}`)
-      console.log(`  Country  ${result.country}${result.area_code ? ` · Area ${result.area_code}` : ''}`)
+      const loc = (result as any).locality
+      console.log(`  Location ${loc ? `${loc} · ` : ''}${result.country}`)
       console.log(`  ID       ${result.id}`)
-      console.log(`  Billing  10 credits/month`)
+      console.log(`  Billing  25 credits/month`)
       console.log()
       console.log(`Use it: blink ai call "+1..." "Your task" --from "${result.phone_number}"`)
     })