@thanh01.pmt/presentation-kit 0.2.1 → 0.2.2

package/dist/ai/index.js

@@ -0,0 +1,415 @@
+import { SLIDE_LAYOUT_PRESETS, getSlideLayoutPresetsByCategory, getSlideLayoutPresetById, serializeLayoutToComment, updateSlideLayoutInMarkdown, splitMarkdownSlides } from '../chunk-HBMXEPZJ.js';
+import { z } from 'zod';
+
+var listSlidePresetsSchema = z.object({
+  category: z.enum([
+    "all",
+    "cover",
+    "content",
+    "split",
+    "code",
+    "metrics",
+    "diagram",
+    "quote",
+    "assessment"
+  ]).optional().describe("Optional category filter for layout presets")
+});
+var createSlideFromPresetSchema = z.object({
+  presetId: z.string().describe(
+    "ID of the layout preset: title-hero, two-column-split, code-explainer, metrics-3-card, process-flow, quote-highlight, quiz-checkpoint, tiered-practice-3cards, agenda-timeline, takeaways-summary"
+  ),
+  title: z.string().describe("Slide heading or title"),
+  subtitle: z.string().optional().describe("Optional subtitle or section context"),
+  content: z.record(z.string()).optional().describe(
+    "Key-value pairs for preset sections. For two-column-split: leftCol, rightCol. For code-explainer: code, language, notes. For metrics-3-card: card1Title, card1Val, card1Desc, etc."
+  ),
+  customMarkdownBody: z.string().optional().describe(
+    "Raw markdown body to place inside the layout container (overrides content key-value pairs if provided)"
+  ),
+  presenterNotes: z.array(z.string()).optional().describe(
+    "Teacher talk track, cold-call check questions, or scaffolding notes for this slide"
+  )
+});
+var applySlideLayoutSchema = z.object({
+  markdown: z.string().describe("Full Markdown slide deck content"),
+  slideIndex: z.number().int().min(0).describe("0-based index of the target slide to modify"),
+  presetId: z.string().optional().describe("Optional preset ID to apply to this slide"),
+  boxes: z.array(
+    z.object({
+      id: z.string(),
+      target: z.string().optional(),
+      pos: z.tuple([z.number(), z.number(), z.number(), z.number()]).describe("[x, y, width, height] in 1280x720 canvas coordinates"),
+      fontSize: z.string().optional(),
+      color: z.string().optional(),
+      textAlign: z.enum(["left", "center", "right", "justify"]).optional(),
+      style: z.string().optional()
+    })
+  ).optional().describe("Custom boxes if not using presetId")
+});
+var updatePresenterNotesSchema = z.object({
+  markdown: z.string().describe("Full Markdown slide deck content"),
+  slideIndex: z.number().int().min(0).describe("0-based index of the target slide"),
+  notes: z.array(z.string()).describe("List of speaker notes / talk tracks to set for this slide")
+});
+var generateDeckOutlineSchema = z.object({
+  topic: z.string().describe("Main subject or topic of the presentation"),
+  durationMins: z.number().int().min(3).max(120).default(15).describe("Estimated duration in minutes (5m: 5-7 slides, 15m: 12-18 slides, 30m: 25-35 slides)"),
+  audience: z.string().describe("Target audience profile (e.g. Grade 10 students, junior developers, enterprise clients)"),
+  keyObjectives: z.array(z.string()).describe("2-4 key learning or decision objectives"),
+  techStack: z.string().optional().describe("Optional programming language, framework, or hardware kit")
+});
+
+// src/ai/tools.ts
+function executeListSlidePresets(params) {
+  const category = params?.category;
+  const presets = !category || category === "all" ? SLIDE_LAYOUT_PRESETS : getSlideLayoutPresetsByCategory(category);
+  return {
+    count: presets.length,
+    presets: presets.map((p) => ({
+      id: p.id,
+      name: p.name,
+      category: p.category,
+      description: p.description,
+      boxCount: p.layout.boxes.length,
+      snippetPreview: p.markdownSnippet.split("\n").slice(0, 8).join("\n") + "\n..."
+    }))
+  };
+}
+function executeCreateSlideFromPreset(params) {
+  const preset = getSlideLayoutPresetById(params.presetId);
+  if (!preset) {
+    return {
+      success: false,
+      slideMarkdown: "",
+      error: `Kh\xF4ng t\xECm th\u1EA5y preset v\u1EDBi ID: "${params.presetId}". S\u1EED d\u1EE5ng listSlidePresets \u0111\u1EC3 xem c\xE1c m\u1EABu c\xF3 s\u1EB5n.`
+    };
+  }
+  const layoutComment = serializeLayoutToComment(preset.layout);
+  const title = params.title;
+  const subtitle = params.subtitle ? `
+### ${params.subtitle}` : "";
+  let body = params.customMarkdownBody;
+  if (!body) {
+    const c = params.content || {};
+    switch (preset.id) {
+      case "title-hero":
+        body = `${subtitle}
+
+**Ng\u01B0\u1EDDi tr\xECnh b\xE0y:** ${c.speaker || "Gi\u1EA3ng vi\xEAn"} | **Th\u1EDDi l\u01B0\u1EE3ng:** ${c.duration || "45 ph\xFAt"} | **Ch\u1EE7 \u0111\u1EC1:** ${c.topic || title}`;
+        break;
+      case "two-column-split":
+        body = `<div class="columns-2">
+<div>
+
+### ${c.leftHeader || "C\xE1ch ti\u1EBFp c\u1EADn A"}
+${c.leftCol || "- \u0110i\u1EC3m 1\n- \u0110i\u1EC3m 2\n- \u0110i\u1EC3m 3"}
+
+</div>
+<div>
+
+### ${c.rightHeader || "C\xE1ch ti\u1EBFp c\u1EADn B"}
+${c.rightCol || "- \u0110i\u1EC3m 1\n- \u0110i\u1EC3m 2\n- \u0110i\u1EC3m 3"}
+
+</div>
+</div>`;
+        break;
+      case "code-explainer":
+        body = `<div class="columns-2">
+<div>
+
+\`\`\`${c.lang || "ts"}
+${c.code || "// Code snippet \u1EDF \u0111\xE2y\nconst example = true;"}
+\`\`\`
+
+</div>
+<div>
+
+### \u{1F50D} \u0110i\u1EC3m c\u1ED1t l\xF5i:
+${c.notes || "1. **Ph\xE2n t\xEDch d\xF2ng 1:** Kh\u1EDFi t\u1EA1o\n2. **Ph\xE2n t\xEDch d\xF2ng 2:** Th\u1EF1c thi\n3. **L\u01B0u \xFD:** \u0110i\u1EC1u ki\u1EC7n bi\xEAn"}
+
+</div>
+</div>`;
+        break;
+      case "metrics-3-card":
+        body = `<div class="columns-3">
+<div>
+
+# ${c.metric1Val || "99.9%"}
+### ${c.metric1Title || "Ch\u1EC9 s\u1ED1 1"}
+${c.metric1Desc || "M\xF4 t\u1EA3 ng\u1EAFn g\u1ECDn v\u1EC1 ch\u1EC9 s\u1ED1."}
+
+</div>
+<div>
+
+# ${c.metric2Val || "10x"}
+### ${c.metric2Title || "Ch\u1EC9 s\u1ED1 2"}
+${c.metric2Desc || "M\xF4 t\u1EA3 ng\u1EAFn g\u1ECDn v\u1EC1 ch\u1EC9 s\u1ED1."}
+
+</div>
+<div>
+
+# ${c.metric3Val || "0"}
+### ${c.metric3Title || "Ch\u1EC9 s\u1ED1 3"}
+${c.metric3Desc || "M\xF4 t\u1EA3 ng\u1EAFn g\u1ECDn v\u1EC1 ch\u1EC9 s\u1ED1."}
+
+</div>
+</div>`;
+        break;
+      case "process-flow":
+        body = `\`\`\`mermaid
+${c.mermaid || "graph LR\n  A[B\u01B0\u1EDBc 1] --> B[B\u01B0\u1EDBc 2]\n  B --> C[B\u01B0\u1EDBc 3]\n  C --> D[Ho\xE0n th\xE0nh]"}
+\`\`\`
+
+${c.summary || "- **Giai \u0111o\u1EA1n 1:** Kh\u1EDFi \u0111\u1ED9ng\n- **Giai \u0111o\u1EA1n 2:** X\u1EED l\xFD d\u1EEF li\u1EC7u\n- **Giai \u0111o\u1EA1n 3:** K\u1EBFt xu\u1EA5t k\u1EBFt qu\u1EA3"}`;
+        break;
+      case "quote-highlight":
+        body = `> "${c.quote || "S\u1EF1 \u0111\u01A1n gi\u1EA3n l\xE0 ch\xECa kh\xF3a c\u1EE7a \u0111\u1ED9 tin c\u1EADy."}"
+> 
+> \u2014 **${c.author || "Danh ng\xF4n c\xF4ng ngh\u1EC7"}**`;
+        break;
+      case "quiz-checkpoint":
+        body = `> **C\xE2u h\u1ECFi:** ${c.question || "Ph\u01B0\u01A1ng \xE1n n\xE0o sau \u0111\xE2y l\xE0 t\u1ED1i \u01B0u nh\u1EA5t?"}
+
+- **A.** ${c.optA || "L\u1EF1a ch\u1ECDn A"}
+- **B.** ${c.optB || "L\u1EF1a ch\u1ECDn B (Ch\xEDnh x\xE1c)"}
+- **C.** ${c.optC || "L\u1EF1a ch\u1ECDn C"}
+- **D.** ${c.optD || "L\u1EF1a ch\u1ECDn D"}`;
+        break;
+      case "tiered-practice-3cards":
+        body = `<div class="columns-3">
+<div>
+
+### \u{1F949} H\u1EA1ng \u0110\u1ED3ng (Bronze)
+${c.bronze || "- B\xE0i t\u1EADp c\u01A1 b\u1EA3n\n- 1 test case m\u1EABu"}
+
+</div>
+<div>
+
+### \u{1F948} H\u1EA1ng B\u1EA1c (Silver)
+${c.silver || "- T\u1ED1i \u01B0u thu\u1EADt to\xE1n\n- X\u1EED l\xFD \u0111i\u1EC1u ki\u1EC7n bi\xEAn"}
+
+</div>
+<div>
+
+### \u{1F947} H\u1EA1ng V\xE0ng (Gold)
+${c.gold || "- T\xEDnh n\u0103ng m\u1EDF r\u1ED9ng\n- T\u1EF1 \u0111\u1ED9ng h\xF3a unit test"}
+
+</div>
+</div>`;
+        break;
+      default:
+        body = preset.markdownSnippet.replace(/^<!--[\s\S]*?-->\n*/, "").replace(/^#\s+[^\n]+\n*/, "").trim();
+    }
+  }
+  const notes = params.presenterNotes && params.presenterNotes.length > 0 ? `
+
+<!--
+Presenter Notes:
+${params.presenterNotes.map((n) => `- ${n}`).join("\n")}
+-->` : `
+
+<!--
+Presenter Notes:
+- Gi\u1EA3i th\xEDch kh\xE1i ni\u1EC7m ch\xEDnh tr\xEAn slide.
+- \u0110\u1EB7t c\xE2u h\u1ECFi t\u01B0\u01A1ng t\xE1c cho c\u1EA3 l\u1EDBp.
+-->`;
+  const slideMarkdown = `${layoutComment}
+
+## ${title}${body ? "\n\n" + body : ""}${notes}`;
+  return {
+    success: true,
+    slideMarkdown,
+    presetName: preset.name
+  };
+}
+function executeApplySlideLayout(params) {
+  let layoutData = null;
+  if (params.presetId) {
+    const preset = getSlideLayoutPresetById(params.presetId);
+    if (!preset) {
+      return {
+        success: false,
+        updatedMarkdown: params.markdown,
+        error: `Kh\xF4ng t\xECm th\u1EA5y preset v\u1EDBi ID: "${params.presetId}"`
+      };
+    }
+    layoutData = preset.layout;
+  } else if (params.boxes && params.boxes.length > 0) {
+    layoutData = { boxes: params.boxes };
+  }
+  const updatedMarkdown = updateSlideLayoutInMarkdown(
+    params.markdown,
+    params.slideIndex,
+    layoutData
+  );
+  return {
+    success: true,
+    updatedMarkdown
+  };
+}
+function executeUpdatePresenterNotes(params) {
+  const { frontmatter, slides } = splitMarkdownSlides(params.markdown);
+  if (params.slideIndex < 0 || params.slideIndex >= slides.length) {
+    return {
+      success: false,
+      updatedMarkdown: params.markdown,
+      error: `Slide index ${params.slideIndex} ngo\xE0i ph\u1EA1m vi (t\u1ED5ng s\u1ED1 slides: ${slides.length})`
+    };
+  }
+  let slideContent = slides[params.slideIndex];
+  const notesCommentRegex = /<!--\s*(?:Presenter Notes|Notes):\s*([\s\S]*?)-->/i;
+  const newNotesComment = `<!--
+Presenter Notes:
+${params.notes.map((n) => `- ${n}`).join("\n")}
+-->`;
+  if (notesCommentRegex.test(slideContent)) {
+    slideContent = slideContent.replace(notesCommentRegex, newNotesComment);
+  } else {
+    slideContent = `${slideContent.trimEnd()}
+
+${newNotesComment}`;
+  }
+  slides[params.slideIndex] = slideContent;
+  const joined = slides.join("\n---\n");
+  const updatedMarkdown = frontmatter ? `${frontmatter}
+
+${joined}` : joined;
+  return {
+    success: true,
+    updatedMarkdown
+  };
+}
+function executeGenerateDeckOutline(params) {
+  const d = params.durationMins;
+  let targetSlideCount = 12;
+  let formatLabel = "15 min (Short Talk)";
+  if (d <= 7) {
+    targetSlideCount = 6;
+    formatLabel = "5 min (Lightning Talk)";
+  } else if (d <= 20) {
+    targetSlideCount = 14;
+    formatLabel = "15 min (Short Talk)";
+  } else if (d <= 35) {
+    targetSlideCount = 28;
+    formatLabel = "30 min (Conference Talk)";
+  } else {
+    targetSlideCount = 42;
+    formatLabel = "45-60 min (Keynote / Workshop)";
+  }
+  return {
+    topic: params.topic,
+    audience: params.audience,
+    durationMins: d,
+    format: formatLabel,
+    recommendedSlideCount: targetSlideCount,
+    structureGuidelines: [
+      "\xC1p d\u1EE5ng nguy\xEAn t\u1EAFc: M\u1ED9t \xFD t\u01B0\u1EDFng duy nh\u1EA5t tr\xEAn m\u1ED7i slide (One Idea Per Slide).",
+      "Gi\u1EDBi h\u1EA1n t\u1EEB: T\u1ED1i \u0111a 40 t\u1EEB tr\xEAn m\u1ED7i card/c\u1ED9t \u0111\u1EC3 ch\u1ED1ng tr\xE0n ch\u1EEF (Zero Scroll Invariant).",
+      "T\u1EF7 l\u1EC7 hi\u1EC3n th\u1ECB: Chu\u1EA9n 16:9 v\u1EDBi h\u1EC7 t\u1ECDa \u0111\u1ED9 1280x720.",
+      "B\u1EAFt bu\u1ED9c c\xF3 kh\u1ED1i Presenter Notes ch\u1EE9a: Talk track gi\u1EA3ng vi\xEAn + 1 c\xE2u h\u1ECFi t\u01B0\u01A1ng t\xE1c cold-call."
+    ],
+    suggestedOutline: [
+      { slide: 1, type: "title-hero", title: `\u{1F680} ${params.topic}`, intent: "G\xE2y \u1EA5n t\u01B0\u1EE3ng ban \u0111\u1EA7u v\xE0 gi\u1EDBi thi\u1EC7u di\u1EC5n gi\u1EA3" },
+      { slide: 2, type: "agenda-timeline", title: "\u{1F5FA}\uFE0F L\u1ED9 tr\xECnh ho\u1EA1t \u0111\u1ED9ng", intent: "\u0110\u1ECBnh h\xECnh c\u1EA5u tr\xFAc th\u1EDDi gian v\xE0 k\u1EBFt qu\u1EA3 \u0111\u1EA7u ra" },
+      { slide: 3, type: "two-column-split", title: "\u26A1 B\u1ED1i c\u1EA3nh & Th\u1EED th\xE1ch", intent: "So s\xE1nh c\xE1ch l\xE0m c\u0169 vs v\u1EA5n \u0111\u1EC1 th\u1EF1c t\u1EBF" },
+      { slide: 4, type: "process-flow", title: "\u{1F504} Ki\u1EBFn tr\xFAc c\u1ED1t l\xF5i", intent: "S\u01A1 \u0111\u1ED3 lu\u1ED3ng x\u1EED l\xFD t\u1ED5ng quan" },
+      { slide: 5, type: "code-explainer", title: "\u{1F4BB} Ph\xE2n t\xEDch m\xE3 ngu\u1ED3n", intent: "\u0110i s\xE2u v\xE0o implementation k\u1EF9 thu\u1EADt" },
+      { slide: 6, type: "metrics-3-card", title: "\u{1F4CA} 3 Ch\u1EC9 s\u1ED1 \u0111o l\u01B0\u1EDDng", intent: "\u0110\u1ECBnh l\u01B0\u1EE3ng hi\u1EC7u n\u0103ng v\xE0 t\xEDnh hi\u1EC7u qu\u1EA3" },
+      { slide: 7, type: "tiered-practice-3cards", title: "\u{1F6E0}\uFE0F Th\u1EED th\xE1ch ph\xE2n h\xF3a", intent: "Th\u1EF1c h\xE0nh t\u1EA1i ch\u1ED7 theo 3 b\u1EADc Bronze-Silver-Gold" },
+      { slide: 8, type: "quiz-checkpoint", title: "\u{1F3AF} Ki\u1EC3m tra nhanh", intent: "\u0110\xE1nh gi\xE1 m\u1EE9c \u0111\u1ED9 ti\u1EBFp thu (Formative Checkpoint)" },
+      { slide: 9, type: "takeaways-summary", title: "\u{1F3C1} T\u1ED5ng k\u1EBFt c\u1ED1t l\xF5i", intent: "3 b\xE0i h\u1ECDc r\xFAt ra v\xE0 nhi\u1EC7m v\u1EE5 ti\u1EBFp theo" }
+    ].slice(0, Math.max(5, Math.min(targetSlideCount, 10)))
+  };
+}
+
+// src/ai/prompt.ts
+var SLIDE_DESIGN_PROMPT_CONTRACT = `
+# SYSTEM MANDATE: PROFESSIONAL PRESENTATION & SLIDE DESIGN INVARIANTS
+
+You are an expert Presentation Architect & Visual Designer for educational, technical, and executive decks.
+When generating or modifying Marp slide presentations, you MUST STRICTLY obey the following non-negotiable rules:
+
+---
+
+## 1. DURATION-INDEXED SLIDE PACING
+Structure decks based on allocated talk time (averaging 1.5 - 2 minutes per slide):
+- **5 min (Lightning Talk):** 5 - 7 slides [Hook -> 2-3 Core Points -> CTA / Summary]
+- **15 min (Short Tech Talk):** 12 - 16 slides [Title -> Agenda -> Hook -> 3-4 Concepts -> Lab/Demo -> Summary]
+- **30 min (Conference / Class):** 24 - 32 slides [Full 5E Learning Cycle + Interactive Formative Checkpoint]
+- **45-60 min (Keynote / Workshop):** 36 - 50 slides [Modular Micro-cycles + Tiered Hands-on Exercises]
+
+---
+
+## 2. THE "ONE IDEA PER SLIDE" RULE
+- Each slide communicates **EXACTLY ONE** pedagogical or architectural concept.
+- Never pack multiple distinct topics into a single slide.
+- If a concept has both theory and code, split into: (Slide A) Concept Diagram -> (Slide B) Code Walkthrough.
+
+---
+
+## 3. STRICT WORD BUDGET (ZERO-SCROLL INVARIANT)
+- **Hard Limit:** Maximum **35 - 40 words** per card or column.
+- Never write paragraphs longer than 2 sentences. Use structured bullets with bold anchor terms:
+  - Format: \`- **Kh\xE1i ni\u1EC7m then ch\u1ED1t:** M\xF4 t\u1EA3 s\xFAc t\xEDch trong 1 d\xF2ng.\`
+- Vertical scrolling inside a slide is STRICTLY FORBIDDEN. Content must fit the 16:9 (1280x720) canvas cleanly.
+
+---
+
+## 4. TWO-COLUMN & CARD BALANCED LAYOUTS
+- Avoid centered vertical walls of text. Use responsive side-by-side card wrappers:
+  \`\`\`html
+  <div class="columns-2">
+  <div>
+  ### \u{1F534} C\u0169 / Th\xE1ch Th\u1EE9c
+  - ...
+  </div>
+  <div>
+  ### \u{1F7E2} M\u1EDBi / Gi\u1EA3i Ph\xE1p
+  - ...
+  </div>
+  </div>
+  \`\`\`
+- For 3 metrics or bronze/silver/gold differentiation, use \`<div class="columns-3">...</div>\`.
+
+---
+
+## 5. MANDATORY PRESENTER NOTES (TEACHER TALK TRACK)
+Every single slide MUST conclude with an HTML comment block containing:
+1. **Talk Track:** 2-3 sentences of what the speaker should say out loud.
+2. **Cold-Call Check Question:** 1 diagnostic question to ask a specific student.
+3. **Scaffolding Tip:** 1 hint if students look confused.
+
+Example:
+\`\`\`markdown
+<!--
+Presenter Notes:
+- Tr\xECnh b\xE0y \u0111i\u1EC3m ngh\u1EBDn l\u1EDBn nh\u1EA5t trong vi\u1EC7c m\u1EDF r\u1ED9ng quy m\xF4 d\u1EEF li\u1EC7u.
+- Cold-call: "Em Nguy\u1EC5n V\u0103n B, n\u1EBFu s\u1ED1 l\u01B0\u1EE3ng request t\u0103ng g\u1EA5p 10 l\u1EA7n th\xEC \u0111i\u1EC3m n\xE0o s\u1EBD s\u1EADp \u0111\u1EA7u ti\xEAn?"
+- G\u1EE3i \xFD g\u1EE3i m\u1EDF: Nh\u1EAFc h\u1ECDc vi\xEAn nh\u1EDB l\u1EA1i kh\xE1i ni\u1EC7m I/O bottleneck \u1EDF b\xE0i tr\u01B0\u1EDBc.
+-->
+\`\`\`
+
+---
+
+## 6. MARP COMPATIBLE YAML LAYOUT HEADERS
+When a precise coordinate layout is specified, include the clean YAML block at the very top of the slide:
+\`\`\`markdown
+<!-- layout:
+  boxes:
+    - id: heading
+      target: h2
+      pos: [80, 50, 1120, 70]
+      fontSize: 2rem
+    - id: col-left
+      target: '.columns-2 > div:first-child'
+      pos: [80, 150, 530, 510]
+    - id: col-right
+      target: '.columns-2 > div:last-child'
+      pos: [670, 150, 530, 510]
+-->
+\`\`\`
+`;
+
+export { SLIDE_DESIGN_PROMPT_CONTRACT, applySlideLayoutSchema, createSlideFromPresetSchema, executeApplySlideLayout, executeCreateSlideFromPreset, executeGenerateDeckOutline, executeListSlidePresets, executeUpdatePresenterNotes, generateDeckOutlineSchema, listSlidePresetsSchema, updatePresenterNotesSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ai/schemas.ts","../../src/ai/tools.ts","../../src/ai/prompt.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit — AI Tool Schemas (Zod)\n// ═══════════════════════════════════════════════════════════════════════════════\n\nimport { z } from 'zod';\n\nexport const listSlidePresetsSchema = z.object({\n  category: z.enum([\n    'all',\n    'cover',\n    'content',\n    'split',\n    'code',\n    'metrics',\n    'diagram',\n    'quote',\n    'assessment',\n  ]).optional().describe('Optional category filter for layout presets'),\n});\n\nexport const createSlideFromPresetSchema = z.object({\n  presetId: z.string().describe(\n    'ID of the layout preset: title-hero, two-column-split, code-explainer, metrics-3-card, process-flow, quote-highlight, quiz-checkpoint, tiered-practice-3cards, agenda-timeline, takeaways-summary'\n  ),\n  title: z.string().describe('Slide heading or title'),\n  subtitle: z.string().optional().describe('Optional subtitle or section context'),\n  content: z.record(z.string()).optional().describe(\n    'Key-value pairs for preset sections. For two-column-split: leftCol, rightCol. For code-explainer: code, language, notes. For metrics-3-card: card1Title, card1Val, card1Desc, etc.'\n  ),\n  customMarkdownBody: z.string().optional().describe(\n    'Raw markdown body to place inside the layout container (overrides content key-value pairs if provided)'\n  ),\n  presenterNotes: z.array(z.string()).optional().describe(\n    'Teacher talk track, cold-call check questions, or scaffolding notes for this slide'\n  ),\n});\n\nexport const applySlideLayoutSchema = z.object({\n  markdown: z.string().describe('Full Markdown slide deck content'),\n  slideIndex: z.number().int().min(0).describe('0-based index of the target slide to modify'),\n  presetId: z.string().optional().describe('Optional preset ID to apply to this slide'),\n  boxes: z.array(\n    z.object({\n      id: z.string(),\n      target: z.string().optional(),\n      pos: z.tuple([z.number(), z.number(), z.number(), z.number()]).describe('[x, y, width, height] in 1280x720 canvas coordinates'),\n      fontSize: z.string().optional(),\n      color: z.string().optional(),\n      textAlign: z.enum(['left', 'center', 'right', 'justify']).optional(),\n      style: z.string().optional(),\n    })\n  ).optional().describe('Custom boxes if not using presetId'),\n});\n\nexport const updatePresenterNotesSchema = z.object({\n  markdown: z.string().describe('Full Markdown slide deck content'),\n  slideIndex: z.number().int().min(0).describe('0-based index of the target slide'),\n  notes: z.array(z.string()).describe('List of speaker notes / talk tracks to set for this slide'),\n});\n\nexport const generateDeckOutlineSchema = z.object({\n  topic: z.string().describe('Main subject or topic of the presentation'),\n  durationMins: z.number().int().min(3).max(120).default(15).describe('Estimated duration in minutes (5m: 5-7 slides, 15m: 12-18 slides, 30m: 25-35 slides)'),\n  audience: z.string().describe('Target audience profile (e.g. Grade 10 students, junior developers, enterprise clients)'),\n  keyObjectives: z.array(z.string()).describe('2-4 key learning or decision objectives'),\n  techStack: z.string().optional().describe('Optional programming language, framework, or hardware kit'),\n});\n","// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit — AI Tool Handlers\n// Pure execution handlers for Vercel AI SDK / OpenAI tool calls\n// ═══════════════════════════════════════════════════════════════════════════════\n\nimport {\n  SLIDE_LAYOUT_PRESETS,\n  getSlideLayoutPresetById,\n  getSlideLayoutPresetsByCategory,\n  type SlideLayoutCategory,\n} from '../core/layout/presets.js';\nimport {\n  updateSlideLayoutInMarkdown,\n  splitMarkdownSlides,\n  serializeLayoutToComment,\n} from '../core/layout/serializer.js';\nimport type { SlideLayoutData } from '../types.js';\n\n/**\n * Execute: listSlidePresets\n */\nexport function executeListSlidePresets(params?: { category?: string }) {\n  const category = params?.category;\n  const presets = (!category || category === 'all')\n    ? SLIDE_LAYOUT_PRESETS\n    : getSlideLayoutPresetsByCategory(category as SlideLayoutCategory);\n\n  return {\n    count: presets.length,\n    presets: presets.map(p => ({\n      id: p.id,\n      name: p.name,\n      category: p.category,\n      description: p.description,\n      boxCount: p.layout.boxes.length,\n      snippetPreview: p.markdownSnippet.split('\\n').slice(0, 8).join('\\n') + '\\n...',\n    })),\n  };\n}\n\n/**\n * Execute: createSlideFromPreset\n */\nexport function executeCreateSlideFromPreset(params: {\n  presetId: string;\n  title: string;\n  subtitle?: string;\n  content?: Record<string, string>;\n  customMarkdownBody?: string;\n  presenterNotes?: string[];\n}): { success: boolean; slideMarkdown: string; presetName?: string; error?: string } {\n  const preset = getSlideLayoutPresetById(params.presetId);\n  if (!preset) {\n    return {\n      success: false,\n      slideMarkdown: '',\n      error: `Không tìm thấy preset với ID: \"${params.presetId}\". Sử dụng listSlidePresets để xem các mẫu có sẵn.`,\n    };\n  }\n\n  const layoutComment = serializeLayoutToComment(preset.layout);\n  const title = params.title;\n  const subtitle = params.subtitle ? `\\n### ${params.subtitle}` : '';\n\n  let body = params.customMarkdownBody;\n\n  if (!body) {\n    const c = params.content || {};\n    switch (preset.id) {\n      case 'title-hero':\n        body = `${subtitle}\\n\\n**Người trình bày:** ${c.speaker || 'Giảng viên'} | **Thời lượng:** ${c.duration || '45 phút'} | **Chủ đề:** ${c.topic || title}`;\n        break;\n\n      case 'two-column-split':\n        body = `<div class=\"columns-2\">\\n<div>\\n\\n### ${c.leftHeader || 'Cách tiếp cận A'}\\n${c.leftCol || '- Điểm 1\\n- Điểm 2\\n- Điểm 3'}\\n\\n</div>\\n<div>\\n\\n### ${c.rightHeader || 'Cách tiếp cận B'}\\n${c.rightCol || '- Điểm 1\\n- Điểm 2\\n- Điểm 3'}\\n\\n</div>\\n</div>`;\n        break;\n\n      case 'code-explainer':\n        body = `<div class=\"columns-2\">\\n<div>\\n\\n\\`\\`\\`${c.lang || 'ts'}\\n${c.code || '// Code snippet ở đây\\nconst example = true;'}\\n\\`\\`\\`\\n\\n</div>\\n<div>\\n\\n### 🔍 Điểm cốt lõi:\\n${c.notes || '1. **Phân tích dòng 1:** Khởi tạo\\n2. **Phân tích dòng 2:** Thực thi\\n3. **Lưu ý:** Điều kiện biên'}\\n\\n</div>\\n</div>`;\n        break;\n\n      case 'metrics-3-card':\n        body = `<div class=\"columns-3\">\\n<div>\\n\\n# ${c.metric1Val || '99.9%'}\\n### ${c.metric1Title || 'Chỉ số 1'}\\n${c.metric1Desc || 'Mô tả ngắn gọn về chỉ số.'}\\n\\n</div>\\n<div>\\n\\n# ${c.metric2Val || '10x'}\\n### ${c.metric2Title || 'Chỉ số 2'}\\n${c.metric2Desc || 'Mô tả ngắn gọn về chỉ số.'}\\n\\n</div>\\n<div>\\n\\n# ${c.metric3Val || '0'}\\n### ${c.metric3Title || 'Chỉ số 3'}\\n${c.metric3Desc || 'Mô tả ngắn gọn về chỉ số.'}\\n\\n</div>\\n</div>`;\n        break;\n\n      case 'process-flow':\n        body = `\\`\\`\\`mermaid\\n${c.mermaid || 'graph LR\\n  A[Bước 1] --> B[Bước 2]\\n  B --> C[Bước 3]\\n  C --> D[Hoàn thành]'}\\n\\`\\`\\`\\n\\n${c.summary || '- **Giai đoạn 1:** Khởi động\\n- **Giai đoạn 2:** Xử lý dữ liệu\\n- **Giai đoạn 3:** Kết xuất kết quả'}`;\n        break;\n\n      case 'quote-highlight':\n        body = `> \"${c.quote || 'Sự đơn giản là chìa khóa của độ tin cậy.'}\"\\n> \\n> — **${c.author || 'Danh ngôn công nghệ'}**`;\n        break;\n\n      case 'quiz-checkpoint':\n        body = `> **Câu hỏi:** ${c.question || 'Phương án nào sau đây là tối ưu nhất?'}\\n\\n- **A.** ${c.optA || 'Lựa chọn A'}\\n- **B.** ${c.optB || 'Lựa chọn B (Chính xác)'}\\n- **C.** ${c.optC || 'Lựa chọn C'}\\n- **D.** ${c.optD || 'Lựa chọn D'}`;\n        break;\n\n      case 'tiered-practice-3cards':\n        body = `<div class=\"columns-3\">\\n<div>\\n\\n### 🥉 Hạng Đồng (Bronze)\\n${c.bronze || '- Bài tập cơ bản\\n- 1 test case mẫu'}\\n\\n</div>\\n<div>\\n\\n### 🥈 Hạng Bạc (Silver)\\n${c.silver || '- Tối ưu thuật toán\\n- Xử lý điều kiện biên'}\\n\\n</div>\\n<div>\\n\\n### 🥇 Hạng Vàng (Gold)\\n${c.gold || '- Tính năng mở rộng\\n- Tự động hóa unit test'}\\n\\n</div>\\n</div>`;\n        break;\n\n      default:\n        body = preset.markdownSnippet.replace(/^<!--[\\s\\S]*?-->\\n*/, '').replace(/^#\\s+[^\\n]+\\n*/, '').trim();\n    }\n  }\n\n  const notes = params.presenterNotes && params.presenterNotes.length > 0\n    ? `\\n\\n<!--\\nPresenter Notes:\\n${params.presenterNotes.map(n => `- ${n}`).join('\\n')}\\n-->`\n    : `\\n\\n<!--\\nPresenter Notes:\\n- Giải thích khái niệm chính trên slide.\\n- Đặt câu hỏi tương tác cho cả lớp.\\n-->`;\n\n  const slideMarkdown = `${layoutComment}\\n\\n## ${title}${body ? '\\n\\n' + body : ''}${notes}`;\n\n  return {\n    success: true,\n    slideMarkdown,\n    presetName: preset.name,\n  };\n}\n\n/**\n * Execute: applySlideLayout\n */\nexport function executeApplySlideLayout(params: {\n  markdown: string;\n  slideIndex: number;\n  presetId?: string;\n  boxes?: SlideLayoutData['boxes'];\n}): { success: boolean; updatedMarkdown: string; error?: string } {\n  let layoutData: SlideLayoutData | null = null;\n\n  if (params.presetId) {\n    const preset = getSlideLayoutPresetById(params.presetId);\n    if (!preset) {\n      return {\n        success: false,\n        updatedMarkdown: params.markdown,\n        error: `Không tìm thấy preset với ID: \"${params.presetId}\"`,\n      };\n    }\n    layoutData = preset.layout;\n  } else if (params.boxes && params.boxes.length > 0) {\n    layoutData = { boxes: params.boxes };\n  }\n\n  const updatedMarkdown = updateSlideLayoutInMarkdown(\n    params.markdown,\n    params.slideIndex,\n    layoutData\n  );\n\n  return {\n    success: true,\n    updatedMarkdown,\n  };\n}\n\n/**\n * Execute: updatePresenterNotes\n */\nexport function executeUpdatePresenterNotes(params: {\n  markdown: string;\n  slideIndex: number;\n  notes: string[];\n}): { success: boolean; updatedMarkdown: string; error?: string } {\n  const { frontmatter, slides } = splitMarkdownSlides(params.markdown);\n\n  if (params.slideIndex < 0 || params.slideIndex >= slides.length) {\n    return {\n      success: false,\n      updatedMarkdown: params.markdown,\n      error: `Slide index ${params.slideIndex} ngoài phạm vi (tổng số slides: ${slides.length})`,\n    };\n  }\n\n  let slideContent = slides[params.slideIndex];\n  const notesCommentRegex = /<!--\\s*(?:Presenter Notes|Notes):\\s*([\\s\\S]*?)-->/i;\n  const newNotesComment = `<!--\\nPresenter Notes:\\n${params.notes.map(n => `- ${n}`).join('\\n')}\\n-->`;\n\n  if (notesCommentRegex.test(slideContent)) {\n    slideContent = slideContent.replace(notesCommentRegex, newNotesComment);\n  } else {\n    slideContent = `${slideContent.trimEnd()}\\n\\n${newNotesComment}`;\n  }\n\n  slides[params.slideIndex] = slideContent;\n  const joined = slides.join('\\n---\\n');\n  const updatedMarkdown = frontmatter ? `${frontmatter}\\n\\n${joined}` : joined;\n\n  return {\n    success: true,\n    updatedMarkdown,\n  };\n}\n\n/**\n * Execute: generateDeckOutline (indexed by talk duration)\n */\nexport function executeGenerateDeckOutline(params: {\n  topic: string;\n  durationMins: number;\n  audience: string;\n  keyObjectives: string[];\n  techStack?: string;\n}) {\n  const d = params.durationMins;\n  let targetSlideCount = 12;\n  let formatLabel = '15 min (Short Talk)';\n\n  if (d <= 7) {\n    targetSlideCount = 6;\n    formatLabel = '5 min (Lightning Talk)';\n  } else if (d <= 20) {\n    targetSlideCount = 14;\n    formatLabel = '15 min (Short Talk)';\n  } else if (d <= 35) {\n    targetSlideCount = 28;\n    formatLabel = '30 min (Conference Talk)';\n  } else {\n    targetSlideCount = 42;\n    formatLabel = '45-60 min (Keynote / Workshop)';\n  }\n\n  return {\n    topic: params.topic,\n    audience: params.audience,\n    durationMins: d,\n    format: formatLabel,\n    recommendedSlideCount: targetSlideCount,\n    structureGuidelines: [\n      'Áp dụng nguyên tắc: Một ý tưởng duy nhất trên mỗi slide (One Idea Per Slide).',\n      'Giới hạn từ: Tối đa 40 từ trên mỗi card/cột để chống tràn chữ (Zero Scroll Invariant).',\n      'Tỷ lệ hiển thị: Chuẩn 16:9 với hệ tọa độ 1280x720.',\n      'Bắt buộc có khối Presenter Notes chứa: Talk track giảng viên + 1 câu hỏi tương tác cold-call.',\n    ],\n    suggestedOutline: [\n      { slide: 1, type: 'title-hero', title: `🚀 ${params.topic}`, intent: 'Gây ấn tượng ban đầu và giới thiệu diễn giả' },\n      { slide: 2, type: 'agenda-timeline', title: '🗺️ Lộ trình hoạt động', intent: 'Định hình cấu trúc thời gian và kết quả đầu ra' },\n      { slide: 3, type: 'two-column-split', title: '⚡ Bối cảnh & Thử thách', intent: 'So sánh cách làm cũ vs vấn đề thực tế' },\n      { slide: 4, type: 'process-flow', title: '🔄 Kiến trúc cốt lõi', intent: 'Sơ đồ luồng xử lý tổng quan' },\n      { slide: 5, type: 'code-explainer', title: '💻 Phân tích mã nguồn', intent: 'Đi sâu vào implementation kỹ thuật' },\n      { slide: 6, type: 'metrics-3-card', title: '📊 3 Chỉ số đo lường', intent: 'Định lượng hiệu năng và tính hiệu quả' },\n      { slide: 7, type: 'tiered-practice-3cards', title: '🛠️ Thử thách phân hóa', intent: 'Thực hành tại chỗ theo 3 bậc Bronze-Silver-Gold' },\n      { slide: 8, type: 'quiz-checkpoint', title: '🎯 Kiểm tra nhanh', intent: 'Đánh giá mức độ tiếp thu (Formative Checkpoint)' },\n      { slide: 9, type: 'takeaways-summary', title: '🏁 Tổng kết cốt lõi', intent: '3 bài học rút ra và nhiệm vụ tiếp theo' },\n    ].slice(0, Math.max(5, Math.min(targetSlideCount, 10))),\n  };\n}\n","// ═══════════════════════════════════════════════════════════════════════════════\n// @learnwell/presentation-kit — Slide Design Prompt Contract & System Invariants\n// \n// Modeled after battle-tested presentation orchestrators (e.g. slides-ai-plugin)\n// Provides rigorous invariants for LLM slide generation across web & PPTX.\n// ═══════════════════════════════════════════════════════════════════════════════\n\nexport const SLIDE_DESIGN_PROMPT_CONTRACT = `\n# SYSTEM MANDATE: PROFESSIONAL PRESENTATION & SLIDE DESIGN INVARIANTS\n\nYou are an expert Presentation Architect & Visual Designer for educational, technical, and executive decks.\nWhen generating or modifying Marp slide presentations, you MUST STRICTLY obey the following non-negotiable rules:\n\n---\n\n## 1. DURATION-INDEXED SLIDE PACING\nStructure decks based on allocated talk time (averaging 1.5 - 2 minutes per slide):\n- **5 min (Lightning Talk):** 5 - 7 slides [Hook -> 2-3 Core Points -> CTA / Summary]\n- **15 min (Short Tech Talk):** 12 - 16 slides [Title -> Agenda -> Hook -> 3-4 Concepts -> Lab/Demo -> Summary]\n- **30 min (Conference / Class):** 24 - 32 slides [Full 5E Learning Cycle + Interactive Formative Checkpoint]\n- **45-60 min (Keynote / Workshop):** 36 - 50 slides [Modular Micro-cycles + Tiered Hands-on Exercises]\n\n---\n\n## 2. THE \"ONE IDEA PER SLIDE\" RULE\n- Each slide communicates **EXACTLY ONE** pedagogical or architectural concept.\n- Never pack multiple distinct topics into a single slide.\n- If a concept has both theory and code, split into: (Slide A) Concept Diagram -> (Slide B) Code Walkthrough.\n\n---\n\n## 3. STRICT WORD BUDGET (ZERO-SCROLL INVARIANT)\n- **Hard Limit:** Maximum **35 - 40 words** per card or column.\n- Never write paragraphs longer than 2 sentences. Use structured bullets with bold anchor terms:\n  - Format: \\`- **Khái niệm then chốt:** Mô tả súc tích trong 1 dòng.\\`\n- Vertical scrolling inside a slide is STRICTLY FORBIDDEN. Content must fit the 16:9 (1280x720) canvas cleanly.\n\n---\n\n## 4. TWO-COLUMN & CARD BALANCED LAYOUTS\n- Avoid centered vertical walls of text. Use responsive side-by-side card wrappers:\n  \\`\\`\\`html\n  <div class=\"columns-2\">\n  <div>\n  ### 🔴 Cũ / Thách Thức\n  - ...\n  </div>\n  <div>\n  ### 🟢 Mới / Giải Pháp\n  - ...\n  </div>\n  </div>\n  \\`\\`\\`\n- For 3 metrics or bronze/silver/gold differentiation, use \\`<div class=\"columns-3\">...</div>\\`.\n\n---\n\n## 5. MANDATORY PRESENTER NOTES (TEACHER TALK TRACK)\nEvery single slide MUST conclude with an HTML comment block containing:\n1. **Talk Track:** 2-3 sentences of what the speaker should say out loud.\n2. **Cold-Call Check Question:** 1 diagnostic question to ask a specific student.\n3. **Scaffolding Tip:** 1 hint if students look confused.\n\nExample:\n\\`\\`\\`markdown\n<!--\nPresenter Notes:\n- Trình bày điểm nghẽn lớn nhất trong việc mở rộng quy mô dữ liệu.\n- Cold-call: \"Em Nguyễn Văn B, nếu số lượng request tăng gấp 10 lần thì điểm nào sẽ sập đầu tiên?\"\n- Gợi ý gợi mở: Nhắc học viên nhớ lại khái niệm I/O bottleneck ở bài trước.\n-->\n\\`\\`\\`\n\n---\n\n## 6. MARP COMPATIBLE YAML LAYOUT HEADERS\nWhen a precise coordinate layout is specified, include the clean YAML block at the very top of the slide:\n\\`\\`\\`markdown\n<!-- layout:\n  boxes:\n    - id: heading\n      target: h2\n      pos: [80, 50, 1120, 70]\n      fontSize: 2rem\n    - id: col-left\n      target: '.columns-2 > div:first-child'\n      pos: [80, 150, 530, 510]\n    - id: col-right\n      target: '.columns-2 > div:last-child'\n      pos: [670, 150, 530, 510]\n-->\n\\`\\`\\`\n`;\n"]}