alvin-bot 4.4.1

package/plugins/smarthome/index.js

@@ -0,0 +1,230 @@
+/**
+ * Smart Home Plugin — Control smart home devices.
+ *
+ * Supports:
+ * - Philips Hue (via local bridge API)
+ * - Generic HTTP devices (webhooks, IFTTT, Home Assistant)
+ *
+ * Configuration via docs/smarthome.json:
+ * {
+ *   "hue": { "bridge": "192.168.1.x", "username": "api-key" },
+ *   "devices": [
+ *     { "name": "Desk Lamp", "type": "hue", "id": "1" },
+ *     { "name": "Fan", "type": "webhook", "on": "http://...", "off": "http://..." }
+ *   ]
+ * }
+ */
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const PLUGIN_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const CONFIG_FILE = path.resolve(PLUGIN_ROOT, "docs", "smarthome.json");
+
+function loadConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8"));
+  } catch {
+    return { hue: null, devices: [] };
+  }
+}
+
+async function hueRequest(method, endpoint, body = null) {
+  const config = loadConfig();
+  if (!config.hue?.bridge || !config.hue?.username) {
+    throw new Error("Hue Bridge not configured. Create docs/smarthome.json");
+  }
+  const url = `http://${config.hue.bridge}/api/${config.hue.username}${endpoint}`;
+  const options = { method, headers: { "Content-Type": "application/json" } };
+  if (body) options.body = JSON.stringify(body);
+  const res = await fetch(url, options);
+  return res.json();
+}
+
+export default {
+  name: "smarthome",
+  description: "Smart home control (Hue, Webhooks, Home Assistant)",
+  version: "1.0.0",
+  author: "Alvin Bot",
+
+  commands: [
+    {
+      command: "home",
+      description: "Control smart home",
+      handler: async (ctx, args) => {
+        const config = loadConfig();
+
+        if (!args) {
+          if (config.devices.length === 0 && !config.hue) {
+            await ctx.reply(
+              "🏠 *Smart Home*\n\n" +
+              "Not configured.\nCreate `docs/smarthome.json` with:\n" +
+              "```json\n" +
+              '{\n  "hue": { "bridge": "IP", "username": "KEY" },\n  "devices": []\n}\n' +
+              "```",
+              { parse_mode: "Markdown" }
+            );
+            return;
+          }
+
+          // List devices
+          const lines = config.devices.map((d, i) => `${i + 1}. ${d.type === "hue" ? "💡" : "🔌"} *${d.name}* (${d.type})`);
+
+          // If Hue configured, show lights
+          if (config.hue) {
+            try {
+              const lights = await hueRequest("GET", "/lights");
+              for (const [id, light] of Object.entries(lights)) {
+                const state = light.state?.on ? "🟢" : "⚫";
+                const brightness = light.state?.bri ? ` (${Math.round(light.state.bri / 254 * 100)}%)` : "";
+                lines.push(`💡 ${state} *${light.name}*${brightness} [Hue #${id}]`);
+              }
+            } catch (err) {
+              lines.push(`⚠️ Hue Bridge unreachable: ${err.message}`);
+            }
+          }
+
+          await ctx.reply(
+            `🏠 *Smart Home:*\n\n${lines.join("\n")}\n\n` +
+            "_Commands: `/home on <name>`, `/home off <name>`, `/home brightness <name> 50`_",
+            { parse_mode: "Markdown" }
+          );
+          return;
+        }
+
+        // /home on <device>
+        if (args.startsWith("on ") || args.startsWith("off ")) {
+          const on = args.startsWith("on ");
+          const deviceName = args.slice(on ? 3 : 4).trim().toLowerCase();
+
+          // Check configured devices first
+          const device = config.devices.find(d => d.name.toLowerCase().includes(deviceName));
+          if (device) {
+            if (device.type === "webhook") {
+              const url = on ? device.on : device.off;
+              if (!url) { await ctx.reply("❌ No webhook for this state."); return; }
+              await fetch(url, { method: "POST" });
+              await ctx.reply(`${on ? "🟢" : "⚫"} *${device.name}* turned ${on ? "on" : "off"}.`, { parse_mode: "Markdown" });
+              return;
+            }
+            if (device.type === "hue" && device.id) {
+              await hueRequest("PUT", `/lights/${device.id}/state`, { on });
+              await ctx.reply(`💡 *${device.name}* ${on ? "on" : "off"}.`, { parse_mode: "Markdown" });
+              return;
+            }
+          }
+
+          // Try Hue lights by name
+          if (config.hue) {
+            try {
+              const lights = await hueRequest("GET", "/lights");
+              for (const [id, light] of Object.entries(lights)) {
+                if (light.name.toLowerCase().includes(deviceName)) {
+                  await hueRequest("PUT", `/lights/${id}/state`, { on });
+                  await ctx.reply(`💡 *${light.name}* ${on ? "on" : "off"}.`, { parse_mode: "Markdown" });
+                  return;
+                }
+              }
+            } catch { /* bridge not reachable */ }
+          }
+
+          await ctx.reply(`❌ Device "${deviceName}" not found.`);
+          return;
+        }
+
+        // /home brightness <device> <0-100>
+        if (args.startsWith("brightness ") || args.startsWith("bri ")) {
+          const parts = args.split(" ").slice(1);
+          const level = parseInt(parts[parts.length - 1]);
+          const deviceName = parts.slice(0, -1).join(" ").toLowerCase();
+
+          if (isNaN(level) || level < 0 || level > 100) {
+            await ctx.reply("Brightness: 0-100. Example: `/home brightness Lamp 50`", { parse_mode: "Markdown" });
+            return;
+          }
+
+          const bri = Math.round(level / 100 * 254);
+
+          if (config.hue) {
+            try {
+              const lights = await hueRequest("GET", "/lights");
+              for (const [id, light] of Object.entries(lights)) {
+                if (light.name.toLowerCase().includes(deviceName)) {
+                  await hueRequest("PUT", `/lights/${id}/state`, { on: true, bri });
+                  await ctx.reply(`💡 *${light.name}* brightness: ${level}%`, { parse_mode: "Markdown" });
+                  return;
+                }
+              }
+            } catch { /* bridge not reachable */ }
+          }
+
+          await ctx.reply(`❌ Device "${deviceName}" not found.`);
+          return;
+        }
+
+        // /home scene <scene-name>
+        if (args.startsWith("scene ")) {
+          const sceneName = args.slice(6).trim().toLowerCase();
+          if (!config.hue) { await ctx.reply("❌ Hue not configured."); return; }
+
+          try {
+            const scenes = await hueRequest("GET", "/scenes");
+            for (const [id, scene] of Object.entries(scenes)) {
+              if (scene.name.toLowerCase().includes(sceneName)) {
+                await hueRequest("PUT", "/groups/0/action", { scene: id });
+                await ctx.reply(`🎨 Scene activated: *${scene.name}*`, { parse_mode: "Markdown" });
+                return;
+              }
+            }
+            await ctx.reply(`❌ Scene "${sceneName}" not found.`);
+          } catch (err) {
+            await ctx.reply(`❌ Hue error: ${err.message}`);
+          }
+          return;
+        }
+
+        await ctx.reply(
+          "🏠 *Smart Home commands:*\n\n" +
+          "`/home` — List devices\n" +
+          "`/home on Lamp` — Turn on\n" +
+          "`/home off Lamp` — Turn off\n" +
+          "`/home brightness Lamp 50` — Brightness\n" +
+          "`/home scene Relax` — Activate Hue scene",
+          { parse_mode: "Markdown" }
+        );
+      },
+    },
+  ],
+
+  tools: [
+    {
+      name: "control_device",
+      description: "Turn a smart home device on or off",
+      parameters: {
+        type: "object",
+        properties: {
+          device: { type: "string", description: "Device name" },
+          action: { type: "string", enum: ["on", "off"], description: "Action" },
+          brightness: { type: "number", description: "Brightness 0-100 (optional)" },
+        },
+        required: ["device", "action"],
+      },
+      execute: async (params) => {
+        const config = loadConfig();
+        if (!config.hue) return "Smart Home not configured";
+
+        const lights = await hueRequest("GET", "/lights");
+        for (const [id, light] of Object.entries(lights)) {
+          if (light.name.toLowerCase().includes(params.device.toLowerCase())) {
+            const state = { on: params.action === "on" };
+            if (params.brightness !== undefined) state.bri = Math.round(params.brightness / 100 * 254);
+            await hueRequest("PUT", `/lights/${id}/state`, state);
+            return `${light.name}: ${params.action}${params.brightness ? ` (${params.brightness}%)` : ""}`;
+          }
+        }
+        return `Device "${params.device}" not found`;
+      },
+    },
+  ],
+};

