abelworkflow 0.9.2 → 1.0.0

package/skills/dev-browser/package.json

@@ -2,30 +2,34 @@
   "name": "dev-browser",
   "version": "0.0.1",
   "type": "module",
-  "imports": {
-    "@/*": "./src/*"
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "npm@10.9.2",
+  "exports": {
+    "./client": {
+      "types": "./dist/src/client.d.ts",
+      "import": "./dist/src/client.js"
+    }
   },
   "scripts": {
-    "start-server": "npx tsx scripts/start.ts standalone",
-    "start-extension": "npx tsx scripts/start.ts extension",
-    "dev": "npx tsx --watch src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/scripts/start.js standalone",
+    "start-server": "node dist/scripts/start.js standalone",
+    "start-extension": "node dist/scripts/start.js extension",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@hono/node-server": "^1.19.7",
-    "@hono/node-ws": "^1.2.0",
-    "express": "^4.21.0",
-    "hono": "^4.11.1",
+    "@hono/node-server": "^1.19.13",
+    "@hono/node-ws": "^1.3.1",
+    "hono": "^4.12.30",
     "playwright": "^1.49.0"
   },
   "devDependencies": {
-    "@types/express": "^5.0.0",
-    "tsx": "^4.21.0",
+    "@types/node": "^22.0.0",
     "typescript": "^5.0.0",
     "vitest": "^2.1.0"
-  },
-  "optionalDependencies": {
-    "@rollup/rollup-linux-x64-gnu": "^4.0.0"
   }
 }

package/skills/dev-browser/references/scraping.md

@@ -17,57 +17,106 @@ Scrolling is slow, unreliable, and wastes time. APIs return structured data with
 
 This prevents wasting time debugging a complex script when the issue is a simple path like `data.user.timeline` vs `data.user.result.timeline`.
 
