thepopebot 1.2.74 → 1.2.75-beta.2

package/templates/skills/agent-job-secrets/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: agent-job-secrets
+description: List, get, or update agent secrets. Use get for OAuth credentials (auto-refreshed on every call). Use set to persist updated credentials back to the event handler.
+---
+
+## Usage
+
+```bash
+# List available secrets (null = must fetch, plain = already in env)
+node skills/agent-job-secrets/agent-job-secrets.js
+
+# Get a secret value (OAuth credentials are auto-refreshed)
+node skills/agent-job-secrets/agent-job-secrets.js get MY_CREDENTIALS
+
+# Set/update a secret (plain string or piped value)
+node skills/agent-job-secrets/agent-job-secrets.js set MY_KEY "value"
+echo "$UPDATED_CREDENTIALS" | node skills/agent-job-secrets/agent-job-secrets.js set MY_KEY
+```
+
+## Notes
+
+- `AGENT_JOB_TOKEN` and `APP_URL` are injected automatically — no setup required
+- OAuth credentials show as `null` in the list and must be fetched via `get`
+- `get` on an OAuth credential refreshes it and persists the updated token immediately
+- Plain secrets are available directly as env vars (e.g. `echo $MY_KEY`)

package/templates/skills/agent-job-secrets/agent-job-secrets.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+
+const [cmd, key, inlineValue] = process.argv.slice(2);
+
+// Default to list
+if (!cmd || cmd === 'list') {
+  const secretsJson = process.env.AGENT_JOB_SECRETS;
+  if (!secretsJson) {
+    console.log('No agent secrets configured.');
+    process.exit(0);
+  }
+  const secrets = JSON.parse(secretsJson);
+  const keys = Object.keys(secrets);
+  if (keys.length === 0) {
+    console.log('No agent secrets configured.');
+  } else {
+    console.log('Available secrets:');
+    keys.forEach(k => {
+      const fetchRequired = secrets[k] === null;
+      console.log(`  - ${k}${fetchRequired ? '  (fetch required: use get)' : ''}`);
+    });
+    console.log('\nTo get a value: agent-job-secrets.js get KEY_NAME');
+  }
+  process.exit(0);
+}
+
+const apiKey = process.env.AGENT_JOB_TOKEN;
+const appUrl = process.env.APP_URL;
+if (!apiKey) { console.error('AGENT_JOB_TOKEN not available'); process.exit(1); }
+if (!appUrl) { console.error('APP_URL not available'); process.exit(1); }
+
+if (cmd === 'get') {
+  if (!key) { console.error('Usage: agent-job-secrets.js get KEY_NAME'); process.exit(1); }
+  const res = await fetch(`${appUrl}/api/get-agent-job-secret?key=${encodeURIComponent(key)}`, {
+    headers: { 'x-api-key': apiKey },
+  });
+  const json = await res.json();
+  if (!res.ok || json.error) { console.error('Failed:', json.error || res.status); process.exit(1); }
+  console.log(json.value);
+  process.exit(0);
+}
+
+if (cmd === 'set') {
+  if (!key) {
+    console.error('Usage: agent-job-secrets.js set KEY_NAME [value]');
+    console.error('       echo "value" | agent-job-secrets.js set KEY_NAME');
+    process.exit(1);
+  }
+  let value = inlineValue;
+  if (value === undefined) {
+    value = readFileSync('/dev/stdin', 'utf8').trim();
+  }
+  const res = await fetch(`${appUrl}/api/set-agent-job-secret`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
+    body: JSON.stringify({ key, value }),
+  });
+  const json = await res.json();
+  if (!res.ok || json.error) { console.error('Failed:', json.error || res.status); process.exit(1); }
+  console.log(`Secret "${key}" updated.`);
+  process.exit(0);
+}
+
+console.error(`Unknown command: ${cmd}`);
+process.exit(1);

package/templates/skills/playwright-cli/SKILL.md

