ffx-cli 0.1.0__py3-none-any.whl

ffx/commands/list_cmd.py

@@ -0,0 +1,68 @@
+from __future__ import annotations
+from typing import Optional
+from datetime import datetime, timedelta, timezone
+
+import typer
+from ffx.config import Config
+from ffx.api_client import FirefliesClient, AuthError, ApiError
+from ffx.output import json_envelope, json_error, transcripts_table
+
+
+def list_cmd(
+    days: Optional[int] = typer.Option(None, "--days", help="Filter to last N days"),
+    limit: int = typer.Option(10, "--limit", help="Max results"),
+    participant: Optional[list[str]] = typer.Option(None, "--participant", help="Filter by attendee email (repeatable)"),
+    table: bool = typer.Option(False, "--table", help="Rich table output"),
+) -> None:
+    """List your Fireflies meetings."""
+    json_mode = not table
+    config = Config()
+    if not config.api_key:
+        if json_mode:
+            typer.echo(json_error("API key not configured", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key not set. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+
+    from_date = None
+    if days:
+        from_date = (datetime.now(timezone.utc) - timedelta(days=days)).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    try:
+        client = FirefliesClient(config.api_key)
+        transcripts = client.list_transcripts(limit=limit, from_date=from_date, participants=participant or None)
+    except AuthError:
+        if json_mode:
+            typer.echo(json_error("API key may have expired", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key may have expired. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+    except ApiError as e:
+        if json_mode:
+            typer.echo(json_error(str(e), "API_ERROR"))
+        else:
+            typer.echo(f"API error: {e}", err=True)
+        raise typer.Exit(2)
+
+    if not transcripts:
+        if json_mode:
+            typer.echo(json_envelope([], {"limit": limit}))
+        else:
+            typer.echo("No meetings found.")
+        return
+
+    if json_mode:
+        results = [
+            {
+                "id": t.id,
+                "title": t.title,
+                "date": t.display_date,
+                "duration_seconds": t.duration,
+                "organizer_email": t.organizer_email,
+                "participants": t.participants,
+            }
+            for t in transcripts
+        ]
+        typer.echo(json_envelope(results, {"limit": limit}))
+    else:
+        transcripts_table(transcripts)

ffx/commands/search.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+from typing import Optional
+from datetime import datetime, timedelta, timezone
+
+import typer
+from ffx.config import Config
+from ffx.api_client import FirefliesClient, AuthError, ApiError
+from ffx.output import json_envelope, json_error, transcripts_table
+
+
+def search(
+    query: str = typer.Argument(..., help="Search query"),
+    days: Optional[int] = typer.Option(None, "--days"),
+    limit: int = typer.Option(20, "--limit"),
+    participant: Optional[list[str]] = typer.Option(None, "--participant", help="Filter by attendee email (repeatable)"),
+    table: bool = typer.Option(False, "--table", help="Rich table output"),
+) -> None:
+    """Search meetings by keyword."""
+    json_mode = not table
+    config = Config()
+    if not config.api_key:
+        if json_mode:
+            typer.echo(json_error("API key not configured", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key not set. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+
+    from_date = None
+    if days:
+        from_date = (datetime.now(timezone.utc) - timedelta(days=days)).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    try:
+        client = FirefliesClient(config.api_key)
+        transcripts = client.search_transcripts(query, limit=limit, from_date=from_date, participants=participant or None)
+    except AuthError:
+        if json_mode:
+            typer.echo(json_error("API key may have expired", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key may have expired. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+    except ApiError as e:
+        if json_mode:
+            typer.echo(json_error(str(e), "API_ERROR"))
+        else:
+            typer.echo(f"API error: {e}", err=True)
+        raise typer.Exit(2)
+
+    if not transcripts:
+        if json_mode:
+            typer.echo(json_envelope([], {"query": query}))
+        else:
+            typer.echo(f"No results found for '{query}'.")
+        return
+
+    if json_mode:
+        results = [
+            {"id": t.id, "title": t.title, "date": t.display_date, "duration_seconds": t.duration}
+            for t in transcripts
+        ]
+        typer.echo(json_envelope(results, {"query": query, "limit": limit}))
+    else:
+        transcripts_table(transcripts)

ffx/commands/speaker.py

@@ -0,0 +1,84 @@
+from __future__ import annotations
+import json
+
+import typer
+from ffx.config import Config
+from ffx.api_client import FirefliesClient, AuthError, ApiError
+from ffx.output import json_error, console
+
+
+def speaker(
+    transcript_id: str = typer.Argument(..., help="Transcript ID"),
+    table: bool = typer.Option(False, "--table", help="Rich table output"),
+) -> None:
+    """Show speaker analytics for a meeting."""
+    json_mode = not table
+    config = Config()
+    if not config.api_key:
+        if json_mode:
+            typer.echo(json_error("API key not configured", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key not set. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+
+    try:
+        client = FirefliesClient(config.api_key)
+        t = client.get_transcript(transcript_id)
+    except AuthError:
+        if json_mode:
+            typer.echo(json_error("API key may have expired", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key may have expired. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+    except ApiError as e:
+        if json_mode:
+            typer.echo(json_error(str(e), "API_ERROR"))
+        else:
+            typer.echo(f"API error: {e}", err=True)
+        raise typer.Exit(2)
+
+    if t is None:
+        if json_mode:
+            typer.echo(json_error("Transcript not found", "NOT_FOUND"))
+        else:
+            typer.echo(f"Transcript '{transcript_id}' not found.", err=True)
+        raise typer.Exit(3)
+
+    if not t.speakers:
+        if json_mode:
+            typer.echo(json.dumps({"id": t.id, "title": t.title, "speakers": []}, indent=2))
+        else:
+            typer.echo("No speaker analytics available for this meeting.")
+        return
+
+    if json_mode:
+        typer.echo(json.dumps({
+            "id": t.id,
+            "title": t.title,
+            "speakers": [
+                {
+                    "name": s.name,
+                    "duration_seconds": s.duration,
+                    "duration_pct": round(s.duration_pct, 1),
+                    "word_count": s.word_count,
+                    "words_per_minute": s.words_per_minute,
+                    "filler_words": s.filler_words,
+                    "questions": s.questions,
+                    "longest_monologue_seconds": s.longest_monologue,
+                    "monologues_count": s.monologues_count,
+                }
+                for s in t.speakers
+            ],
+        }, indent=2))
+    else:
+        console.print(f"\n[bold]{t.title}[/bold]  [dim]{t.display_date}[/dim]\n")
+        for s in sorted(t.speakers, key=lambda x: x.duration_pct, reverse=True):
+            pct = f"{s.duration_pct:.0f}%"
+            bar_len = max(0, min(20, int(s.duration_pct / 5)))
+            bar = "\u2588" * bar_len + "\u2591" * (20 - bar_len)
+            console.print(f"  [bold]{s.name}[/bold]")
+            console.print(f"    {bar} {pct}")
+            console.print(f"    {s.word_count} words  |  {s.words_per_minute:.0f} wpm  |  {s.filler_words} fillers  |  {s.questions} questions")
+            if s.longest_monologue:
+                console.print(f"    Longest monologue: {s.longest_monologue:.0f}s")
+            console.print()

ffx/commands/summary.py

@@ -0,0 +1,78 @@
+from __future__ import annotations
+import json
+import typer
+from ffx.config import Config
+from ffx.api_client import FirefliesClient, AuthError, ApiError
+from ffx.output import json_error
+
+
+def summary(
+    transcript_id: str = typer.Argument(..., help="Transcript ID"),
+    table: bool = typer.Option(False, "--table", help="Rich table output"),
+) -> None:
+    """Show the AI-generated summary for a meeting."""
+    json_mode = not table
+    config = Config()
+    if not config.api_key:
+        if json_mode:
+            typer.echo(json_error("API key not configured", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key not set. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+
+    try:
+        client = FirefliesClient(config.api_key)
+        t = client.get_transcript(transcript_id)
+    except AuthError:
+        if json_mode:
+            typer.echo(json_error("API key may have expired", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key may have expired. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+    except ApiError as e:
+        if json_mode:
+            typer.echo(json_error(str(e), "API_ERROR"))
+        else:
+            typer.echo(f"API error: {e}", err=True)
+        raise typer.Exit(2)
+
+    if t is None:
+        if json_mode:
+            typer.echo(json_error("Transcript not found", "NOT_FOUND"))
+        else:
+            typer.echo(f"Transcript '{transcript_id}' not found.", err=True)
+        raise typer.Exit(3)
+
+    s = t.summary
+    has_content = s and (s.overview or s.gist or s.keywords or s.action_items_list or s.topics_list)
+    if not has_content:
+        if json_mode:
+            typer.echo(json.dumps({"id": t.id, "title": t.title, "summary": None}, indent=2))
+        else:
+            typer.echo("No summary available for this meeting.")
+        return
+
+    if json_mode:
+        typer.echo(json.dumps({
+            "id": t.id,
+            "title": t.title,
+            "overview": t.summary.overview,
+            "gist": t.summary.gist,
+            "keywords": t.summary.keywords,
+            "topics_discussed": t.summary.topics_list,
+            "action_items": t.summary.action_items_list,
+        }, indent=2))
+    else:
+        typer.echo(f"\n{t.title}\n")
+        if t.summary.overview:
+            typer.echo(f"Overview:\n{t.summary.overview}\n")
+        if t.summary.gist:
+            typer.echo(f"Gist: {t.summary.gist}\n")
+        if t.summary.keywords:
+            typer.echo(f"Keywords: {', '.join(t.summary.keywords)}\n")
+        if t.summary.topics_list:
+            typer.echo(f"Topics: {', '.join(t.summary.topics_list)}\n")
+        if t.summary.action_items_list:
+            typer.echo("Action items:")
+            for item in t.summary.action_items_list:
+                typer.echo(f"  - {item}")

ffx/commands/topics.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+from typing import Optional
+from datetime import datetime, timedelta, timezone
+
+import typer
+from ffx.config import Config
+from ffx.api_client import FirefliesClient, AuthError, ApiError
+from ffx.output import json_envelope, json_error
+
+
+def topics(
+    transcript_id: Optional[str] = typer.Argument(None, help="Transcript ID (omit for recent meetings)"),
+    days: Optional[int] = typer.Option(7, "--days", help="Last N days (when no ID given)"),
+    limit: int = typer.Option(20, "--limit"),
+    table: bool = typer.Option(False, "--table", help="Rich table output"),
+) -> None:
+    """List topics discussed in meetings."""
+    json_mode = not table
+    config = Config()
+    if not config.api_key:
+        if json_mode:
+            typer.echo(json_error("API key not configured", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key not set. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+
+    try:
+        client = FirefliesClient(config.api_key)
+
+        if transcript_id:
+            t = client.get_transcript(transcript_id)
+            if t is None:
+                if json_mode:
+                    typer.echo(json_error("Transcript not found", "NOT_FOUND"))
+                else:
+                    typer.echo(f"Transcript '{transcript_id}' not found.", err=True)
+                raise typer.Exit(3)
+            transcripts = [t]
+        else:
+            from_date = None
+            if days:
+                from_date = (datetime.now(timezone.utc) - timedelta(days=days)).strftime("%Y-%m-%dT%H:%M:%SZ")
+            transcripts = client.list_transcripts(limit=limit, from_date=from_date)
+
+    except AuthError:
+        if json_mode:
+            typer.echo(json_error("API key may have expired", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key may have expired. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+    except ApiError as e:
+        if json_mode:
+            typer.echo(json_error(str(e), "API_ERROR"))
+        else:
+            typer.echo(f"API error: {e}", err=True)
+        raise typer.Exit(2)
+
+    all_topics: dict[str, list[str]] = {}
+    for t in transcripts:
+        topic_list = t.summary.topics_list if t.summary else []
+        if not topic_list and t.summary and t.summary.keywords:
+            topic_list = t.summary.keywords
+        for topic in topic_list:
+            all_topics.setdefault(topic, []).append(t.title)
+
+    if not all_topics:
+        if json_mode:
+            typer.echo(json_envelope([], {"days": days}))
+        else:
+            typer.echo("No topics found.")
+        return
+
+    if json_mode:
+        results = [
+            {"topic": topic, "count": len(meetings), "meetings": meetings}
+            for topic, meetings in sorted(all_topics.items(), key=lambda x: -len(x[1]))
+        ]
+        typer.echo(json_envelope(results, {"days": days}))
+    else:
+        for topic, meetings in sorted(all_topics.items(), key=lambda x: -len(x[1])):
+            count = f" ({len(meetings)})" if len(meetings) > 1 else ""
+            typer.echo(f"  {topic}{count}")

ffx/commands/transcript.py

@@ -0,0 +1,91 @@
+from __future__ import annotations
+import json
+
+import typer
+from ffx.config import Config
+from ffx.api_client import FirefliesClient, AuthError, ApiError
+from ffx.output import json_error, console
+
+
+def transcript(
+    transcript_id: str = typer.Argument(..., help="Transcript ID"),
+    table: bool = typer.Option(False, "--table", help="Rich table output"),
+    timestamps: bool = typer.Option(True, "--timestamps/--no-timestamps", help="Show timestamps"),
+    speakers: bool = typer.Option(True, "--speakers/--no-speakers", help="Show speaker names"),
+) -> None:
+    """Show the full transcript text with speaker names and timestamps."""
+    json_mode = not table
+    config = Config()
+    if not config.api_key:
+        if json_mode:
+            typer.echo(json_error("API key not configured", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key not set. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+
+    try:
+        client = FirefliesClient(config.api_key)
+        t = client.get_transcript_with_sentences(transcript_id)
+    except AuthError:
+        if json_mode:
+            typer.echo(json_error("API key may have expired", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key may have expired. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+    except ApiError as e:
+        if json_mode:
+            typer.echo(json_error(str(e), "API_ERROR"))
+        else:
+            typer.echo(f"API error: {e}", err=True)
+        raise typer.Exit(2)
+
+    if t is None:
+        if json_mode:
+            typer.echo(json_error("Transcript not found", "NOT_FOUND"))
+        else:
+            typer.echo(f"Transcript '{transcript_id}' not found.", err=True)
+        raise typer.Exit(3)
+
+    if not t.sentences:
+        if json_mode:
+            typer.echo(json.dumps({"id": t.id, "title": t.title, "sentences": []}, indent=2))
+        else:
+            typer.echo("No transcript text available for this meeting.")
+        return
+
+    if json_mode:
+        typer.echo(json.dumps({
+            "id": t.id,
+            "title": t.title,
+            "date": t.display_date,
+            "sentences": [
+                {
+                    "index": s.index,
+                    "speaker": s.speaker_name,
+                    "text": s.text,
+                    "start_time": s.start_time,
+                    "end_time": s.end_time,
+                }
+                for s in t.sentences
+            ],
+        }, indent=2))
+        return
+
+    console.print(f"\n[bold]{t.title}[/bold]  [dim]{t.display_date}[/dim]\n")
+
+    last_speaker = None
+    for s in t.sentences:
+        parts = []
+        if timestamps:
+            parts.append(f"[dim]{s.timestamp}[/dim]")
+        if speakers and s.speaker_name != last_speaker:
+            parts.append(f"[bold]{s.speaker_name}:[/bold]")
+            last_speaker = s.speaker_name
+        elif speakers:
+            parts.append(" " * (len(s.speaker_name) + 1))
+
+        prefix = "  ".join(parts)
+        if prefix:
+            console.print(f"{prefix}  {s.text}")
+        else:
+            console.print(s.text)

ffx/commands/week.py

@@ -0,0 +1,121 @@
+from __future__ import annotations
+import json
+from datetime import datetime, timedelta, timezone
+
+import typer
+from ffx.config import Config
+from ffx.api_client import FirefliesClient, AuthError, ApiError
+from ffx.output import json_envelope, json_error, console
+
+
+def _meeting_summary(transcripts, period_label: str, json_mode: bool) -> None:
+    if not transcripts:
+        if json_mode:
+            typer.echo(json_envelope([], {"period": period_label}))
+        else:
+            typer.echo(f"No meetings found for {period_label}.")
+        return
+
+    total_duration = sum(t.duration or 0 for t in transcripts)
+    total_hours = total_duration / 3600
+
+    all_action_items = []
+    all_topics = {}
+    speaker_time: dict[str, float] = {}
+
+    for t in transcripts:
+        all_action_items.extend(t.action_items)
+        if t.summary:
+            for topic in t.summary.topics_list:
+                all_topics[topic] = all_topics.get(topic, 0) + 1
+            for kw in t.summary.keywords:
+                all_topics[kw] = all_topics.get(kw, 0) + 1
+        for s in t.speakers:
+            speaker_time[s.name] = speaker_time.get(s.name, 0) + s.duration
+
+    if json_mode:
+        typer.echo(json.dumps({
+            "period": period_label,
+            "meeting_count": len(transcripts),
+            "total_hours": round(total_hours, 1),
+            "meetings": [
+                {"id": t.id, "title": t.title, "date": t.display_date, "duration_seconds": t.duration}
+                for t in transcripts
+            ],
+            "action_items_count": len(all_action_items),
+            "top_topics": sorted(all_topics.items(), key=lambda x: -x[1])[:10],
+            "speaker_time": {k: round(v, 1) for k, v in sorted(speaker_time.items(), key=lambda x: -x[1])},
+        }, indent=2))
+    else:
+        console.print(f"\n[bold]{period_label}[/bold]\n")
+        console.print(f"  {len(transcripts)} meetings  |  {total_hours:.1f} hours  |  {len(all_action_items)} action items\n")
+
+        console.print("  [bold]Meetings:[/bold]")
+        for t in transcripts:
+            dur = f"{(t.duration or 0) // 60}m"
+            console.print(f"    {t.display_date}  {t.title}  ({dur})")
+        console.print()
+
+        if all_topics:
+            top = sorted(all_topics.items(), key=lambda x: -x[1])[:8]
+            topics_str = ", ".join(f"{t}" for t, c in top)
+            console.print(f"  [bold]Top topics:[/bold] {topics_str}\n")
+
+        if speaker_time:
+            console.print("  [bold]Time by speaker:[/bold]")
+            total = sum(speaker_time.values())
+            for name, secs in sorted(speaker_time.items(), key=lambda x: -x[1]):
+                pct = (secs / total * 100) if total > 0 else 0
+                console.print(f"    {name}: {secs / 60:.0f}m ({pct:.0f}%)")
+            console.print()
+
+        if all_action_items:
+            console.print(f"  [bold]Action items ({len(all_action_items)}):[/bold]")
+            for i, item in enumerate(all_action_items[:10], 1):
+                typer.echo(f"    {i}. {item.text}")
+            if len(all_action_items) > 10:
+                typer.echo(f"    ... and {len(all_action_items) - 10} more")
+
+
+def week(
+    table: bool = typer.Option(False, "--table", help="Rich table output"),
+) -> None:
+    """Show a summary of this week's meetings."""
+    _run_period(7, "This Week", not table)
+
+
+def month(
+    table: bool = typer.Option(False, "--table", help="Rich table output"),
+) -> None:
+    """Show a summary of this month's meetings."""
+    _run_period(30, "This Month", not table)
+
+
+def _run_period(days: int, label: str, json_mode: bool) -> None:
+    config = Config()
+    if not config.api_key:
+        if json_mode:
+            typer.echo(json_error("API key not configured", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key not set. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+
+    from_date = (datetime.now(timezone.utc) - timedelta(days=days)).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    try:
+        client = FirefliesClient(config.api_key)
+        transcripts = client.list_transcripts(limit=100, from_date=from_date)
+    except AuthError:
+        if json_mode:
+            typer.echo(json_error("API key may have expired", "UNAUTHENTICATED", "Run: ffx auth"))
+        else:
+            typer.echo("API key may have expired. Run: ffx auth", err=True)
+        raise typer.Exit(2)
+    except ApiError as e:
+        if json_mode:
+            typer.echo(json_error(str(e), "API_ERROR"))
+        else:
+            typer.echo(f"API error: {e}", err=True)
+        raise typer.Exit(2)
+
+    _meeting_summary(transcripts, label, json_mode)

ffx/config.py

@@ -0,0 +1,46 @@
+import os
+import stat
+from pathlib import Path
+
+import yaml
+
+
+def _ffx_home() -> Path:
+    home = os.environ.get("FFX_HOME")
+    if home:
+        return Path(home)
+    return Path.home() / ".ffx"
+
+
+class Config:
+    def __init__(self) -> None:
+        self._home = _ffx_home()
+        self._home.mkdir(parents=True, exist_ok=True)
+        self._path = self._home / "config.yaml"
+
+    def _load(self) -> dict:
+        if not self._path.exists():
+            return {}
+        with open(self._path) as f:
+            return yaml.safe_load(f) or {}
+
+    def _save(self, data: dict) -> None:
+        with open(self._path, "w") as f:
+            yaml.safe_dump(data, f)
+        self._path.chmod(stat.S_IRUSR | stat.S_IWUSR)
+
+    def get(self, key: str):
+        return self._load().get(key)
+
+    def set(self, key: str, value) -> None:
+        data = self._load()
+        data[key] = value
+        self._save(data)
+
+    @property
+    def api_key(self) -> str | None:
+        return os.environ.get("FIREFLIES_API_KEY") or self.get("api_key")
+
+    @property
+    def home(self) -> Path:
+        return self._home