@blinkdotnew/cli 0.3.0 → 0.3.2

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);
@@ -1320,30 +1348,40 @@ async function getPersonId(agentId) {
   return id;
 }
 function registerLinkedInCommands(program2) {
-  const li = program2.command("linkedin").description("LinkedIn connector \u2014 publish posts and manage your profile").addHelpText("after", `
+  const li = program2.command("linkedin").description("LinkedIn connector \u2014 publish posts, comment, react, and manage your profile").addHelpText("after", `
 LinkedIn must be linked to your agent via the Integrations tab at blink.new/claw.
 Agent ID defaults to BLINK_AGENT_ID (automatically set on Claw Fly machines).
 
 What works today (w_member_social scope):
   \u2705 blink linkedin me                               Show your LinkedIn profile
-  \u2705 blink linkedin post "Excited to announce..."    Publish a text post
+  \u2705 blink linkedin post "text"                      Publish a text post
   \u2705 blink linkedin delete <postUrn>                 Delete one of your posts
+  \u2705 blink linkedin like <postUrn>                   Like a post
+  \u2705 blink linkedin unlike <postUrn>                 Unlike a post
+  \u2705 blink linkedin comment <postUrn> "text"         Add a comment
+
+For feed reading, search, and profiles \u2014 use scripts/lk.py (requires cookies):
+  python3 scripts/lk.py feed -n 10       Browse your LinkedIn feed
+  python3 scripts/lk.py search "query"   Search people
+  python3 scripts/lk.py profile <id>     View a profile
+  python3 scripts/lk.py messages         Check messages
+  See SKILL.md for cookie setup instructions.
 
-Not yet available (requires LinkedIn Partner API approval):
-  \u2717  Reading posts, comments, likes (needs r_member_social \u2014 restricted scope)
-  \u2717  Adding comments (needs Community Management API)
+Post URNs: use the URN returned by "blink linkedin post --json" or extract from
+  a LinkedIn post URL: https://linkedin.com/feed/update/urn:li:activity:123...
 
 Examples:
   $ blink linkedin me
-  $ blink linkedin post "Our product just launched!"
-  $ blink linkedin post "Team update" --visibility CONNECTIONS
-  $ blink linkedin delete "urn:li:ugcPost:1234567890"
+  $ blink linkedin post "Our product just launched! \u{1F680}"
+  $ blink linkedin like "urn:li:share:1234567890"
+  $ blink linkedin comment "urn:li:share:1234567890" "Great post!"
+  $ blink linkedin delete "urn:li:share:1234567890"
 `);
   li.command("me").description("Show your LinkedIn profile (name, ID, email)").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").addHelpText("after", `
 Examples:
   $ blink linkedin me
   $ blink linkedin me --json
-  $ blink linkedin me --agent clw_xxx
+  $ PERSON_ID=$(blink linkedin me --json | jq -r .sub)
 `).action(async (opts) => {
     requireToken();
     const agentId = requireAgentId(opts.agent);
@@ -1360,10 +1398,12 @@ Examples:
     if (data?.email) console.log(`  ${chalk7.dim("Email:")}  ${data.email}`);
   });
   li.command("post <text>").description("Publish a text post to LinkedIn").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").option("--visibility <vis>", "PUBLIC | CONNECTIONS (default: PUBLIC)", "PUBLIC").addHelpText("after", `
+Returns the post URN which you can pass to like/comment/delete.
+
 Examples:
   $ blink linkedin post "Excited to share our latest update!"
-  $ blink linkedin post "Internal team update" --visibility CONNECTIONS
-  $ blink linkedin post "Hello LinkedIn" --json
+  $ blink linkedin post "Internal update" --visibility CONNECTIONS
+  $ POST_URN=$(blink linkedin post "Hello LinkedIn" --json | jq -r .id)
 `).action(async (text, opts) => {
     requireToken();
     const agentId = requireAgentId(opts.agent);
@@ -1395,46 +1435,227 @@ 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.
-
+  li.command("delete <postUrn>").description("Delete one of your LinkedIn posts").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").addHelpText("after", `
 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) => {
+  $ blink linkedin delete "urn:li:share:1234567890"
+`).action(async (postUrn, 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 }
-      })
+    const encoded = encodeURIComponent(postUrn);
+    await withSpinner(
+      "Deleting post...",
+      () => liExec(`ugcPosts/${encoded}`, "DELETE", {}, 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}`));
-    }
+    if (isJsonMode()) return printJson({ deleted: true, urn: postUrn });
+    console.log(chalk7.green("\u2713 Post deleted"));
   });
