@blinkdotnew/cli 0.3.2 → 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 } : {}
         }
       })
@@ -1127,6 +1128,7 @@ The email is sent from your project's configured sender address (set in blink.ne
 }
 
 // src/commands/connector.ts
+init_agent();
 import chalk6 from "chalk";
 var PROVIDERS = [
   // Communication
@@ -1233,8 +1235,10 @@ ${filtered.length} providers total. Connect at blink.new/settings?tab=connectors
         if (d.metadata?.email) console.log(chalk6.dim(`  Email:   ${d.metadata.email}`));
         if (d.metadata?.name) console.log(chalk6.dim(`  Name:    ${d.metadata.name}`));
       } else {
+        const agentUrl = process.env.BLINK_WORKSPACE_SLUG && process.env.BLINK_AGENT_ID ? `https://blink.new/${process.env.BLINK_WORKSPACE_SLUG}/claw/${process.env.BLINK_AGENT_ID}` : "https://blink.new/settings?tab=connectors";
         console.log(chalk6.red("\u2717 Not connected"));
-        console.log(chalk6.dim(`  Connect at blink.new/settings?tab=connectors`));
+        console.log(chalk6.dim(`  Fix:     blink connector link ${provider}`));
+        console.log(chalk6.dim(`  Or visit: ${agentUrl}`));
       }
     } else {
       const result = await withSpinner(
@@ -1257,6 +1261,40 @@ ${filtered.length} providers total. Connect at blink.new/settings?tab=connectors
 ${connected.length} provider(s) connected`));
     }
   });
+  connector.command("link <provider>").description("Auto-link a workspace connector to the current agent").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").addHelpText("after", `
+Links the workspace's connected account for <provider> to this agent automatically.
+The workspace must already have the account connected at blink.new/settings?tab=connectors.
+
+This is the self-service fix when an agent gets "not linked" errors \u2014 run this once
+and the connector will be available for all subsequent commands.
+
+Examples:
+  $ blink connector link linkedin         Link LinkedIn to this agent
+  $ blink connector link notion           Link Notion to this agent
+  $ blink connector link slack            Link Slack to this agent
+  $ blink connector link linkedin --json  Machine-readable output
+`).action(async (provider, opts) => {
+    requireToken();
+    const agentId = requireAgentId(opts.agent);
+    const result = await withSpinner(
+      `Linking ${provider} to agent ${agentId}...`,
+      () => resourcesRequest(`/v1/connectors/${provider}/link`, {
+        method: "POST",
+        headers: { "x-blink-agent-id": agentId },
+        body: {}
+      })
+    );
+    if (!result?.success) {
+      const agentUrl = process.env.BLINK_WORKSPACE_SLUG && process.env.BLINK_AGENT_ID ? `https://blink.new/${process.env.BLINK_WORKSPACE_SLUG}/claw/${process.env.BLINK_AGENT_ID}` : "https://blink.new/settings?tab=connectors";
+      console.error(chalk6.red(`\u2717 ${result?.error ?? `No ${provider} account in workspace`}`));
+      console.error(chalk6.dim(`  Connect one first: ${agentUrl}`));
+      process.exit(1);
+    }
+    if (isJsonMode()) return printJson(result.data);
+    const label = result.data?.account_label ?? provider;
+    console.log(chalk6.green(`\u2713 ${provider} linked`) + chalk6.dim(` (${label})`));
+    console.log(chalk6.dim(`  Agent ${agentId} can now use blink connector exec ${provider}`));
+  });
   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.
 
@@ -1332,13 +1370,24 @@ Provider base URLs used:
 // src/commands/linkedin.ts
 init_agent();
 import chalk7 from "chalk";
