@mangomagic/cli 0.1.12 → 0.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mangomagic/cli",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "MangoMagic CLI — sign in, manage episodes, and expose MangoMagic to MCP clients (Claude Desktop, Cursor).",
   "type": "module",
   "bin": {

package/src/chat/natural-language.mjs

@@ -2,13 +2,25 @@ import readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { apiCall } from "../api.mjs";
 import { planWithKimi } from "../ai/kimi.mjs";
-import { ALL_MCP_TOOL_CATALOG } from "../tools/catalog.mjs";
 import { runCatalogTool } from "../tools/run.mjs";
 
 const GOLD = "\x1b[38;2;241;171;28m";
 const DIM = "\x1b[2m";
 const BOLD = "\x1b[1m";
 const RESET = "\x1b[0m";
+const CHAT_TOOL_NAMES = [
+  "create_talking_cards",
+  "list_episodes",
+  "search_episodes",
+  "get_episode",
+  "get_user_episodes",
+  "get_user_clips",
+  "get_user_leads",
+  "get_user_stats",
+  "get_upcoming_meetings",
+  "get_bookings",
+  "get_inbox",
+];
 
 function compact(s) {
   return String(s || "").trim().replace(/\s+/g, " ");
@@ -42,6 +54,27 @@ function localPlan(text) {
   if (t.includes("talking card") || t.includes("carousel") || /\bcards?\b/.test(t)) {
     return { action: "create_talking_cards", args: { focus: raw, count: inferCount(raw) } };
   }
+  if (/\b(email|emails|inbox|messages?)\b/.test(t) && /\b(show|list|get|what|my|check)\b/.test(t)) {
+    return { action: "list_inbox", args: { limit: 5 } };
+  }
+  if (/\b(stats?|account|credits?|streak|level|usage)\b/.test(t) && /\b(show|get|what|my|how|check)\b/.test(t)) {
+    return { action: "account_stats", args: {} };
+  }
+  if (/\b(clips?|highlights?)\b/.test(t) && /\b(show|list|get|my|what)\b/.test(t)) {
+    return { action: "list_clips", args: { limit: 5 } };
+  }
+  if (/\b(guests?|leads?|contacts?)\b/.test(t) && /\b(analy[sz]e|qualify|score|best|priority|prioritise|prioritize)\b/.test(t)) {
+    return { action: "analyze_guests", args: { limit: 10 } };
+  }
+  if (/\b(guests?|leads?|contacts?)\b/.test(t) && /\b(show|list|get|my|what)\b/.test(t)) {
+    return { action: "list_leads", args: { limit: 8 } };
+  }
+  if (/\b(meetings?|recording sessions?|sessions?)\b/.test(t) && /\b(show|list|get|upcoming|my|what)\b/.test(t)) {
+    return { action: "list_meetings", args: { limit: 5 } };
+  }
+  if (/\b(bookings?|booking requests?)\b/.test(t) && /\b(show|list|get|my|what)\b/.test(t)) {
+    return { action: "list_bookings", args: { limit: 5 } };
+  }
   if (t.includes("mcp") && (t.includes("config") || t.includes("connect") || t.includes("claude") || t.includes("cursor") || t.includes("codex"))) {
     return { action: "mcp_config", args: {} };
   }
@@ -80,6 +113,28 @@ function asArray(data) {
   return [];
 }
 
+function items(data) {
+  if (Array.isArray(data?.items)) return data.items;
+  return asArray(data).map((row) => ({
+    id: row.id,
+    title: row.title || row.name || [row.first_name, row.last_name].filter(Boolean).join(" ") || row.subject || row.id,
+    subtitle: row.subtitle || row.company || row.participant_email || row.status || "",
+    link: row.link,
+    metadata: row.metadata || row,
+  }));
+}
+
+function formatDate(value) {
+  if (!value) return "";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return "";
+  return date.toLocaleDateString("en-AU", { month: "short", day: "numeric", year: "numeric" });
+}
+
+function plural(count, singular, pluralName = `${singular}s`) {
+  return `${count} ${count === 1 ? singular : pluralName}`;
+}
+
 function printEpisodeList(data) {
   const rows = asArray(data);
   if (!rows.length) {
@@ -93,6 +148,177 @@ function printEpisodeList(data) {
   }
 }
 
+function printInbox(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No MangoMagic inbox threads found.\n");
+    return;
+  }
+  const unread = rows.reduce((sum, row) => sum + Number(row.unread_count || 0), 0);
+  process.stdout.write(`${BOLD}MangoMagic inbox:${RESET} ${plural(rows.length, "thread")} shown${unread ? `, ${plural(unread, "unread message")}` : ""}.\n\n`);
+  for (const row of rows.slice(0, 8)) {
+    const sender = row.participant_name || row.participant_email || "Unknown sender";
+    const unreadText = Number(row.unread_count || 0) ? `${row.unread_count} unread` : "read";
+    const when = formatDate(row.last_message_at);
+    process.stdout.write(`  ${GOLD}${row.subject || "Untitled thread"}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${sender} • ${unreadText}${when ? ` • ${when}` : ""}${RESET}\n`);
+  }
+  process.stdout.write(`\n${DIM}This is your MangoMagic inbox. Ask "show my stats" or "analyse my guests" for the next useful snapshot.${RESET}\n`);
+}
+
+function printStats(data) {
+  const stats = data?.data || data;
+  if (!stats || typeof stats !== "object") {
+    process.stdout.write("No account stats found.\n");
+    return;
+  }
+  process.stdout.write(`${BOLD}Account snapshot${RESET}\n`);
+  process.stdout.write(`  Level: ${GOLD}${stats.level ?? "?"}${RESET}${stats.xp_points != null ? ` (${stats.xp_points} XP)` : ""}\n`);
+  process.stdout.write(`  Streak: ${GOLD}${stats.current_streak ?? 0}${RESET} days\n`);
+  process.stdout.write(`  Recordings: ${GOLD}${stats.total_recordings ?? 0}${RESET}${stats.total_minutes_recorded != null ? ` • ${stats.total_minutes_recorded} minutes` : ""}\n`);
+  process.stdout.write(`  Clips: ${GOLD}${stats.total_clips_created ?? 0}${RESET}\n`);
+  process.stdout.write(`  Credits: ${GOLD}${stats.credit_balance ?? stats.episodes_remaining ?? "?"}${RESET}\n`);
+}
+
+function printClips(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No clips found yet.\n");
+    return;
+  }
+  const failed = rows.filter((row) => row.status === "failed").length;
+  process.stdout.write(`${BOLD}Recent clips${RESET}${failed ? ` ${DIM}(${failed} need attention)${RESET}` : ""}\n\n`);
+  for (const clip of rows.slice(0, 8)) {
+    const status = clip.status || clip.metadata?.status || "unknown";
+    const views = clip.view_count ?? clip.metadata?.view_count ?? 0;
+    const link = clip.slug ? `https://mangomagic.live/clips/${clip.slug}` : clip.link ? `https://mangomagic.live${clip.link}` : "";
+    process.stdout.write(`  ${GOLD}${clip.title || "Untitled clip"}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${status} • ${plural(Number(views), "view")}${link ? ` • ${link}` : ""}${RESET}\n`);
+  }
+}
+
+function leadName(row) {
+  return row.title || [row.first_name, row.last_name].filter(Boolean).join(" ") || row.name || row.email || row.id || "Unnamed lead";
+}
+
+function printLeads(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No guests or leads found yet.\n");
+    return;
+  }
+  process.stdout.write(`${BOLD}Guests and leads${RESET}\n\n`);
+  for (const lead of rows.slice(0, 10)) {
+    const role = [lead.position, lead.company].filter(Boolean).join(" at ");
+    const stage = lead.stage || lead.metadata?.stage || "unknown stage";
+    const enrichment = lead.enrichment_status || lead.metadata?.enrichment_status;
+    process.stdout.write(`  ${GOLD}${leadName(lead)}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${[role, stage, enrichment].filter(Boolean).join(" • ")}${RESET}\n`);
+  }
+}
+
+function printGuestAnalysis(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("I could not find guests or leads to analyse yet.\n");
+    return;
+  }
+
+  const stageCounts = new Map();
+  const pending = [];
+  const ready = [];
+  for (const lead of rows) {
+    const stage = lead.stage || "unknown";
+    stageCounts.set(stage, (stageCounts.get(stage) || 0) + 1);
+    if ((lead.enrichment_status || "").toLowerCase() === "pending") pending.push(lead);
+    if (lead.email || lead.profile_url) ready.push(lead);
+  }
+
+  process.stdout.write(`${BOLD}Guest pipeline snapshot${RESET}\n`);
+  process.stdout.write(`  Analysed: ${GOLD}${plural(rows.length, "guest")}${RESET}\n`);
+  process.stdout.write(`  Contactable now: ${GOLD}${ready.length}${RESET}\n`);
+  process.stdout.write(`  Need enrichment: ${GOLD}${pending.length}${RESET}\n`);
+  if (stageCounts.size) {
+    const summary = [...stageCounts.entries()].map(([stage, count]) => `${stage}: ${count}`).join(", ");
+    process.stdout.write(`  Stages: ${DIM}${summary}${RESET}\n`);
+  }
+
+  process.stdout.write(`\n${BOLD}Best immediate moves${RESET}\n`);
+  for (const lead of ready.slice(0, 5)) {
+    const contact = lead.email || lead.profile_url || "contact details available";
+    process.stdout.write(`  ${GOLD}${leadName(lead)}${RESET} ${DIM}${contact}${RESET}\n`);
+  }
+  const lead = leadName(ready[0] || pending[0]);
+  process.stdout.write(`\n${DIM}Next: ask "show me my leads" or "create talking cards about why ${lead} should join my podcast".${RESET}\n`);
+}
+
+function printMeetings(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No upcoming meetings found.\n");
+    return;
+  }
+  process.stdout.write(`${BOLD}Upcoming meetings${RESET}\n\n`);
+  for (const meeting of rows.slice(0, 8)) {
+    const when = formatDate(meeting.scheduled_at || meeting.scheduledAt || meeting.start_time);
+    process.stdout.write(`  ${GOLD}${meeting.title || meeting.name || "Untitled meeting"}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${[when, meeting.status, meeting.guest_email || meeting.guestEmail].filter(Boolean).join(" • ")}${RESET}\n`);
+  }
+}
+
+function printBookings(data) {
+  const rows = asArray(data);
+  if (!rows.length) {
+    process.stdout.write("No bookings found.\n");
+    return;
+  }
+  process.stdout.write(`${BOLD}Bookings${RESET}\n\n`);
+  for (const booking of rows.slice(0, 8)) {
+    const when = formatDate(booking.scheduled_at || booking.created_at);
+    process.stdout.write(`  ${GOLD}${booking.title || booking.name || booking.guest_name || "Booking"}${RESET}\n`);
+    process.stdout.write(`  ${DIM}${[booking.status, when, booking.email || booking.guest_email].filter(Boolean).join(" • ")}${RESET}\n`);
+  }
+}
+
+function printGenericResult(name, data) {
+  const rows = items(data);
+  if (rows.length) {
+    process.stdout.write(`${BOLD}${name}${RESET}\n\n`);
+    for (const row of rows.slice(0, 10)) {
+      process.stdout.write(`  ${GOLD}${row.title || row.id || "Result"}${RESET}\n`);
+      if (row.subtitle) process.stdout.write(`  ${DIM}${row.subtitle}${RESET}\n`);
+      if (row.link) process.stdout.write(`  ${DIM}https://mangomagic.live${row.link}${RESET}\n`);
+    }
+    return;
+  }
+  const message = data?.message || data?.summary || data?.status;
+  process.stdout.write(message ? `${message}\n` : `${BOLD}Done.${RESET}\n`);
+}
+
+function printToolResult(name, data) {
+  switch (name) {
+    case "get_inbox":
+      return printInbox(data);
+    case "get_user_stats":
+      return printStats(data);
+    case "get_user_clips":
+      return printClips(data);
+    case "get_user_leads":
+      return printLeads(data);
+    case "get_upcoming_meetings":
+      return printMeetings(data);
+    case "get_bookings":
+      return printBookings(data);
+    case "get_user_episodes":
+    case "list_episodes":
+    case "search_user_episodes":
+    case "search_episodes":
+      return printEpisodeList(data);
+    default:
+      return printGenericResult(name, data);
+  }
+}
+
 function printEpisode(data) {
   const ep = data?.episode || data?.data || data;
   if (!ep || typeof ep !== "object") {
@@ -166,12 +392,17 @@ export async function handleNaturalLanguage(text, actions, { allowModel = true }
       plan = await planWithKimi(text, {
         availableTools: [
           "create_talking_cards",
-          "open_cards",
-          "open_brand_doc",
+          "list_inbox",
+          "list_leads",
+          "analyze_guests",
+          "list_clips",
+          "account_stats",
+          "list_meetings",
+          "list_bookings",
           "show_tools",
           "mcp_config",
           "home",
-          ...ALL_MCP_TOOL_CATALOG.map((tool) => tool.name),
+          ...CHAT_TOOL_NAMES,
         ],
       });
     } catch (err) {
@@ -210,6 +441,34 @@ ${DIM}${err?.message ?? err}${RESET}
       return actions.mcpConfig();
     case "home":
       return actions.home();
+    case "list_inbox": {
+      const data = await runCatalogTool("get_inbox", { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) });
+      return printInbox(data);
+    }
+    case "account_stats": {
+      const data = await runCatalogTool("get_user_stats", {});
+      return printStats(data);
+    }
+    case "list_clips": {
+      const data = await runCatalogTool("get_user_clips", { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) });
+      return printClips(data);
+    }
+    case "list_leads": {
+      const data = await runCatalogTool("get_user_leads", { limit: Math.max(1, Math.min(Number(args.limit || 8), 20)) });
+      return printLeads(data);
+    }
+    case "analyze_guests": {
+      const data = await runCatalogTool("get_user_leads", { limit: Math.max(1, Math.min(Number(args.limit || 10), 20)) });
+      return printGuestAnalysis(data);
+    }
+    case "list_meetings": {
+      const data = await runCatalogTool("get_upcoming_meetings", { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) });
+      return printMeetings(data);
+    }
+    case "list_bookings": {
+      const data = await runCatalogTool("get_bookings", { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) });
+      return printBookings(data);
+    }
     case "list_episodes": {
       const data = await apiCall("cli-list-episodes", { body: { limit: Math.max(1, Math.min(Number(args.limit || 5), 10)) } });
       return printEpisodeList(data);
@@ -235,10 +494,29 @@ ${DIM}${err?.message ?? err}${RESET}
         process.stdout.write("Which tool should I run?\n");
         return;
       }