-## Step-by-Step Workflow
-
-### 1. Capture Request Details
-
-First, intercept a request to understand URL structure and required headers:
-
-```typescript
-import { connect, waitForPageLoad } from "@/client.js";
-import * as fs from "node:fs";
-
-const client = await connect();
-const page = await client.page("site");
-
-let capturedRequest = null;
-page.on("request", (request) => {
-  const url = request.url();
-  // Look for API endpoints (adjust pattern for your target site)
-  if (url.includes("/api/") || url.includes("/graphql/")) {
-    capturedRequest = {
-      url: url,
-      headers: request.headers(),
-      method: request.method(),
-    };
-    fs.writeFileSync("tmp/request-details.json", JSON.stringify(capturedRequest, null, 2));
-    console.log("Captured request:", url.substring(0, 80) + "...");
+## External Script Setup
+
+Keep the installed skill directory read-only. Put scripts and temporary artifacts in the OS temporary directory or the task workspace, and remove them when the task finishes. External scripts receive the installed skill directory as their first argument and dynamically import the compiled client by file URL.
+
+Never persist complete authentication headers. Keep captured headers in memory, and write only redacted metadata or final non-sensitive results.
+
+```javascript
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const skillDir = process.argv[2];
+if (!skillDir) throw new Error("Pass the installed dev-browser skill directory");
+const { connect, waitForPageLoad } = await import(
+  pathToFileURL(join(skillDir, "dist", "src", "client.js")).href
+);
+
+const workDir = await mkdtemp(join(tmpdir(), "dev-browser-scrape-"));
+let client;
+try {
+  client = await connect();
+  const page = await client.page("site");
+  let capturedRequest;
+
+  page.on("request", (request) => {
+    const url = request.url();
+    if (url.includes("/api/") || url.includes("/graphql/")) {
+      capturedRequest = {
+        url,
+        method: request.method(),
+        headers: request.headers(),
+      };
+    }
+  });
+
+  await page.goto("https://example.com/profile");
+  await waitForPageLoad(page);
+  await page.waitForTimeout(3000);
+
+  if (!capturedRequest) throw new Error("No matching API request captured");
+  const capturedUrl = new URL(capturedRequest.url);
+  console.log({
+    url: `${capturedUrl.origin}${capturedUrl.pathname}`,
+    method: capturedRequest.method,
+    headerNames: Object.keys(capturedRequest.headers),
+  });
+
+  const results = new Map();
+  let cursor;
+  do {
+    const params = { count: 20, ...(cursor ? { cursor } : {}) };
+    const url = new URL(capturedRequest.url);
+    url.searchParams.set("params", JSON.stringify(params));
+    const response = await page.evaluate(
+      async ({ url, headers }) => {
+        const result = await fetch(url, { headers });
+        return result.json();
+      },
+      { url: url.href, headers: capturedRequest.headers }
+    );
+
+    const entries = response?.data?.entries ?? [];
+    cursor = undefined;
+    for (const entry of entries) {
+      if (entry.type === "cursor-bottom") cursor = entry.value;
+      else if (entry.id) results.set(entry.id, entry);
+    }
+    await new Promise((resolve) => setTimeout(resolve, 500));
+  } while (cursor);
+
+  const resultPath = join(workDir, "results.json");
+  await writeFile(resultPath, JSON.stringify([...results.values()], null, 2));
+  console.log({ count: results.size, resultPath });
+} finally {
+  try {
+    await client?.disconnect();
+  } finally {
+    await rm(workDir, { recursive: true, force: true });
   }
-});
+}
+```
 
-await page.goto("https://example.com/profile");
-await waitForPageLoad(page);
-await page.waitForTimeout(3000);
+Run it with quoted paths on Linux, PowerShell, or Command Prompt:
 
-await client.disconnect();
+```text
+node "PATH_TO_SCRIPT.mjs" "PATH_TO_INSTALLED_DEV_BROWSER"
 ```
 
-### 2. Capture Response to Understand Schema
+If a result must survive the script, write the sanitized deliverable to the task workspace instead of `workDir`, then delete it at task completion unless the user asks to retain it.
 
-Save a raw response to inspect the data structure:
+## Step-by-Step Workflow
 
-```typescript
-page.on("response", async (response) => {
-  const url = response.url();
-  if (url.includes("UserTweets") || url.includes("/api/data")) {
-    const json = await response.json();
-    fs.writeFileSync("tmp/api-response.json", JSON.stringify(json, null, 2));
-    console.log("Captured response");
-  }
-});
-```
+### 1. Capture One Request
+
+Match a narrow API or GraphQL URL pattern. Keep the request URL and headers in memory. Log only the URL origin/path, method, and header names while confirming the endpoint; query parameters can contain credentials.
 
-Then analyze the structure to find:
+### 2. Inspect One Response
+
+Inspect the response in memory before building pagination. Find:
 
 - Where the data array lives (e.g., `data.user.result.timeline.instructions[].entries`)
 - Where pagination cursors are (e.g., `cursor-bottom` entries)
@@ -75,67 +124,7 @@ Then analyze the structure to find:
 
 ### 3. Replay API with Pagination
 
-Once you understand the schema, replay requests directly:
-
-```typescript
-import { connect } from "@/client.js";
-import * as fs from "node:fs";
-
-const client = await connect();
-const page = await client.page("site");
-
-const results = new Map(); // Use Map for deduplication
-const headers = JSON.parse(fs.readFileSync("tmp/request-details.json", "utf8")).headers;
-const baseUrl = "https://example.com/api/data";
-
-let cursor = null;
-let hasMore = true;
-
-while (hasMore) {
-  // Build URL with pagination cursor
-  const params = { count: 20 };
-  if (cursor) params.cursor = cursor;
-  const url = `${baseUrl}?params=${encodeURIComponent(JSON.stringify(params))}`;
-
-  // Execute fetch in browser context (has auth cookies/headers)
-  const response = await page.evaluate(
-    async ({ url, headers }) => {
-      const res = await fetch(url, { headers });
-      return res.json();
-    },
-    { url, headers }
-  );
-
-  // Extract data and cursor (adjust paths for your API)
-  const entries = response?.data?.entries || [];
-  for (const entry of entries) {
-    if (entry.type === "cursor-bottom") {
-      cursor = entry.value;
-    } else if (entry.id && !results.has(entry.id)) {
-      results.set(entry.id, {
-        id: entry.id,
-        text: entry.content,
-        timestamp: entry.created_at,
-      });
-    }
-  }
-
-  console.log(`Fetched page, total: ${results.size}`);
-
-  // Check stop conditions
-  if (!cursor || entries.length === 0) hasMore = false;
-
-  // Rate limiting - be respectful
-  await new Promise((r) => setTimeout(r, 500));
-}
-
-// Export results
-const data = Array.from(results.values());
-fs.writeFileSync("tmp/results.json", JSON.stringify(data, null, 2));
-console.log(`Saved ${data.length} items`);
-
-await client.disconnect();
-```
+Replay through `page.evaluate(fetch)` so the browser supplies its session cookies. Pass only the in-memory headers required by the endpoint, deduplicate with a `Map`, stop when the cursor or results end, and rate-limit requests.
 
 ## Key Patterns
 
@@ -149,7 +138,7 @@ await client.disconnect();
 
 ## Tips
 
-- **Extension mode**: `page.context().cookies()` doesn't work - capture auth headers from intercepted requests instead
+- **Extension mode**: `page.context().cookies()` doesn't work - keep intercepted auth headers in memory instead
 - **Rate limiting**: Add 500ms+ delays between requests to avoid blocks
 - **Stop conditions**: Check for empty results, missing cursor, or reaching a date/ID threshold
 - **GraphQL APIs**: URL params often include `variables` and `features` JSON objects - capture and reuse them

package/skills/grok-search/.env.example

@@ -6,9 +6,9 @@ GROK_API_URL=
 # 必填项：你的 API 密钥
 GROK_API_KEY=
 
-# 可选项：使用的 Grok 模型（默认：grok-4.20-auto）
-# 常用选项：grok-4.20-auto, grok-4-fast
-GROK_MODEL=grok-4.20-auto
+# 可选项：使用的 Grok 模型（默认：grok-4.20-non-reasoning）
+# 常用选项：grok-4.20-non-reasoning, grok-4.20-auto, grok-4-fast
+GROK_MODEL=grok-4.20-non-reasoning
 
 # 可选项：启用调试模式（true/false）
 GROK_DEBUG=false

package/skills/grok-search/SKILL.md

@@ -24,7 +24,7 @@ Use this skill for web search, webpage retrieval, and current-information lookup
 ```bash
 cp "<SKILL_DIR>/.env.example" "<SKILL_DIR>/.env"
 