-  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
+  li.command("like <postUrn>").description("Like a LinkedIn post").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").addHelpText("after", `
+<postUrn> accepts urn:li:share:, urn:li:ugcPost:, or urn:li:activity: URNs.
+LinkedIn feed URLs contain the activity URN: linkedin.com/feed/update/urn:li:activity:123
 
 Examples:
-  $ blink linkedin delete "urn:li:ugcPost:1234567890"
+  $ blink linkedin like "urn:li:share:1234567890"
+  $ blink linkedin like "urn:li:activity:1234567890"
 `).action(async (postUrn, opts) => {
     requireToken();
     const agentId = requireAgentId(opts.agent);
+    const personId = await withSpinner(
+      "Resolving LinkedIn identity...",
+      () => getPersonId(agentId)
+    );
     const encoded = encodeURIComponent(postUrn);
+    const data = await withSpinner(
+      "Liking post...",
+      () => liExec(`v2/socialActions/${encoded}/likes`, "POST", {
+        actor: `urn:li:person:${personId}`
+      }, agentId)
+    );
+    if (isJsonMode()) return printJson(data);
+    console.log(chalk7.green("\u2713 Post liked"));
+    if (data?.["$URN"]) console.log(chalk7.dim(`  Like URN: ${data["$URN"]}`));
+  });
+  li.command("unlike <postUrn>").description("Unlike a LinkedIn post").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").addHelpText("after", `
+Examples:
+  $ blink linkedin unlike "urn:li:share:1234567890"
+`).action(async (postUrn, opts) => {
+    requireToken();
+    const agentId = requireAgentId(opts.agent);
+    const personId = await withSpinner(
+      "Resolving LinkedIn identity...",
+      () => getPersonId(agentId)
+    );
+    const encodedPost = encodeURIComponent(postUrn);
+    const encodedPerson = encodeURIComponent(`urn:li:person:${personId}`);
     await withSpinner(
-      "Deleting post...",
-      () => liExec(`ugcPosts/${encoded}`, "DELETE", {}, agentId)
+      "Unliking post...",
+      () => liExec(`v2/socialActions/${encodedPost}/likes/${encodedPerson}`, "DELETE", {}, agentId)
     );
-    if (isJsonMode()) return printJson({ deleted: true, urn: postUrn });
-    console.log(chalk7.green("\u2713 Post deleted"));
+    if (isJsonMode()) return printJson({ unliked: true });
+    console.log(chalk7.green("\u2713 Post unliked"));
+  });
+  li.command("comment <postUrn> <text>").description("Add a comment to a LinkedIn post").option("--agent <id>", "Agent ID (defaults to BLINK_AGENT_ID)").addHelpText("after", `
+<postUrn> accepts urn:li:share:, urn:li:ugcPost:, or urn:li:activity: URNs.
+
+Examples:
+  $ blink linkedin comment "urn:li:share:1234567890" "Great post!"
+  $ blink linkedin comment "urn:li:activity:1234567890" "Thanks for sharing"
+`).action(async (postUrn, text, opts) => {
+    requireToken();
+    const agentId = requireAgentId(opts.agent);
+    const personId = await withSpinner(
+      "Resolving LinkedIn identity...",
+      () => getPersonId(agentId)
+    );
+    const encoded = encodeURIComponent(postUrn);
+    const data = await withSpinner(
+      "Adding comment...",
+      () => liExec(`v2/socialActions/${encoded}/comments`, "POST", {
+        actor: `urn:li:person:${personId}`,
+        message: { text }
+      }, agentId)
+    );
+    if (isJsonMode()) return printJson(data);
+    console.log(chalk7.green("\u2713 Comment added"));
+    if (data?.id) console.log(chalk7.dim(`  Comment ID: ${data.id}`));
+  });
+}
+
+// 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`);
   });
 }
 
@@ -1981,6 +2202,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 +2269,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.2",
   "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/linkedin.ts