+      if (String(args.toolName).startsWith("edge_")) {
+        process.stdout.write(`That is a developer/admin edge function. In chat mode I only run value-facing actions.\n`);
+        process.stdout.write(`Use ${GOLD}npx -y @mangomagic/cli tool ${args.toolName} '{"dryRun":true}'${RESET} if you want the raw operational tool.\n`);
+        return;
+      }
       const data = await runCatalogTool(args.toolName, args.args || {});
-      process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+      printToolResult(args.toolName, data);
       return;
     }
+    case "get_inbox":
+    case "get_user_stats":
+    case "get_user_clips":
+    case "get_user_leads":
+    case "get_upcoming_meetings":
+    case "get_bookings":
+    case "get_user_episodes": {
+      const data = await runCatalogTool(action, args);
+      return printToolResult(action, data);
+    }
+    case "qualify_leads": {
+      const data = await runCatalogTool("get_user_leads", { limit: Math.max(1, Math.min(Number(args.limit || 10), 20)) });
+      return printGuestAnalysis(data);
+    }
     case "answer":
       process.stdout.write(`${args.text || "I can help with MangoMagic episodes, talking cards, and MCP setup."}\n`);
       return;

package/src/index.mjs

@@ -44,9 +44,10 @@ function sessionIntro() {
 ${BOLD}You can type naturally now.${RESET}
 
 Try:
-  ${GOLD}what episodes do I have?${RESET}
   ${GOLD}create 3 talking cards about founder-led sales${RESET}
-  ${GOLD}show me all of your tools${RESET}
+  ${GOLD}analyse my guests${RESET}
+  ${GOLD}show me my clips${RESET}
+  ${GOLD}what episodes do I have?${RESET}
 
 ${DIM}Type ${BOLD}exit${RESET}${DIM} to leave. Add ${BOLD}--home${RESET}${DIM} next time if you only want the menu.${RESET}
 `);
@@ -98,6 +99,12 @@ ${DIM}Core tools available now:${RESET}
   }
 
   process.stdout.write(`
+${DIM}Value actions that work in chat now:${RESET}
+  ${GOLD}analyse my guests${RESET}
+  ${GOLD}show me my clips${RESET}
+  ${GOLD}show me my emails${RESET}
+  ${GOLD}show me my stats${RESET}
+
 ${DIM}Catalog:${RESET} ${ALL_MCP_TOOL_CATALOG.length} tools total (${MCP_TOOL_CATALOG.length} core, ${ALL_MCP_TOOL_CATALOG.length - MCP_TOOL_CATALOG.length} business/admin/raw tools).
 ${DIM}Run:${RESET} ${GOLD}${COMMAND_PREFIX} tool get_user_stats${RESET}
 ${DIM}Run with JSON:${RESET} ${GOLD}${COMMAND_PREFIX} tool get_user_episodes '{"limit":3}'${RESET}
@@ -120,14 +127,14 @@ ${DIM}Full list:${RESET} ${GOLD}${COMMAND_PREFIX} tools --all${RESET}
   }
 
   process.stdout.write(`
-${DIM}Next high-value workflows to wire in:${RESET}
+${DIM}High-value workflows:${RESET}
 `);
   for (const workflow of NEXT_WORKFLOWS) {
     process.stdout.write(`  ${GOLD}${workflow.name.padEnd(28)}${RESET} ${workflow.description}\n`);
   }
 
   process.stdout.write(`
-${DIM}Use \`mangomagic mcp-config\` to connect an MCP client.${RESET}
+${DIM}Use \`${COMMAND_PREFIX} mcp-config\` to connect an MCP client.${RESET}
 `);
 }
 