-python "<SKILL_DIR>/scripts/groksearch_entry.py" web_search --query "search terms" [--platform "GitHub"] [--min-results 3] [--max-results 10] [--model "grok-4.20-auto"] [--extra-sources 3]
+python "<SKILL_DIR>/scripts/groksearch_entry.py" web_search --query "search terms" [--platform "GitHub"] [--min-results 3] [--max-results 10] [--model "grok-4.20-non-reasoning"] [--extra-sources 3]
 
 python "<SKILL_DIR>/scripts/groksearch_entry.py" web_fetch --url "https://..." [--out file.md] [--fallback-grok]
 

package/skills/grok-search/defaults.json

@@ -0,0 +1,3 @@
+{
+  "model": "grok-4.20-non-reasoning"
+}

package/skills/grok-search/gitignore.template

@@ -0,0 +1,4 @@
+GrokSearch_new/
+.env
+.venv/
+*__pycache__*

package/skills/grok-search/scripts/_dotenv.py

@@ -9,6 +9,7 @@ def load_dotenv() -> bool:
     if not env_path.exists():
         return False
     try:
+        seen_keys = set()
         with open(env_path, "r", encoding="utf-8") as f:
             for line in f:
                 line = line.strip()
@@ -21,7 +22,10 @@ def load_dotenv() -> bool:
                     value.startswith("'") and value.endswith("'")
                 ):
                     value = value[1:-1]
-                if key and not os.environ.get(key):
+                if not key or key in seen_keys:
+                    continue
+                seen_keys.add(key)
+                if not os.environ.get(key):
                     os.environ[key] = value
         return True
     except IOError:

package/skills/grok-search/scripts/groksearch_cli.py

@@ -15,6 +15,8 @@ from pathlib import Path
 from typing import Optional
 from urllib.parse import urlsplit, urlunsplit
 
