@blinkdotnew/cli 0.2.7 → 0.3.1

package/dist/cli.js

@@ -478,7 +478,7 @@ 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").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("--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
@@ -496,6 +496,7 @@ Voices:
   cartesia:sonic-english  Low-latency, natural
 
 Call is charged to your workspace credits after completion (~1 credit/min).
+Use --from to specify which of your workspace numbers to call from.
 `).action(async (phoneNumber, systemPrompt, opts) => {
     requireToken();
     const result = await withSpinner(
@@ -505,13 +506,14 @@ Call is charged to your workspace credits after completion (~1 credit/min).
           phone_number: phoneNumber,
           system_prompt: systemPrompt,
           voice: opts.voice,
-          max_duration_seconds: parseInt(opts.maxDuration)
+          max_duration_seconds: parseInt(opts.maxDuration),
+          ...opts.from ? { from_number: opts.from } : {}
         }
       })
     );
     if (isJsonMode()) return printJson(result);
     const callId = result?.call_id;
-    if (opts.noWait) {
+    if (!opts.wait) {
       console.log(`Call initiated: ${callId}`);
       console.log(`Poll status: blink ai call-status ${callId}`);
       return;
@@ -884,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 } })
@@ -896,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 } })
@@ -906,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);
@@ -1227,7 +1257,7 @@ ${filtered.length} providers total. Connect at blink.new/settings?tab=connectors
 ${connected.length} provider(s) connected`));
     }
   });
