clawed 2.3.0__tar.gz → 2.3.2__tar.gz

{clawed-2.3.0 → clawed-2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawed
-Version: 2.3.0
+Version: 2.3.2
 Summary: Claw-ED — personal AI teaching agent. Learns your voice, works while you sleep.
 Project-URL: Homepage, https://github.com/SirhanMacx/Claw-ED
 Project-URL: Documentation, https://github.com/SirhanMacx/Claw-ED#readme

{clawed-2.3.0 → clawed-2.3.2}/clawed/__init__.py

@@ -17,7 +17,7 @@ if hasattr(sys.stderr, "reconfigure"):
     except Exception:
         pass
 
-__version__ = "2.3.0"
+__version__ = "2.3.2"
 __author__ = "Jon Maccarello & Claw-ED contributors"
 __description__ = "Personal AI teaching agent. Learns your voice, works while you sleep."
 

{clawed-2.3.0 → clawed-2.3.2}/clawed/export_pptx.py

@@ -455,7 +455,7 @@ def export_lesson_pptx(
 
     # Lesson title -- 44pt white bold, centered
     tb = slide.shapes.add_textbox(
-        Inches(1.5), Inches(2.0), slide_w - Inches(3.0), Inches(2.5),
+        Inches(1.5), Inches(1.5), slide_w - Inches(3.0), Inches(2.5),
     )
     tf = tb.text_frame
     tf.word_wrap = True
@@ -465,9 +465,30 @@ def export_lesson_pptx(
     run.text = lesson.title
     _set_text_props(run, 44, theme["text_light"], bold=True)
 
-    # Subtitle: "Lesson N | Teacher Name | Date" -- 20pt white
+    # Aim -- the driving question, centered below title
+    aim_text = lesson.objective
+    if aim_text and not aim_text.lower().startswith("students will"):
+        aim_display = f"Aim: {aim_text}"
+    elif aim_text:
+        aim_display = aim_text
+    else:
+        aim_display = ""
+    if aim_display:
+        tb_aim = slide.shapes.add_textbox(
+            Inches(1.5), Inches(4.0), slide_w - Inches(3.0), Inches(1.0),
+        )
+        tf_aim = tb_aim.text_frame
+        tf_aim.word_wrap = True
+        p_aim = tf_aim.paragraphs[0]
+        p_aim.alignment = PP_ALIGN.CENTER
+        run_aim = p_aim.add_run()
+        run_aim.text = aim_display
+        _set_text_props(run_aim, 20, "EEEEEE")
+        run_aim.font.italic = True
+
+    # Subtitle: "Teacher Name | Date" -- 16pt
     tb2 = slide.shapes.add_textbox(
-        Inches(1.5), Inches(4.8), slide_w - Inches(3.0), Inches(1.0),
+        Inches(1.5), Inches(5.2), slide_w - Inches(3.0), Inches(0.8),
     )
     tf2 = tb2.text_frame
     tf2.word_wrap = True
@@ -475,11 +496,10 @@ def export_lesson_pptx(
     p2.alignment = PP_ALIGN.CENTER
     run2 = p2.add_run()
     run2.text = (
-        f"Lesson {lesson.lesson_number}  |  "
         f"{teacher_display_name}  |  "
         f"{date.today().strftime('%B %d, %Y')}"
     )
-    _set_text_props(run2, 20, "DDDDDD")
+    _set_text_props(run2, 16, "BBBBBB")
 
     # Bottom accent bar in subject color
     _bar(slide, Emu(0), slide_h - Inches(0.15), slide_w, Inches(0.15), theme["secondary"])
@@ -535,7 +555,7 @@ def export_lesson_pptx(
         run.text = "Standards Addressed"
         _set_text_props(run, 16, "888888", bold=True)
 
-        for std in lesson.standards[:5]:
+        for std in lesson.standards[:3]:
             p = tf.add_paragraph()
             p.space_before = Pt(6)
             run = p.add_run()
@@ -577,9 +597,22 @@ def export_lesson_pptx(
         p = tf.paragraphs[0]
         p.line_spacing = Pt(38)
         run = p.add_run()
-        run.text = lesson.do_now
+        # Brief prompt on slide face, full text in speaker notes
+        dn_text = lesson.do_now
+        if len(dn_text) > 250:
+            cutoff = dn_text[:250].rfind(". ")
+            dn_display = dn_text[:cutoff + 1] if cutoff > 80 else dn_text[:250].rsplit(" ", 1)[0] + "..."
+        else:
+            dn_display = dn_text
+        run.text = dn_display
         _set_text_props(run, 28, theme["text_dark"])
 
+        # Full Do Now in speaker notes
+        if len(dn_text) > 250:
+            notes_slide = slide.notes_slide
+            notes_tf = notes_slide.notes_text_frame
+            notes_tf.text = dn_text
+
         if do_now_img:
             from clawed.slide_images import _extract_key_concepts
             concepts = _extract_key_concepts(lesson.do_now)
@@ -663,41 +696,45 @@ def export_lesson_pptx(
 
         _add_footer(slide, slide_num[0])
 
-        # ── Vocabulary slide (if terms detected) ───────────────────
-        # Try multiple patterns for vocabulary extraction
-        di_text_raw = lesson.direct_instruction or ""
-        vocab_patterns: list[tuple[str, str]] = []
-
-        # Pattern 1: **Bold Term** — definition
-        vocab_patterns = re.findall(
-            r'\*\*([A-Z][^*]{2,30})\*\*\s*[-—:]+\s*([^*\n]{15,200})',
-            di_text_raw,
-        )
-        # Pattern 2: KEY TERM: definition or Term: definition (capitalized)
-        if not vocab_patterns:
+        # ── Vocabulary slide ───────────────────────────────────────
+        # Prefer structured vocabulary from v2.3 model fields
+        vocab_pairs: list[tuple[str, str]] = []
+        if hasattr(lesson, "vocabulary") and lesson.vocabulary:
+            for vt in lesson.vocabulary:
+                term = getattr(vt, "term", "") if hasattr(vt, "term") else vt.get("term", "")
+                defn = getattr(vt, "definition", "") if hasattr(vt, "definition") else vt.get("definition", "")
+                if term and defn:
+                    vocab_pairs.append((term, defn))
+
+        # Fallback: regex extraction from DI text
+        if not vocab_pairs:
+            di_text_raw = lesson.direct_instruction or ""
             vocab_patterns = re.findall(
-                r'(?:^|\n)\s*\*?\*?([A-Z][a-z]+(?:\s+[A-Za-z]+){0,3})\*?\*?\s*[-—:]+\s+'
-                r'([A-Za-z][^\n]{15,200})',
+                r'\*\*([A-Z][^*]{2,30})\*\*\s*[-—:]+\s*([^*\n]{15,200})',
                 di_text_raw,
             )
-
-        # Filter out instructional directions and non-vocabulary content
-        INSTRUCTIONAL_WORDS = {
-            "check", "ask", "call", "facilitate", "transition", "minutes",
-            "discuss", "display", "distribute", "brief", "move", "moved",
-            "students", "responses", "excellent", "turn", "now", "let",
-            "today", "good", "morning", "scholars", "friends", "class",
-            "next", "first", "take", "look", "read", "write", "complete",
-        }
-        vocab_patterns = [
-            (term.strip(), defn.strip()) for term, defn in vocab_patterns
-            if 1 <= len(term.split()) <= 4
-            and len(defn.split()) >= 3
-            and not any(w in defn.lower().split()[:3] for w in INSTRUCTIONAL_WORDS)
-            and not any(w in term.lower().split() for w in INSTRUCTIONAL_WORDS)
-        ]
-
-        if vocab_patterns:
+            if not vocab_patterns:
+                vocab_patterns = re.findall(
+                    r'(?:^|\n)\s*\*?\*?([A-Z][a-z]+(?:\s+[A-Za-z]+){0,3})\*?\*?\s*[-—:]+\s+'
+                    r'([A-Za-z][^\n]{15,200})',
+                    di_text_raw,
+                )
+            INSTRUCTIONAL_WORDS = {
+                "check", "ask", "call", "facilitate", "transition", "minutes",
+                "discuss", "display", "distribute", "brief", "move", "moved",
+                "students", "responses", "excellent", "turn", "now", "let",
+                "today", "good", "morning", "scholars", "friends", "class",
+                "next", "first", "take", "look", "read", "write", "complete",
+            }
+            vocab_pairs = [
+                (term.strip(), defn.strip()) for term, defn in vocab_patterns
+                if 1 <= len(term.split()) <= 4
+                and len(defn.split()) >= 3
+                and not any(w in defn.lower().split()[:3] for w in INSTRUCTIONAL_WORDS)
+                and not any(w in term.lower().split() for w in INSTRUCTIONAL_WORDS)
+            ]
+
+        if vocab_pairs:
             slide = _next_slide()
             _white_bg(slide)
 
@@ -724,7 +761,7 @@ def export_lesson_pptx(
             tf = tb.text_frame
             tf.word_wrap = True
 
-            for idx, (term, definition) in enumerate(vocab_patterns[:8]):
+            for idx, (term, definition) in enumerate(vocab_pairs[:8]):
                 p = tf.paragraphs[0] if idx == 0 else tf.add_paragraph()
                 p.space_before = Pt(10)
                 p.line_spacing = Pt(36)
@@ -808,7 +845,11 @@ def export_lesson_pptx(
     # SECTION DIVIDER: "Let's Practice Together"
     # ═══════════════════════════════════════════════════════════════════
     if lesson.guided_practice:
-        _section_divider(prs, slide_num, "Let's Practice Together", theme, slide_w, slide_h)
+        gp_min = lesson.time_estimates.get("guided_practice", 15)
+        _section_divider(
+            prs, slide_num, f"Let's Practice Together\n({gp_min} minutes)",
+            theme, slide_w, slide_h,
+        )
 
     # ═══════════════════════════════════════════════════════════════════
     # GUIDED PRACTICE -- "Your Turn" header
@@ -832,7 +873,16 @@ def export_lesson_pptx(
 
         # No image on Guided Practice -- keep clean for readability
 
-        # Activity instructions -- 24pt
+        # Brief student-facing instructions on slide face (first 2-3 sentences)
+        gp_text = lesson.guided_practice
+        gp_summary = gp_text
+        if len(gp_text) > 250:
+            cutoff = gp_text[:250].rfind(". ")
+            if cutoff > 80:
+                gp_summary = gp_text[:cutoff + 1]
+            else:
+                gp_summary = gp_text[:250].rsplit(" ", 1)[0] + "..."
+
         tb = slide.shapes.add_textbox(
             Inches(0.8), Inches(1.8), slide_w - Inches(2.0), Inches(4.5),
         )
@@ -841,9 +891,14 @@ def export_lesson_pptx(
         p = tf.paragraphs[0]
         p.line_spacing = Pt(34)
         run = p.add_run()
-        run.text = lesson.guided_practice
+        run.text = gp_summary
         _set_text_props(run, 24, theme["text_dark"])
 
+        # Full guided practice in speaker notes
+        notes_slide = slide.notes_slide
+        notes_tf = notes_slide.notes_text_frame
+        notes_tf.text = gp_text
+
         # Time estimate
         minutes = lesson.time_estimates.get("guided_practice", 15)
         tb_time = slide.shapes.add_textbox(
@@ -883,7 +938,16 @@ def export_lesson_pptx(
 
         # No image on Independent Work -- keep clean for readability
 
-        # Task description -- 24pt
+        # Brief student-facing instructions on slide face
+        iw_text = lesson.independent_work
+        iw_summary = iw_text
+        if len(iw_text) > 250:
+            cutoff = iw_text[:250].rfind(". ")
+            if cutoff > 80:
+                iw_summary = iw_text[:cutoff + 1]
+            else:
+                iw_summary = iw_text[:250].rsplit(" ", 1)[0] + "..."
+
         tb = slide.shapes.add_textbox(
             Inches(1.0), Inches(1.8), slide_w - Inches(2.0), Inches(4.5),
         )
@@ -892,9 +956,14 @@ def export_lesson_pptx(
         p = tf.paragraphs[0]
         p.line_spacing = Pt(34)
         run = p.add_run()
-        run.text = lesson.independent_work
+        run.text = iw_summary
         _set_text_props(run, 24, theme["text_dark"])
 
+        # Full independent work in speaker notes
+        notes_slide = slide.notes_slide
+        notes_tf = notes_slide.notes_text_frame
+        notes_tf.text = iw_text
+
         # Time estimate in corner
         minutes = lesson.time_estimates.get("independent_work", 10)
         _rounded_card(
@@ -919,7 +988,7 @@ def export_lesson_pptx(
     # SECTION DIVIDER: "Show What You Know"
     # ═══════════════════════════════════════════════════════════════════
     if lesson.exit_ticket:
-        _section_divider(prs, slide_num, "Show What You Know", theme, slide_w, slide_h)
+        _section_divider(prs, slide_num, "Show What You Know\n(Exit Ticket)", theme, slide_w, slide_h)
 
     # ═══════════════════════════════════════════════════════════════════
     # EXIT TICKET -- distinctive assessment design
@@ -972,7 +1041,11 @@ def export_lesson_pptx(
             tf = tb.text_frame
             tf.word_wrap = True
             run = tf.paragraphs[0].add_run()
-            run.text = q.question
+            # Truncate long questions for slide readability
+            q_text = q.question
+            if len(q_text) > 120:
+                q_text = q_text[:120].rsplit(" ", 1)[0] + "..."
+            run.text = q_text
             _set_text_props(run, 20, theme["text_dark"])
 
             q_top += Inches(1.3)
@@ -1025,8 +1098,19 @@ def export_lesson_pptx(
         p = tf.paragraphs[0]
         p.line_spacing = Pt(30)
         run = p.add_run()
-        run.text = lesson.homework
+        # Brief homework summary on slide, full in notes
+        hw_text = lesson.homework
+        if len(hw_text) > 200:
+            cutoff = hw_text[:200].rfind(". ")
+            hw_display = hw_text[:cutoff + 1] if cutoff > 60 else hw_text[:200].rsplit(" ", 1)[0] + "..."
+        else:
+            hw_display = hw_text
+        run.text = hw_display
         _set_text_props(run, 22, "DDDDDD")
+        if len(hw_text) > 200:
+            notes_slide = slide.notes_slide
+            notes_tf = notes_slide.notes_text_frame
+            notes_tf.text = f"HOMEWORK (full text):\n{hw_text}"
     else:
         # "Key Takeaway" or "Questions?"
         tb = slide.shapes.add_textbox(

{clawed-2.3.0 → clawed-2.3.2}/clawed/onboarding.py

@@ -73,22 +73,35 @@ def _ask_provider() -> tuple[LLMProvider, str | None]:
     table.add_column("Provider")
     table.add_column("Cost")
     table.add_column("Notes")
-    table.add_row("1", "Anthropic (Claude)", "Pay per token", "Best quality")
-    table.add_row("2", "OpenAI (GPT-4o)", "Pay per token", "Widely used")
-    table.add_row("3", "Ollama", "Free", "Runs locally \u2014 no API key needed")
+    table.add_row("1", "Google Gemini", "Free tier available", "Best for getting started \u2014 generous free quota")
+    table.add_row("2", "Anthropic (Claude)", "Pay per token", "Highest quality")
+    table.add_row("3", "OpenAI (GPT-4o)", "Pay per token", "Widely used")
+    table.add_row("4", "Ollama (local)", "Free", "Runs on your machine \u2014 no internet needed")
     console.print()
     console.print(table)
 
     while True:
-        choice = Prompt.ask("\n[bold]Pick a provider[/bold]", choices=["1", "2", "3"], default="1")
+        choice = Prompt.ask(
+            "\n[bold]Pick a provider[/bold]", choices=["1", "2", "3", "4"], default="1",
+        )
         if choice == "1":
+            provider = LLMProvider.GOOGLE
+            console.print(
+                "\n  [dim]Get a free API key at: https://aistudio.google.com/apikey[/dim]",
+            )
+            key = Prompt.ask("  [bold]Google AI API key[/bold]  [dim](AIza...)[/dim]")
+            if not key.strip():
+                console.print("  [red]API key cannot be empty.[/red]")
+                continue
+            return provider, key.strip()
+        elif choice == "2":
             provider = LLMProvider.ANTHROPIC
             key = Prompt.ask("  [bold]Anthropic API key[/bold]  [dim](sk-ant-...)[/dim]")
             if not key.strip():
                 console.print("  [red]API key cannot be empty.[/red]")
                 continue
             return provider, key.strip()
-        elif choice == "2":
+        elif choice == "3":
             provider = LLMProvider.OPENAI
             key = Prompt.ask("  [bold]OpenAI API key[/bold]  [dim](sk-...)[/dim]")
             if not key.strip():
@@ -126,6 +139,10 @@ def _detect_available_models() -> tuple[LLMProvider | None, str]:
     and Ollama running locally.
     Returns (provider, description) or (None, message).
     """
+    # Check Google Gemini (free tier)
+    if os.environ.get("GOOGLE_API_KEY"):
+        return LLMProvider.GOOGLE, "Google Gemini API key found in environment"
+
     # Check Anthropic
     if os.environ.get("ANTHROPIC_API_KEY"):
         return LLMProvider.ANTHROPIC, "Anthropic API key found in environment"

{clawed-2.3.0 → clawed-2.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "clawed"
-version = "2.3.0"
+version = "2.3.2"
 description = "Claw-ED — personal AI teaching agent. Learns your voice, works while you sleep."
 readme = "README.md"
 license = "MIT"