@blinkdotnew/cli 0.3.3 → 0.3.6

package/AGENTS.md

@@ -38,6 +38,7 @@ packages/cli/
 │   │   ├── db.ts               # blink db query/exec/list                           → core.blink.new
 │   │   ├── deploy.ts           # blink deploy / deployments / rollback              → blink.new
 │   │   ├── notify.ts           # blink notify email                                 → core.blink.new
+│   │   ├── sms.ts              # blink sms send                                     → core.blink.new
 │   │   ├── project.ts          # blink project / blink link / blink status          → blink.new
 │   │   ├── rag.ts              # blink rag search/upload/collections                → core.blink.new
 │   │   ├── realtime.ts         # blink realtime publish                             → core.blink.new
@@ -144,6 +145,14 @@ blink notify email <project_id> <to> <subject> [body]
 blink notify email <to> <subject> --file ./body.html
 ```
 
+### SMS (→ core.blink.new /api/v1/sms/send)
+```bash
+blink sms send <to> <message>                     # Send SMS from workspace primary number
+blink sms send <to> <message> --from <number>     # Send from specific workspace number
+blink sms send <to> <message> --json              # Machine-readable output
+```
+Requires a provisioned workspace phone number (`blink phone buy`). 0.1 credits/message.
+
 ### Connectors (→ core.blink.new /api/v1/connectors/[provider]/execute)
 ```bash
 blink connector exec <provider> <action> [params-json] [--account <id>] [--method POST]

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}"`);
   });
@@ -1708,6 +1726,53 @@ The number is permanently returned to the carrier pool. This action cannot be un
   });
 }
 
+// src/commands/sms.ts
+function formatPhone2(num) {
+  const m = num.match(/^\+1(\d{3})(\d{3})(\d{4})$/);
+  return m ? `+1 (${m[1]}) ${m[2]}-${m[3]}` : num;
+}
+function registerSmsCommands(program2) {
+  const sms = program2.command("sms").description("Send SMS messages from your workspace phone number").addHelpText("after", `
+Commands:
+  send      Send an SMS text message to any phone number
+
+Examples:
+  $ blink sms send "+14155551234" "Your order is ready!"
+  $ blink sms send "+14155551234" "Code: 492817" --from "+19143720262"
+  $ blink sms send "+447911123456" "Your appointment is confirmed."
+  $ blink sms send "+14155551234" "Hello" --json
+
+Requires a provisioned workspace phone number (blink phone list / blink phone buy).
+0.1 credits per message. Credits charged immediately on send.
+`).action(() => sms.help());
+  sms.command("send <to> <message>").description("Send an SMS message (0.1 credits per message)").option("--from <number>", "Specific sender number (default: workspace primary)").addHelpText("after", `
+Examples:
+  $ blink sms send "+14155551234" "Your appointment is confirmed for tomorrow at 2pm."
+  $ blink sms send "+447911123456" "Your order #1042 has shipped!"
+  $ blink sms send "+14155551234" "Code: 492817" --from "+19143720262"
+  $ blink sms send "+14155551234" "Hello" --json
+
+Phone numbers must be in E.164 format (+14155551234).
+Messages over 160 characters count as multiple segments (still 0.1 credits).
+Requires a provisioned workspace phone number: blink phone buy
+`).action(async (to, message, opts) => {
+    requireToken();
+    const body = { to, message };
+    if (opts.from?.trim()) body.from = opts.from.trim();
+    const result = await withSpinner(
+      `Sending SMS to ${to}...`,
+      () => resourcesRequest("/api/v1/sms/send", { body })
+    );
+    if (isJsonMode()) return printJson(result);
+    console.log(`\u2713 SMS sent`);
+    console.log(`  To       ${formatPhone2(result.to)}`);
+    console.log(`  From     ${formatPhone2(result.from)}`);
+    if (result.segment_count > 1) console.log(`  Segments ${result.segment_count}`);
+    console.log(`  ID       ${result.message_id}`);
+    console.log(`  Credits  ${result.credits_charged}`);
+  });
+}
+
 // src/lib/api-app.ts
 var BASE_URL2 = process.env.BLINK_APP_URL ?? "https://blink.new";
 async function appRequest(path, opts = {}) {
@@ -2354,6 +2419,7 @@ registerNotifyCommands(program);
 registerConnectorCommands(program);
 registerLinkedInCommands(program);
 registerPhoneCommands(program);
+registerSmsCommands(program);
 program.command("use <project_id>").description("Set active project for this shell session (alternative to blink link)").option("--export", "Output a shell export statement \u2014 use with eval to actually set it").addHelpText("after", `
 Examples:
   $ blink use proj_xxx                        Shows the export command to run

package/package.json

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

package/src/cli.ts

@@ -11,6 +11,7 @@ import { registerNotifyCommands } from './commands/notify.js'
 import { registerConnectorCommands } from './commands/connector.js'
 import { registerLinkedInCommands } from './commands/linkedin.js'
 import { registerPhoneCommands } from './commands/phone.js'
+import { registerSmsCommands } from './commands/sms.js'
 import { registerDeployCommands } from './commands/deploy.js'
 import { registerProjectCommands } from './commands/project.js'
 import { registerAuthCommands } from './commands/auth.js'
@@ -150,6 +151,7 @@ registerNotifyCommands(program)
 registerConnectorCommands(program)
 registerLinkedInCommands(program)
 registerPhoneCommands(program)
+registerSmsCommands(program)
 
 program.command('use <project_id>')
   .description('Set active project for this shell session (alternative to blink link)')

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}"`)
     })

