@blinkdotnew/cli 0.3.5 → 0.3.7

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

@@ -197,7 +197,12 @@ async function resourcesRequest(path, opts = {}) {
     const errText = await res.text();
     let errMsg = `HTTP ${res.status}`;
     try {
-      errMsg = JSON.parse(errText).error ?? errMsg;
+      const parsed = JSON.parse(errText);
+      const err = parsed.error;
+      if (typeof err === "string") errMsg = err;
+      else if (err?.message) errMsg = err.message;
+      else if (parsed.message) errMsg = parsed.message;
+      else if (err) errMsg = JSON.stringify(err);
     } catch {
     }
     throw new Error(errMsg);
@@ -1391,7 +1396,7 @@ async function liExec(method, httpMethod, params, agentId) {
   return result.data;
 }
 async function getPersonId(agentId) {
-  const data = await liExec("v2/userinfo", "GET", {}, agentId);
+  const data = await liExec("userinfo", "GET", {}, agentId);
   const id = data?.sub ?? data?.id;
   if (!id) throw new Error("Could not resolve LinkedIn person ID");
   return id;
@@ -1436,7 +1441,7 @@ Examples:
     const agentId = requireAgentId(opts.agent);
     const data = await withSpinner(
       "Fetching LinkedIn profile...",
-      () => liExec("v2/userinfo", "GET", {}, agentId)
+      () => liExec("userinfo", "GET", {}, agentId)
     );
     if (isJsonMode()) return printJson(data);
     const name = data?.name ?? [data?.given_name, data?.family_name].filter(Boolean).join(" ");
@@ -1515,7 +1520,7 @@ Examples:
     const encoded = encodeURIComponent(postUrn);
     const data = await withSpinner(
       "Liking post...",
-      () => liExec(`v2/socialActions/${encoded}/likes`, "POST", {
+      () => liExec(`socialActions/${encoded}/likes`, "POST", {
         actor: `urn:li:person:${personId}`
       }, agentId)
     );
@@ -1537,7 +1542,7 @@ Examples:
     const encodedPerson = encodeURIComponent(`urn:li:person:${personId}`);
     await withSpinner(
       "Unliking post...",
-      () => liExec(`v2/socialActions/${encodedPost}/likes/${encodedPerson}`, "DELETE", {}, agentId)
+      () => liExec(`socialActions/${encodedPost}/likes/${encodedPerson}`, "DELETE", {}, agentId)
     );
     if (isJsonMode()) return printJson({ unliked: true });
     console.log(chalk7.green("\u2713 Post unliked"));
@@ -1558,7 +1563,7 @@ Examples:
     const encoded = encodeURIComponent(postUrn);
     const data = await withSpinner(
       "Adding comment...",
-      () => liExec(`v2/socialActions/${encoded}/comments`, "POST", {
+      () => liExec(`socialActions/${encoded}/comments`, "POST", {
         actor: `urn:li:person:${personId}`,
         message: { text }
       }, agentId)
@@ -1726,6 +1731,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 = {}) {
@@ -2372,6 +2424,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.5",
+  "version": "0.3.7",
   "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/linkedin.ts

@@ -34,7 +34,7 @@ async function liExec(
 }
 
 async function getPersonId(agentId: string): Promise<string> {
-  const data = await liExec('v2/userinfo', 'GET', {}, agentId)
+  const data = await liExec('userinfo', 'GET', {}, agentId)
   const id = data?.sub ?? data?.id
   if (!id) throw new Error('Could not resolve LinkedIn person ID')
   return id
@@ -87,7 +87,7 @@ Examples:
       requireToken()
       const agentId = requireAgentId(opts.agent)
       const data = await withSpinner('Fetching LinkedIn profile...', () =>
-        liExec('v2/userinfo', 'GET', {}, agentId)
+        liExec('userinfo', 'GET', {}, agentId)
       )
       if (isJsonMode()) return printJson(data)
       const name = data?.name ?? [data?.given_name, data?.family_name].filter(Boolean).join(' ')
@@ -180,7 +180,7 @@ Examples:
       )
       const encoded = encodeURIComponent(postUrn)
       const data = await withSpinner('Liking post...', () =>
-        liExec(`v2/socialActions/${encoded}/likes`, 'POST', {
+        liExec(`socialActions/${encoded}/likes`, 'POST', {
           actor: `urn:li:person:${personId}`,
         }, agentId)
       )
@@ -206,7 +206,7 @@ Examples:
       const encodedPost = encodeURIComponent(postUrn)
       const encodedPerson = encodeURIComponent(`urn:li:person:${personId}`)
       await withSpinner('Unliking post...', () =>
-        liExec(`v2/socialActions/${encodedPost}/likes/${encodedPerson}`, 'DELETE', {}, agentId)
+        liExec(`socialActions/${encodedPost}/likes/${encodedPerson}`, 'DELETE', {}, agentId)
       )
       if (isJsonMode()) return printJson({ unliked: true })
       console.log(chalk.green('✓ Post unliked'))
@@ -231,7 +231,7 @@ Examples:
       )
       const encoded = encodeURIComponent(postUrn)
       const data = await withSpinner('Adding comment...', () =>
-        liExec(`v2/socialActions/${encoded}/comments`, 'POST', {
+        liExec(`socialActions/${encoded}/comments`, 'POST', {
           actor: `urn:li:person:${personId}`,
           message: { text },
         }, agentId)

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

package/src/lib/api-resources.ts

@@ -35,7 +35,14 @@ export async function resourcesRequest(path: string, opts: RequestOptions = {})
   if (!res.ok) {
     const errText = await res.text()
     let errMsg = `HTTP ${res.status}`
-    try { errMsg = JSON.parse(errText).error ?? errMsg } catch { /* use default */ }
+    try {
+      const parsed = JSON.parse(errText)
+      const err = parsed.error
+      if (typeof err === 'string') errMsg = err
+      else if (err?.message) errMsg = err.message
+      else if (parsed.message) errMsg = parsed.message
+      else if (err) errMsg = JSON.stringify(err)
+    } catch { /* use default */ }
     throw new Error(errMsg)
   }
   const ct = res.headers.get('content-type') ?? ''