+from _dotenv import load_dotenv
+
 try:
     import httpx
     from tenacity import AsyncRetrying, retry_if_exception, stop_after_attempt, wait_random_exponential
@@ -24,38 +26,6 @@ except ImportError:
     sys.exit(1)
 
 
-# ============================================================================
-# .env 文件支持
-# ============================================================================
-
-def load_dotenv() -> bool:
-    """从项目根目录的 .env 文件加载环境变量。"""
-    env_path = Path(__file__).parent.parent / ".env"
-    if env_path.exists():
-        try:
-            with open(env_path, 'r', encoding='utf-8') as f:
-                for line in f:
-                    line = line.strip()
-                    if not line or line.startswith('#'):
-                        continue
-                    if '=' in line:
-                        key, _, value = line.partition('=')
-                        key = key.strip()
-                        value = value.strip()
-                        # 如果存在引号则移除
-                        if (value.startswith('"') and value.endswith('"')) or \
-                           (value.startswith("'") and value.endswith("'")):
-                            value = value[1:-1]
-                        # 允许 .env 覆盖空字符串环境变量
-                        if key and not os.environ.get(key):
-                            os.environ[key] = value
-            return True
-        except IOError:
-            pass
-    return False
-
-
-# 模块导入时加载 .env
 load_dotenv()
 
 
@@ -63,9 +33,21 @@ load_dotenv()
 # 配置
 # ============================================================================
 
+def load_default_model() -> str:
+    defaults_path = Path(__file__).resolve().parent.parent / "defaults.json"
+    try:
+        defaults = json.loads(defaults_path.read_text(encoding="utf-8"))
+        model = defaults["model"]
+    except (OSError, json.JSONDecodeError, KeyError, TypeError) as error:
+        raise RuntimeError(f"无法读取 Grok 默认配置 {defaults_path}: {error}") from error
+    if not isinstance(model, str) or not model.strip():
+        raise RuntimeError(f"Grok 默认配置缺少有效 model: {defaults_path}")
+    return model
+
+
 class Config:
     _instance = None
-    _DEFAULT_MODEL = "grok-4.20-auto"
+    _DEFAULT_MODEL = load_default_model()
 
     def __new__(cls):
         if cls._instance is None:

package/skills/prompt-enhancer/SKILL.md

@@ -2,7 +2,6 @@
 name: prompt-enhancer
 description: |
   Rewrite a raw prompt into a clearer prompt for a coding agent. Use only when the user explicitly asks to improve, optimize, rewrite, or structure a prompt for Codex, Claude Code, Gemini CLI, or another AI agent. Triggers: "improve this prompt", "rewrite this prompt", "optimize this prompt for Codex", "make this prompt better for an AI agent".
-allowed-tools: Bash(python:*), Bash(python3:*), Bash(uv:*), Read, Grep
 ---
 
 # Prompt Enhancer
@@ -19,31 +18,7 @@ Do not use this for general writing edits like email, docs, or PR copy.
 
 ## Do
 
-- Default path: rewrite the prompt directly with the current agent using the structure from [TEMPLATE.md](TEMPLATE.md).
-- Third-party path: use the Python entrypoint only when the user explicitly provides `url`, `apiKey`, and `model`, or when all three are already configured in `<SKILL_DIR>/.env`.
-
-```bash
-python "<SKILL_DIR>/scripts/prompt_enhancer_entry.py" "user's raw prompt here"
-```
-
-- Do not call `scripts/enhance.py` directly.
-- Use the installed skill directory for `<SKILL_DIR>`.
-- If any of `url`, `apiKey`, or `model` is missing, do not invoke the script. Use the current agent directly instead.
-- Optional setup: `cp "<SKILL_DIR>/.env.example" "<SKILL_DIR>/.env"`
-
-## Output
-
-- Read the enhanced prompt from `stdout`.
-- Keep `stderr` for usage or optional debug output only.
+- Rewrite the prompt directly with the current agent, following the structure from [TEMPLATE.md](TEMPLATE.md).
 - Preserve the user's intent and explicit constraints.
 - Add structure and missing execution context only when it helps the agent act.