package/plugins/weather/index.js

@@ -0,0 +1,122 @@
+/**
+ * Weather Plugin — Get current weather and forecasts.
+ *
+ * Uses wttr.in (no API key needed).
+ * Example plugin for Alvin Bot's plugin system.
+ */
+
+export default {
+  name: "weather",
+  description: "Weather queries via wttr.in (no API key needed)",
+  version: "1.0.0",
+  author: "Alvin Bot",
+
+  commands: [
+    {
+      command: "weather",
+      description: "Get weather (e.g. /weather Berlin)",
+      handler: async (ctx, args) => {
+        const location = args || "Berlin";
+
+        try {
+          await ctx.api.sendChatAction(ctx.chat.id, "typing");
+
+          const response = await fetch(
+            `https://wttr.in/${encodeURIComponent(location)}?format=j1`,
+            { headers: { "User-Agent": "AlvinBot/1.0" } }
+          );
+
+          if (!response.ok) {
+            await ctx.reply(`❌ Weather for "${location}" not found.`);
+            return;
+          }
+
+          const data = await response.json();
+          const current = data.current_condition?.[0];
+          const area = data.nearest_area?.[0];
+
+          if (!current) {
+            await ctx.reply(`❌ No weather data for "${location}".`);
+            return;
+          }
+
+          const areaName = area?.areaName?.[0]?.value || location;
+          const country = area?.country?.[0]?.value || "";
+          const temp = current.temp_C;
+          const feelsLike = current.FeelsLikeC;
+          const desc = current.lang_de?.[0]?.value || current.weatherDesc?.[0]?.value || "";
+          const humidity = current.humidity;
+          const wind = current.windspeedKmph;
+          const windDir = current.winddir16Point;
+
+          // Weather emoji based on description
+          let emoji = "🌤️";
+          const descLower = desc.toLowerCase();
+          if (descLower.includes("regen") || descLower.includes("rain")) emoji = "🌧️";
+          else if (descLower.includes("schnee") || descLower.includes("snow")) emoji = "🌨️";
+          else if (descLower.includes("gewitter") || descLower.includes("thunder")) emoji = "⛈️";
+          else if (descLower.includes("wolkig") || descLower.includes("cloud") || descLower.includes("bewölkt")) emoji = "☁️";
+          else if (descLower.includes("sonnig") || descLower.includes("sunny") || descLower.includes("klar") || descLower.includes("clear")) emoji = "☀️";
+          else if (descLower.includes("nebel") || descLower.includes("fog")) emoji = "🌫️";
+
+          // 3-day forecast
+          const forecast = data.weather?.slice(0, 3).map(day => {
+            const date = day.date;
+            const maxT = day.maxtempC;
+            const minT = day.mintempC;
+            const dayDesc = day.hourly?.[4]?.lang_de?.[0]?.value || day.hourly?.[4]?.weatherDesc?.[0]?.value || "";
+            return `📅 ${date}: ${minT}°–${maxT}°C, ${dayDesc}`;
+          }).join("\n") || "";
+
+          await ctx.reply(
+            `${emoji} *Weather in ${areaName}*${country ? ` (${country})` : ""}\n\n` +
+            `🌡️ ${temp}°C (feels like ${feelsLike}°C)\n` +
+            `${desc}\n` +
+            `💧 Humidity: ${humidity}%\n` +
+            `💨 Wind: ${wind} km/h ${windDir}\n` +
+            (forecast ? `\n*3-Day Forecast:*\n${forecast}` : ""),
+            { parse_mode: "Markdown" }
+          );
+        } catch (err) {
+          await ctx.reply(`❌ Error: ${err.message || err}`);
+        }
+      },
+    },
+  ],
+
+  tools: [
+    {
+      name: "get_weather",
+      description: "Get current weather for a location",
+      parameters: {
+        type: "object",
+        properties: {
+          location: { type: "string", description: "City name (e.g. Berlin, London)" },
+        },
+        required: ["location"],
+      },
+      execute: async (params) => {
+        const location = params.location || "Berlin";
+        const response = await fetch(
+          `https://wttr.in/${encodeURIComponent(location)}?format=j1`,
+          { headers: { "User-Agent": "AlvinBot/1.0" } }
+        );
+
+        if (!response.ok) return `Weather not found for "${location}"`;
+
+        const data = await response.json();
+        const current = data.current_condition?.[0];
+        if (!current) return `No weather data for "${location}"`;
+
+        return JSON.stringify({
+          location,
+          temperature: `${current.temp_C}°C`,
+          feelsLike: `${current.FeelsLikeC}°C`,
+          description: current.lang_de?.[0]?.value || current.weatherDesc?.[0]?.value,
+          humidity: `${current.humidity}%`,
+          wind: `${current.windspeedKmph} km/h ${current.winddir16Point}`,
+        });
+      },
+    },
+  ],
+};

