@blinkdotnew/cli 0.5.3 → 0.6.0

package/dist/cli.js

@@ -3831,6 +3831,370 @@ Examples:
   });
 }
 
+// src/commands/queue.ts
+init_project();
+import chalk25 from "chalk";
+function registerQueueCommands(program2) {
+  const queue = program2.command("queue").description("Manage background task queues and cron schedules").addHelpText("after", `
+Blink Queue provides background task processing and cron scheduling.
+Tasks are delivered to your backend at /api/queue. Pro+ plans only.
+
+Examples:
+  $ blink queue enqueue send-email --payload '{"to":"user@example.com"}'
+  $ blink queue schedule create daily-cleanup "0 3 * * *"
+  $ blink queue list --status pending
+  $ blink queue stats
+  $ blink queue dlq list
+`);
+  registerEnqueue(queue);
+  registerList(queue);
+  registerGet(queue);
+  registerCancel(queue);
+  registerStats(queue);
+  registerScheduleCommands(queue);
+  registerQueueCrud(queue);
+  registerDlqCommands(queue);
+}
+function queuePath(projectId, path) {
+  return `/api/project/${projectId}/queue/${path}`;
+}
+function registerEnqueue(queue) {
+  queue.command("enqueue <taskName>").description("Enqueue a background task").option("--payload <json>", "JSON payload", "{}").option("--queue <name>", "Named queue for FIFO ordering").option("--delay <duration>", "Delay before execution (e.g. 30s, 5m, 1h)").option("--retries <n>", "Max retry attempts", "3").option("--timeout <duration>", "Execution timeout (e.g. 30s, 5m)").addHelpText("after", `
+Examples:
+  $ blink queue enqueue send-email --payload '{"to":"user@example.com"}'
+  $ blink queue enqueue process-image --queue media --delay 5m
+  $ blink queue enqueue cleanup --retries 5 --timeout 60s
+`).action(async (taskName, opts) => {
+    requireToken();
+    const projectId = requireProjectId();
+    let payload = {};
+    if (opts.payload && opts.payload !== "{}") {
+      payload = JSON.parse(opts.payload);
+    }
+    const body = { taskName, payload, retries: parseInt(opts.retries) };
+    if (opts.queue) body.queue = opts.queue;
+    if (opts.delay) body.delay = opts.delay;
+    if (opts.timeout) body.timeout = opts.timeout;
+    const result = await withSpinner(
+      `Enqueuing ${taskName}...`,
+      () => appRequest(queuePath(projectId, "enqueue"), { body })
+    );
+    if (isJsonMode()) return printJson(result);
+    printSuccess(`Task enqueued: ${result?.taskId ?? "ok"}`);
+    if (result?.taskId) printKv("Task ID", result.taskId);
+    if (opts.queue) printKv("Queue", opts.queue);
+  });
+}
+function registerList(queue) {
+  queue.command("list").description("List tasks").option("--status <status>", "Filter: pending, completed, failed, dead").option("--queue <name>", "Filter by queue name").option("--limit <n>", "Max results", "20").addHelpText("after", `
+Examples:
+  $ blink queue list
+  $ blink queue list --status pending
+  $ blink queue list --queue emails --limit 50
+  $ blink queue list --json
+`).action(async (opts) => {
+    requireToken();
+    const projectId = requireProjectId();
+    const params = new URLSearchParams();
+    if (opts.status) params.set("status", opts.status);
+    if (opts.queue) params.set("queue", opts.queue);
+    if (opts.limit) params.set("limit", opts.limit);
+    const result = await withSpinner(
+      "Loading tasks...",
+      () => appRequest(queuePath(projectId, `tasks?${params}`))
+    );
+    const tasks = result?.tasks ?? result ?? [];
+    if (isJsonMode()) return printJson(tasks);
+    if (!tasks.length) {
+      console.log(chalk25.dim("(no tasks)"));
+      return;
+    }
+    const table = createTable(["ID", "Task", "Status", "Queue", "Created"]);
+    for (const t of tasks) {
+      table.push([t.id, t.task_name, t.status, t.queue ?? "-", t.created_at?.slice(0, 19) ?? "-"]);
+    }
+    console.log(table.toString());
+  });
+}
+function registerGet(queue) {
+  queue.command("get <taskId>").description("Get task details").addHelpText("after", `
+Examples:
+  $ blink queue get tsk_abc123
+  $ blink queue get tsk_abc123 --json
+`).action(async (taskId) => {
+    requireToken();
+    const projectId = requireProjectId();
+    const result = await withSpinner(
+      "Loading task...",
+      () => appRequest(queuePath(projectId, `tasks/${taskId}`))
+    );
+    if (isJsonMode()) return printJson(result);
+    const t = result?.task ?? result;
+    printKv("ID", t.id);
+    printKv("Task", t.task_name);
+    printKv("Status", t.status);
+    if (t.queue) printKv("Queue", t.queue);
+    if (t.error) printKv("Error", chalk25.red(t.error));
+    printKv("Created", t.created_at);
+  });
+}
+function registerCancel(queue) {
+  queue.command("cancel <taskId>").description("Cancel a pending task").addHelpText("after", `
+Examples:
+  $ blink queue cancel tsk_abc123
+`).action(async (taskId) => {
+    requireToken();
+    const projectId = requireProjectId();
+    await withSpinner(
+      "Cancelling task...",
+      () => appRequest(queuePath(projectId, `tasks/${taskId}`), { method: "DELETE" })
+    );
+    if (isJsonMode()) return printJson({ status: "ok", task_id: taskId });
+    printSuccess(`Cancelled ${taskId}`);
+  });
+}
+function registerStats(queue) {
+  queue.command("stats").description("Show queue statistics").addHelpText("after", `
+Examples:
+  $ blink queue stats
+  $ blink queue stats --json
+`).action(async () => {
+    requireToken();
+    const projectId = requireProjectId();
+    const result = await withSpinner(
+      "Loading stats...",
+      () => appRequest(queuePath(projectId, "stats"))
+    );
+    if (isJsonMode()) return printJson(result);
+    console.log();
+    printKv("Pending", String(result?.pending ?? 0));
+    printKv("Completed", String(result?.completed ?? 0));
+    printKv("Failed", String(result?.failed ?? 0));
+    printKv("Dead", String(result?.dead ?? 0));
+    printKv("Schedules", String(result?.schedules ?? 0));
+    if (result?.tier) printKv("Tier", result.tier);
+    console.log();
+  });
+}
+function registerScheduleCommands(queue) {
+  const sched = queue.command("schedule").description("Manage cron schedules").addHelpText("after", `
+Examples:
+  $ blink queue schedule create daily-report "0 9 * * *"
+  $ blink queue schedule list
+  $ blink queue schedule pause daily-report
+  $ blink queue schedule delete daily-report
+`);
+  sched.command("create <name> <cron>").description("Create or update a cron schedule").option("--payload <json>", "JSON payload", "{}").option("--timezone <tz>", "Timezone (e.g. America/New_York)", "UTC").option("--retries <n>", "Max retries per execution", "3").addHelpText("after", `
+Examples:
+  $ blink queue schedule create daily-report "0 9 * * *"
+  $ blink queue schedule create cleanup "0 3 * * *" --timezone America/New_York
+  $ blink queue schedule create sync "*/15 * * * *" --payload '{"source":"api"}'
+`).action(async (name, cron, opts) => {
+    requireToken();
+    const projectId = requireProjectId();
+    let payload = {};
+    if (opts.payload && opts.payload !== "{}") payload = JSON.parse(opts.payload);
+    const body = { name, cron, payload, timezone: opts.timezone, retries: parseInt(opts.retries) };
+    const result = await withSpinner(
+      `Creating schedule "${name}"...`,
+      () => appRequest(queuePath(projectId, "schedule"), { body })
+    );
+    if (isJsonMode()) return printJson(result);
+    printSuccess(`Schedule "${name}" created: ${cron}`);
+    if (result?.scheduleId) printKv("Schedule ID", result.scheduleId);
+  });
+  sched.command("list").description("List all cron schedules").addHelpText("after", `
+Examples:
+  $ blink queue schedule list
+  $ blink queue schedule list --json
+`).action(async () => {
+    requireToken();
+    const projectId = requireProjectId();
+    const result = await withSpinner(
+      "Loading schedules...",
+      () => appRequest(queuePath(projectId, "schedules"))
+    );
+    const schedules = result?.schedules ?? result ?? [];
+    if (isJsonMode()) return printJson(schedules);
+    if (!schedules.length) {
+      console.log(chalk25.dim("(no schedules)"));
+      return;
+    }
+    const table = createTable(["Name", "Cron", "Timezone", "Paused", "Next Run"]);
+    for (const s of schedules) {
+      table.push([s.name, s.cron, s.timezone ?? "UTC", s.is_paused ? "yes" : "no", s.next_run_at ?? "-"]);
+    }
+    console.log(table.toString());
+  });
+  sched.command("pause <name>").description("Pause a schedule").action(async (name) => {
+    requireToken();
+    const projectId = requireProjectId();
+    await withSpinner(
+      `Pausing "${name}"...`,
+      () => appRequest(queuePath(projectId, `schedules/${name}/pause`), { method: "POST", body: {} })
+    );
+    if (isJsonMode()) return printJson({ status: "ok", name });
+    printSuccess(`Schedule "${name}" paused`);
+  });
+  sched.command("resume <name>").description("Resume a paused schedule").action(async (name) => {
+    requireToken();
+    const projectId = requireProjectId();
+    await withSpinner(
+      `Resuming "${name}"...`,
+      () => appRequest(queuePath(projectId, `schedules/${name}/resume`), { method: "POST", body: {} })
+    );
+    if (isJsonMode()) return printJson({ status: "ok", name });
+    printSuccess(`Schedule "${name}" resumed`);
+  });
+  sched.command("delete <name>").description("Delete a schedule").option("--yes", "Skip confirmation").action(async (name, opts) => {
+    requireToken();
+    const projectId = requireProjectId();
+    const skip = opts.yes || process.argv.includes("--yes") || process.argv.includes("-y") || isJsonMode() || !process.stdout.isTTY;
+    if (!skip) {
+      const { confirm } = await import("@clack/prompts");
+      const ok = await confirm({ message: `Delete schedule "${name}"?` });
+      if (!ok) {
+        console.log("Cancelled.");
+        return;
+      }
+    }
+    await withSpinner(
+      `Deleting "${name}"...`,
+      () => appRequest(queuePath(projectId, `schedules/${name}`), { method: "DELETE" })
+    );
+    if (isJsonMode()) return printJson({ status: "ok", name });
+    printSuccess(`Schedule "${name}" deleted`);
+  });
+}
+function registerQueueCrud(queue) {
+  queue.command("create-queue <name>").description("Create a named queue with parallelism control").option("--parallelism <n>", "Max concurrent tasks", "1").addHelpText("after", `
+Named queues provide FIFO ordering and parallelism control.
+
+Examples:
+  $ blink queue create-queue emails
+  $ blink queue create-queue media --parallelism 5
+`).action(async (name, opts) => {
+    requireToken();
+    const projectId = requireProjectId();
+    const result = await withSpinner(
+      `Creating queue "${name}"...`,
+      () => appRequest(queuePath(projectId, "queues"), { body: { name, parallelism: parseInt(opts.parallelism) } })
+    );
+    if (isJsonMode()) return printJson(result);
+    printSuccess(`Queue "${name}" created (parallelism: ${opts.parallelism})`);
+  });
+  queue.command("queues").description("List all named queues").addHelpText("after", `
+Examples:
+  $ blink queue queues
+  $ blink queue queues --json
+`).action(async () => {
+    requireToken();
+    const projectId = requireProjectId();
+    const result = await withSpinner(
+      "Loading queues...",
+      () => appRequest(queuePath(projectId, "queues"))
+    );
+    const queues = result?.queues ?? result ?? [];
+    if (isJsonMode()) return printJson(queues);
+    if (!queues.length) {
+      console.log(chalk25.dim("(no named queues)"));
+      return;
+    }
+    const table = createTable(["Name", "Parallelism", "Pending", "Created"]);
+    for (const q of queues) {
+      table.push([q.name, String(q.parallelism ?? 1), String(q.pending ?? 0), q.created_at?.slice(0, 10) ?? "-"]);
+    }
+    console.log(table.toString());
+  });
+  queue.command("delete-queue <name>").description("Delete a named queue").option("--yes", "Skip confirmation").action(async (name, opts) => {
+    requireToken();
+    const projectId = requireProjectId();
+    const skip = opts.yes || process.argv.includes("--yes") || process.argv.includes("-y") || isJsonMode() || !process.stdout.isTTY;
+    if (!skip) {
+      const { confirm } = await import("@clack/prompts");
+      const ok = await confirm({ message: `Delete queue "${name}"? Pending tasks will be lost.` });
+      if (!ok) {
+        console.log("Cancelled.");
+        return;
+      }
+    }
+    await withSpinner(
+      `Deleting queue "${name}"...`,
+      () => appRequest(queuePath(projectId, `queues/${name}`), { method: "DELETE" })
+    );
+    if (isJsonMode()) return printJson({ status: "ok", name });
+    printSuccess(`Queue "${name}" deleted`);
+  });
+}
+function registerDlqCommands(queue) {
+  const dlq = queue.command("dlq").description("Manage dead letter queue (failed tasks)").addHelpText("after", `
+Tasks that exhaust all retries are moved to the dead letter queue.
+
+Examples:
+  $ blink queue dlq list
+  $ blink queue dlq retry <taskId>
+  $ blink queue dlq purge --yes
+`);
+  dlq.command("list").description("List dead tasks").action(async () => {
+    requireToken();
+    const projectId = requireProjectId();
+    const result = await withSpinner(
+      "Loading DLQ...",
+      () => appRequest(queuePath(projectId, "dlq"))
+    );
+    const tasks = result?.tasks ?? result ?? [];
+    if (isJsonMode()) return printJson(tasks);
+    if (!tasks.length) {
+      console.log(chalk25.dim("(no dead tasks)"));
+      return;
+    }
+    const table = createTable(["ID", "Task", "Error", "Failed At"]);
+    for (const t of tasks) {
+      table.push([t.id, t.task_name, (t.error ?? "-").slice(0, 40), t.failed_at?.slice(0, 19) ?? "-"]);
+    }
+    console.log(table.toString());
+  });
+  dlq.command("retry <taskId>").description("Retry a dead task").action(async (taskId) => {
+    requireToken();
+    const projectId = requireProjectId();
+    await withSpinner(
+      `Retrying ${taskId}...`,
+      () => appRequest(queuePath(projectId, `dlq/${taskId}/retry`), { method: "POST", body: {} })
+    );
+    if (isJsonMode()) return printJson({ status: "ok", task_id: taskId });
+    printSuccess(`Retried ${taskId}`);
+  });
+  dlq.command("delete <taskId>").description("Delete a dead task").action(async (taskId) => {
+    requireToken();
+    const projectId = requireProjectId();
+    await withSpinner(
+      `Deleting ${taskId}...`,
+      () => appRequest(queuePath(projectId, `dlq/${taskId}`), { method: "DELETE" })
+    );
+    if (isJsonMode()) return printJson({ status: "ok", task_id: taskId });
+    printSuccess(`Deleted ${taskId} from DLQ`);
+  });
+  dlq.command("purge").description("Delete all dead tasks").option("--yes", "Skip confirmation").action(async (opts) => {
+    requireToken();
+    const projectId = requireProjectId();
+    const skip = opts.yes || process.argv.includes("--yes") || process.argv.includes("-y") || isJsonMode() || !process.stdout.isTTY;
+    if (!skip) {
+      const { confirm } = await import("@clack/prompts");
+      const ok = await confirm({ message: "Purge all dead tasks? This cannot be undone." });
+      if (!ok) {
+        console.log("Cancelled.");
+        return;
+      }
+    }
+    await withSpinner(
+      "Purging DLQ...",
+      () => appRequest(queuePath(projectId, "dlq"), { method: "DELETE" })
+    );
+    if (isJsonMode()) return printJson({ status: "ok" });
+    printSuccess("DLQ purged");
+  });
+}
+
 // src/cli.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