@@ -0,0 +1,294 @@
+---
+name: playwright-cli
+description: Automate browser interactions, test web pages and work with Playwright tests.
+allowed-tools: Bash(playwright-cli:*) Bash(npx:*) Bash(npm:*)
+---
+
+# Browser Automation with playwright-cli
+
+## Quick start
+
+```bash
+# open new browser
+playwright-cli open
+# navigate to a page
+playwright-cli goto https://playwright.dev
+# interact with the page using refs from the snapshot
+playwright-cli click e15
+playwright-cli type "page.click"
+playwright-cli press Enter
+# take a screenshot (rarely used, as snapshot is more common)
+playwright-cli screenshot
+# close the browser
+playwright-cli close
+```
+
+## Commands
+
+### Core
+
+```bash
+playwright-cli open
+# open and navigate right away
+playwright-cli open https://example.com/
+playwright-cli goto https://playwright.dev
+playwright-cli type "search query"
+playwright-cli click e3
+playwright-cli dblclick e7
+# --submit presses Enter after filling the element
+playwright-cli fill e5 "user@example.com"  --submit
+playwright-cli drag e2 e8
+playwright-cli hover e4
+playwright-cli select e9 "option-value"
+playwright-cli upload ./document.pdf
+playwright-cli check e12
+playwright-cli uncheck e12
+playwright-cli snapshot
+playwright-cli eval "document.title"
+playwright-cli eval "el => el.textContent" e5
+# get element id, class, or any attribute not visible in the snapshot
+playwright-cli eval "el => el.id" e5
+playwright-cli eval "el => el.getAttribute('data-testid')" e5
+playwright-cli dialog-accept
+playwright-cli dialog-accept "confirmation text"
+playwright-cli dialog-dismiss
+playwright-cli resize 1920 1080
+playwright-cli close
+```
+
+### Navigation
+
+```bash
+playwright-cli go-back
+playwright-cli go-forward
+playwright-cli reload
+```
+
+### Keyboard
+
+```bash
+playwright-cli press Enter
+playwright-cli press ArrowDown
+playwright-cli keydown Shift
+playwright-cli keyup Shift
+```
+
+### Mouse
+
+```bash
+playwright-cli mousemove 150 300
+playwright-cli mousedown
+playwright-cli mousedown right
+playwright-cli mouseup
+playwright-cli mouseup right
+playwright-cli mousewheel 0 100
+```
+
+### Save as
+
+```bash
+playwright-cli screenshot
+playwright-cli screenshot e5
+playwright-cli screenshot --filename=page.png
+playwright-cli pdf --filename=page.pdf
+```
+
+### Tabs
+
+```bash
+playwright-cli tab-list
+playwright-cli tab-new
+playwright-cli tab-new https://example.com/page
+playwright-cli tab-close
+playwright-cli tab-close 2
+playwright-cli tab-select 0
+```
+
+### Storage
+
+```bash
+playwright-cli state-save
+playwright-cli state-save auth.json
+playwright-cli state-load auth.json
+
+# Cookies
+playwright-cli cookie-list
+playwright-cli cookie-list --domain=example.com
+playwright-cli cookie-get session_id
+playwright-cli cookie-set session_id abc123
+playwright-cli cookie-set session_id abc123 --domain=example.com --httpOnly --secure
+playwright-cli cookie-delete session_id
+playwright-cli cookie-clear
+
+# LocalStorage
+playwright-cli localstorage-list
+playwright-cli localstorage-get theme
+playwright-cli localstorage-set theme dark
+playwright-cli localstorage-delete theme
+playwright-cli localstorage-clear
+
+# SessionStorage
+playwright-cli sessionstorage-list
+playwright-cli sessionstorage-get step
+playwright-cli sessionstorage-set step 3
+playwright-cli sessionstorage-delete step
+playwright-cli sessionstorage-clear
+```
+
+### Network
+
+```bash
+playwright-cli route "**/*.jpg" --status=404
+playwright-cli route "https://api.example.com/**" --body='{"mock": true}'
+playwright-cli route-list
+playwright-cli unroute "**/*.jpg"
+playwright-cli unroute
+```
+
+### DevTools
+
+```bash
+playwright-cli console
+playwright-cli console warning
+playwright-cli network
+playwright-cli run-code "async page => await page.context().grantPermissions(['geolocation'])"
+playwright-cli run-code --filename=script.js
+playwright-cli tracing-start
+playwright-cli tracing-stop
+playwright-cli video-start video.webm
+playwright-cli video-chapter "Chapter Title" --description="Details" --duration=2000
+playwright-cli video-stop
+```
+
+## Open parameters
+
+```bash
+# Use specific browser when creating session
+playwright-cli open --browser=chrome
+playwright-cli open --browser=firefox
+playwright-cli open --browser=webkit
+playwright-cli open --browser=msedge
+# Connect to browser via extension
+playwright-cli open --extension
+
+# Use persistent profile (by default profile is in-memory)
+playwright-cli open --persistent
+# Use persistent profile with custom directory
+playwright-cli open --profile=/path/to/profile
+
+# Start with config file
+playwright-cli open --config=my-config.json
+
+# Close the browser
+playwright-cli close
+# Delete user data for the default session
+playwright-cli delete-data
+```
+
+## Snapshots
+
+After each command, playwright-cli provides a snapshot of the current browser state.
+
+```bash
+> playwright-cli goto https://example.com
+### Page
+- Page URL: https://example.com/
+- Page Title: Example Domain
+### Snapshot
+[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)
+```
+
+You can also take a snapshot on demand using `playwright-cli snapshot` command.
+
+```bash
+# default - save to a file with timestamp-based name
+playwright-cli snapshot
+
+# save to file, use when snapshot is a part of the workflow result
+playwright-cli snapshot --filename=after-click.yaml
+
+# snapshot an element instead of the whole page
+playwright-cli snapshot "#main"
+
+# limit snapshot depth for efficiency, take a partial snapshot afterwards
+playwright-cli snapshot --depth=4
+playwright-cli snapshot e34
+```
+
+## Targeting elements
+
+By default, use refs from the snapshot to interact with page elements.
+
+```bash
+# get snapshot with refs
+playwright-cli snapshot
+
+# interact using a ref
+playwright-cli click e15
+```
+
+You can also use css selectors or Playwright locators.
+
+```bash
+# css selector
+playwright-cli click "#main > button.submit"
+
+# role locator
+playwright-cli click "getByRole('button', { name: 'Submit' })"
+
+# test id
+playwright-cli click "getByTestId('submit-button')"
+```
+
+## Browser Sessions
+
+```bash
+# create new browser session named "mysession" with persistent profile
+playwright-cli -s=mysession open example.com --persistent
+# same with manually specified profile directory (use when requested explicitly)
+playwright-cli -s=mysession open example.com --profile=/path/to/profile
+playwright-cli -s=mysession click e6
+playwright-cli -s=mysession close  # stop a named browser
+playwright-cli -s=mysession delete-data  # delete user data for persistent session
+
+playwright-cli list
+# Close all browsers
+playwright-cli close-all
+# Forcefully kill all browser processes
+playwright-cli kill-all
+```
+
+## Example: Form submission
+
+```bash
+playwright-cli open https://example.com/form
+playwright-cli snapshot
+
+playwright-cli fill e1 "user@example.com"
+playwright-cli fill e2 "password123"
+playwright-cli click e3
+playwright-cli snapshot
+playwright-cli close
+```
+
+## Example: Multi-tab workflow
+
+```bash
+playwright-cli open https://example.com
+playwright-cli tab-new https://example.com/other
+playwright-cli tab-list
+playwright-cli tab-select 0
+playwright-cli snapshot
+playwright-cli close
+```
+
+## Example: Debugging with DevTools
+
+```bash
+playwright-cli open https://example.com
+playwright-cli click e4
+playwright-cli fill e7 "test"
+playwright-cli console
+playwright-cli network
+playwright-cli close
+```