-  connector.command("exec <provider> <endpoint> [params]").description("Execute a call on a connected OAuth provider").option("--account <id>", "Specific account ID (if you have multiple accounts)").option("--method <method>", "HTTP method: GET | POST | PUT | PATCH | DELETE (default: POST)", "POST").addHelpText("after", `
+  connector.command("exec <provider> <endpoint> [method-or-params] [params]").description("Execute a call on a connected OAuth provider").option("--account <id>", "Specific account ID (if you have multiple accounts)").option("--method <method>", "HTTP method: GET | POST | PUT | PATCH | DELETE (default: POST)", "POST").addHelpText("after", `
 <endpoint> is the API path relative to the provider's base URL, OR a GraphQL query string for Linear.
 
 Examples (REST):
@@ -1260,22 +1290,35 @@ Provider base URLs used:
   jira             https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/
   shopify          https://{shop}.myshopify.com/admin/api/2024-10/
   ... run \`blink connector providers\` for all 38 providers
-`).action(async (provider, endpoint, paramsArg, opts) => {
+`).action(async (provider, endpoint, arg1, arg2, opts) => {
     requireToken();
+    const HTTP_METHODS = /^(GET|POST|PUT|PATCH|DELETE|HEAD)$/i;
+    let httpMethod = opts.method;
     let params = {};
-    if (paramsArg) {
-      try {
-        params = JSON.parse(paramsArg);
-      } catch {
-        params = {};
+    if (arg1) {
+      if (HTTP_METHODS.test(arg1)) {
+        httpMethod = arg1.toUpperCase();
+        if (arg2) {
+          try {
+            params = JSON.parse(arg2);
+          } catch {
+            params = {};
+          }
+        }
+      } else {
+        try {
+          params = JSON.parse(arg1);
+        } catch {
+          params = {};
+        }
       }
     }
     const result = await withSpinner(
-      `${opts.method} ${provider}${endpoint}...`,
+      `${httpMethod} ${provider}${endpoint}...`,
       () => resourcesRequest(`/v1/connectors/${provider}/execute`, {
         body: {
           method: endpoint,
-          http_method: opts.method,
+          http_method: httpMethod,
           params,
           ...opts.account ? { account_id: opts.account } : {}
         }
@@ -1380,6 +1423,30 @@ Examples:
     console.log(chalk7.green("\u2713 Post published"));
     if (data?.id) console.log(chalk7.dim(`  URN: ${data.id}`));
   });
+  li.command("upload-media <media-url>").description("Upload an image or video to LinkedIn storage, returns asset URN for use in posts").option("--type <type>", "Media type: image | video (default: image)", "image").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").addHelpText("after", `
+Returns an asset URN to use when composing a post with media via blink connector exec.
+
+Examples:
+  $ blink linkedin upload-media https://example.com/photo.jpg
+  $ blink linkedin upload-media https://example.com/demo.mp4 --type video
+  $ ASSET_URN=$(blink linkedin upload-media https://example.com/photo.jpg --json | python3 -c "import json,sys; print(json.load(sys.stdin)['asset_urn'])")
+`).action(async (mediaUrl, opts) => {
+    requireToken();
+    const agentId = requireAgentId(opts.agent);
+    const result = await withSpinner(
+      `Uploading ${opts.type}...`,
+      () => resourcesRequest("/v1/connectors/linkedin/upload-media", {
+        body: { media_url: mediaUrl, media_type: opts.type },
+        headers: { "x-blink-agent-id": agentId }
+      })
+    );
+    if (isJsonMode()) return printJson(result?.data ?? result);
+    const assetUrn = result?.data?.asset_urn;
+    if (assetUrn) {
+      console.log(chalk7.green("\u2713 Upload complete"));
+      console.log(chalk7.dim(`  Asset URN: ${assetUrn}`));
+    }
+  });
   li.command("delete <postUrn>").description("Delete one of your LinkedIn posts").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").addHelpText("after", `
 <postUrn> is the LinkedIn post URN returned when the post was created.
 e.g. urn:li:ugcPost:1234567890
@@ -1399,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 = {}) {
@@ -1942,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
@@ -2003,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.2.7",
+  "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/ai.ts

@@ -290,6 +290,7 @@ Supported formats: mp3, wav, m4a, ogg
     .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', `
 Examples:
   $ blink ai call "+14155551234" "You are collecting a payment of $240 from John Smith. Be polite but firm."
@@ -308,6 +309,7 @@ Voices:
   cartesia:sonic-english  Low-latency, natural
 
 Call is charged to your workspace credits after completion (~1 credit/min).
+Use --from to specify which of your workspace numbers to call from.
 `)
     .action(async (phoneNumber, systemPrompt, opts) => {
       requireToken()
@@ -318,6 +320,7 @@ Call is charged to your workspace credits after completion (~1 credit/min).
             system_prompt: systemPrompt,
             voice: opts.voice,
             max_duration_seconds: parseInt(opts.maxDuration),
+            ...(opts.from ? { from_number: opts.from } : {}),
           },
         })
       )
@@ -325,7 +328,7 @@ Call is charged to your workspace credits after completion (~1 credit/min).
 
       const callId = result?.call_id as string
 
-      if (opts.noWait) {
+      if (!opts.wait) { // Commander --no-wait sets opts.wait=false (not opts.noWait)
         console.log(`Call initiated: ${callId}`)
         console.log(`Poll status: blink ai call-status ${callId}`)
         return

package/src/commands/connector.ts

@@ -149,8 +149,12 @@ Use --account <id> if you have multiple linked accounts for the same provider.
       }
     })
 
-  // blink connector exec <provider> <endpoint> [params]
-  connector.command('exec <provider> <endpoint> [params]')
+  // blink connector exec <provider> <endpoint> [method-or-params] [params]
+  // Supports both patterns:
+  //   blink connector exec github /user/repos GET
+  //   blink connector exec notion /search POST '{"query":"notes"}'
+  //   blink connector exec notion /search '{"query":"notes"}'
+  connector.command('exec <provider> <endpoint> [method-or-params] [params]')
     .description('Execute a call on a connected OAuth provider')
     .option('--account <id>', 'Specific account ID (if you have multiple accounts)')
     .option('--method <method>', 'HTTP method: GET | POST | PUT | PATCH | DELETE (default: POST)', 'POST')
@@ -188,17 +192,28 @@ Provider base URLs used:
   shopify          https://{shop}.myshopify.com/admin/api/2024-10/
   ... run \`blink connector providers\` for all 38 providers
 `)
-    .action(async (provider: string, endpoint: string, paramsArg: string | undefined, opts) => {
+    .action(async (provider: string, endpoint: string, arg1: string | undefined, arg2: string | undefined, opts) => {
       requireToken()
+      const HTTP_METHODS = /^(GET|POST|PUT|PATCH|DELETE|HEAD)$/i
+      let httpMethod = opts.method
       let params: Record<string, unknown> = {}
-      if (paramsArg) {
-        try { params = JSON.parse(paramsArg) } catch { params = {} }
+
+      if (arg1) {
+        if (HTTP_METHODS.test(arg1)) {
+          // Pattern: exec provider endpoint GET ['{"key":"val"}']
+          httpMethod = arg1.toUpperCase()
+          if (arg2) { try { params = JSON.parse(arg2) } catch { params = {} } }
+        } else {
+          // Pattern: exec provider endpoint '{"key":"val"}'
+          try { params = JSON.parse(arg1) } catch { params = {} }
+        }
       }
-      const result = await withSpinner(`${opts.method} ${provider}${endpoint}...`, () =>
+
+      const result = await withSpinner(`${httpMethod} ${provider}${endpoint}...`, () =>
         resourcesRequest(`/v1/connectors/${provider}/execute`, {
           body: {
             method: endpoint,
-            http_method: opts.method,
+            http_method: httpMethod,
             params,
             ...(opts.account ? { account_id: opts.account } : {}),
           }

package/src/commands/linkedin.ts

@@ -117,6 +117,36 @@ Examples:
       if (data?.id) console.log(chalk.dim(`  URN: ${data.id}`))
     })
 
+  // blink linkedin upload-media <media-url>
+  li.command('upload-media <media-url>')
+    .description('Upload an image or video to LinkedIn storage, returns asset URN for use in posts')
+    .option('--type <type>', 'Media type: image | video (default: image)', 'image')
+    .option('--agent <id>', 'Agent ID (defaults to BLINK_AGENT_ID)')
+    .addHelpText('after', `
+Returns an asset URN to use when composing a post with media via blink connector exec.
+
+Examples:
+  $ blink linkedin upload-media https://example.com/photo.jpg
+  $ blink linkedin upload-media https://example.com/demo.mp4 --type video
+  $ ASSET_URN=$(blink linkedin upload-media https://example.com/photo.jpg --json | python3 -c "import json,sys; print(json.load(sys.stdin)['asset_urn'])")
+`)
+    .action(async (mediaUrl: string, opts) => {
+      requireToken()
+      const agentId = requireAgentId(opts.agent)
+      const result = await withSpinner(`Uploading ${opts.type}...`, () =>
+        resourcesRequest('/v1/connectors/linkedin/upload-media', {
+          body: { media_url: mediaUrl, media_type: opts.type },
+          headers: { 'x-blink-agent-id': agentId },
+        })
+      )
+      if (isJsonMode()) return printJson(result?.data ?? result)
+      const assetUrn = result?.data?.asset_urn
+      if (assetUrn) {
+        console.log(chalk.green('✓ Upload complete'))
+        console.log(chalk.dim(`  Asset URN: ${assetUrn}`))
+      }
+    })
+
   // blink linkedin delete <postUrn>
   li.command('delete <postUrn>')
     .description('Delete one of your LinkedIn posts')

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)