-var NOT_LINKED = "LinkedIn not linked. Link it in the Agent Integrations tab at blink.new/claw";
+function getAgentPageUrl() {
+  const slug = process.env.BLINK_WORKSPACE_SLUG;
+  const agentId = process.env.BLINK_AGENT_ID;
+  if (slug && agentId) return `https://blink.new/${slug}/claw/${agentId}`;
+  return "https://blink.new/claw";
+}
+function notLinkedError() {
+  const url = getAgentPageUrl();
+  return `LinkedIn not linked to this agent.
+  Fix: blink connector link linkedin
+  Or connect manually: ${url}`;
+}
 async function liExec(method, httpMethod, params, agentId) {
   const result = await resourcesRequest("/v1/connectors/linkedin/execute", {
     body: { method, http_method: httpMethod, params },
     headers: { "x-blink-agent-id": agentId }
   });
-  if (!result?.success) throw new Error(result?.error ?? NOT_LINKED);
+  if (!result?.success) throw new Error(result?.error ?? notLinkedError());
   return result.data;
 }
 async function getPersonId(agentId) {
@@ -1557,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
@@ -1588,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
         }
       })
     );
@@ -1612,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}"`);
   });
@@ -1642,7 +1708,8 @@ Examples:
 The number is permanently returned to the carrier pool. This action cannot be undone.
 `).action(async (id, opts) => {
     requireToken();
-    if (!opts.yes && !isJsonMode()) {
+    const skipConfirm = process.argv.includes("--yes") || process.argv.includes("-y") || isJsonMode();
+    if (!skipConfirm) {
       const { confirm } = await import("@clack/prompts");
       const yes = await confirm({ message: `Release ${id}? This cannot be undone.` });
       if (!yes) {
@@ -2050,6 +2117,41 @@ Examples:
     console.log(chalk11.bold("Machine  ") + (a.machine_size ?? "-"));
     if (a.fly_app_name) console.log(chalk11.bold("Fly App  ") + a.fly_app_name);
   });
+  agent.command("url [agent_id]").description("Print the blink.new page URL for this agent (for sharing / setup links)").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID or BLINK_ACTIVE_AGENT)").addHelpText("after", `
+Returns the direct URL to this agent's page on blink.new.
+On Claw machines, uses BLINK_WORKSPACE_SLUG + BLINK_AGENT_ID env vars (no API call).
+Otherwise fetches workspace slug from the API.
+
+Examples:
+  $ blink agent url
+  https://blink.new/kai/claw/clw_xxx
+
+  $ blink agent url --json
+  {"url":"https://blink.new/kai/claw/clw_xxx","agent_id":"clw_xxx","workspace_slug":"kai"}
+`).action(async (agentIdArg, opts) => {
+    requireToken();
+    const agentId = requireAgentId(opts.agent ?? agentIdArg);
+    const envSlug = process.env.BLINK_WORKSPACE_SLUG;
+    if (envSlug) {
+      const url2 = `https://blink.new/${envSlug}/claw/${agentId}`;
+      if (isJsonMode()) return printJson({ url: url2, agent_id: agentId, workspace_slug: envSlug });
+      console.log(url2);
+      return;
+    }
+    const result = await withSpinner(
+      "Fetching agent details...",
+      () => appRequest(`/api/claw/agents/${agentId}`)
+    );
+    const a = result?.agent ?? result;
+    const workspaceSlug = a?.workspace_slug ?? a?.workspace_id;
+    if (!workspaceSlug) {
+      console.error(chalk11.red("Could not determine workspace slug"));
+      process.exit(1);
+    }
+    const url = `https://blink.new/${workspaceSlug}/claw/${agentId}`;
+    if (isJsonMode()) return printJson({ url, agent_id: agentId, workspace_slug: workspaceSlug });
+    console.log(url);
+  });
 }
 
 // src/commands/secrets.ts

package/package.json

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

package/src/commands/agent.ts

@@ -86,4 +86,48 @@ Examples:
       console.log(chalk.bold('Machine  ') + (a.machine_size ?? '-'))
       if (a.fly_app_name) console.log(chalk.bold('Fly App  ') + a.fly_app_name)
     })