package/skills/apple-notes/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: Apple Notes
+description: Read, create, and search Apple Notes via AppleScript
+triggers: apple notes, notes app, notizen, note, notes, apple notizen
+priority: 5
+category: productivity
+---
+
+# Apple Notes
+
+Access Apple Notes.app via AppleScript (macOS only).
+
+## Read Notes
+```bash
+osascript -e 'tell application "Notes" to get name of every note in default account'
+```
+
+## Search Notes
+```bash
+osascript -e 'tell application "Notes" to get name of every note of default account whose name contains "search term"'
+```
+
+## Create Note
+```bash
+osascript -e 'tell application "Notes" to make new note at folder "Notes" of default account with properties {name:"Title", body:"Content"}'
+```
+
+## Read Note Content
+```bash
+osascript -e 'tell application "Notes" to get body of note "Note Title" of default account'
+```

package/skills/browse/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: Browser Automation
+description: Interactive browser control — navigate, click, fill forms, screenshot, test web apps
+triggers: browse, browser, test webapp, test app, test website, screenshot page, interact with, click on, fill form, visual test, qa test, check page, open page, test my app, browse to, open url, puppeteer, playwright, browser automation, test die seite, teste die app, schau dir an, öffne die seite, teste mal, visual check, check the ui, check the page
+priority: 8
+category: automation
+---
+
+# Browser Automation — Playwright Interactive
+
+## Browser Strategies
+
+Alvin Bot auto-selects the best browser approach:
+
+| Strategy | When | How |
+|----------|------|-----|
+| **CLI** (default) | Simple screenshots, text extraction, PDF | Headless Playwright, one-shot |
+| **HTTP Gateway** | Interactive browsing, form-filling, QA testing | Persistent browser server on port 3800 |
+| **CDP** | Attach to user's Chrome (with login state) | Chrome DevTools Protocol via CDP_URL |
+
+The gateway starts automatically when needed and shuts down after 5 min idle.
+For CDP: Launch Chrome with `--remote-debugging-port=9222` and set `CDP_URL=http://localhost:9222`.
+
+---
+
+You have a persistent Playwright browser server that gives you **eyes** and **hands** to interact with web pages. You can navigate, see screenshots, read the accessibility tree, click buttons, fill forms, and test running web apps.
+
+## Quick Start
+
+```bash
+# 1. Ensure server is running (auto-shuts down after 5 min idle)
+curl -s http://127.0.0.1:3800/health 2>/dev/null | grep -q '"ok":true' || \
+  (BOT_DIR=$(node -e "console.log(require('path').resolve(require.resolve('alvin-bot/package.json'), '..'))" 2>/dev/null || echo ".") && cd "$BOT_DIR" && node scripts/browse-server.cjs &) && sleep 3
+
+# 2. Navigate to a page
+curl -s "http://127.0.0.1:3800/navigate?url=https://example.com" | jq
+
+# 3. Take a screenshot (view it with Read tool)
+SHOT=$(curl -s "http://127.0.0.1:3800/screenshot" | jq -r '.path')
+# Then use Read tool on $SHOT to see the image
+
+# 4. Get interactive elements
+curl -s "http://127.0.0.1:3800/tree" | jq '.tree[]' -r
+
+# 5. Click something
+curl -s "http://127.0.0.1:3800/click?ref=e5" | jq
+```
+
+## All Routes
+
+| Route | Params | What it does |
+|-------|--------|-------------|
+| `/navigate` | `url` | Open a URL, returns title + accessibility tree |
+| `/screenshot` | `full=true` (optional) | Take screenshot, returns file path |
+| `/tree` | `limit=N` (optional) | Get all interactive elements with @eN refs |
+| `/click` | `ref=eN` | Click element by ref |
+| `/fill` | `ref=eN`, `value=text` | Fill input field |
+| `/type` | `ref=eN`, `text=chars` | Type character by character (for special inputs) |
+| `/press` | `key=Enter`, `ref=eN` (opt) | Press keyboard key |
+| `/select` | `ref=eN`, `value=opt` | Select dropdown option |
+| `/hover` | `ref=eN` | Hover over element |
+| `/scroll` | `direction=down/up/top/bottom`, `amount=600` | Scroll page |
+| `/eval` | `js=expression` | Run JavaScript on page |
+| `/wait` | `ms=2000` or `selector=.class` | Wait for time or element |
+| `/viewport` | `device=mobile/tablet` or `width=W&height=H` | Change viewport |
+| `/cookies` | `set=[{...}]` (optional) | Get or set cookies |
+| `/back` | — | Browser back |
+| `/forward` | — | Browser forward |
+| `/reload` | — | Reload page |
+| `/network` | `limit=20` | Recent network requests |
+| `/info` | — | Current page info |
+| `/close` | — | Close browser + shutdown server |
+| `/health` | — | Server status check |
+
+## Element Refs (@eN)
+
+The accessibility tree assigns **refs** like `@e1`, `@e2`, `@e3` to every interactive element (links, buttons, inputs, etc.). Use these refs for all interactions — they're more robust than CSS selectors.
+
+Example tree:
+```
+@e1 <a href="/"> "Home"
+@e2 <a href="/dashboard"> "Dashboard"
+@e3 <input type="email" name="email" placeholder="Enter email">
+@e4 <input type="password" name="password" placeholder="Password">
+@e5 <button> "Sign In"
+@e6 <a href="/forgot"> "Forgot password?"
+```
+
+To login:
+```bash
+curl -s "http://127.0.0.1:3800/fill?ref=e3&value=user@example.com"
+curl -s "http://127.0.0.1:3800/fill?ref=e4&value=mypassword"
+curl -s "http://127.0.0.1:3800/click?ref=e5"
+```
+
+## Standard Workflow: Test a Web App
+
+1. **Start** the browse server if not running
+2. **Navigate** to the app URL
+3. **Screenshot** → view with Read tool to see current state
+4. **Tree** → see all interactive elements
+5. **Interact** (click, fill, press) using @eN refs
+6. **Screenshot** again to verify the result
+7. **Repeat** for each test step
+8. **Report** findings to the user
+9. **Close** when done
+
+## Mobile Testing
+
+```bash
+# Switch to mobile viewport
+curl -s "http://127.0.0.1:3800/viewport?device=mobile"
+curl -s "http://127.0.0.1:3800/screenshot" | jq -r '.path'
+# Switch back to desktop
+curl -s "http://127.0.0.1:3800/viewport?width=1280&height=720"
+```
+
+## Auth / Cookie Injection
+
+For pages that need authentication:
+```bash
+# Set cookies manually
+curl -s 'http://127.0.0.1:3800/cookies?set=[{"name":"session","value":"abc123","domain":"example.com","path":"/"}]'
+# Then navigate to the authenticated page
+curl -s "http://127.0.0.1:3800/navigate?url=https://example.com/dashboard"
+```
+
+## Important Notes
+
+- **Server auto-shuts down** after 5 min idle — restart if needed
+- **One page at a time** — navigation replaces the current page
+- **Screenshots** are saved to `/tmp/alvin-bot/browse/` — view with Read tool
+- **127.0.0.1 only** — not accessible from outside
+- **URL-encode** values with special chars: `value=hello%20world`
+- **Refs reset** on every navigation/click — always get fresh /tree after page changes
+- For **local dev servers**: use `http://localhost:PORT` as the URL

