@supacloud/cli 0.5.0 → 0.6.0

package/README.md

@@ -30,6 +30,11 @@ Examples:
 supacloud-cli status
 supacloud-cli project get
 supacloud-cli project logs --log_type database
+supacloud-cli project task_stats
+supacloud-cli project task_detail --task_id task_123
+supacloud-cli queue stats --queue emails
+supacloud-cli queue dlq --queue emails --limit 20
+supacloud-cli task_events inspect_webhook --ref abc123
 supacloud-cli database query --sql "select now()"
 supacloud-cli database query --ref abc123 --file ./queries/vector-search.sql
 supacloud-cli database push_migrations --ref abc123 --dir supabase/migrations --dry_run
@@ -62,5 +67,33 @@ Project commands owned by this CLI:
 - `project api_keys`
 - `project settings`
 - `project tasks`
+- `project task_detail`
+- `project task_stats`
+- `project task_cancel`
+- `project task_retry`
+- `project dlq`
+- `project background_settings`
+- `project update_background_settings`
+
+Queue commands:
+
+- `queue send`
+- `queue receive`
+- `queue ack`
+- `queue release`
+- `queue fail`
+- `queue retry`
+- `queue delete_message`
+- `queue list_messages`
+- `queue stats`
+- `queue dlq`
+- `queue get_settings`
+- `queue update_settings`
+
+Task event commands:
+
+- `task_events register_webhook`
+- `task_events unregister_webhook`
+- `task_events inspect_webhook`
 
 For server installation, SSH diagnostics, and tenant administration, use `@supacloud/admin`.

package/dist/index.js

@@ -15399,7 +15399,7 @@ Actions: list_providers, get_provider, configure_provider, update_provider, disa
     url: exports_external.string().optional().describe("[configure] Custom OAuth URL"),
     app_id: exports_external.string().optional().describe("[wechat_*] WeChat App ID"),
     app_secret: exports_external.string().optional().describe("[wechat_*] WeChat App Secret"),
-    config: exports_external.record(exports_external.unknown()).optional().describe("[update_settings/update_config] Config fields")
+    config: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("[update_settings/update_config] Config fields")
   }, async (args) => {
     const { action, ref, provider, client_id, client_secret, redirect_uri, url: url2, app_id, app_secret, config: config2 } = args;
     const need = (f) => {
@@ -15689,7 +15689,7 @@ Actions: list, deploy, deploy_bundle, config, source, delete, check`, {
     slug: exports_external.string().optional().describe("[deploy/deploy_bundle/config/source/delete/check] Function name"),
     code: exports_external.string().optional().describe("[deploy/check] Function source code (TypeScript)"),
     path: exports_external.string().optional().describe("[deploy/check] Local file path to read code from (alternative to code)"),
-    files: exports_external.record(exports_external.string()).optional().describe("[deploy_bundle] File map: { 'index.ts': '...', '_shared/x.ts': '...' }"),
+    files: exports_external.record(exports_external.string(), exports_external.string()).optional().describe("[deploy_bundle] File map: { 'index.ts': '...', '_shared/x.ts': '...' }"),
     entrypoint: exports_external.string().optional().describe("[deploy_bundle] Entrypoint file (default: index.ts)"),
     minify: exports_external.boolean().optional().describe("[deploy/deploy_bundle] Minify bundle"),
     verify_jwt: exports_external.boolean().optional().describe("[deploy/deploy_bundle/config] Set JWT verification for this function"),
@@ -15882,6 +15882,85 @@ ${JSON.stringify(r.data, null, 2)}` : `❌ Failed (${r.status})`;
     }
     return { content: [{ type: "text", text }] };
   });
