pi-ui-extend 0.1.1

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "pi-ui-extend",
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "pix": "./bin/pix.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/sdk.d.ts",
+      "import": "./dist/sdk.js"
+    },
+    "./sdk": {
+      "types": "./dist/sdk.d.ts",
+      "import": "./dist/sdk.js"
+    }
+  },
+  "files": [
+    "bin",
+    "docs",
+    "dist",
+    "extensions",
+    "skills",
+    "external/pi-tools-suite/index.ts",
+    "external/pi-tools-suite/package.json",
+    "external/pi-tools-suite/README.md",
+    "external/pi-tools-suite/src",
+    "external/pi-tools-suite/docs",
+    "external/pi-tools-suite/licenses",
+    "README.md"
+  ],
+  "scripts": {
+    "predev": "npm run link:pix --silent",
+    "dev": "mise exec node@24.16.0 -- tsx src/main.ts",
+    "start": "mise exec node@24.16.0 -- tsx src/main.ts",
+    "build:pix": "mise exec node@24.16.0 -- tsc -p tsconfig.json",
+    "prelink:pix": "npm run build:pix --silent",
+    "link:pix": "mise exec node@24.16.0 -- npm link --silent",
+    "watch:pix": "npm run link:pix --silent && mise exec node@24.16.0 -- tsc -p tsconfig.json --watch --preserveWatchOutput --noEmitOnError",
+    "check": "mise exec node@24.16.0 -- npm run check:inner",
+    "check:inner": "tsc --noEmit && npm run test:inner",
+    "test": "mise exec node@24.16.0 -- npm run test:inner",
+    "test:inner": "node --import tsx --test \"tests/**/*.test.ts\"",
+    "test:tools-suite": "npm --prefix external/pi-tools-suite test",
+    "test:coverage": "mise exec node@24.16.0 -- node --import tsx --test --experimental-test-coverage --test-coverage-include=src/**/*.ts --test-coverage-exclude=src/main.ts --test-coverage-lines=95 --test-coverage-branches=80 --test-coverage-functions=95 \"tests/**/*.test.ts\"",
+    "update-sdk-references": "mise exec node@24.16.0 -- node .pi/skills/pi-sdk/scripts/update-references.mjs",
+    "pack:dry-run": "npm pack --dry-run",
+    "smoke-test": "mise exec node@24.16.0 -- bash scripts/smoke-test-package.sh",
+    "release:check": "npm run check && npm run build:pix && npm run pack:dry-run",
+    "publish-npm": "bash scripts/publish.sh",
+    "prepublishOnly": "npm run check && npm run build:pix"
+  },
+  "dependencies": {
+    "@earendil-works/pi-tui": "0.77.0",
+    "@earendil-works/pi-ai": "0.77.0",
+    "@earendil-works/pi-coding-agent": "0.77.0",
+    "@mariozechner/pi-ai": "npm:@earendil-works/pi-ai@0.77.0",
+    "@mariozechner/pi-coding-agent": "npm:@earendil-works/pi-coding-agent@0.77.0",
+    "@mariozechner/pi-tui": "npm:@earendil-works/pi-tui@0.77.0",
+    "@mariozechner/clipboard": "^0.3.9",
+    "jsonc-parser": "3.3.1",
+    "typebox": "1.1.38",
+    "vscode-jsonrpc": "^8.2.1",
+    "vscode-languageserver-protocol": "^3.17.5"
+  },
+  "devDependencies": {
+    "@types/node": "24.12.4",
+    "tsx": "4.22.1",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=24 <25"
+  },
+  "overrides": {
+    "get-uv-event-loop-napi-h": "1.0.6",
+    "node-addon-api": "8.8.0"
+  },
+  "optionalDependencies": {
+    "vosk": "0.3.39"
+  },
+  "keywords": [
+    "pi",
+    "pix",
+    "coding-agent",
+    "terminal",
+    "renderer"
+  ]
+}