@@ -30,25 +30,35 @@ async function getPersonId(agentId: string): Promise<string> {
 
 export function registerLinkedInCommands(program: Command) {
   const li = program.command('linkedin')
-    .description('LinkedIn connector — publish posts and manage your profile')
+    .description('LinkedIn connector — publish posts, comment, react, and manage your profile')
     .addHelpText('after', `
 LinkedIn must be linked to your agent via the Integrations tab at blink.new/claw.
 Agent ID defaults to BLINK_AGENT_ID (automatically set on Claw Fly machines).
 
 What works today (w_member_social scope):
   ✅ blink linkedin me                               Show your LinkedIn profile
-  ✅ blink linkedin post "Excited to announce..."    Publish a text post
+  ✅ blink linkedin post "text"                      Publish a text post
   ✅ blink linkedin delete <postUrn>                 Delete one of your posts
+  ✅ blink linkedin like <postUrn>                   Like a post
+  ✅ blink linkedin unlike <postUrn>                 Unlike a post
+  ✅ blink linkedin comment <postUrn> "text"         Add a comment
 
-Not yet available (requires LinkedIn Partner API approval):
-  ✗  Reading posts, comments, likes (needs r_member_social — restricted scope)
-  ✗  Adding comments (needs Community Management API)
+For feed reading, search, and profiles — use scripts/lk.py (requires cookies):
+  python3 scripts/lk.py feed -n 10       Browse your LinkedIn feed
+  python3 scripts/lk.py search "query"   Search people
+  python3 scripts/lk.py profile <id>     View a profile
+  python3 scripts/lk.py messages         Check messages
+  See SKILL.md for cookie setup instructions.
+
+Post URNs: use the URN returned by "blink linkedin post --json" or extract from
+  a LinkedIn post URL: https://linkedin.com/feed/update/urn:li:activity:123...
 
 Examples:
   $ blink linkedin me
-  $ blink linkedin post "Our product just launched!"
-  $ blink linkedin post "Team update" --visibility CONNECTIONS
-  $ blink linkedin delete "urn:li:ugcPost:1234567890"
+  $ blink linkedin post "Our product just launched! 🚀"
+  $ blink linkedin like "urn:li:share:1234567890"
+  $ blink linkedin comment "urn:li:share:1234567890" "Great post!"
+  $ blink linkedin delete "urn:li:share:1234567890"
 `)
 
   // blink linkedin me
@@ -59,7 +69,7 @@ Examples:
 Examples:
   $ blink linkedin me
   $ blink linkedin me --json
-  $ blink linkedin me --agent clw_xxx
+  $ PERSON_ID=$(blink linkedin me --json | jq -r .sub)
 `)
     .action(async (opts) => {
       requireToken()
@@ -82,10 +92,12 @@ Examples:
     .option('--agent <id>', 'Agent ID (defaults to BLINK_AGENT_ID)')
     .option('--visibility <vis>', 'PUBLIC | CONNECTIONS (default: PUBLIC)', 'PUBLIC')
     .addHelpText('after', `
+Returns the post URN which you can pass to like/comment/delete.
+
 Examples:
   $ blink linkedin post "Excited to share our latest update!"
-  $ blink linkedin post "Internal team update" --visibility CONNECTIONS
-  $ blink linkedin post "Hello LinkedIn" --json
+  $ blink linkedin post "Internal update" --visibility CONNECTIONS
+  $ POST_URN=$(blink linkedin post "Hello LinkedIn" --json | jq -r .id)
 `)
     .action(async (text: string, opts) => {
       requireToken()
@@ -117,55 +129,103 @@ 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')
+  // blink linkedin delete <postUrn>
+  li.command('delete <postUrn>')
+    .description('Delete one of your LinkedIn posts')
     .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'])")
+  $ blink linkedin delete "urn:li:share:1234567890"
 `)
-    .action(async (mediaUrl: string, opts) => {
+    .action(async (postUrn: 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 },
-        })
+      const encoded = encodeURIComponent(postUrn)
+      await withSpinner('Deleting post...', () =>
+        liExec(`ugcPosts/${encoded}`, 'DELETE', {}, 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}`))
-      }
+      if (isJsonMode()) return printJson({ deleted: true, urn: postUrn })
+      console.log(chalk.green('✓ Post deleted'))
     })
 
-  // blink linkedin delete <postUrn>
-  li.command('delete <postUrn>')
-    .description('Delete one of your LinkedIn posts')
+  // blink linkedin like <postUrn>
+  li.command('like <postUrn>')
+    .description('Like a LinkedIn post')
     .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
+<postUrn> accepts urn:li:share:, urn:li:ugcPost:, or urn:li:activity: URNs.
+LinkedIn feed URLs contain the activity URN: linkedin.com/feed/update/urn:li:activity:123
 
 Examples:
-  $ blink linkedin delete "urn:li:ugcPost:1234567890"
+  $ blink linkedin like "urn:li:share:1234567890"
+  $ blink linkedin like "urn:li:activity:1234567890"
 `)
     .action(async (postUrn: string, opts) => {
       requireToken()
       const agentId = requireAgentId(opts.agent)
+      const personId = await withSpinner('Resolving LinkedIn identity...', () =>
+        getPersonId(agentId)
+      )
       const encoded = encodeURIComponent(postUrn)
-      await withSpinner('Deleting post...', () =>
-        liExec(`ugcPosts/${encoded}`, 'DELETE', {}, agentId)
+      const data = await withSpinner('Liking post...', () =>
+        liExec(`v2/socialActions/${encoded}/likes`, 'POST', {
+          actor: `urn:li:person:${personId}`,
+        }, agentId)
       )
-      if (isJsonMode()) return printJson({ deleted: true, urn: postUrn })
-      console.log(chalk.green('✓ Post deleted'))
+      if (isJsonMode()) return printJson(data)
+      console.log(chalk.green('✓ Post liked'))
+      if (data?.['$URN']) console.log(chalk.dim(`  Like URN: ${data['$URN']}`))
+    })
+
+  // blink linkedin unlike <postUrn>
+  li.command('unlike <postUrn>')
+    .description('Unlike a LinkedIn post')
+    .option('--agent <id>', 'Agent ID (defaults to BLINK_AGENT_ID)')
+    .addHelpText('after', `
+Examples:
+  $ blink linkedin unlike "urn:li:share:1234567890"
+`)
+    .action(async (postUrn: string, opts) => {
+      requireToken()
+      const agentId = requireAgentId(opts.agent)
+      const personId = await withSpinner('Resolving LinkedIn identity...', () =>
+        getPersonId(agentId)
+      )
+      const encodedPost = encodeURIComponent(postUrn)
+      const encodedPerson = encodeURIComponent(`urn:li:person:${personId}`)
+      await withSpinner('Unliking post...', () =>
+        liExec(`v2/socialActions/${encodedPost}/likes/${encodedPerson}`, 'DELETE', {}, agentId)
+      )
+      if (isJsonMode()) return printJson({ unliked: true })
+      console.log(chalk.green('✓ Post unliked'))
+    })
+
+  // blink linkedin comment <postUrn> "text"
+  li.command('comment <postUrn> <text>')
+    .description('Add a comment to a LinkedIn post')
+    .option('--agent <id>', 'Agent ID (defaults to BLINK_AGENT_ID)')
+    .addHelpText('after', `
+<postUrn> accepts urn:li:share:, urn:li:ugcPost:, or urn:li:activity: URNs.
+
+Examples:
+  $ blink linkedin comment "urn:li:share:1234567890" "Great post!"
+  $ blink linkedin comment "urn:li:activity:1234567890" "Thanks for sharing"
+`)
+    .action(async (postUrn: string, text: string, opts) => {
+      requireToken()
+      const agentId = requireAgentId(opts.agent)
+      const personId = await withSpinner('Resolving LinkedIn identity...', () =>
+        getPersonId(agentId)
+      )
+      const encoded = encodeURIComponent(postUrn)
+      const data = await withSpinner('Adding comment...', () =>
+        liExec(`v2/socialActions/${encoded}/comments`, 'POST', {
+          actor: `urn:li:person:${personId}`,
+          message: { text },
+        }, agentId)
+      )
+      if (isJsonMode()) return printJson(data)
+      console.log(chalk.green('✓ Comment added'))
+      if (data?.id) console.log(chalk.dim(`  Comment ID: ${data.id}`))
     })
 }

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)