+
+  // blink agent url
+  agent.command('url [agent_id]')
+    .description('Print the blink.new page URL for this agent (for sharing / setup links)')
+    .option('--agent <id>', 'Agent ID (defaults to BLINK_AGENT_ID or BLINK_ACTIVE_AGENT)')
+    .addHelpText('after', `
+Returns the direct URL to this agent's page on blink.new.
+On Claw machines, uses BLINK_WORKSPACE_SLUG + BLINK_AGENT_ID env vars (no API call).
+Otherwise fetches workspace slug from the API.
+
+Examples:
+  $ blink agent url
+  https://blink.new/kai/claw/clw_xxx
+
+  $ blink agent url --json
+  {"url":"https://blink.new/kai/claw/clw_xxx","agent_id":"clw_xxx","workspace_slug":"kai"}
+`)
+    .action(async (agentIdArg: string | undefined, opts) => {
+      requireToken()
+      const agentId = requireAgentId(opts.agent ?? agentIdArg)
+
+      // Fast path: env vars already set on Claw machines (no API call needed)
+      const envSlug = process.env.BLINK_WORKSPACE_SLUG
+      if (envSlug) {
+        const url = `https://blink.new/${envSlug}/claw/${agentId}`
+        if (isJsonMode()) return printJson({ url, agent_id: agentId, workspace_slug: envSlug })
+        console.log(url)
+        return
+      }
+
+      // Fallback: fetch workspace slug from API
+      const result = await withSpinner('Fetching agent details...', () =>
+        appRequest(`/api/claw/agents/${agentId}`)
+      )
+      const a = result?.agent ?? result
+      const workspaceSlug = a?.workspace_slug ?? a?.workspace_id
+      if (!workspaceSlug) {
+        console.error(chalk.red('Could not determine workspace slug'))
+        process.exit(1)
+      }
+      const url = `https://blink.new/${workspaceSlug}/claw/${agentId}`
+      if (isJsonMode()) return printJson({ url, agent_id: agentId, workspace_slug: workspaceSlug })
+      console.log(url)
+    })
 }

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/connector.ts

@@ -1,6 +1,7 @@
 import { Command } from 'commander'
 import { resourcesRequest } from '../lib/api-resources.js'
 import { requireToken } from '../lib/auth.js'
+import { requireAgentId } from '../lib/agent.js'
 import { printJson, isJsonMode, withSpinner, createTable } from '../lib/output.js'
 import chalk from 'chalk'
 
@@ -124,8 +125,12 @@ Use --account <id> if you have multiple linked accounts for the same provider.
           if (d.metadata?.email) console.log(chalk.dim(`  Email:   ${d.metadata.email}`))
           if (d.metadata?.name) console.log(chalk.dim(`  Name:    ${d.metadata.name}`))
         } else {
+          const agentUrl = process.env.BLINK_WORKSPACE_SLUG && process.env.BLINK_AGENT_ID
+            ? `https://blink.new/${process.env.BLINK_WORKSPACE_SLUG}/claw/${process.env.BLINK_AGENT_ID}`
+            : 'https://blink.new/settings?tab=connectors'
           console.log(chalk.red('✗ Not connected'))
-          console.log(chalk.dim(`  Connect at blink.new/settings?tab=connectors`))
+          console.log(chalk.dim(`  Fix:     blink connector link ${provider}`))
+          console.log(chalk.dim(`  Or visit: ${agentUrl}`))
         }
       } else {
         // List all connected providers
@@ -149,6 +154,47 @@ Use --account <id> if you have multiple linked accounts for the same provider.
       }
     })
 