package/skills/code-project/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: Code Project
+description: Build, debug, and manage code projects
+triggers: code, programming, build project, create app, debug, fix bug, refactor, deploy, git, npm, python project, node project
+priority: 4
+category: development
+---
+
+# Code Project Skill
+
+When working on code projects:
+
+## Workflow
+1. **Understand** — read existing files, README, package.json before changing anything
+2. **Plan** — explain what you'll do before doing it
+3. **Implement** — write clean, well-structured code
+4. **Test** — run the code, check for errors, verify it works
+5. **Document** — update README if you made significant changes
+
+## Guidelines
+- **Read before write** — always understand existing code structure first
+- **Small commits** — one logical change per step
+- **Error handling** — always handle errors, never ignore them
+- **Types** — use TypeScript types, avoid `any` where possible
+- **Test after changes** — run `node --check`, build, or test suite
+
+## Common Patterns
+```bash
+# Node.js project
+cat package.json | head -20    # understand the project
+npm run build                   # verify it builds
+npm test                        # run tests
+
+# Python project
+cat requirements.txt            # dependencies
+python3 -m py_compile file.py   # syntax check
+python3 -m pytest               # run tests
+
+# Git
+git status                      # check state
+git diff --stat                 # see changes
+git log --oneline -5            # recent history
+```