package/skills/context7/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: context7
+description: Fetch up-to-date documentation and code examples for any library or framework using the Context7 API. Use this skill whenever you need current docs, API references, code snippets, migration guides, or usage examples for a specific package, library, or framework. Triggers on 'how to use X', 'X documentation', 'look up docs for', 'API reference for', 'how does X work', 'example of X', 'X tutorial', 'X migration guide', 'latest docs for', 'check the docs', or any task where you need accurate, version-specific documentation for a library, SDK, framework, or package. Especially useful when the user asks about library features, configuration options, or best practices that may have changed in recent versions.
+---
+
+# Context7 — Up-to-date Library Documentation
+
+This skill fetches current documentation and code examples for any programming library or framework via the Context7 REST API, called directly through `bash`.
+
+Context7 indexes documentation from official sources and provides version-specific, relevant excerpts — much more reliable than relying on potentially outdated training data.
+
+## Two-step workflow
+
+### Step 1: Resolve the library ID
+
+Before fetching docs, you need the Context7-compatible library ID for the package:
+
+```bash
+bash <SKILL_DIR>/scripts/context7.sh resolve "Library Name" "what you need help with"
+```
+
+This returns a list of matching libraries with:
+- **Library ID** — the identifier you need for step 2 (format: `/org/project`)
+- **Name** — human-readable name
+- **Description** — short summary
+- **Code Snippets** — how many examples are available
+- **Source Reputation** — authority level (High/Medium/Low)
+- **Benchmark Score** — quality indicator (100 = best)
+- **Versions** — available versions if you need a specific one
+
+Pick the library with the best name match, highest reputation, and most snippets. If the user specified a version, use it (format: `/org/project/version`).
+
+### Step 2: Query documentation
+
+```bash
+bash <SKILL_DIR>/scripts/context7.sh docs "/org/project" "specific question or topic"
+```
+
+Returns relevant documentation sections with code examples and source links.
+
+`<SKILL_DIR>` is the directory containing this SKILL.md file.
+
+## Best practices
+
+1. **Be specific with queries.** "How to set up authentication with JWT in Express.js" is much better than "auth". The more specific, the more relevant the results.
+
+2. **Resolve once, query multiple times.** If researching a broad topic, resolve the library ID once, then make 2-3 focused queries with different aspects.
+
+3. **Don't over-call.** Limit to 3 calls per question total (resolve + docs). If you can't find what you need in 3 calls, work with the best result you have.
+
+4. **Use versions when specified.** If the user mentions a specific version ("Next.js 15", "React 19"), pass it as part of the library ID: `/vercel/next.js/v16.0.3`.
+
+5. **Present the code examples.** Context7 returns actual code from official docs. Show the relevant snippets to the user, along with explanations.
+
+6. **Cite sources.** Each documentation section includes a source URL. Reference it when presenting information.
+
+## Example usage
+
+```bash
+# Step 1: Find the library
+bash /path/to/scripts/context7.sh resolve "Tailwind CSS" "how to use flexbox utilities"
+
+# Step 2: Get docs (using the library ID from step 1)
+bash /path/to/scripts/context7.sh docs "/tailwindlabs/tailwindcss" "flexbox grid layout examples"
+
+# With a specific version
+bash /path/to/scripts/context7.sh resolve "Next.js" "App Router"
+bash /path/to/scripts/context7.sh docs "/vercel/next.js/v16.0.3" "server components setup"
+```