@@ -3953,6 +4317,13 @@ Functions (legacy edge functions):
   $ blink functions logs index                 View function logs
   $ blink functions delete old-fn --yes        Delete a function
 
+Queue (background tasks + cron, Pro+):
+  $ blink queue enqueue send-email --payload '{"to":"a@b.com"}'
+  $ blink queue schedule create daily "0 9 * * *"
+  $ blink queue list --status pending           List tasks
+  $ blink queue stats                           Queue overview
+  $ blink queue dlq list                        Dead letter queue
+
 Versions:
   $ blink versions list                        List saved versions
   $ blink versions save --message "v1.0"       Save a snapshot
@@ -4023,6 +4394,7 @@ registerWorkspaceCommands(program);
 registerVersionCommands(program);
 registerBillingCommands(program);
 registerTokenCommands(program);
+registerQueueCommands(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
@@ -4038,10 +4410,10 @@ After setting:
     process.stdout.write(`export BLINK_ACTIVE_PROJECT=${projectId}
 `);
   } else {
-    const { default: chalk25 } = await import("chalk");
-    console.log(chalk25.bold("Active project: ") + projectId);
-    console.log(chalk25.dim(`Run: export BLINK_ACTIVE_PROJECT=${projectId}`));
-    console.log(chalk25.dim(`Or:  eval $(blink use ${projectId} --export)`));
+    const { default: chalk26 } = await import("chalk");
+    console.log(chalk26.bold("Active project: ") + projectId);
+    console.log(chalk26.dim(`Run: export BLINK_ACTIVE_PROJECT=${projectId}`));
+    console.log(chalk26.dim(`Or:  eval $(blink use ${projectId} --export)`));
   }
 });
 program.action(async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/cli",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Blink CLI — full-stack cloud infrastructure from your terminal. Deploy, database, auth, storage, backend, domains, and more.",
   "bin": {
     "blink": "dist/cli.js"

package/src/cli.ts

@@ -31,6 +31,7 @@ import { registerBillingCommands } from './commands/billing.js'
 // PAT tokens are deprecated in favor of workspace API keys (blnk_ak_*).
 // The tokens command is kept for backward compat but hidden from help.
 import { registerTokenCommands } from './commands/tokens.js'
+import { registerQueueCommands } from './commands/queue.js'
 
 const require = createRequire(import.meta.url)
 const pkg = require('../package.json') as { version: string }
@@ -164,6 +165,13 @@ Functions (legacy edge functions):
   $ blink functions logs index                 View function logs
   $ blink functions delete old-fn --yes        Delete a function
 
+Queue (background tasks + cron, Pro+):
+  $ blink queue enqueue send-email --payload '{"to":"a@b.com"}'
+  $ blink queue schedule create daily "0 9 * * *"
+  $ blink queue list --status pending           List tasks
+  $ blink queue stats                           Queue overview
+  $ blink queue dlq list                        Dead letter queue
+
 Versions:
   $ blink versions list                        List saved versions
   $ blink versions save --message "v1.0"       Save a snapshot
@@ -236,6 +244,7 @@ registerWorkspaceCommands(program)
 registerVersionCommands(program)
 registerBillingCommands(program)
 registerTokenCommands(program)
+registerQueueCommands(program)
 
 program.command('use <project_id>')
   .description('Set active project for this shell session (alternative to blink link)')

package/src/commands/queue.ts

@@ -0,0 +1,414 @@
+import { Command } from 'commander'
+import { appRequest } from '../lib/api-app.js'
+import { requireToken } from '../lib/auth.js'
+import { requireProjectId } from '../lib/project.js'
+import { printJson, printSuccess, isJsonMode, withSpinner, createTable, printKv } from '../lib/output.js'
+import chalk from 'chalk'
+
+export function registerQueueCommands(program: Command) {
+  const queue = program.command('queue')
+    .description('Manage background task queues and cron schedules')
+    .addHelpText('after', `
+Blink Queue provides background task processing and cron scheduling.
+Tasks are delivered to your backend at /api/queue. Pro+ plans only.
+
+Examples:
+  $ blink queue enqueue send-email --payload '{"to":"user@example.com"}'
+  $ blink queue schedule create daily-cleanup "0 3 * * *"
+  $ blink queue list --status pending
+  $ blink queue stats
+  $ blink queue dlq list
+`)
+
+  registerEnqueue(queue)
+  registerList(queue)
+  registerGet(queue)
+  registerCancel(queue)
+  registerStats(queue)
+  registerScheduleCommands(queue)
+  registerQueueCrud(queue)
+  registerDlqCommands(queue)
+}
+
+function queuePath(projectId: string, path: string) {
+  return `/api/project/${projectId}/queue/${path}`
+}
+
+function registerEnqueue(queue: Command) {
+  queue.command('enqueue <taskName>')
+    .description('Enqueue a background task')
+    .option('--payload <json>', 'JSON payload', '{}')
+    .option('--queue <name>', 'Named queue for FIFO ordering')
+    .option('--delay <duration>', 'Delay before execution (e.g. 30s, 5m, 1h)')
+    .option('--retries <n>', 'Max retry attempts', '3')
+    .option('--timeout <duration>', 'Execution timeout (e.g. 30s, 5m)')
+    .addHelpText('after', `
+Examples:
+  $ blink queue enqueue send-email --payload '{"to":"user@example.com"}'
+  $ blink queue enqueue process-image --queue media --delay 5m
+  $ blink queue enqueue cleanup --retries 5 --timeout 60s
+`)
+    .action(async (taskName: string, opts) => {
+      requireToken()
+      const projectId = requireProjectId()
+      let payload: Record<string, unknown> = {}
+      if (opts.payload && opts.payload !== '{}') {
+        payload = JSON.parse(opts.payload)
+      }
+      const body: Record<string, unknown> = { taskName, payload, retries: parseInt(opts.retries) }
+      if (opts.queue) body.queue = opts.queue
+      if (opts.delay) body.delay = opts.delay
+      if (opts.timeout) body.timeout = opts.timeout
+      const result = await withSpinner(`Enqueuing ${taskName}...`, () =>
+        appRequest(queuePath(projectId, 'enqueue'), { body })
+      )
+      if (isJsonMode()) return printJson(result)
+      printSuccess(`Task enqueued: ${result?.taskId ?? 'ok'}`)
+      if (result?.taskId) printKv('Task ID', result.taskId)
+      if (opts.queue) printKv('Queue', opts.queue)
+    })
+}
+
+function registerList(queue: Command) {
+  queue.command('list')
+    .description('List tasks')
+    .option('--status <status>', 'Filter: pending, completed, failed, dead')
+    .option('--queue <name>', 'Filter by queue name')
+    .option('--limit <n>', 'Max results', '20')
+    .addHelpText('after', `
+Examples:
+  $ blink queue list
+  $ blink queue list --status pending
+  $ blink queue list --queue emails --limit 50
+  $ blink queue list --json
+`)
+    .action(async (opts) => {
+      requireToken()
+      const projectId = requireProjectId()
+      const params = new URLSearchParams()
+      if (opts.status) params.set('status', opts.status)
+      if (opts.queue) params.set('queue', opts.queue)
+      if (opts.limit) params.set('limit', opts.limit)
+      const result = await withSpinner('Loading tasks...', () =>
+        appRequest(queuePath(projectId, `tasks?${params}`))
+      )
+      const tasks = result?.tasks ?? result ?? []
+      if (isJsonMode()) return printJson(tasks)
+      if (!tasks.length) { console.log(chalk.dim('(no tasks)')); return }
+      const table = createTable(['ID', 'Task', 'Status', 'Queue', 'Created'])
+      for (const t of tasks) {
+        table.push([t.id, t.task_name, t.status, t.queue ?? '-', t.created_at?.slice(0, 19) ?? '-'])
+      }
+      console.log(table.toString())
+    })
+}
+
+function registerGet(queue: Command) {
+  queue.command('get <taskId>')
+    .description('Get task details')
+    .addHelpText('after', `
+Examples:
+  $ blink queue get tsk_abc123
+  $ blink queue get tsk_abc123 --json
+`)
+    .action(async (taskId: string) => {
+      requireToken()
+      const projectId = requireProjectId()
+      const result = await withSpinner('Loading task...', () =>
+        appRequest(queuePath(projectId, `tasks/${taskId}`))
+      )
+      if (isJsonMode()) return printJson(result)
+      const t = result?.task ?? result
+      printKv('ID', t.id)
+      printKv('Task', t.task_name)
+      printKv('Status', t.status)
+      if (t.queue) printKv('Queue', t.queue)
+      if (t.error) printKv('Error', chalk.red(t.error))
+      printKv('Created', t.created_at)
+    })
+}
+
+function registerCancel(queue: Command) {
+  queue.command('cancel <taskId>')
+    .description('Cancel a pending task')
+    .addHelpText('after', `
+Examples:
+  $ blink queue cancel tsk_abc123
+`)
+    .action(async (taskId: string) => {
+      requireToken()
+      const projectId = requireProjectId()
+      await withSpinner('Cancelling task...', () =>
+        appRequest(queuePath(projectId, `tasks/${taskId}`), { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', task_id: taskId })
+      printSuccess(`Cancelled ${taskId}`)
+    })
+}
+
+function registerStats(queue: Command) {
+  queue.command('stats')
+    .description('Show queue statistics')
+    .addHelpText('after', `
+Examples:
+  $ blink queue stats
+  $ blink queue stats --json
+`)
+    .action(async () => {
+      requireToken()
+      const projectId = requireProjectId()
+      const result = await withSpinner('Loading stats...', () =>
+        appRequest(queuePath(projectId, 'stats'))
+      )
+      if (isJsonMode()) return printJson(result)
+      console.log()
+      printKv('Pending', String(result?.pending ?? 0))
+      printKv('Completed', String(result?.completed ?? 0))
+      printKv('Failed', String(result?.failed ?? 0))
+      printKv('Dead', String(result?.dead ?? 0))
+      printKv('Schedules', String(result?.schedules ?? 0))
+      if (result?.tier) printKv('Tier', result.tier)
+      console.log()
+    })
+}
+
+function registerScheduleCommands(queue: Command) {
+  const sched = queue.command('schedule')
+    .description('Manage cron schedules')
+    .addHelpText('after', `
+Examples:
+  $ blink queue schedule create daily-report "0 9 * * *"
+  $ blink queue schedule list
+  $ blink queue schedule pause daily-report
+  $ blink queue schedule delete daily-report
+`)
+
+  sched.command('create <name> <cron>')
+    .description('Create or update a cron schedule')
+    .option('--payload <json>', 'JSON payload', '{}')
+    .option('--timezone <tz>', 'Timezone (e.g. America/New_York)', 'UTC')
+    .option('--retries <n>', 'Max retries per execution', '3')
+    .addHelpText('after', `
+Examples:
+  $ blink queue schedule create daily-report "0 9 * * *"
+  $ blink queue schedule create cleanup "0 3 * * *" --timezone America/New_York
+  $ blink queue schedule create sync "*/15 * * * *" --payload '{"source":"api"}'
+`)
+    .action(async (name: string, cron: string, opts) => {
+      requireToken()
+      const projectId = requireProjectId()
+      let payload: Record<string, unknown> = {}
+      if (opts.payload && opts.payload !== '{}') payload = JSON.parse(opts.payload)
+      const body = { name, cron, payload, timezone: opts.timezone, retries: parseInt(opts.retries) }
+      const result = await withSpinner(`Creating schedule "${name}"...`, () =>
+        appRequest(queuePath(projectId, 'schedule'), { body })
+      )
+      if (isJsonMode()) return printJson(result)
+      printSuccess(`Schedule "${name}" created: ${cron}`)
+      if (result?.scheduleId) printKv('Schedule ID', result.scheduleId)
+    })
+
+  sched.command('list')
+    .description('List all cron schedules')
+    .addHelpText('after', `
+Examples:
+  $ blink queue schedule list
+  $ blink queue schedule list --json
+`)
+    .action(async () => {
+      requireToken()
+      const projectId = requireProjectId()
+      const result = await withSpinner('Loading schedules...', () =>
+        appRequest(queuePath(projectId, 'schedules'))
+      )
+      const schedules = result?.schedules ?? result ?? []
+      if (isJsonMode()) return printJson(schedules)
+      if (!schedules.length) { console.log(chalk.dim('(no schedules)')); return }
+      const table = createTable(['Name', 'Cron', 'Timezone', 'Paused', 'Next Run'])
+      for (const s of schedules) {
+        table.push([s.name, s.cron, s.timezone ?? 'UTC', s.is_paused ? 'yes' : 'no', s.next_run_at ?? '-'])
+      }
+      console.log(table.toString())
+    })
+
+  sched.command('pause <name>')
+    .description('Pause a schedule')
+    .action(async (name: string) => {
+      requireToken()
+      const projectId = requireProjectId()
+      await withSpinner(`Pausing "${name}"...`, () =>
+        appRequest(queuePath(projectId, `schedules/${name}/pause`), { method: 'POST', body: {} })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', name })
+      printSuccess(`Schedule "${name}" paused`)
+    })
+
+  sched.command('resume <name>')
+    .description('Resume a paused schedule')
+    .action(async (name: string) => {
+      requireToken()
+      const projectId = requireProjectId()
+      await withSpinner(`Resuming "${name}"...`, () =>
+        appRequest(queuePath(projectId, `schedules/${name}/resume`), { method: 'POST', body: {} })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', name })
+      printSuccess(`Schedule "${name}" resumed`)
+    })
+
+  sched.command('delete <name>')
+    .description('Delete a schedule')
+    .option('--yes', 'Skip confirmation')
+    .action(async (name: string, opts) => {
+      requireToken()
+      const projectId = requireProjectId()
+      const skip = opts.yes || process.argv.includes('--yes') || process.argv.includes('-y') || isJsonMode() || !process.stdout.isTTY
+      if (!skip) {
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: `Delete schedule "${name}"?` })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      await withSpinner(`Deleting "${name}"...`, () =>
+        appRequest(queuePath(projectId, `schedules/${name}`), { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', name })
+      printSuccess(`Schedule "${name}" deleted`)
+    })
+}
+
+function registerQueueCrud(queue: Command) {
+  queue.command('create-queue <name>')
+    .description('Create a named queue with parallelism control')
+    .option('--parallelism <n>', 'Max concurrent tasks', '1')
+    .addHelpText('after', `
+Named queues provide FIFO ordering and parallelism control.
+
+Examples:
+  $ blink queue create-queue emails
+  $ blink queue create-queue media --parallelism 5
+`)
+    .action(async (name: string, opts) => {
+      requireToken()
+      const projectId = requireProjectId()
+      const result = await withSpinner(`Creating queue "${name}"...`, () =>
+        appRequest(queuePath(projectId, 'queues'), { body: { name, parallelism: parseInt(opts.parallelism) } })
+      )
+      if (isJsonMode()) return printJson(result)
+      printSuccess(`Queue "${name}" created (parallelism: ${opts.parallelism})`)
+    })
+
+  queue.command('queues')
+    .description('List all named queues')
+    .addHelpText('after', `
+Examples:
+  $ blink queue queues
+  $ blink queue queues --json
+`)
+    .action(async () => {
+      requireToken()
+      const projectId = requireProjectId()
+      const result = await withSpinner('Loading queues...', () =>
+        appRequest(queuePath(projectId, 'queues'))
+      )
+      const queues = result?.queues ?? result ?? []
+      if (isJsonMode()) return printJson(queues)
+      if (!queues.length) { console.log(chalk.dim('(no named queues)')); return }
+      const table = createTable(['Name', 'Parallelism', 'Pending', 'Created'])
+      for (const q of queues) {
+        table.push([q.name, String(q.parallelism ?? 1), String(q.pending ?? 0), q.created_at?.slice(0, 10) ?? '-'])
+      }
+      console.log(table.toString())
+    })
+
+  queue.command('delete-queue <name>')
+    .description('Delete a named queue')
+    .option('--yes', 'Skip confirmation')
+    .action(async (name: string, opts) => {
+      requireToken()
+      const projectId = requireProjectId()
+      const skip = opts.yes || process.argv.includes('--yes') || process.argv.includes('-y') || isJsonMode() || !process.stdout.isTTY
+      if (!skip) {
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: `Delete queue "${name}"? Pending tasks will be lost.` })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      await withSpinner(`Deleting queue "${name}"...`, () =>
+        appRequest(queuePath(projectId, `queues/${name}`), { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', name })
+      printSuccess(`Queue "${name}" deleted`)
+    })
+}
+
+function registerDlqCommands(queue: Command) {
+  const dlq = queue.command('dlq')
+    .description('Manage dead letter queue (failed tasks)')
+    .addHelpText('after', `
+Tasks that exhaust all retries are moved to the dead letter queue.
+
+Examples:
+  $ blink queue dlq list
+  $ blink queue dlq retry <taskId>
+  $ blink queue dlq purge --yes
+`)
+
+  dlq.command('list')
+    .description('List dead tasks')
+    .action(async () => {
+      requireToken()
+      const projectId = requireProjectId()
+      const result = await withSpinner('Loading DLQ...', () =>
+        appRequest(queuePath(projectId, 'dlq'))
+      )
+      const tasks = result?.tasks ?? result ?? []
+      if (isJsonMode()) return printJson(tasks)
+      if (!tasks.length) { console.log(chalk.dim('(no dead tasks)')); return }
+      const table = createTable(['ID', 'Task', 'Error', 'Failed At'])
+      for (const t of tasks) {
+        table.push([t.id, t.task_name, (t.error ?? '-').slice(0, 40), t.failed_at?.slice(0, 19) ?? '-'])
+      }
+      console.log(table.toString())
+    })
+
+  dlq.command('retry <taskId>')
+    .description('Retry a dead task')
+    .action(async (taskId: string) => {
+      requireToken()
+      const projectId = requireProjectId()
+      await withSpinner(`Retrying ${taskId}...`, () =>
+        appRequest(queuePath(projectId, `dlq/${taskId}/retry`), { method: 'POST', body: {} })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', task_id: taskId })
+      printSuccess(`Retried ${taskId}`)
+    })
+
+  dlq.command('delete <taskId>')
+    .description('Delete a dead task')
+    .action(async (taskId: string) => {
+      requireToken()
+      const projectId = requireProjectId()
+      await withSpinner(`Deleting ${taskId}...`, () =>
+        appRequest(queuePath(projectId, `dlq/${taskId}`), { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', task_id: taskId })
+      printSuccess(`Deleted ${taskId} from DLQ`)
+    })
+
+  dlq.command('purge')
+    .description('Delete all dead tasks')
+    .option('--yes', 'Skip confirmation')
+    .action(async (opts) => {
+      requireToken()
+      const projectId = requireProjectId()
+      const skip = opts.yes || process.argv.includes('--yes') || process.argv.includes('-y') || isJsonMode() || !process.stdout.isTTY
+      if (!skip) {
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: 'Purge all dead tasks? This cannot be undone.' })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      await withSpinner('Purging DLQ...', () =>
+        appRequest(queuePath(projectId, 'dlq'), { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok' })
+      printSuccess('DLQ purged')
+    })
+}