package/skills/data-analysis/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: Data Analysis
+description: Analyze data files (CSV, JSON, Excel) with Python
+triggers: analyze data, data analysis, datenanalyse, csv, excel analysis, chart, graph, visualize, statistik, statistics
+priority: 4
+category: analysis
+---
+
+# Data Analysis Skill
+
+When analyzing data files or creating visualizations:
+
+## Workflow
+1. **Read the file** — use Python (pandas) for CSV/Excel, or parse JSON directly
+2. **Analyze YOURSELF** — describe patterns, trends, outliers in natural language
+3. **Visualize** with matplotlib/seaborn if charts are requested
+4. **Save outputs** to /tmp/ and deliver to the user
+
+## Python Pattern
+```python
+import pandas as pd
+import matplotlib.pyplot as plt
+
+df = pd.read_csv("/path/to/data.csv")  # or pd.read_excel()
+print(df.describe())
+print(df.head(10))
+
+# Visualization
+fig, ax = plt.subplots(figsize=(10, 6))
+df.plot(kind='bar', ax=ax)
+plt.tight_layout()
+plt.savefig('/tmp/chart.png', dpi=150)
+```
+
+## Guidelines
+- Always show a quick summary first (rows, columns, types, missing values)
+- Interpret results — don't just dump numbers, explain what they mean
+- For large datasets: show head + describe, not the full data
+- Charts: clean labels, readable fonts, meaningful titles