package/src/tools/catalog.mjs

@@ -91,14 +91,14 @@ export const QUICK_WINS = [
 export const NEXT_WORKFLOWS = [
   {
     name: "create_talking_cards",
-    description: "Generate a batch of branded talking cards from a short idea, saved to the user's carousel library.",
+    description: "Generate a batch of branded talking cards from a short idea and save them to the user's carousel library.",
   },
   {
     name: "sync_linkedin_brand_context",
-    description: "Use LinkedIn profile context to draft or refresh the user's Brand Doc.",
+    description: "Use LinkedIn profile context to draft or refresh the user's Brand Doc. Coming next.",
   },
   {
     name: "publish_talking_card",
-    description: "Publish an approved card to LinkedIn or prepare the post for manual approval.",
+    description: "Publish an approved card to LinkedIn or prepare the post for manual approval. Coming next.",
   },
 ];

package/src/tools/run.mjs

@@ -2,6 +2,56 @@ import { apiCall } from "../api.mjs";
 import { ALL_MCP_TOOL_CATALOG } from "./catalog.mjs";
 import { functionNameFromEdgeTool } from "./edge-functions.mjs";
 
+function asArray(data) {
+  if (Array.isArray(data)) return data;
+  if (Array.isArray(data?.data)) return data.data;
+  if (Array.isArray(data?.items)) return data.items;
+  if (Array.isArray(data?.results)) return data.results;
+  return [];
+}
+
+function leadName(lead) {
+  return [lead.first_name, lead.last_name].filter(Boolean).join(" ") || lead.title || lead.name || lead.email || lead.id || "Unnamed lead";
+}
+
+function qualifyFromLeads(result) {
+  const leads = asArray(result);
+  const recommendations = leads.map((lead) => {
+    const hasEmail = Boolean(lead.email || lead.metadata?.email);
+    const hasProfile = Boolean(lead.profile_url || lead.metadata?.profile_url);
+    const enrichmentStatus = lead.enrichment_status || lead.metadata?.enrichment_status || "unknown";
+    const score = (hasEmail ? 45 : 0) + (hasProfile ? 30 : 0) + (enrichmentStatus === "pending" ? 10 : 20);
+    return {
+      id: lead.id,
+      name: leadName(lead),
+      email: lead.email || lead.metadata?.email || null,
+      profileUrl: lead.profile_url || lead.metadata?.profile_url || null,
+      stage: lead.stage || lead.metadata?.stage || null,
+      enrichmentStatus,
+      score: Math.min(score, 100),
+      nextAction: enrichmentStatus === "pending" ? "Enrich this guest, then draft outreach." : "Draft outreach or invite to a recording.",
+    };
+  }).sort((a, b) => b.score - a.score);
+
+  return {
+    tool: "qualify_leads",
+    data: {
+      analysed: recommendations.length,
+      contactable: recommendations.filter((lead) => lead.email || lead.profileUrl).length,
+      needsEnrichment: recommendations.filter((lead) => lead.enrichmentStatus === "pending").length,
+      recommendations,
+    },
+    items: recommendations.slice(0, 10).map((lead) => ({
+      type: "lead_recommendation",
+      id: lead.id,
+      title: `${lead.name} (${lead.score}/100)`,
+      subtitle: lead.nextAction,
+      link: lead.id ? `/leads?id=${lead.id}` : undefined,
+      metadata: lead,
+    })),
+  };
+}
+
 const BUILTIN_TOOL_HANDLERS = {
   list_episodes: async ({ limit = 10 }) => apiCall("cli-list-episodes", { body: { limit } }),
   get_episode: async ({ episode }) => apiCall("cli-get-episode", { body: { episode } }),
@@ -12,6 +62,15 @@ const BUILTIN_TOOL_HANDLERS = {
       count: Math.max(1, Math.min(Number(count || 3), 10)),
     },
   }),
+  qualify_leads: async ({ stage = "all", limit = 10 } = {}) => {
+    const leads = await apiCall("magic-assistant", {
+      body: {
+        toolName: "get_user_leads",
+        args: { stage, limit: Math.max(1, Math.min(Number(limit || 10), 20)) },
+      },
+    });
+    return qualifyFromLeads(leads);
+  },
 };
 
 export function findTool(name) {