@blinkdotnew/cli 0.3.2 → 0.3.3

package/dist/cli.js

@@ -1127,6 +1127,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 +1234,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 +1260,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 +1369,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) {
@@ -1642,7 +1690,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 +2099,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.3",
   "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/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

@@ -163,7 +163,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 }