+  server.tool("task_events", `Task lifecycle webhook configuration.
+Actions: register_webhook, unregister_webhook, inspect_webhook`, {
+    action: exports_external.enum(["register_webhook", "unregister_webhook", "inspect_webhook"]).describe("Action"),
+    ref: exports_external.string().describe("Project ref"),
+    url: exports_external.string().optional().describe("[register_webhook] HTTPS webhook URL for task lifecycle events"),
+    secret: exports_external.string().optional().describe("[register_webhook] Optional HMAC secret for webhook verification")
+  }, async (args) => {
+    const { action, ref, url: url2, secret } = args;
+    let text;
+    switch (action) {
+      case "register_webhook": {
+        if (!url2)
+          throw new Error("'url' is required for register_webhook");
+        const body = { url: url2 };
+        if (secret)
+          body.secret = secret;
+        const r = await http.post(`/v1/projects/${ref}/task-events/webhook`, body);
+        text = r.ok ? `✅ Webhook registered for project ${ref}
+${JSON.stringify(r.data, null, 2)}` : `❌ Failed (${r.status}): ${JSON.stringify(r.data)}`;
+        break;
+      }
+      case "unregister_webhook": {
+        const r = await http.delete(`/v1/projects/${ref}/task-events/webhook`);
+        text = r.ok ? `✅ Webhook unregistered for project ${ref}` : `❌ Failed (${r.status}): ${JSON.stringify(r.data)}`;
+        break;
+      }
+      case "inspect_webhook": {
+        const r = await http.get(`/v1/projects/${ref}/task-events/webhook`);
+        text = r.ok ? JSON.stringify(r.data, null, 2) : `❌ Failed (${r.status}): ${JSON.stringify(r.data)}`;
+        break;
+      }
+      default:
+        text = `❌ Unknown action`;
+    }
+    return { content: [{ type: "text", text }] };
+  });
+  server.tool("diagnostics", `Platform and project diagnostics: health checks, diagnostic runs, and repair.
+Actions: list_checks, run_checks, get_run, repair`, {
+    action: exports_external.enum(["list_checks", "run_checks", "get_run", "repair"]).describe("Action"),
+    ref: exports_external.string().optional().describe("Project ref (for project-scoped diagnostics)"),
+    run_id: exports_external.string().optional().describe("[get_run/repair] Diagnostic run ID"),
+    check_id: exports_external.string().optional().describe("[repair] Check result ID to repair")
+  }, async (args) => {
+    const { action, ref, run_id, check_id } = args;
+    let text;
+    switch (action) {
+      case "list_checks": {
+        const path = ref ? `/v1/projects/${ref}/diagnostics/checks` : "/v1/diagnostics/checks";
+        text = JSON.stringify((await http.get(path)).data, null, 2);
+        break;
+      }
+      case "run_checks": {
+        const path = ref ? `/v1/projects/${ref}/diagnostics/runs` : "/v1/diagnostics/runs";
+        const r = await http.post(path);
+        text = r.ok ? `✅ Diagnostic run started
+${JSON.stringify(r.data, null, 2)}` : `❌ Failed (${r.status}): ${JSON.stringify(r.data)}`;
+        break;
+      }
+      case "get_run": {
+        if (!run_id)
+          throw new Error("'run_id' is required for get_run");
+        const path = ref ? `/v1/projects/${ref}/diagnostics/runs/${run_id}` : `/v1/diagnostics/runs/${run_id}`;
+        text = JSON.stringify((await http.get(path)).data, null, 2);
+        break;
+      }
+      case "repair": {
+        if (!check_id)
+          throw new Error("'check_id' is required for repair");
+        const path = `/v1/diagnostics/results/${check_id}/repair`;
+        const r = await http.post(path);
+        text = r.ok ? `✅ Repair executed for ${check_id}
+${JSON.stringify(r.data, null, 2)}` : `❌ Failed (${r.status}): ${JSON.stringify(r.data)}`;
+        break;
+      }
+      default:
+        text = `❌ Unknown action`;
+    }
+    return { content: [{ type: "text", text }] };
+  });
 }
 
 // src/shared/tools/frontend-tools.ts
@@ -15915,7 +15994,7 @@ Actions: list, get, create, update, delete, deploy_git, deploy_upload, redeploy,
     output_dir: exports_external.string().optional().describe("[create/update] Output directory override"),
     install_command: exports_external.string().optional().describe("[create/update] Install command override"),
     node_version: exports_external.string().optional().describe("[create/update] Node.js version"),