package/src/commands/sms.ts

@@ -0,0 +1,71 @@
+import { Command } from 'commander'
+import { resourcesRequest } from '../lib/api-resources.js'
+import { requireToken } from '../lib/auth.js'
+import { printJson, isJsonMode, withSpinner } from '../lib/output.js'
+
+interface SmsResult {
+  message_id: string
+  twilio_sid: string
+  status: string
+  to: string
+  from: string
+  segment_count: number
+  credits_charged: number
+}
+
+function formatPhone(num: string): string {
+  const m = num.match(/^\+1(\d{3})(\d{3})(\d{4})$/)
+  return m ? `+1 (${m[1]}) ${m[2]}-${m[3]}` : num
+}
+
+export function registerSmsCommands(program: Command) {
+  const sms = program.command('sms')
+    .description('Send SMS messages from your workspace phone number')
+    .addHelpText('after', `
+Commands:
+  send      Send an SMS text message to any phone number
+
+Examples:
+  $ blink sms send "+14155551234" "Your order is ready!"
+  $ blink sms send "+14155551234" "Code: 492817" --from "+19143720262"
+  $ blink sms send "+447911123456" "Your appointment is confirmed."
+  $ blink sms send "+14155551234" "Hello" --json
+
+Requires a provisioned workspace phone number (blink phone list / blink phone buy).
+0.1 credits per message. Credits charged immediately on send.
+`)
+    .action(() => sms.help())
+
+  sms.command('send <to> <message>')
+    .description('Send an SMS message (0.1 credits per message)')
+    .option('--from <number>', 'Specific sender number (default: workspace primary)')
+    .addHelpText('after', `
+Examples:
+  $ blink sms send "+14155551234" "Your appointment is confirmed for tomorrow at 2pm."
+  $ blink sms send "+447911123456" "Your order #1042 has shipped!"
+  $ blink sms send "+14155551234" "Code: 492817" --from "+19143720262"
+  $ blink sms send "+14155551234" "Hello" --json
+
+Phone numbers must be in E.164 format (+14155551234).
+Messages over 160 characters count as multiple segments (still 0.1 credits).
+Requires a provisioned workspace phone number: blink phone buy
+`)
+    .action(async (to: string, message: string, opts) => {
+      requireToken()
+      const body: Record<string, string> = { to, message }
+      if (opts.from?.trim()) body.from = opts.from.trim()
+
+      const result = await withSpinner(`Sending SMS to ${to}...`, () =>
+        resourcesRequest('/api/v1/sms/send', { body })
+      ) as SmsResult
+
+      if (isJsonMode()) return printJson(result)
+
+      console.log(`✓ SMS sent`)
+      console.log(`  To       ${formatPhone(result.to)}`)
+      console.log(`  From     ${formatPhone(result.from)}`)
+      if (result.segment_count > 1) console.log(`  Segments ${result.segment_count}`)
+      console.log(`  ID       ${result.message_id}`)
+      console.log(`  Credits  ${result.credits_charged}`)
+    })
+}