package/skills/context7/scripts/context7.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+# Context7 — fetch up-to-date library documentation via the Context7 MCP API
+#
+# Usage:
+#   context7.sh resolve "React" "how to use hooks"
+#   context7.sh docs "/facebook/react" "useEffect cleanup examples"
+#   context7.sh docs "/vercel/next.js/v16.0.3" "App Router setup"
+#
+# Two-step workflow:
+#   1. resolve — find the Context7 library ID for a package
+#   2. docs    — query documentation for a resolved library ID
+#
+# Requires CONTEXT7_API_KEY env var (falls back to hardcoded default).
+
+set -euo pipefail
+
+API_KEY="${CONTEXT7_API_KEY:-ctx7sk-d3b58838-f015-48a3-8059-93562f78837d}"
+BASE_URL="https://mcp.context7.com/mcp"
+
+call_mcp() {
+  local method="$1"
+  local name="$2"
+  local arguments="$3"
+
+  # Extract the id from a simple counter
+  local response
+  response=$(curl -s -X POST "$BASE_URL" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json, text/event-stream" \
+    -H "Authorization: Bearer $API_KEY" \
+    -d "$(jq -n \
+      --argjson id "$RANDOM" \
+      --arg method "$method" \
+      --arg name "$name" \
+      --argjson args "$arguments" \
+      '{
+        jsonrpc: "2.0",
+        id: $id,
+        method: $method,
+        params: { name: $name, arguments: $args }
+      }')")
+
+  # MCP responses come as SSE events — extract the JSON data line
+  if echo "$response" | grep -q "^data:"; then
+    echo "$response" | grep "^data:" | sed 's/^data: //' | jq '.result.content[0].text // .result.content'
+  else
+    echo "$response" | jq '.'
+  fi
+}
+
+cmd="${1:?Usage: context7.sh [resolve|docs] ...}"
+
+case "$cmd" in
+  resolve)
+    LIBRARY_NAME="${2:?Usage: context7.sh resolve \"Library Name\" \"query\"}"
+    QUERY="${3:-$LIBRARY_NAME}"
+    call_mcp "tools/call" "resolve-library-id" \
+      "$(jq -n --arg lib "$LIBRARY_NAME" --arg q "$QUERY" '{libraryName: $lib, query: $q}')"
+    ;;
+
+  docs)
+    LIBRARY_ID="${2:?Usage: context7.sh docs \"/org/project\" \"query\"}"
+    QUERY="${3:?Usage: context7.sh docs \"/org/project\" \"query\"}"
+    call_mcp "tools/call" "query-docs" \
+      "$(jq -n --arg id "$LIBRARY_ID" --arg q "$QUERY" '{libraryId: $id, query: $q}')"
+    ;;
+
+  *)
+    echo "Unknown command: $cmd" >&2
+    echo "Usage: context7.sh [resolve|docs] ..." >&2
+    exit 1
+    ;;
+esac

package/skills/handoff/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: handoff
+description: Compact the current conversation into a handoff document for another agent to pick up.
+argument-hint: "What will the next session be used for?"
+---
+
+Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace.
+
+Include a "suggested skills" section in the document, which suggests skills that the agent should invoke.
+
+Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.
+
+Redact any sensitive information, such as API keys, passwords, or personally identifiable information.
+
+If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly.

package/skills/pdf/LICENSE.txt

@@ -0,0 +1,30 @@
+© 2025 Anthropic, PBC. All rights reserved.
+
+LICENSE: Use of these materials (including all code, prompts, assets, files,
+and other components of this Skill) is governed by your agreement with
+Anthropic regarding use of Anthropic's services. If no separate agreement
+exists, use is governed by Anthropic's Consumer Terms of Service or
+Commercial Terms of Service, as applicable:
+https://www.anthropic.com/legal/consumer-terms
+https://www.anthropic.com/legal/commercial-terms
+Your applicable agreement is referred to as the "Agreement." "Services" are
+as defined in the Agreement.
+
+ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the
+contrary, users may not:
+
+- Extract these materials from the Services or retain copies of these
+  materials outside the Services
+- Reproduce or copy these materials, except for temporary copies created
+  automatically during authorized use of the Services
+- Create derivative works based on these materials
+- Distribute, sublicense, or transfer these materials to any third party
+- Make, offer to sell, sell, or import any inventions embodied in these
+  materials
+- Reverse engineer, decompile, or disassemble these materials
+
+The receipt, viewing, or possession of these materials does not convey or
+imply any license or right beyond those expressly granted above.
+
+Anthropic retains all right, title, and interest in these materials,
+including all copyrights, patents, and other intellectual property rights.

package/skills/pdf/SKILL.md