-- When running directly in the current agent, use placeholders for unknown context instead of inventing new requirements.
-
-## Notes
-
-- Local config file: `<SKILL_DIR>/.env`
-- The entrypoint auto-loads `<SKILL_DIR>/.env` before bootstrap and dependency install.
-- Optional debug flag: `PE_DEBUG=1`
-- Bootstrap controls: `PROMPT_ENHANCER_VENV_DIR`, `PROMPT_ENHANCER_PYTHON`, `AGENTS_SKILLS_PYTHON`
-- Setup and troubleshooting: [ADVANCED.md](ADVANCED.md)
-- Prompt template reference: [TEMPLATE.md](TEMPLATE.md)
+- Use placeholders for unknown context instead of inventing new requirements.

package/skills/prompt-enhancer/TEMPLATE.md

@@ -84,8 +84,4 @@ Identify and fix the sorting bug in the codebase.
 5. Add or update tests to cover the bug scenario
 
 # Constraints
-- Maintain backward compatibility
-- Do not change the function signature unless necessary
-- Add inline comments explaining the fix
 ```
-

package/.skill-lock.json

@@ -1,29 +0,0 @@
-{
-  "version": 3,
-  "skills": {
-    "git-commit": {
-      "source": "github/awesome-copilot",
-      "sourceType": "github",
-      "sourceUrl": "https://github.com/github/awesome-copilot.git",
-      "skillPath": "skills/git-commit/SKILL.md",
-      "skillFolderHash": "883a6a7466f55a9cd9f22cf1cce2d9333fc9b998",
-      "installedAt": "2026-03-12T08:25:08.313Z",
-      "updatedAt": "2026-03-12T08:25:08.313Z"
-    }
-  },
-  "dismissed": {
-    "findSkillsPrompt": true
-  },
-  "lastSelectedAgents": [
-    "amp",
-    "cline",
-    "codex",
-    "cursor",
-    "gemini-cli",
-    "github-copilot",
-    "kimi-cli",
-    "opencode",
-    "claude-code",
-    "crush"
-  ]
-}

package/AGENTS.md

@@ -1,45 +0,0 @@
-# Configuration
-
-## Language
-
-- Tool/model interactions: **English**
-- User-facing output: **Chinese**
-
-## Code Style
-
-- Concise, efficient, no redundancy
-- Minimal comments/docs (only when necessary)
-- Targeted changes only; never touch unrelated functionality
-
-## Context Rules
-
-- {{CODEBASE_RETRIEVAL_POLICY}}
-- Rely only on project code plus `grok/context7` results
-- If information is insufficient or uncertain, state it explicitly
-
-## Workflow
-
-```
-/abel-init → /abel-research → /abel-plan → /abel-implement(TDD)
-                                      ↘ /abel-diagnose (bug fix)
-```
-
-## Universal Constraints
-
-1. Use `unified diff patch` format for proposed/applied changes
-2. Require confidence ≥90% before applying changes
-
-## Stage Skill Matrix
-
-| Skill | Research | Plan | Implement | Diagnose | Capability & Triggers |
-| --- | :---: | :---: | :---: | :---: | --- |
-| /sequential-think | ✅ | ✅ | ❌ | ✅ | Multi-step reasoning, hypothesis testing. Trigger: 3+ interconnected components |
-| /grok-search | ✅ | ○ | ❌ | ✅ | Deep research, concept understanding. Trigger: architectural patterns, best practices |
-| /context7-auto-research | ✅ | ✅ | ✅ | ✅ | Official docs retrieval. Trigger: framework/library usage, APIs |
-| /dev-browser | ○ | ○ | ✅ | ✅ | Browser automation. Trigger: E2E testing, UI verification |
-| /confidence-check | ❌ | ✅ | ✅ | ✅ | Readiness verification. Trigger: before implementation/fix (≥90%) |
-| /time | ○ | ✅ | ✅ | ○ | Time/timezone operations. Trigger: scheduling logic |
-
-Legend: ✅ Primary, ○ Optional, ❌ Forbidden
-
-OpenSpec commands: `/opsx:new` `/opsx:ff` `/opsx:archive` `openspec view` `openspec status`