-    env_vars: exports_external.record(exports_external.string()).optional().describe("[create/update/set_env] Environment variables"),
+    env_vars: exports_external.record(exports_external.string(), exports_external.string()).optional().describe("[create/update/set_env] Environment variables"),
     git_url: exports_external.string().optional().describe("[deploy_git] Git repository URL"),
     branch: exports_external.string().optional().describe("[deploy_git] Branch (default: main)"),
     zip_path: exports_external.string().optional().describe("[deploy_upload] Local zip file path")
@@ -16038,19 +16117,32 @@ var formatTasks = (data) => {
     return JSON.stringify(data, null, 2);
   if (data.length === 0)
     return "No tasks found.";
-  const emoji3 = { pending: "⏳", processing: "\uD83D\uDD04", completed: "✅", failed: "❌" };
+  const emoji3 = {
+    pending: "⏳",
+    leased: "\uD83D\uDD13",
+    running: "\uD83D\uDD04",
+    retry_scheduled: "\uD83D\uDD01",
+    succeeded: "✅",
+    failed: "❌",
+    dead_lettered: "\uD83D\uDC80",
+    cancelled: "\uD83D\uDEAB",
+    queued: "\uD83D\uDCE5",
+    processing: "\uD83D\uDD04",
+    completed: "✅"
+  };
   let out = `\uD83D\uDCCB Tasks (${data.length}):
 
 `;
   for (const t of data) {
-    out += `  ${emoji3[t.status] || "❓"} ${t.task_type} — ${t.status}
+    const st = t.status || "?";
+    out += `  ${emoji3[st] || "❓"} ${t.task_type || t.type || ""} — ${st}
      ID: ${t.id}
 `;
-    if (t.retries > 0)
-      out += `     Retries: ${t.retries}
+    if (t.retries > 0 || t.retry_count > 0)
+      out += `     Retries: ${t.retries || t.retry_count}
 `;
-    if (t.error)
-      out += `     Error: ${t.error}
+    if (t.error || t.error_message)
+      out += `     Error: ${t.error || t.error_message}
 `;
     if (t.created_at)
       out += `     Created: ${t.created_at}
@@ -16060,6 +16152,77 @@ var formatTasks = (data) => {
   }
   return out;
 };
+var formatTaskDetail = (data) => {
+  if (!data || typeof data !== "object")
+    return JSON.stringify(data, null, 2);
+  const t = data;
+  const emoji3 = {
+    pending: "⏳",
+    leased: "\uD83D\uDD13",
+    running: "\uD83D\uDD04",
+    retry_scheduled: "\uD83D\uDD01",
+    succeeded: "✅",
+    failed: "❌",
+    dead_lettered: "\uD83D\uDC80",
+    cancelled: "\uD83D\uDEAB"
+  };
+  const st = String(t.status || "?");
+  const lines = [
+    `${emoji3[st] || "❓"} Task Detail:`,
+    `  ID:           ${t.id}`,
+    `  Type:         ${t.task_type || t.type || "?"}`,
+    `  Status:       ${st}`,
+    `  Attempt:      ${t.attempt ?? "?"}/${t.max_attempts ?? "?"}`,
+    `  Function:     ${t.function_slug || "-"}`,
+    `  Created:      ${t.created_at || "?"}`,
+    `  Updated:      ${t.updated_at || "-"}`
+  ];
+  if (t.error || t.error_message)
+    lines.push(`  Error:        ${t.error || t.error_message}`);
+  if (t.correlation_id)
+    lines.push(`  Correlation:  ${t.correlation_id}`);
+  if (t.business_task_id)
+    lines.push(`  Business ID:  ${t.business_task_id}`);
+  if (t.trace_id)
+    lines.push(`  Trace:        ${t.trace_id}`);
+  if (t.result)
+    lines.push(`  Result:       ${JSON.stringify(t.result).slice(0, 200)}`);
+  const attempts = t.attempts;
+  if (Array.isArray(attempts) && attempts.length > 0) {
+    lines.push("", `  Attempts (${attempts.length}):`);
+    for (const a of attempts) {
+      const aa = a;
+      lines.push(`    #${aa.attempt_no ?? "?"} ${aa.status || ""} ${aa.error ? `— ${aa.error}` : ""}`);
+    }
+  }
+  const logs = t.latest_logs;
+  if (Array.isArray(logs) && logs.length > 0) {
+    lines.push("", `  Latest Logs (${logs.length}):`);
+    for (const l of logs.slice(-10)) {
+      const ll = l;
+      lines.push(`    [${ll.stream || "?"}] ${String(ll.message || "").slice(0, 200)}`);
+    }
+  }
+  return lines.join(`
+`);
+};
+var formatTaskStats = (data) => {
+  if (!data || typeof data !== "object")
+    return JSON.stringify(data, null, 2);
+  const s = data;
+  return [
+    "\uD83D\uDCCA Task Stats:",
+    `  Pending:         ${s.pending ?? "?"}`,
+    `  Leased:          ${s.leased ?? "?"}`,
+    `  Running:         ${s.running ?? "?"}`,
+    `  Retry Scheduled: ${s.retry_scheduled ?? "?"}`,
+    `  Succeeded:       ${s.succeeded ?? "?"}`,
+    `  Failed:          ${s.failed ?? "?"}`,
+    `  Dead Lettered:   ${s.dead_lettered ?? "?"}`,
+    `  Cancelled:       ${s.cancelled ?? "?"}`
+  ].join(`
+`);
+};
 var ok = (res) => res.ok ? JSON.stringify(res.data, null, 2) : `❌ Failed (${res.status}): ${JSON.stringify(res.data)}`;
 function buildProjectLogsPath(ref, logType) {
   const params = new URLSearchParams({ limit: "200" });
@@ -16076,11 +16239,29 @@ function resolveRef2(refFromArgs, defaultRef) {
 }
 function registerUserProjectCliTools(server, http, options = {}) {
   const { projectRef } = options;
-  server.tool("project", "Project-scoped inspection and developer operations. Actions: get, health, logs, api_keys, settings, tasks", {
-    action: exports_external.enum(["get", "health", "logs", "api_keys", "settings", "tasks"]).describe("Action to perform"),
+  server.tool("project", `Project-scoped inspection and developer operations.
+Actions: get, health, logs, api_keys, settings, tasks, task_detail, task_cancel, task_retry, task_stats, dlq, background_settings, update_background_settings`, {
+    action: exports_external.enum([
+      "get",
+      "health",
+      "logs",
+      "api_keys",
+      "settings",
+      "tasks",
+      "task_detail",
+      "task_cancel",
+      "task_retry",
+      "task_stats",
+      "dlq",
+      "background_settings"
+    ]).describe("Action to perform"),
     ref: exports_external.string().optional().describe(projectRef ? "Optional override when not auto-linked" : "Project ref"),
-    log_type: exports_external.enum(["all", "auth", "database", "api"]).optional().describe("[logs] Filter by service")
-  }, async ({ action, ref, log_type }) => {
+    log_type: exports_external.enum(["all", "auth", "database", "api"]).optional().describe("[logs] Filter by service"),
+    task_id: exports_external.string().optional().describe("[task_detail/task_cancel/task_retry] Task ID"),
+    limit: exports_external.number().optional().describe("[tasks/dlq] Max items to return"),
+    concurrency: exports_external.number().optional().describe("[update_background_settings] Max concurrent background tasks"),
+    max_attempts: exports_external.number().optional().describe("[update_background_settings] Max attempts for background tasks")
+  }, async ({ action, ref, log_type, task_id, limit, concurrency, max_attempts }) => {
     const resolvedRef = resolveRef2(ref, projectRef);
     let text;
     switch (action) {
@@ -16102,10 +16283,68 @@ function registerUserProjectCliTools(server, http, options = {}) {
         text = ok(await http.get(`/v1/projects/${resolvedRef}/settings`));
         break;
       case "tasks": {
-        const res = await http.get(`/v1/projects/${resolvedRef}/tasks`);
+        const params = {};
+        if (limit)
+          params.limit = String(limit);
+        const qs = Object.keys(params).length ? `?${new URLSearchParams(params)}` : "";
+        const res = await http.get(`/v1/projects/${resolvedRef}/tasks${qs}`);
         text = res.ok ? formatTasks(res.data) : `❌ Failed (${res.status})`;
         break;
       }
+      case "task_detail": {
+        if (!task_id)
+          throw new Error("'task_id' is required for task_detail");
+        const res = await http.get(`/v1/projects/${resolvedRef}/tasks/${task_id}`);
+        text = res.ok ? formatTaskDetail(res.data) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "task_cancel": {
+        if (!task_id)
+          throw new Error("'task_id' is required for task_cancel");
+        const res = await http.post(`/v1/projects/${resolvedRef}/tasks/${task_id}/cancel`);
+        text = res.ok ? `✅ Task ${task_id} cancelled` : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "task_retry": {
+        if (!task_id)
+          throw new Error("'task_id' is required for task_retry");
+        const res = await http.post(`/v1/projects/${resolvedRef}/tasks/${task_id}/retry`);
+        text = res.ok ? `✅ Task ${task_id} queued for retry
+${JSON.stringify(res.data, null, 2)}` : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "task_stats": {
+        const res = await http.get(`/v1/projects/${resolvedRef}/tasks/stats`);
+        text = res.ok ? formatTaskStats(res.data) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "dlq": {
+        const params = {};
+        if (limit)
+          params.limit = String(limit);
+        const qs = Object.keys(params).length ? `?${new URLSearchParams(params)}` : "";
+        const res = await http.get(`/v1/projects/${resolvedRef}/tasks/dlq${qs}`);
+        text = res.ok ? formatTasks(res.data) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "background_settings": {
+        const res = await http.get(`/v1/projects/${resolvedRef}/tasks/settings/background`);
+        text = res.ok ? JSON.stringify(res.data, null, 2) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "update_background_settings": {
+        const body = {};
+        if (concurrency)
+          body.concurrency = concurrency;
+        if (max_attempts)
+          body.max_attempts = max_attempts;
+        if (Object.keys(body).length === 0)
+          throw new Error("At least one setting (concurrency or max_attempts) is required");
+        const res = await http.patch(`/v1/projects/${resolvedRef}/tasks/settings/background`, body);
+        text = res.ok ? `✅ Background settings updated
+${JSON.stringify(res.data, null, 2)}` : `❌ Failed (${res.status})`;
+        break;
+      }
       default:
         text = `❌ Unknown action: ${action}`;
     }
@@ -16113,11 +16352,285 @@ function registerUserProjectCliTools(server, http, options = {}) {
   });
 }
 
+// src/shared/tools/queue-tools.ts
+function formatQueueStats(data) {
+  if (!data || typeof data !== "object")
+    return JSON.stringify(data, null, 2);
+  const s = data;
+  return [
+    "\uD83D\uDCCA Queue Stats:",
+    `  Pending:          ${s.pending ?? "?"}`,
+    `  Leased:           ${s.leased ?? "?"}`,
+    `  Running:          ${s.running ?? "?"}`,
+    `  Retry Scheduled:  ${s.retryScheduled ?? s.retry_scheduled ?? "?"}`,
+    `  Succeeded (24h):  ${s.succeededLast24h ?? s.succeeded_last_24h ?? "?"}`,
+    `  Failed (24h):     ${s.failedLast24h ?? s.failed_last_24h ?? "?"}`,
+    `  Dead Lettered:    ${s.deadLettered ?? s.dead_lettered ?? "?"}`,
+    `  In Flight:        ${s.inFlight ?? s.in_flight ?? "?"}`,
+    `  Oldest Pending:   ${s.oldestPendingAgeSec ?? s.oldest_pending_age_sec ?? "?"}s`
+  ].join(`
+`);
+}
+function formatQueueSettings(data) {
+  if (!data || typeof data !== "object")
+    return JSON.stringify(data, null, 2);
+  const s = data;
+  return [
+    "⚙️ Queue Settings:",
+    `  Max In Flight:       ${s.max_in_flight ?? "?"}`,
+    `  Visibility Timeout:  ${s.default_visibility_timeout_sec ?? "?"}s`,
+    `  Max Attempts:        ${s.max_attempts ?? "?"}`,
+    `  Rate Limit:          ${s.rate_limit_per_minute ?? "?"}/min`
+  ].join(`
+`);
+}
+function formatMessages(data, label = "Messages") {
+  if (!Array.isArray(data))
+    return JSON.stringify(data, null, 2);
+  if (data.length === 0)
+    return `No ${label.toLowerCase()} found.`;
+  const emoji3 = {
+    pending: "⏳",
+    leased: "\uD83D\uDD13",
+    running: "\uD83D\uDD04",
+    retry_scheduled: "\uD83D\uDD01",
+    succeeded: "✅",
+    failed: "❌",
+    dead_lettered: "\uD83D\uDC80"
+  };
+  let out = `${label} (${data.length}):
+
+`;
+  for (const m of data) {
+    const st = m.status || "?";
+    out += `  ${emoji3[st] || "❓"} ${st} — id: ${m.id}
+`;
+    if (m.attempt != null)
+      out += `     Attempt: ${m.attempt}/${m.max_attempts ?? "?"}
+`;
+    if (m.error)
+      out += `     Error: ${typeof m.error === "string" ? m.error : JSON.stringify(m.error)}
+`;
+    if (m.created_at)
+      out += `     Created: ${m.created_at}
+`;
+    out += `
+`;
+  }
+  return out;
+}
+function resolveRef3(refFromArgs, defaultRef) {
+  const ref = defaultRef || refFromArgs;
+  if (!ref)
+    throw new Error("'ref' is required for this action");
+  return ref;
+}
+function registerQueueTools(server, http, options = {}) {
+  const { projectRef } = options;
+  server.tool("queue", `Message queue operations for task-based messaging.
+Actions: list, stats, list_messages, dlq, get_message, send, receive, ack, release, fail, retry, delete_message, get_settings, update_settings`, {
+    action: exports_external.enum([
+      "list",
+      "stats",
+      "list_messages",
+      "dlq",
+      "get_message",
+      "send",
+      "receive",
+      "ack",
+      "release",
+      "fail",
+      "retry",
+      "delete_message",
+      "get_settings",
+      "update_settings"
+    ]).describe("Action"),
+    ref: exports_external.string().optional().describe("Project ref"),
+    queue: exports_external.string().optional().describe("[list/stats/list_messages/dlq/get_message/send/receive/ack/release/fail/retry/delete_message/get_settings/update_settings] Queue name"),
+    message_id: exports_external.string().optional().describe("[get_message/ack/release/fail/retry/delete_message] Message ID"),
+    payload: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("[send] Message payload"),
+    delay_ms: exports_external.number().optional().describe("[send] Delay in ms before message becomes visible"),
+    max_attempts: exports_external.number().optional().describe("[send] Max delivery attempts"),
+    idempotency_key: exports_external.string().optional().describe("[send] Idempotency key for dedup"),
+    correlation_id: exports_external.string().optional().describe("[send] Correlation ID for tracing"),
+    business_task_id: exports_external.string().optional().describe("[send] Business task ID for cross-system mapping"),
+    metadata: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("[send] Arbitrary metadata attached to the message"),
+    visibility_timeout_sec: exports_external.number().optional().describe("[receive] Visibility timeout in seconds"),
+    status: exports_external.string().optional().describe("[list_messages] Filter by status (comma-separated)"),
+    limit: exports_external.number().optional().describe("[list_messages/dlq] Max messages to return"),
+    result: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe("[ack] Ack result payload"),
+    error: exports_external.string().optional().describe("[release/fail] Error description"),
+    delay_ms_release: exports_external.number().optional().describe("[release] Delay before message becomes visible again"),
+    max_in_flight: exports_external.number().optional().describe("[update_settings] Max concurrent in-flight messages"),
+    default_visibility_timeout: exports_external.number().optional().describe("[update_settings] Default visibility timeout (sec)"),
+    max_attempts_setting: exports_external.number().optional().describe("[update_settings] Max delivery attempts"),
+    rate_limit: exports_external.number().optional().describe("[update_settings] Rate limit per minute")
+  }, async (args) => {
+    const resolvedRef = resolveRef3(args.ref, projectRef);
+    const q = args.queue;
+    const need = (fields) => {
+      for (const f of fields) {
+        if (!args[f])
+          throw new Error(`'${f}' is required for '${args.action}'`);
+      }
+    };
+    const qBase = `/v1/projects/${resolvedRef}/tasks/queues/${q}`;
+    let text;
+    switch (args.action) {
+      case "list": {
+        need(["queue"]);
+        const res = await http.get(`${qBase}/messages`);
+        text = res.ok ? formatMessages(res.data, `Queue ${q}`) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "stats": {
+        need(["queue"]);
+        const res = await http.get(`${qBase}/stats`);
+        text = res.ok ? formatQueueStats(res.data) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "list_messages": {
+        need(["queue"]);
+        const params = {};
+        if (args.status)
+          params.status = args.status;
+        if (args.limit)
+          params.limit = String(args.limit);
+        const qs = Object.keys(params).length ? `?${new URLSearchParams(params)}` : "";
+        const res = await http.get(`${qBase}/messages${qs}`);
+        text = res.ok ? formatMessages(res.data) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "dlq": {
+        need(["queue"]);
+        const params = { status: "dead_lettered" };
+        if (args.limit)
+          params.limit = String(args.limit);
+        const res = await http.get(`${qBase}/messages?${new URLSearchParams(params)}`);
+        text = res.ok ? formatMessages(res.data, "Dead-Letter Messages") : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "get_message": {
+        need(["queue", "message_id"]);
+        const res = await http.get(`${qBase}/messages/${args.message_id}`);
+        text = res.ok ? JSON.stringify(res.data, null, 2) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "send": {
+        need(["queue", "payload"]);
+        const body = {
+          payload: args.payload,
+          ...args.delay_ms ? { delayMs: args.delay_ms } : {},
+          ...args.max_attempts ? { maxAttempts: args.max_attempts } : {},
+          ...args.idempotency_key ? { idempotencyKey: args.idempotency_key } : {},
+          ...args.correlation_id ? { correlationId: args.correlation_id } : {},
+          ...args.business_task_id ? { businessTaskId: args.business_task_id } : {},
+          ...args.metadata ? { metadata: args.metadata } : {}
+        };
+        const res = await http.post(`${qBase}/messages`, body);
+        text = res.ok ? `✅ Message sent
+${JSON.stringify(res.data, null, 2)}` : `❌ Failed (${res.status}): ${JSON.stringify(res.data)}`;
+        break;
+      }
+      case "receive": {
+        need(["queue"]);
+        const body = {};
+        if (args.visibility_timeout_sec)
+          body.visibilityTimeoutSec = args.visibility_timeout_sec;
+        const res = await http.post(`${qBase}/messages/receive`, body);
+        if (!res.ok) {
+          text = `❌ Failed (${res.status})`;
+          break;
+        }
+        text = res.data ? JSON.stringify(res.data, null, 2) : "\uD83D\uDCED No messages available";
+        break;
+      }
+      case "ack": {
+        need(["queue", "message_id"]);
+        const body = args.result ? { result: args.result } : {};
+        const res = await http.post(`${qBase}/messages/${args.message_id}/ack`, body);
+        text = res.ok ? `✅ Message ${args.message_id} acknowledged` : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "release": {
+        need(["queue", "message_id"]);
+        const body = {};
+        if (args.delay_ms_release)
+          body.delayMs = args.delay_ms_release;
+        if (args.error)
+          body.error = args.error;
+        const res = await http.post(`${qBase}/messages/${args.message_id}/release`, body);
+        text = res.ok ? `✅ Message ${args.message_id} released back to queue` : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "fail": {
+        need(["queue", "message_id"]);
+        const body = args.error ? { error: args.error } : {};
+        const res = await http.post(`${qBase}/messages/${args.message_id}/fail`, body);
+        text = res.ok ? `✅ Message ${args.message_id} marked as failed` : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "retry": {
+        need(["queue", "message_id"]);
+        const res = await http.post(`${qBase}/messages/${args.message_id}/retry`);
+        text = res.ok ? `✅ Message ${args.message_id} queued for retry` : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "delete_message": {
+        need(["queue", "message_id"]);
+        const res = await http.delete(`${qBase}/messages/${args.message_id}`);
+        text = res.ok ? `✅ Message ${args.message_id} deleted` : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "get_settings": {
+        need(["queue"]);
+        const res = await http.get(`${qBase}/settings`);
+        text = res.ok ? formatQueueSettings(res.data) : `❌ Failed (${res.status})`;
+        break;
+      }
+      case "update_settings": {
+        need(["queue"]);
+        const body = {};
+        if (args.max_in_flight)
+          body.max_in_flight = args.max_in_flight;
+        if (args.default_visibility_timeout)
+          body.default_visibility_timeout_sec = args.default_visibility_timeout;
+        if (args.max_attempts_setting)
+          body.max_attempts = args.max_attempts_setting;
+        if (args.rate_limit)
+          body.rate_limit_per_minute = args.rate_limit;
+        if (Object.keys(body).length === 0)
+          throw new Error("At least one setting field is required");
+        const res = await http.patch(`${qBase}/settings`, body);
+        text = res.ok ? `✅ Settings updated
+${formatQueueSettings(res.data)}` : `❌ Failed (${res.status})`;
+        break;
+      }
+      default:
+        text = `❌ Unknown action: ${args.action}`;
+    }
+    return { content: [{ type: "text", text }] };
+  });
+}
+
 // src/index.ts
 var invokedCommand = path.basename(process.argv[1] || "supacloud-cli");
 var commandName = invokedCommand === "supacloud" ? "supacloud" : "supacloud-cli";
 var preferredCommand = "supacloud-cli";
-var projectActionSchema = exports_external.enum(["get", "health", "logs", "api_keys", "settings", "tasks"]);
+var projectActionSchema = exports_external.enum([
+  "get",
+  "health",
+  "logs",
+  "api_keys",
+  "settings",
+  "tasks",
+  "task_detail",
+  "task_cancel",
+  "task_retry",
+  "task_stats",
+  "dlq",
+  "background_settings"
+]);
 var genericActionSchema = exports_external.string();
 function unwrapMcpSchema(schema) {
   if (schema && typeof schema === "object" && !Array.isArray(schema) && "args" in schema) {
@@ -16172,6 +16685,9 @@ EXAMPLES
   ${preferredCommand} status
   ${preferredCommand} project get
   ${preferredCommand} project logs --log_type database
+  ${preferredCommand} project task_stats
+  ${preferredCommand} queue stats --queue emails
+  ${preferredCommand} queue dlq --queue emails --limit 20
   ${preferredCommand} frontend list --ref abc123
   ${preferredCommand} database query --sql "select now()"
   ${preferredCommand} database query --ref abc123 --file ./queries/vector-search.sql
@@ -16232,7 +16748,7 @@ function createCliTools() {
         ]
       })
     };
-    for (const name of ["database", "auth", "storage", "edge_functions", "secrets", "frontend"]) {
+    for (const name of ["database", "auth", "storage", "edge_functions", "secrets", "frontend", "queue", "task_events", "diagnostics"]) {
       tools[name] = {
         schema: { action: genericActionSchema },
         callback: async () => ({
@@ -16295,6 +16811,9 @@ function createCliTools() {
   assign(captureTools((server) => registerStorageTools(server, http)));
   assign(captureTools((server) => registerAdvancedTools(server, http)));
   assign(captureTools((server) => registerFrontendTools(server, http)));
+  assign(captureTools((server) => registerQueueTools(server, http, {
+    projectRef: context.projectRef || undefined
+  })));
   delete tools.platform;
   return tools;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Project-scoped CLI for SupaCloud users",
   "type": "module",
   "main": "./dist/index.js",