@blinkdotnew/cli 0.3.0 → 0.3.1

package/dist/cli.js

@@ -886,9 +886,21 @@ Examples:
     for (const f of files) table.push([f.name, f.size ? `${(f.size / 1024).toFixed(1)} KB` : "-"]);
     console.log(table.toString());
   });
-  storage.command("download <path> [output]").description("Download a file from storage").action(async (storagePath, output) => {
+  storage.command("download <arg1> [arg2] [output]").description("Download a file from storage \u2014 blink storage download <path> [output] OR blink storage download <proj> <path> [output]").action(async (arg1, arg2, output) => {
     requireToken();
-    const projectId = requireProjectId();
+    let projectId;
+    let storagePath;
+    if (arg2 !== void 0 && !arg1.startsWith("proj_")) {
+      projectId = requireProjectId();
+      storagePath = arg1;
+      output = arg2;
+    } else if (arg2 !== void 0) {
+      projectId = requireProjectId(arg1);
+      storagePath = arg2;
+    } else {
+      projectId = requireProjectId();
+      storagePath = arg1;
+    }
     const result = await withSpinner(
       "Downloading...",
       () => resourcesRequest(`/api/storage/${projectId}/download`, { body: { path: storagePath } })
@@ -898,9 +910,17 @@ Examples:
     else writeFileSync4(outFile, Buffer.from(result?.data ?? "", "base64"));
     if (!isJsonMode()) console.log("Saved to " + outFile);
   });
-  storage.command("delete <path>").description("Delete a file from storage").action(async (storagePath) => {
+  storage.command("delete <arg1> [arg2]").description("Delete a file from storage \u2014 blink storage delete <path> OR blink storage delete <proj> <path>").action(async (arg1, arg2) => {
     requireToken();
-    const projectId = requireProjectId();
+    let projectId;
+    let storagePath;
+    if (arg2 !== void 0) {
+      projectId = requireProjectId(arg1);
+      storagePath = arg2;
+    } else {
+      projectId = requireProjectId();
+      storagePath = arg1;
+    }
     await withSpinner(
       "Deleting...",
       () => resourcesRequest(`/api/storage/${projectId}/remove`, { method: "DELETE", body: { path: storagePath } })
@@ -908,9 +928,17 @@ Examples:
     if (!isJsonMode()) console.log("Deleted: " + storagePath);
     else printJson({ status: "ok", path: storagePath });
   });
-  storage.command("url <path>").description("Get public URL for a storage file").action(async (storagePath) => {
+  storage.command("url <arg1> [arg2]").description("Get public URL for a storage file \u2014 blink storage url <path> OR blink storage url <proj> <path>").action(async (arg1, arg2) => {
     requireToken();
-    const projectId = requireProjectId();
+    let projectId;
+    let storagePath;
+    if (arg2 !== void 0) {
+      projectId = requireProjectId(arg1);
+      storagePath = arg2;
+    } else {
+      projectId = requireProjectId();
+      storagePath = arg1;
+    }
     const result = await resourcesRequest(`/api/storage/${projectId}/public-url`, { body: { path: storagePath } });
     if (isJsonMode()) return printJson(result);
     console.log(result?.url ?? result);
@@ -1438,6 +1466,145 @@ Examples:
   });
 }
 
+// src/commands/phone.ts
+function formatPhone(num) {
+  const m = num.match(/^\+1(\d{3})(\d{3})(\d{4})$/);
+  return m ? `+1 (${m[1]}) ${m[2]}-${m[3]}` : num;
+}
+function statusDot(status) {
+  return status === "active" ? "\u25CF" : status === "grace" ? "\u26A1" : "\u25CB";
+}
+function nextCharge(lastCharged) {
+  if (!lastCharged) return "";
+  const d = new Date(new Date(lastCharged).getTime() + 30 * 864e5);
+  return d.toLocaleDateString("en-US", { month: "short", day: "numeric", year: "numeric" });
+}
+function printRecords(records) {
+  if (!records.length) {
+    console.log("No phone numbers. Run: blink phone buy");
+    return;
+  }
+  records.forEach((r, i) => {
+    const label = r.label ? `  ${r.label}` : "";
+    const primary = i === 0 && r.status === "active" ? "  \u2605 primary" : "";
+    const next = nextCharge(r.last_charged_at);
+    const charge = next ? `  Next charge ${next}` : "";
+    console.log(`${statusDot(r.status)}  ${formatPhone(r.phone_number)}${label}${primary}`);
+    console.log(`   ${r.id}  ${r.country}${r.area_code ? ` \xB7 ${r.area_code}` : ""}${charge}`);
+  });
+}
+function registerPhoneCommands(program2) {
+  const phone = program2.command("phone").description("Manage workspace phone numbers for AI calling").addHelpText("after", `
+Commands:
+  list      List all workspace phone numbers
+  buy       Provision a new phone number
+  label     Update a number's label
+  release   Release (cancel) a phone number
+
+Examples:
+  $ blink phone list
+  $ blink phone buy --label "Sales" --country US --area-code 415
+  $ blink phone buy --label "Support"
+  $ blink phone label wpn_abc123 "Support line"
+  $ blink phone release wpn_abc123
+
+Numbers cost 10 credits/month each. First charge is immediate on buy.
+Primary number (oldest active) is used by default for \`blink ai call\`.
+Use \`blink ai call --from +1XXXXXXXXXX\` to specify a different number.
+`);
+  phone.action(async () => {
+    requireToken();
+    const records = await withSpinner(
+      "Fetching phone numbers...",
+      () => resourcesRequest("/api/v1/phone-numbers")
+    );
+    if (isJsonMode()) return printJson(records);
+    printRecords(records);
+  });
+  phone.command("list").description("List all workspace phone numbers").addHelpText("after", `
+Examples:
+  $ blink phone list
+  $ blink phone list --json
+`).action(async () => {
+    requireToken();
+    const records = await withSpinner(
+      "Fetching phone numbers...",
+      () => resourcesRequest("/api/v1/phone-numbers")
+    );
+    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", `
+Examples:
+  $ blink phone buy
+  $ blink phone buy --label "Sales" --area-code 415
+  $ blink phone buy --label "UK Support" --country GB
+  $ blink phone buy --json | jq '.phone_number'
+
+10 credits charged immediately, then monthly on anniversary.
+`).action(async (opts) => {
+    requireToken();
+    const result = await withSpinner(
+      "Provisioning phone number...",
+      () => resourcesRequest("/api/v1/phone-numbers", {
+        body: {
+          label: opts.label || void 0,
+          country: opts.country,
+          area_code: opts.areaCode || void 0
+        }
+      })
+    );
+    if (isJsonMode()) return printJson(result);
+    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}` : ""}`);
+    console.log(`  ID       ${result.id}`);
+    console.log(`  Billing  10 credits/month`);
+    console.log();
+    console.log(`Use it: blink ai call "+1..." "Your task" --from "${result.phone_number}"`);
+  });
+  phone.command("label <id> <label>").description("Set or update the label for a phone number").addHelpText("after", `
+Examples:
+  $ blink phone label wpn_abc123 "Sales"
+  $ blink phone label wpn_abc123 ""       Clear label
+`).action(async (id, label) => {
+    requireToken();
+    const result = await withSpinner(
+      "Updating label...",
+      () => resourcesRequest(`/api/v1/phone-numbers/${id}`, {
+        method: "PATCH",
+        body: { label }
+      })
+    );
+    if (isJsonMode()) return printJson(result);
+    console.log(`\u2713 Label updated: ${formatPhone(result.phone_number)} \u2192 "${result.label ?? ""}"`);
+  });
+  phone.command("release <id>").description("Release a phone number (permanent)").option("-y, --yes", "Skip confirmation prompt").addHelpText("after", `
+Examples:
+  $ blink phone release wpn_abc123
+  $ blink phone release wpn_abc123 --yes
+
+The number is permanently returned to the carrier pool. This action cannot be undone.
+`).action(async (id, opts) => {
+    requireToken();
+    if (!opts.yes && !isJsonMode()) {
+      const { confirm } = await import("@clack/prompts");
+      const yes = await confirm({ message: `Release ${id}? This cannot be undone.` });
+      if (!yes) {
+        console.log("Cancelled.");
+        return;
+      }
+    }
+    await withSpinner(
+      "Releasing phone number...",
+      () => resourcesRequest(`/api/v1/phone-numbers/${id}`, { method: "DELETE" })
+    );
+    if (isJsonMode()) return printJson({ success: true, id });
+    console.log(`\u2713 Phone number ${id} released`);
+  });
+}
+
 // src/lib/api-app.ts
 var BASE_URL2 = process.env.BLINK_APP_URL ?? "https://blink.new";
 async function appRequest(path, opts = {}) {
@@ -1981,6 +2148,12 @@ Realtime / RAG / Notify:
   $ blink rag search "how does billing work" --ai
   $ blink notify email user@example.com "Subject" "Body"
 
+Phone Numbers (10 credits/month per number):
+  $ blink phone list               List all workspace phone numbers
+  $ blink phone buy --label Sales  Buy a new number (US, UK, CA, AU)
+  $ blink phone label <id> Sales   Update label
+  $ blink phone release <id>       Release a number
+
 Connectors (38 OAuth providers \u2014 GitHub, Notion, Slack, Stripe, Shopify, Jira, Linear, and more):
   $ blink connector providers                                    List all 38 providers
   $ blink connector status                                       Show all connected accounts
@@ -2042,6 +2215,7 @@ registerRagCommands(program);
 registerNotifyCommands(program);
 registerConnectorCommands(program);
 registerLinkedInCommands(program);
+registerPhoneCommands(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.0",
+  "version": "0.3.1",
   "description": "Blink platform CLI — deploy apps, manage databases, generate AI content",
   "bin": {
     "blink": "dist/cli.js"

package/src/cli.ts

@@ -10,6 +10,7 @@ import { registerRagCommands } from './commands/rag.js'
 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 { registerDeployCommands } from './commands/deploy.js'
 import { registerProjectCommands } from './commands/project.js'
 import { registerAuthCommands } from './commands/auth.js'
@@ -79,6 +80,12 @@ Realtime / RAG / Notify:
   $ blink rag search "how does billing work" --ai
   $ blink notify email user@example.com "Subject" "Body"
 
+Phone Numbers (10 credits/month per number):
+  $ blink phone list               List all workspace phone numbers
+  $ blink phone buy --label Sales  Buy a new number (US, UK, CA, AU)
+  $ blink phone label <id> Sales   Update label
+  $ blink phone release <id>       Release a number
+
 Connectors (38 OAuth providers — GitHub, Notion, Slack, Stripe, Shopify, Jira, Linear, and more):
   $ blink connector providers                                    List all 38 providers
   $ blink connector status                                       Show all connected accounts
@@ -142,6 +149,7 @@ registerRagCommands(program)
 registerNotifyCommands(program)
 registerConnectorCommands(program)
 registerLinkedInCommands(program)
+registerPhoneCommands(program)
 
 program.command('use <project_id>')
   .description('Set active project for this shell session (alternative to blink link)')

package/src/commands/phone.ts

@@ -0,0 +1,177 @@
+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 PhoneRecord {
+  id: string
+  phone_number: string
+  label?: string | null
+  area_code?: string | null
+  country: string
+  status: string
+  last_charged_at?: string | null
+  created_at: string
+}
+
+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
+}
+
+function statusDot(status: string): string {
+  return status === 'active' ? '●' : status === 'grace' ? '⚡' : '○'
+}
+
+function nextCharge(lastCharged?: string | null): string {
+  if (!lastCharged) return ''
+  const d = new Date(new Date(lastCharged).getTime() + 30 * 86_400_000)
+  return d.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' })
+}
+
+function printRecords(records: PhoneRecord[]) {
+  if (!records.length) {
+    console.log('No phone numbers. Run: blink phone buy')
+    return
+  }
+  records.forEach((r, i) => {
+    const label = r.label ? `  ${r.label}` : ''
+    const primary = i === 0 && r.status === 'active' ? '  ★ primary' : ''
+    const next = nextCharge(r.last_charged_at)
+    const charge = next ? `  Next charge ${next}` : ''
+    console.log(`${statusDot(r.status)}  ${formatPhone(r.phone_number)}${label}${primary}`)
+    console.log(`   ${r.id}  ${r.country}${r.area_code ? ` · ${r.area_code}` : ''}${charge}`)
+  })
+}
+
+export function registerPhoneCommands(program: Command) {
+  const phone = program.command('phone')
+    .description('Manage workspace phone numbers for AI calling')
+    .addHelpText('after', `
+Commands:
+  list      List all workspace phone numbers
+  buy       Provision a new phone number
+  label     Update a number's label
+  release   Release (cancel) a phone number
+
+Examples:
+  $ blink phone list
+  $ blink phone buy --label "Sales" --country US --area-code 415
+  $ blink phone buy --label "Support"
+  $ blink phone label wpn_abc123 "Support line"
+  $ blink phone release wpn_abc123
+
+Numbers cost 10 credits/month each. First charge is immediate on buy.
+Primary number (oldest active) is used by default for \`blink ai call\`.
+Use \`blink ai call --from +1XXXXXXXXXX\` to specify a different number.
+`)
+
+  // Default: list
+  phone.action(async () => {
+    requireToken()
+    const records = await withSpinner('Fetching phone numbers...', () =>
+      resourcesRequest('/api/v1/phone-numbers')
+    ) as PhoneRecord[]
+    if (isJsonMode()) return printJson(records)
+    printRecords(records)
+  })
+
+  // blink phone list
+  phone.command('list')
+    .description('List all workspace phone numbers')
+    .addHelpText('after', `
+Examples:
+  $ blink phone list
+  $ blink phone list --json
+`)
+    .action(async () => {
+      requireToken()
+      const records = await withSpinner('Fetching phone numbers...', () =>
+        resourcesRequest('/api/v1/phone-numbers')
+      ) as PhoneRecord[]
+      if (isJsonMode()) return printJson(records)
+      printRecords(records)
+    })
+
+  // blink phone buy
+  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', `
+Examples:
+  $ blink phone buy
+  $ blink phone buy --label "Sales" --area-code 415
+  $ blink phone buy --label "UK Support" --country GB
+  $ blink phone buy --json | jq '.phone_number'
+
+10 credits charged immediately, then monthly on anniversary.
+`)
+    .action(async (opts) => {
+      requireToken()
+      const result = await withSpinner('Provisioning phone number...', () =>
+        resourcesRequest('/api/v1/phone-numbers', {
+          body: {
+            label: opts.label || undefined,
+            country: opts.country,
+            area_code: opts.areaCode || undefined,
+          },
+        })
+      ) as PhoneRecord
+      if (isJsonMode()) return printJson(result)
+      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}` : ''}`)
+      console.log(`  ID       ${result.id}`)
+      console.log(`  Billing  10 credits/month`)
+      console.log()
+      console.log(`Use it: blink ai call "+1..." "Your task" --from "${result.phone_number}"`)
+    })
+
+  // blink phone label <id> <label>
+  phone.command('label <id> <label>')
+    .description('Set or update the label for a phone number')
+    .addHelpText('after', `
+Examples:
+  $ blink phone label wpn_abc123 "Sales"
+  $ blink phone label wpn_abc123 ""       Clear label
+`)
+    .action(async (id: string, label: string) => {
+      requireToken()
+      const result = await withSpinner('Updating label...', () =>
+        resourcesRequest(`/api/v1/phone-numbers/${id}`, {
+          method: 'PATCH',
+          body: { label },
+        })
+      ) as PhoneRecord
+      if (isJsonMode()) return printJson(result)
+      console.log(`✓ Label updated: ${formatPhone(result.phone_number)} → "${result.label ?? ''}"`)
+    })
+
+  // blink phone release <id>
+  phone.command('release <id>')
+    .description('Release a phone number (permanent)')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .addHelpText('after', `
+Examples:
+  $ blink phone release wpn_abc123
+  $ blink phone release wpn_abc123 --yes
+
+The number is permanently returned to the carrier pool. This action cannot be undone.
+`)
+    .action(async (id: string, opts) => {
+      requireToken()
+      if (!opts.yes && !isJsonMode()) {
+        const { confirm } = await import('@clack/prompts')
+        const yes = await confirm({ message: `Release ${id}? This cannot be undone.` })
+        if (!yes) { console.log('Cancelled.'); return }
+      }
+      await withSpinner('Releasing phone number...', () =>
+        resourcesRequest(`/api/v1/phone-numbers/${id}`, { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ success: true, id })
+      console.log(`✓ Phone number ${id} released`)
+    })
+}

package/src/commands/storage.ts

@@ -80,11 +80,21 @@ Examples:
       console.log(table.toString())
     })
 
-  storage.command('download <path> [output]')
-    .description('Download a file from storage')
-    .action(async (storagePath: string, output: string | undefined) => {
+  storage.command('download <arg1> [arg2] [output]')
+    .description('Download a file from storage — blink storage download <path> [output] OR blink storage download <proj> <path> [output]')
+    .action(async (arg1: string, arg2: string | undefined, output: string | undefined) => {
       requireToken()
-      const projectId = requireProjectId()
+      let projectId: string
+      let storagePath: string
+      if (arg2 !== undefined && !arg1.startsWith('proj_')) {
+        // blink storage download <path> <output>  (no project_id)
+        projectId = requireProjectId(); storagePath = arg1; output = arg2
+      } else if (arg2 !== undefined) {
+        // blink storage download proj_xxx <path> [output]
+        projectId = requireProjectId(arg1); storagePath = arg2
+      } else {
+        projectId = requireProjectId(); storagePath = arg1
+      }
       const result = await withSpinner('Downloading...', () =>
         resourcesRequest(`/api/storage/${projectId}/download`, { body: { path: storagePath } })
       )
@@ -94,11 +104,14 @@ Examples:
       if (!isJsonMode()) console.log('Saved to ' + outFile)
     })
 
-  storage.command('delete <path>')
-    .description('Delete a file from storage')
-    .action(async (storagePath: string) => {
+  storage.command('delete <arg1> [arg2]')
+    .description('Delete a file from storage — blink storage delete <path> OR blink storage delete <proj> <path>')
+    .action(async (arg1: string, arg2: string | undefined) => {
       requireToken()
-      const projectId = requireProjectId()
+      let projectId: string
+      let storagePath: string
+      if (arg2 !== undefined) { projectId = requireProjectId(arg1); storagePath = arg2 }
+      else { projectId = requireProjectId(); storagePath = arg1 }
       await withSpinner('Deleting...', () =>
         resourcesRequest(`/api/storage/${projectId}/remove`, { method: 'DELETE', body: { path: storagePath } })
       )
@@ -106,11 +119,14 @@ Examples:
       else printJson({ status: 'ok', path: storagePath })
     })
 
-  storage.command('url <path>')
-    .description('Get public URL for a storage file')
-    .action(async (storagePath: string) => {
+  storage.command('url <arg1> [arg2]')
+    .description('Get public URL for a storage file — blink storage url <path> OR blink storage url <proj> <path>')
+    .action(async (arg1: string, arg2: string | undefined) => {
       requireToken()
-      const projectId = requireProjectId()
+      let projectId: string
+      let storagePath: string
+      if (arg2 !== undefined) { projectId = requireProjectId(arg1); storagePath = arg2 }
+      else { projectId = requireProjectId(); storagePath = arg1 }
       const result = await resourcesRequest(`/api/storage/${projectId}/public-url`, { body: { path: storagePath } })
       if (isJsonMode()) return printJson(result)
       console.log(result?.url ?? result)