package/skills/document-creation/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: Document Creation
+description: Create professional documents (PDF, reports, letters)
+triggers: pdf, document, report, brief, letter, create document, dokument erstellen, bericht, schreiben, anschreiben, vorlage
+priority: 4
+category: productivity
+---
+
+# Document Creation Skill
+
+When creating professional documents:
+
+## Workflow
+1. **Clarify** format and content requirements
+2. **Write** the content YOURSELF — you are the language model
+3. **Generate** HTML with professional styling
+4. **Convert** to PDF using available tools
+5. **Deliver** to the user
+
+## PDF via HTML + Chrome/Playwright
+```bash
+# Write HTML
+cat > /tmp/document.html << 'EOF'
+<!DOCTYPE html>
+<html><head><meta charset="utf-8">
+<style>
+  body { font-family: 'Segoe UI', system-ui, sans-serif; max-width: 210mm; margin: 0 auto; padding: 20mm; line-height: 1.6; color: #333; }
+  h1 { color: #1a1a2e; border-bottom: 2px solid #e2b04a; padding-bottom: 8px; }
+  h2 { color: #2d2a26; margin-top: 1.5em; }
+  .header { text-align: right; font-size: 0.9em; color: #666; margin-bottom: 2em; }
+  table { width: 100%; border-collapse: collapse; margin: 1em 0; }
+  th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
+  th { background: #f5f5f5; }
+</style></head><body>
+<!-- CONTENT HERE -->
+</body></html>
+EOF
+
+# Convert to PDF
+npx playwright-core pdf /tmp/document.html /tmp/document.pdf --format=A4 2>/dev/null || \
+  wkhtmltopdf --page-size A4 /tmp/document.html /tmp/document.pdf 2>/dev/null
+```
+
+## Guidelines
+- **A4 format** for European documents, Letter for US
+- **Professional tone** unless told otherwise
+- **Page breaks** — use `break-inside: avoid` on logical blocks
+- **Date format** — match user's locale (DD.MM.YYYY for DE, MM/DD/YYYY for EN)