+  // blink connector link <provider>
+  connector.command('link <provider>')
+    .description('Auto-link a workspace connector to the current agent')
+    .option('--agent <id>', 'Agent ID (defaults to BLINK_AGENT_ID)')
+    .addHelpText('after', `
+Links the workspace's connected account for <provider> to this agent automatically.
+The workspace must already have the account connected at blink.new/settings?tab=connectors.
+
+This is the self-service fix when an agent gets "not linked" errors — run this once
+and the connector will be available for all subsequent commands.
+
+Examples:
+  $ blink connector link linkedin         Link LinkedIn to this agent
+  $ blink connector link notion           Link Notion to this agent
+  $ blink connector link slack            Link Slack to this agent
+  $ blink connector link linkedin --json  Machine-readable output
+`)
+    .action(async (provider: string, opts) => {
+      requireToken()
+      const agentId = requireAgentId(opts.agent)
+      const result = await withSpinner(`Linking ${provider} to agent ${agentId}...`, () =>
+        resourcesRequest(`/v1/connectors/${provider}/link`, {
+          method: 'POST',
+          headers: { 'x-blink-agent-id': agentId },
+          body: {},
+        })
+      )
+      if (!result?.success) {
+        const agentUrl = process.env.BLINK_WORKSPACE_SLUG && process.env.BLINK_AGENT_ID
+          ? `https://blink.new/${process.env.BLINK_WORKSPACE_SLUG}/claw/${process.env.BLINK_AGENT_ID}`
+          : 'https://blink.new/settings?tab=connectors'
+        console.error(chalk.red(`✗ ${result?.error ?? `No ${provider} account in workspace`}`))
+        console.error(chalk.dim(`  Connect one first: ${agentUrl}`))
+        process.exit(1)
+      }
+      if (isJsonMode()) return printJson(result.data)
+      const label = result.data?.account_label ?? provider
+      console.log(chalk.green(`✓ ${provider} linked`) + chalk.dim(` (${label})`))
+      console.log(chalk.dim(`  Agent ${agentId} can now use blink connector exec ${provider}`))
+    })
+
   // blink connector exec <provider> <endpoint> [method-or-params] [params]
   // Supports both patterns:
   //   blink connector exec github /user/repos GET

package/src/commands/linkedin.ts

@@ -5,7 +5,19 @@ import { printJson, isJsonMode, withSpinner } from '../lib/output.js'
 import { resourcesRequest } from '../lib/api-resources.js'
 import chalk from 'chalk'
 
-const NOT_LINKED = 'LinkedIn not linked. Link it in the Agent Integrations tab at blink.new/claw'
+// Build agent page URL from env vars (set at machine creation via BLINK_WORKSPACE_SLUG).
+// Falls back to generic URL if env vars aren't set (e.g. local dev).
+function getAgentPageUrl(): string {
+  const slug = process.env.BLINK_WORKSPACE_SLUG
+  const agentId = process.env.BLINK_AGENT_ID
+  if (slug && agentId) return `https://blink.new/${slug}/claw/${agentId}`
+  return 'https://blink.new/claw'
+}
+
+function notLinkedError(): string {
+  const url = getAgentPageUrl()
+  return `LinkedIn not linked to this agent.\n  Fix: blink connector link linkedin\n  Or connect manually: ${url}`
+}
 
 async function liExec(
   method: string,
@@ -17,7 +29,7 @@ async function liExec(
     body: { method, http_method: httpMethod, params },
     headers: { 'x-blink-agent-id': agentId },
   })
-  if (!result?.success) throw new Error(result?.error ?? NOT_LINKED)
+  if (!result?.success) throw new Error(result?.error ?? notLinkedError())
   return result.data
 }
 

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}"`)
     })
@@ -163,7 +182,8 @@ The number is permanently returned to the carrier pool. This action cannot be un
 `)
     .action(async (id: string, opts) => {
       requireToken()
-      if (!opts.yes && !isJsonMode()) {
+      const skipConfirm = process.argv.includes('--yes') || process.argv.includes('-y') || isJsonMode()
+      if (!skipConfirm) {
         const { confirm } = await import('@clack/prompts')
         const yes = await confirm({ message: `Release ${id}? This cannot be undone.` })
         if (!yes) { console.log('Cancelled.'); return }