qubicl-cli 0.1.0-dev.0 → 0.1.1

package/dist/assets/computer/skills/core/pdf/scripts/pdf_split.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""Extract page ranges from a PDF, optionally rotating and/or compressing pages."""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+
+def parse_pages(spec: str, page_count: int) -> list[int]:
+    """Parse a 1-based page spec like '1-3,5,9-' into 0-based indices."""
+    indices: list[int] = []
+    for part in spec.split(","):
+        part = part.strip()
+        if not part:
+            continue
+        if "-" in part:
+            start_s, _, end_s = part.partition("-")
+            start = int(start_s) if start_s else 1
+            end = int(end_s) if end_s else page_count
+        else:
+            start = end = int(part)
+        if start < 1 or end > page_count or start > end:
+            raise ValueError(f"Page range {part!r} out of bounds (1-{page_count})")
+        indices.extend(range(start - 1, end))
+    return indices
+
+
+def main() -> int:
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(encoding="utf-8")
+        except Exception:
+            pass
+    parser = argparse.ArgumentParser(
+        description="Split/extract pages from a PDF (pypdf). Pages are 1-based: '1-3,5,9-'.")
+    parser.add_argument("pdf", help="Input PDF path")
+    parser.add_argument("--pages", required=True, help="1-based page spec, e.g. '1-3,5,9-'")
+    parser.add_argument("-o", "--output", required=True, help="Output PDF path")
+    parser.add_argument("--rotate", type=int, default=0,
+                        help="Rotate extracted pages clockwise (multiple of 90)")
+    parser.add_argument("--compress", action="store_true",
+                        help="Deflate content streams (modest savings; does not recompress images)")
+    parser.add_argument("--password", help="Password if the input is encrypted")
+    args = parser.parse_args()
+
+    if args.rotate % 90 != 0:
+        print("Error: --rotate must be a multiple of 90", file=sys.stderr)
+        return 2
+
+    try:
+        from pypdf import PdfReader, PdfWriter
+    except ImportError:
+        print("Required Qubicl PDF dependency is unavailable: pypdf", file=sys.stderr)
+        return 2
+
+    reader = PdfReader(args.pdf)
+    if reader.is_encrypted:
+        if args.password is None or not reader.decrypt(args.password):
+            print("Error: input is encrypted; pass --password", file=sys.stderr)
+            return 3
+    try:
+        indices = parse_pages(args.pages, len(reader.pages))
+    except ValueError as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        return 2
+
+    writer = PdfWriter()
+    for idx in indices:
+        page = reader.pages[idx]
+        if args.rotate:
+            page.rotate(args.rotate)
+        writer.add_page(page)
+    if args.compress:
+        for page in writer.pages:
+            page.compress_content_streams()
+    with open(args.output, "wb") as fh:
+        writer.write(fh)
+    print(json.dumps({"output": args.output, "page_count": len(indices), "rotated": args.rotate}))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/dist/assets/computer/skills/core/pdf/scripts/pdf_stamp.py

@@ -0,0 +1,143 @@
+#!/usr/bin/env python3
+"""Stamp text or an image at coordinates onto selected PDF pages.
+
+Builds an in-memory single-page overlay with reportlab, then merges it
+onto each selected page with pypdf. Coordinates are PDF points, origin
+bottom-left. Covers 'sign here' arrows, diagonal DRAFT banners, and
+page-corner labels.
+
+Examples:
+  pdf_stamp.py in.pdf -o out.pdf --text "DRAFT" --x 200 --y 400 \
+      --font-size 60 --rotation 45 --opacity 0.3 --color "#cc0000"
+  pdf_stamp.py in.pdf -o out.pdf --image sig.png --x 400 --y 60 \
+      --width 120 --pages 3
+"""
+from __future__ import annotations
+
+import argparse
+import io
+import json
+import sys
+
+
+def parse_pages(spec: str, page_count: int) -> list[int]:
+    pages: set[int] = set()
+    for part in spec.split(","):
+        part = part.strip()
+        if not part:
+            continue
+        if "-" in part:
+            start_s, _, end_s = part.partition("-")
+            start = int(start_s) if start_s else 1
+            end = int(end_s) if end_s else page_count
+            pages.update(range(start, end + 1))
+        else:
+            pages.add(int(part))
+    bad = [p for p in pages if not 1 <= p <= page_count]
+    if bad:
+        raise ValueError(f"pages out of range 1-{page_count}: {sorted(bad)}")
+    return sorted(pages)
+
+
+def build_overlay(args, page_width: float, page_height: float) -> bytes:
+    from reportlab.lib.colors import HexColor
+    from reportlab.pdfgen import canvas
+    buf = io.BytesIO()
+    c = canvas.Canvas(buf, pagesize=(page_width, page_height))
+    c.saveState()
+    try:
+        c.setFillAlpha(float(args.opacity))
+        c.setStrokeAlpha(float(args.opacity))
+    except Exception:
+        pass  # very old reportlab: no alpha support
+    c.translate(float(args.x), float(args.y))
+    if args.rotation:
+        c.rotate(float(args.rotation))
+    if args.text:
+        c.setFont(args.font, float(args.font_size))
+        c.setFillColor(HexColor(args.color))
+        c.drawString(0, 0, args.text)
+    else:
+        kwargs = {}
+        if args.width:
+            kwargs["width"] = float(args.width)
+        if args.height:
+            kwargs["height"] = float(args.height)
+        if "width" in kwargs and "height" not in kwargs:
+            from PIL import Image as PILImage
+            with PILImage.open(args.image) as im:
+                kwargs["height"] = kwargs["width"] * im.height / im.width
+        c.drawImage(args.image, 0, 0, mask="auto", **kwargs)
+    c.restoreState()
+    c.save()
+    return buf.getvalue()
+
+
+def main() -> int:
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(encoding="utf-8")
+        except Exception:
+            pass
+    parser = argparse.ArgumentParser(description="Stamp text or an image onto PDF pages.")
+    parser.add_argument("pdf", help="Input PDF path")
+    parser.add_argument("-o", "--output", required=True, help="Output PDF path")
+    what = parser.add_mutually_exclusive_group(required=True)
+    what.add_argument("--text", help="Text to stamp")
+    what.add_argument("--image", help="Image file to stamp (PNG/JPEG)")
+    parser.add_argument("--x", type=float, required=True, help="X in points (origin bottom-left)")
+    parser.add_argument("--y", type=float, required=True, help="Y in points")
+    parser.add_argument("--pages", default="1-", help="1-based ranges, e.g. '1-3,5' (default: all)")
+    parser.add_argument("--font", default="Helvetica", help="Font name (default Helvetica)")
+    parser.add_argument("--font-size", type=float, default=24, help="Font size in points")
+    parser.add_argument("--color", default="#000000", help="Text color as #RRGGBB")
+    parser.add_argument("--rotation", type=float, default=0, help="Degrees counterclockwise")
+    parser.add_argument("--opacity", type=float, default=1.0, help="0.0-1.0 (default 1.0)")
+    parser.add_argument("--width", type=float, help="Image width in points")
+    parser.add_argument("--height", type=float, help="Image height in points")
+    parser.add_argument("--under", action="store_true",
+                        help="Place the stamp under existing content instead of over it")
+    parser.add_argument("--password", help="Password if the input is encrypted")
+    args = parser.parse_args()
+
+    try:
+        from pypdf import PdfReader, PdfWriter
+    except ImportError:
+        print("Required Qubicl PDF dependencies are unavailable: pypdf and reportlab",
+              file=sys.stderr)
+        return 2
+
+    reader = PdfReader(args.pdf)
+    if reader.is_encrypted:
+        if args.password is None or not reader.decrypt(args.password):
+            print("Error: input is encrypted; pass --password", file=sys.stderr)
+            return 3
+    try:
+        pages = set(parse_pages(args.pages, len(reader.pages)))
+    except ValueError as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        return 4
+
+    writer = PdfWriter()
+    overlay_cache: dict[tuple[float, float], object] = {}
+    for idx, page in enumerate(reader.pages, start=1):
+        if idx in pages:
+            size = (float(page.mediabox.width), float(page.mediabox.height))
+            if size not in overlay_cache:
+                overlay_pdf = PdfReader(io.BytesIO(build_overlay(args, *size)))
+                overlay_cache[size] = overlay_pdf.pages[0]
+            stamp = overlay_cache[size]
+            if args.under:
+                page.merge_page(stamp, over=False)
+            else:
+                page.merge_page(stamp)
+        writer.add_page(page)
+    with open(args.output, "wb") as fh:
+        writer.write(fh)
+    print(json.dumps({"output": args.output, "stamped_pages": sorted(pages),
+                      "kind": "text" if args.text else "image"}, ensure_ascii=False))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/dist/assets/computer/skills/core/pdf/scripts/pdf_watermark.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+"""Stamp/watermark every page of a PDF with page 1 of another PDF."""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+
+def main() -> int:
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(encoding="utf-8")
+        except Exception:
+            pass
+    parser = argparse.ArgumentParser(
+        description="Overlay (stamp) or underlay (watermark) a one-page PDF onto every page.")
+    parser.add_argument("pdf", help="Input PDF path")
+    parser.add_argument("--stamp", required=True, help="One-page PDF to apply (page 1 is used)")
+    parser.add_argument("-o", "--output", required=True, help="Output PDF path")
+    parser.add_argument("--under", action="store_true",
+                        help="Place stamp under the page content (background watermark)")
+    parser.add_argument("--password", help="Password if the input is encrypted")
+    args = parser.parse_args()
+
+    try:
+        from pypdf import PdfReader, PdfWriter
+    except ImportError:
+        print("Required Qubicl PDF dependency is unavailable: pypdf", file=sys.stderr)
+        return 2
+
+    reader = PdfReader(args.pdf)
+    if reader.is_encrypted:
+        if args.password is None or not reader.decrypt(args.password):
+            print("Error: input is encrypted; pass --password", file=sys.stderr)
+            return 3
+    stamp_page = PdfReader(args.stamp).pages[0]
+
+    writer = PdfWriter()
+    writer.append(reader)
+    for page in writer.pages:
+        page.merge_page(stamp_page, over=not args.under)
+    with open(args.output, "wb") as fh:
+        writer.write(fh)
+    print(json.dumps({"output": args.output, "page_count": len(writer.pages),
+                      "mode": "under" if args.under else "over"}))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/dist/assets/computer/skills/core/plan/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nous Research
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/assets/computer/skills/core/plan/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: plan
+description: Create a concrete, reviewable implementation or project plan without performing the planned changes. Use for architecture proposals, migration plans, release plans, debugging strategies, and any request to plan before acting.
+---
+
+# Plan
+
+Stay in planning mode for this turn. Inspect relevant context with read-only Qubicl tools, but do not edit project files, start deployments, publish, commit, or perform the proposed work.
+
+Write a concise Markdown plan in the active workspace. Prefer `write_file` for a new plan and `edit_file` for an existing one. Use a user-provided destination; otherwise write under `.agents/plans/` with a descriptive kebab-case filename.
+
+Include only useful sections:
+
+- goal and success criteria;
+- current evidence and assumptions;
+- ordered implementation steps;
+- files or components likely to change;
+- validation and rollback;
+- risks, tradeoffs, and unresolved decisions.
+
+Use exact local paths and commands when known. Clearly label anything inferred. End by summarizing the decisions required before implementation.

package/dist/assets/computer/skills/core/powerpoint/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nous Research
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/assets/computer/skills/core/powerpoint/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: powerpoint
+description: Create, inspect, edit, template, render, and verify PowerPoint PPTX presentations using Qubicl's pinned local presentation tools. Use for slide decks, speaker notes, charts, images, templates, and visual presentation review.
+---
+
+# PowerPoint workflows
+
+Keep decks and rendered previews under `/home/qubicl`. Obtain this skill's `resourceRoot` from `skill_view` and run bundled helpers with `/opt/qubicl/skills-venv/bin/python`. Qubicl computer and workstation images contain the pinned PPTX library; do not install dependencies during a task.
+
+Useful helpers beneath `<resourceRoot>/scripts/`:
+
+- `pptx_read.py FILE --outline|--notes|--images DIR`
+- `pptx_create.py SPEC.json OUTPUT.pptx`
+- `pptx_edit.py FILE` for text, charts, images, slide order, backgrounds, links, footers, and notes
+- `pptx_from_template.py TEMPLATE.pptx OUTPUT.pptx --values VALUES.json`
+- `pptx_render.py FILE --outdir DIR`
+
+Inspect the source deck before editing. Prefer a new output for structural changes. Validate by reading the resulting outline and notes. On workstation computers, render slides through LibreOffice and Poppler for visual QA; on computer computers, structured operations remain available but rendering may be unavailable. Check representative first, middle, and last slides rather than assuming a successful save preserved layout.

package/dist/assets/computer/skills/core/powerpoint/scripts/pptx_create.py

@@ -0,0 +1,214 @@
+#!/usr/bin/env python3
+"""Create a .pptx presentation from a JSON deck spec.
+
+Spec format (all positions/sizes in inches, colors as RRGGBB hex):
+{
+  "slide_size": "16:9",              // or "4:3" (default "16:9")
+  "slides": [
+    {"layout": "title", "title": "My Deck", "subtitle": "Q3 review"},
+    {"layout": "title_content", "title": "Agenda",
+     "bullets": ["Top item",
+                 {"text": "Sub item", "level": 1, "bold": true,
+                  "size": 18, "color": "CC0000", "font": "Arial",
+                  "italic": false,
+                  "link": "https://example.com/agenda"}],
+     "background": "1F2937",           // solid slide background (hex)
+     "footer": "Confidential",         // footer placeholder text
+     "slide_number": true,             // enable slide-number placeholder
+     "notes": "Speaker notes for this slide"},
+    {"layout": "blank", "title": "Widgets",
+     "images":  [{"path": "logo.png", "left": 1, "top": 1, "width": 3}],
+     "tables":  [{"left": 1, "top": 2, "width": 6, "height": 2,
+                  "rows": [["H1", "H2"], ["a", "b"]]}],
+     "shapes":  [{"type": "rounded_rectangle", "left": 8, "top": 1,
+                  "width": 3, "height": 1, "fill": "4472C4",
+                  "text": "Callout", "text_color": "FFFFFF"}],
+     "charts":  [{"type": "bar", "left": 1, "top": 3, "width": 6,
+                  "height": 3.5, "title": "Sales",
+                  "categories": ["Q1", "Q2"],
+                  "series": {"North": [10, 20], "South": [7, 13]}}]}
+  ]
+}
+Layouts: title, title_content, section, two_content, title_only, blank
+Chart types: bar, bar_h, line, pie   Shape types: rectangle,
+rounded_rectangle, oval, diamond, right_arrow, chevron
+"""
+import argparse
+import copy
+import json
+import sys
+
+from pptx import Presentation
+from pptx.chart.data import CategoryChartData
+from pptx.dml.color import RGBColor
+from pptx.enum.chart import XL_CHART_TYPE
+from pptx.enum.shapes import MSO_SHAPE
+from pptx.util import Inches, Pt
+
+LAYOUTS = {"title": 0, "title_content": 1, "section": 2,
+           "two_content": 3, "title_only": 5, "blank": 6}
+CHART_TYPES = {"bar": XL_CHART_TYPE.COLUMN_CLUSTERED,
+               "bar_h": XL_CHART_TYPE.BAR_CLUSTERED,
+               "line": XL_CHART_TYPE.LINE_MARKERS,
+               "pie": XL_CHART_TYPE.PIE}
+SHAPE_TYPES = {"rectangle": MSO_SHAPE.RECTANGLE,
+               "rounded_rectangle": MSO_SHAPE.ROUNDED_RECTANGLE,
+               "oval": MSO_SHAPE.OVAL, "diamond": MSO_SHAPE.DIAMOND,
+               "right_arrow": MSO_SHAPE.RIGHT_ARROW,
+               "chevron": MSO_SHAPE.CHEVRON}
+
+
+def style_run(run, spec):
+    """Apply font styling from a bullet/text spec dict to a run."""
+    font = run.font
+    if spec.get("size"):
+        font.size = Pt(spec["size"])
+    if spec.get("bold") is not None:
+        font.bold = spec["bold"]
+    if spec.get("italic") is not None:
+        font.italic = spec["italic"]
+    if spec.get("font"):
+        font.name = spec["font"]
+    if spec.get("color"):
+        font.color.rgb = RGBColor.from_string(spec["color"])
+    if spec.get("link"):
+        run.hyperlink.address = spec["link"]
+
+
+def add_bullets(text_frame, bullets):
+    text_frame.clear()
+    for i, item in enumerate(bullets):
+        if isinstance(item, str):
+            item = {"text": item}
+        para = text_frame.paragraphs[0] if i == 0 else text_frame.add_paragraph()
+        para.level = int(item.get("level", 0))
+        run = para.add_run()
+        run.text = item.get("text", "")
+        style_run(run, item)
+
+
+def copy_layout_placeholder(slide, ph_idx):
+    """Copy a layout placeholder (footer=11, slide number=12) onto the
+    slide so it actually renders; returns the shape or None if the layout
+    does not provide it."""
+    for ph in slide.slide_layout.placeholders:
+        if ph.placeholder_format.idx == ph_idx:
+            slide.shapes._spTree.append(copy.deepcopy(ph._element))
+            for shape in slide.placeholders:
+                if shape.placeholder_format.idx == ph_idx:
+                    return shape
+    return None
+
+
+def build_slide(prs, spec):
+    layout_idx = LAYOUTS.get(spec.get("layout", "title_content"), 1)
+    slide = prs.slides.add_slide(prs.slide_layouts[layout_idx])
+
+    if spec.get("background"):
+        fill = slide.background.fill
+        fill.solid()
+        fill.fore_color.rgb = RGBColor.from_string(spec["background"])
+    if spec.get("slide_number"):
+        copy_layout_placeholder(slide, 12)
+    if spec.get("footer"):
+        shape = copy_layout_placeholder(slide, 11)
+        if shape is not None:
+            shape.text_frame.text = spec["footer"]
+
+    if spec.get("title") is not None and slide.shapes.title is not None:
+        slide.shapes.title.text = spec["title"]
+    if spec.get("subtitle") is not None:
+        for ph in slide.placeholders:
+            if ph.placeholder_format.idx == 1:
+                ph.text = spec["subtitle"]
+                break
+    if spec.get("bullets"):
+        body = next((ph for ph in slide.placeholders
+                     if ph.placeholder_format.idx != 0), None)
+        if body is None:
+            body = slide.shapes.add_textbox(Inches(0.5), Inches(1.5),
+                                            Inches(9), Inches(5))
+        add_bullets(body.text_frame, spec["bullets"])
+
+    for img in spec.get("images", []):
+        kwargs = {}
+        if img.get("width"):
+            kwargs["width"] = Inches(img["width"])
+        if img.get("height"):
+            kwargs["height"] = Inches(img["height"])
+        slide.shapes.add_picture(img["path"], Inches(img.get("left", 1)),
+                                 Inches(img.get("top", 1)), **kwargs)
+
+    for tbl in spec.get("tables", []):
+        rows = tbl["rows"]
+        shape = slide.shapes.add_table(
+            len(rows), len(rows[0]), Inches(tbl.get("left", 1)),
+            Inches(tbl.get("top", 2)), Inches(tbl.get("width", 6)),
+            Inches(tbl.get("height", 2)))
+        for r, row in enumerate(rows):
+            for c, val in enumerate(row):
+                shape.table.cell(r, c).text = str(val)
+
+    for shp in spec.get("shapes", []):
+        shape = slide.shapes.add_shape(
+            SHAPE_TYPES.get(shp.get("type", "rectangle"), MSO_SHAPE.RECTANGLE),
+            Inches(shp.get("left", 1)), Inches(shp.get("top", 1)),
+            Inches(shp.get("width", 2)), Inches(shp.get("height", 1)))
+        if shp.get("fill"):
+            shape.fill.solid()
+            shape.fill.fore_color.rgb = RGBColor.from_string(shp["fill"])
+        if shp.get("text"):
+            shape.text_frame.text = shp["text"]
+            if shp.get("text_color"):
+                run = shape.text_frame.paragraphs[0].runs[0]
+                run.font.color.rgb = RGBColor.from_string(shp["text_color"])
+
+    for cht in spec.get("charts", []):
+        data = CategoryChartData()
+        data.categories = cht["categories"]
+        for name, values in cht["series"].items():
+            data.add_series(name, values)
+        frame = slide.shapes.add_chart(
+            CHART_TYPES.get(cht.get("type", "bar"),
+                            XL_CHART_TYPE.COLUMN_CLUSTERED),
+            Inches(cht.get("left", 1)), Inches(cht.get("top", 2)),
+            Inches(cht.get("width", 6)), Inches(cht.get("height", 4)), data)
+        if cht.get("title"):
+            frame.chart.has_title = True
+            frame.chart.chart_title.text_frame.text = cht["title"]
+
+    if spec.get("notes"):
+        slide.notes_slide.notes_text_frame.text = spec["notes"]
+    return slide
+
+
+def main(argv=None):
+    if hasattr(sys.stdout, "reconfigure"):
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    parser = argparse.ArgumentParser(
+        description="Create a .pptx deck from a JSON spec.",
+        epilog=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    parser.add_argument("spec", help="path to JSON deck spec")
+    parser.add_argument("output", help="output .pptx path")
+    args = parser.parse_args(argv)
+
+    with open(args.spec, encoding="utf-8") as fh:
+        spec = json.load(fh)
+
+    prs = Presentation()
+    if spec.get("slide_size", "16:9") == "16:9":
+        prs.slide_width, prs.slide_height = Inches(13.333), Inches(7.5)
+    else:
+        prs.slide_width, prs.slide_height = Inches(10), Inches(7.5)
+
+    for slide_spec in spec.get("slides", []):
+        build_slide(prs, slide_spec)
+
+    prs.save(args.output)
+    print(json.dumps({"ok": True, "output": args.output,
+                      "slides": len(prs.slides._sldIdLst)}))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())