@@ -0,0 +1,314 @@
+---
+name: pdf
+description: Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
+license: Proprietary. LICENSE.txt has complete terms
+---
+
+# PDF Processing Guide
+
+## Overview
+
+This guide covers essential PDF processing operations using Python libraries and command-line tools. For advanced features, JavaScript libraries, and detailed examples, see REFERENCE.md. If you need to fill out a PDF form, read FORMS.md and follow its instructions.
+
+## Quick Start
+
+```python
+from pypdf import PdfReader, PdfWriter
+
+# Read a PDF
+reader = PdfReader("document.pdf")
+print(f"Pages: {len(reader.pages)}")
+
+# Extract text
+text = ""
+for page in reader.pages:
+    text += page.extract_text()
+```
+
+## Python Libraries
+
+### pypdf - Basic Operations
+
+#### Merge PDFs
+```python
+from pypdf import PdfWriter, PdfReader
+
+writer = PdfWriter()
+for pdf_file in ["doc1.pdf", "doc2.pdf", "doc3.pdf"]:
+    reader = PdfReader(pdf_file)
+    for page in reader.pages:
+        writer.add_page(page)
+
+with open("merged.pdf", "wb") as output:
+    writer.write(output)
+```
+
+#### Split PDF
+```python
+reader = PdfReader("input.pdf")
+for i, page in enumerate(reader.pages):
+    writer = PdfWriter()
+    writer.add_page(page)
+    with open(f"page_{i+1}.pdf", "wb") as output:
+        writer.write(output)
+```
+
+#### Extract Metadata
+```python
+reader = PdfReader("document.pdf")
+meta = reader.metadata
+print(f"Title: {meta.title}")
+print(f"Author: {meta.author}")
+print(f"Subject: {meta.subject}")
+print(f"Creator: {meta.creator}")
+```
+
+#### Rotate Pages
+```python
+reader = PdfReader("input.pdf")
+writer = PdfWriter()
+
+page = reader.pages[0]
+page.rotate(90)  # Rotate 90 degrees clockwise
+writer.add_page(page)
+
+with open("rotated.pdf", "wb") as output:
+    writer.write(output)
+```
+
+### pdfplumber - Text and Table Extraction
+
+#### Extract Text with Layout
+```python
+import pdfplumber
+
+with pdfplumber.open("document.pdf") as pdf:
+    for page in pdf.pages:
+        text = page.extract_text()
+        print(text)
+```
+
+#### Extract Tables
+```python
+with pdfplumber.open("document.pdf") as pdf:
+    for i, page in enumerate(pdf.pages):
+        tables = page.extract_tables()
+        for j, table in enumerate(tables):
+            print(f"Table {j+1} on page {i+1}:")
+            for row in table:
+                print(row)
+```
+
+#### Advanced Table Extraction
+```python
+import pandas as pd
+
+with pdfplumber.open("document.pdf") as pdf:
+    all_tables = []
+    for page in pdf.pages:
+        tables = page.extract_tables()
+        for table in tables:
+            if table:  # Check if table is not empty
+                df = pd.DataFrame(table[1:], columns=table[0])
+                all_tables.append(df)
+
+# Combine all tables
+if all_tables:
+    combined_df = pd.concat(all_tables, ignore_index=True)
+    combined_df.to_excel("extracted_tables.xlsx", index=False)
+```
+
+### reportlab - Create PDFs
+
+#### Basic PDF Creation
+```python
+from reportlab.lib.pagesizes import letter
+from reportlab.pdfgen import canvas
+
+c = canvas.Canvas("hello.pdf", pagesize=letter)
+width, height = letter
+
+# Add text
+c.drawString(100, height - 100, "Hello World!")
+c.drawString(100, height - 120, "This is a PDF created with reportlab")
+
+# Add a line
+c.line(100, height - 140, 400, height - 140)
+
+# Save
+c.save()
+```
+
+#### Create PDF with Multiple Pages
+```python
+from reportlab.lib.pagesizes import letter
+from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
+from reportlab.lib.styles import getSampleStyleSheet
+
+doc = SimpleDocTemplate("report.pdf", pagesize=letter)
+styles = getSampleStyleSheet()
+story = []
+
+# Add content
+title = Paragraph("Report Title", styles['Title'])
+story.append(title)
+story.append(Spacer(1, 12))
+
+body = Paragraph("This is the body of the report. " * 20, styles['Normal'])
+story.append(body)
+story.append(PageBreak())
+
+# Page 2
+story.append(Paragraph("Page 2", styles['Heading1']))
+story.append(Paragraph("Content for page 2", styles['Normal']))
+
+# Build PDF
+doc.build(story)
+```
+
+#### Subscripts and Superscripts
+
+**IMPORTANT**: Never use Unicode subscript/superscript characters (₀₁₂₃₄₅₆₇₈₉, ⁰¹²³⁴⁵⁶⁷⁸⁹) in ReportLab PDFs. The built-in fonts do not include these glyphs, causing them to render as solid black boxes.
+
+Instead, use ReportLab's XML markup tags in Paragraph objects:
+```python
+from reportlab.platypus import Paragraph
+from reportlab.lib.styles import getSampleStyleSheet
+
+styles = getSampleStyleSheet()
+
+# Subscripts: use <sub> tag
+chemical = Paragraph("H<sub>2</sub>O", styles['Normal'])
+
+# Superscripts: use <super> tag
+squared = Paragraph("x<super>2</super> + y<super>2</super>", styles['Normal'])
+```
+
+For canvas-drawn text (not Paragraph objects), manually adjust font the size and position rather than using Unicode subscripts/superscripts.
+
+## Command-Line Tools
+
+### pdftotext (poppler-utils)
+```bash
+# Extract text
+pdftotext input.pdf output.txt
+
+# Extract text preserving layout
+pdftotext -layout input.pdf output.txt
+
+# Extract specific pages
+pdftotext -f 1 -l 5 input.pdf output.txt  # Pages 1-5
+```
+
+### qpdf
+```bash
+# Merge PDFs
+qpdf --empty --pages file1.pdf file2.pdf -- merged.pdf
+
+# Split pages
+qpdf input.pdf --pages . 1-5 -- pages1-5.pdf
+qpdf input.pdf --pages . 6-10 -- pages6-10.pdf
+
+# Rotate pages
+qpdf input.pdf output.pdf --rotate=+90:1  # Rotate page 1 by 90 degrees
+
+# Remove password
+qpdf --password=mypassword --decrypt encrypted.pdf decrypted.pdf
+```
+
+### pdftk (if available)
+```bash
+# Merge
+pdftk file1.pdf file2.pdf cat output merged.pdf
+
+# Split
+pdftk input.pdf burst
+
+# Rotate
+pdftk input.pdf rotate 1east output rotated.pdf
+```
+
+## Common Tasks
+
+### Extract Text from Scanned PDFs
+```python
+# Requires: pip install pytesseract pdf2image
+import pytesseract
+from pdf2image import convert_from_path
+
+# Convert PDF to images
+images = convert_from_path('scanned.pdf')
+
+# OCR each page
+text = ""
+for i, image in enumerate(images):
+    text += f"Page {i+1}:\n"
+    text += pytesseract.image_to_string(image)
+    text += "\n\n"
+
+print(text)
+```
+
+### Add Watermark
+```python
+from pypdf import PdfReader, PdfWriter
+
+# Create watermark (or load existing)
+watermark = PdfReader("watermark.pdf").pages[0]
+
+# Apply to all pages
+reader = PdfReader("document.pdf")
+writer = PdfWriter()
+
+for page in reader.pages:
+    page.merge_page(watermark)
+    writer.add_page(page)
+
+with open("watermarked.pdf", "wb") as output:
+    writer.write(output)
+```
+
+### Extract Images
+```bash
+# Using pdfimages (poppler-utils)
+pdfimages -j input.pdf output_prefix
+
+# This extracts all images as output_prefix-000.jpg, output_prefix-001.jpg, etc.
+```
+
+### Password Protection
+```python
+from pypdf import PdfReader, PdfWriter
+
+reader = PdfReader("input.pdf")
+writer = PdfWriter()
+
+for page in reader.pages:
+    writer.add_page(page)
+
+# Add password
+writer.encrypt("userpassword", "ownerpassword")
+
+with open("encrypted.pdf", "wb") as output:
+    writer.write(output)
+```
+
+## Quick Reference
+
+| Task | Best Tool | Command/Code |
+|------|-----------|--------------|
+| Merge PDFs | pypdf | `writer.add_page(page)` |
+| Split PDFs | pypdf | One page per file |
+| Extract text | pdfplumber | `page.extract_text()` |
+| Extract tables | pdfplumber | `page.extract_tables()` |
+| Create PDFs | reportlab | Canvas or Platypus |
+| Command line merge | qpdf | `qpdf --empty --pages ...` |
+| OCR scanned PDFs | pytesseract | Convert to image first |
+| Fill PDF forms | pdf-lib or pypdf (see FORMS.md) | See FORMS.md |
+
+## Next Steps
+
+- For advanced pypdfium2 usage, see REFERENCE.md
+- For JavaScript libraries (pdf-lib), see REFERENCE.md
+- If you need to fill out a PDF form, follow the instructions in FORMS.md
+- For troubleshooting guides, see REFERENCE.md