package/templates/skills/brave-search/SKILL.md

@@ -1,79 +0,0 @@
----
-name: brave-search
-description: Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
----
-
-# Brave Search
-
-Web search and content extraction using the official Brave Search API. No browser required.
-
-## Setup
-
-Requires a Brave Search API account with a free subscription. A credit card is required to create the free subscription (you won't be charged).
-
-1. Create an account at https://api-dashboard.search.brave.com/register
-2. Create a "Free AI" subscription
-3. Create an API key for the subscription
-4. Add to your shell profile (`~/.profile` or `~/.zprofile` for zsh):
-   ```bash
-   export BRAVE_API_KEY="your-api-key-here"
-   ```
-5. Install dependencies (run once):
-   ```bash
-   cd skills/brave-search
-   npm install
-   ```
-
-## Search
-
-```bash
-skills/brave-search/search.js "query"                         # Basic search (5 results)
-skills/brave-search/search.js "query" -n 10                   # More results (max 20)
-skills/brave-search/search.js "query" --content               # Include page content as markdown
-skills/brave-search/search.js "query" --freshness pw          # Results from last week
-skills/brave-search/search.js "query" --freshness 2024-01-01to2024-06-30  # Date range
-skills/brave-search/search.js "query" --country DE            # Results from Germany
-skills/brave-search/search.js "query" -n 3 --content          # Combined options
-```
-
-### Options
-
-- `-n <num>` - Number of results (default: 5, max: 20)
-- `--content` - Fetch and include page content as markdown
-- `--country <code>` - Two-letter country code (default: US)
-- `--freshness <period>` - Filter by time:
-  - `pd` - Past day (24 hours)
-  - `pw` - Past week
-  - `pm` - Past month
-  - `py` - Past year
-  - `YYYY-MM-DDtoYYYY-MM-DD` - Custom date range
-
-## Extract Page Content
-
-```bash
-skills/brave-search/content.js https://example.com/article
-```
-
-Fetches a URL and extracts readable content as markdown.
-
-## Output Format
-
-```
---- Result 1 ---
-Title: Page Title
-Link: https://example.com/page
-Age: 2 days ago
-Snippet: Description from search results
-Content: (if --content flag used)
-  Markdown content extracted from the page...
-
---- Result 2 ---
-...
-```
-
-## When to Use
-
-- Searching for documentation or API references
-- Looking up facts or current information
-- Fetching content from specific URLs
-- Any task requiring web search without interactive browsing

package/templates/skills/brave-search/content.js

@@ -1,86 +0,0 @@
-#!/usr/bin/env node
-
-import { Readability } from "@mozilla/readability";
-import { JSDOM } from "jsdom";
-import TurndownService from "turndown";
-import { gfm } from "turndown-plugin-gfm";
-
-const url = process.argv[2];
-
-if (!url) {
-	console.log("Usage: content.js <url>");
-	console.log("\nExtracts readable content from a webpage as markdown.");
-	console.log("\nExamples:");
-	console.log("  content.js https://example.com/article");
-	console.log("  content.js https://doc.rust-lang.org/book/ch04-01-what-is-ownership.html");
-	process.exit(1);
-}
-
-function htmlToMarkdown(html) {
-	const turndown = new TurndownService({ headingStyle: "atx", codeBlockStyle: "fenced" });
-	turndown.use(gfm);
-	turndown.addRule("removeEmptyLinks", {
-		filter: (node) => node.nodeName === "A" && !node.textContent?.trim(),
-		replacement: () => "",
-	});
-	return turndown
-		.turndown(html)
-		.replace(/\[\\?\[\s*\\?\]\]\([^)]*\)/g, "")
-		.replace(/ +/g, " ")
-		.replace(/\s+,/g, ",")
-		.replace(/\s+\./g, ".")
-		.replace(/\n{3,}/g, "\n\n")
-		.trim();
-}
-
-try {
-	const response = await fetch(url, {
-		headers: {
-			"User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
-			"Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
-			"Accept-Language": "en-US,en;q=0.9",
-		},
-		signal: AbortSignal.timeout(15000),
-	});
-	
-	if (!response.ok) {
-		console.error(`HTTP ${response.status}: ${response.statusText}`);
-		process.exit(1);
-	}
-	
-	const html = await response.text();
-	const dom = new JSDOM(html, { url });
-	const reader = new Readability(dom.window.document);
-	const article = reader.parse();
-	
-	if (article && article.content) {
-		if (article.title) {
-			console.log(`# ${article.title}\n`);
-		}
-		console.log(htmlToMarkdown(article.content));
-		process.exit(0);
-	}
-	
-	// Fallback: try to extract main content
-	const fallbackDoc = new JSDOM(html, { url });
-	const body = fallbackDoc.window.document;
-	body.querySelectorAll("script, style, noscript, nav, header, footer, aside").forEach(el => el.remove());
-	
-	const title = body.querySelector("title")?.textContent?.trim();
-	const main = body.querySelector("main, article, [role='main'], .content, #content") || body.body;
-	
-	if (title) {
-		console.log(`# ${title}\n`);
-	}
-	
-	const text = main?.innerHTML || "";
-	if (text.trim().length > 100) {
-		console.log(htmlToMarkdown(text));
-	} else {
-		console.error("Could not extract readable content from this page.");
-		process.exit(1);
-	}
-} catch (e) {
-	console.error(`Error: ${e.message}`);
-	process.exit(1);
-}