@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/web-development/cloudflare-temporary-deploy/scripts/parse_deploy_output.py

@@ -0,0 +1,122 @@
+#!/usr/bin/env python3
+"""Parse `wrangler deploy --temporary` output into structured JSON.
+
+Reads wrangler's stdout/stderr from STDIN and extracts the live workers.dev
+URL, the claim URL, the temporary account name/state, the claim window, and
+whether a deploy actually happened. Stdlib only — no dependencies.
+
+Usage:
+    npx wrangler@latest deploy --temporary 2>&1 | python3 parse_deploy_output.py
+    python3 parse_deploy_output.py --selftest
+"""
+
+from __future__ import annotations
+
+import json
+import re
+import sys
+
+# 匹配实时 workers.dev URL（subdomain.subdomain.workers.dev）。
+_LIVE_URL = re.compile(r"https://[A-Za-z0-9._-]+\.workers\.dev\S*")
+# 匹配领取 URL。Cloudflare 使用 dash.cloudflare.com/claim-preview?claimToken=...
+# 保持足够宽泛，以应对细微的路径更改，同时仍然需要领取令牌。
+_CLAIM_URL = re.compile(r"https://\S*claim\S*claimToken=\S+", re.IGNORECASE)
+# "Account: Serene Temple (created)"  /  "Account:  example-name (reused)"
+# 账户名可以包含空格（例如 "Serene Temple"），因此捕获所有内容
+# 直到末尾的 "(state)" 标记，而不是单个标记。
+_ACCOUNT = re.compile(
+    r"Account:\s*(?P<name>.+?)\s*\((?P<state>created|reused)\)", re.IGNORECASE
+)
+# "Claim within:   60 minutes"
+_CLAIM_WITHIN = re.compile(r"Claim within:\s*(?P<minutes>\d+)\s*minutes?", re.IGNORECASE)
+# 成功的部署会打印一行 "Deployed" / "Uploaded"。
+_DEPLOYED = re.compile(r"^\s*(Deployed|Uploaded)\b", re.IGNORECASE | re.MULTILINE)
+
+
+def _first(pattern: re.Pattern, text: str) -> str | None:
+    m = pattern.search(text)
+    if not m:
+        return None
+    # 去除在日志行中经常紧贴在 URL 末尾的标点符号。
+    return m.group(0).rstrip(".,);]")
+
+
+def parse(text: str) -> dict:
+    """Extract deploy facts from wrangler output text."""
+    account = _ACCOUNT.search(text)
+    claim_within = _CLAIM_WITHIN.search(text)
+    return {
+        "live_url": _first(_LIVE_URL, text),
+        "claim_url": _first(_CLAIM_URL, text),
+        "account": account.group("name") if account else None,
+        "account_state": account.group("state").lower() if account else None,
+        "expires_minutes": int(claim_within.group("minutes")) if claim_within else None,
+        "deployed": bool(_DEPLOYED.search(text)),
+    }
+
+
+_SAMPLE = """\
+Continuing means you accept Cloudflare's Terms of Service and Privacy Policy.
+
+Temporary account ready:
+     Account:        example-name (created)
+     Claim within:   60 minutes
+     Claim URL:      https://dash.cloudflare.com/claim-preview?claimToken=abc123XYZ
+
+Uploaded example-worker
+Deployed example-worker triggers
+     https://example-worker.example-name.workers.dev
+"""
+
+_SAMPLE_REUSED = """\
+Temporary account ready:
+     Account:        example-name (reused)
+     Claim within:   42 minutes
+     Claim URL:      https://dash.cloudflare.com/claim-preview?claimToken=def456
+Deployed example-worker triggers
+     https://example-worker.example-name.workers.dev
+"""
+
+_SAMPLE_NO_TEMP = """\
+✘ [ERROR] You are not logged in.
+
+To continue without logging in, rerun this command with `--temporary`.
+"""
+
+
+def _selftest() -> int:
+    r = parse(_SAMPLE)
+    assert r["live_url"] == "https://example-worker.example-name.workers.dev", r
+    assert r["claim_url"] == "https://dash.cloudflare.com/claim-preview?claimToken=abc123XYZ", r
+    assert r["account"] == "example-name", r
+    assert r["account_state"] == "created", r
+    assert r["expires_minutes"] == 60, r
+    assert r["deployed"] is True, r
+
+    r2 = parse(_SAMPLE_REUSED)
+    assert r2["account_state"] == "reused", r2
+    assert r2["expires_minutes"] == 42, r2
+    assert r2["deployed"] is True, r2
+
+    r3 = parse(_SAMPLE_NO_TEMP)
+    assert r3["live_url"] is None, r3
+    assert r3["claim_url"] is None, r3
+    assert r3["account"] is None, r3
+    assert r3["deployed"] is False, r3
+
+    print("selftest: OK")
+    return 0
+
+
+def main(argv: list[str]) -> int:
+    if "--selftest" in argv:
+        return _selftest()
+    text = sys.stdin.read()
+    result = parse(text)
+    print(json.dumps(result, indent=2))
+    # 如果未找到实时 URL 则以非零状态码退出，以便调用者进行相应的分支处理。
+    return 0 if result["live_url"] else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv[1:]))

package/extensions/skills/optional/web-development/page-agent/SKILL.md

@@ -0,0 +1,190 @@
+---
+name: page-agent
+description: 将 alibaba/page-agent 嵌入到你自己的 Web 应用中 —— 这是一个纯 JavaScript 的页内 GUI agent，以单个 <script> 标签或 npm 包的形式提供，允许你网站的用户通过自然语言驱动 UI（“点击登录，将用户名填写为 John”）。无需 Python、无需 headless 浏览器、无需扩展。当用户是 Web 开发者，且希望在其 SaaS / 管理面板 / B2B 工具中添加 AI copilot，希望通过自然语言使传统的 Web 应用更具可访问性，或者希望在本地 (Ollama) 或云端 (Qwen / OpenAI / OpenRouter) LLM 上评估 page-agent 时，请使用此 skill。不适用于服务端浏览器自动化 —— 请将此类用户引导至 Hermes 内置的浏览器工具。
+version: 1.0.0
+author: Hermes Agent
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [web, javascript, agent, browser, gui, alibaba, embed, copilot, saas]
+    category: web-development
+---
+
+# page-agent
+
+alibaba/page-agent (https://github.com/alibaba/page-agent, 17k+ stars, MIT) 是一个使用 TypeScript 编写的页内 GUI agent。它运行在网页内部，将 DOM 作为文本读取（无需截图，无需多模态 LLM），并在当前页面上执行诸如“点击登录按钮，然后将用户名填写为 John”的自然语言指令。纯客户端实现 —— 宿主网站只需引入一个脚本，并传入一个兼容 OpenAI 的 LLM endpoint 即可。
+
+## 何时使用此 skill
+
+当用户有以下需求时加载此 skill：
+
+- **在自己的 Web 应用中集成 AI copilot**（SaaS、管理面板、B2B 工具、ERP、CRM）—— “我控制面板上的用户应该能够输入‘为 Acme Corp 创建发票并将其作为邮件发送’，而不是点击穿过五个屏幕”
+- **实现传统 Web 应用的现代化**，且无需重写前端 —— page-agent 可直接在现有 DOM 之上运行
+- **通过自然语言增加可访问性** —— 语音 / 屏幕阅读器用户可以通过描述他们想要的内容来驱动 UI
+- **演示或评估 page-agent**，可对接本地 (Ollama) 或托管 (Qwen, OpenAI, OpenRouter) LLM
+- **构建交互式培训 / 产品演示** —— 让 AI 在真实的 UI 中向用户实时演示“如何提交费用报告”
+
+## 何时不适用此 skill
+
+- 用户希望 **Hermes 本身去驱动浏览器** → 使用 Hermes 内置的浏览器工具 (Browserbase / Camofox)。page-agent 的方向正好*相反*。
+- 用户希望 **在不嵌入的情况下进行跨标签页自动化** → 使用 Playwright、browser-use 或 page-agent Chrome 扩展
+- 用户需要 **视觉定位 / 截图** → page-agent 仅支持基于文本的 DOM；请改用多模态浏览器 agent
+
+## 前置条件
+
+- Node 22.13+ 或 24+，npm 10+（文档声称需要 11+，但 10.9 也能正常工作）
+- 兼容 OpenAI 的 LLM endpoint：Qwen (DashScope)、OpenAI、Ollama、OpenRouter，或任何支持 `/v1/chat/completions` 的平台
+- 带有开发者工具的浏览器（用于调试）
+
+## 路径 1 —— 通过 CDN 进行 30 秒演示（无需安装）
+
+查看其运行效果的最快方式。使用 alibaba 免费的测试 LLM 代理 —— **仅供评估**，受制于其服务条款。
+
+添加到任何 HTML 页面（或者作为 bookmarklet 粘贴到开发者工具控制台中）：
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/page-agent@1.8.0/dist/iife/page-agent.demo.js" crossorigin="true"></script>
+```
+
+会出现一个面板。输入指令。完成。
+
+Bookmarklet 形式（拖放到书签栏，在任何页面点击）：
+
+```javascript
+javascript:(function(){var s=document.createElement('script');s.src='https://cdn.jsdelivr.net/npm/page-agent@1.8.0/dist/iife/page-agent.demo.js';document.head.appendChild(s);})();
+```
+
+## 路径 2 —— npm install 到你自己的 Web 应用（生产环境使用）
+
+在现有的 Web 项目中 (React / Vue / Svelte / 原生)：
+
+```bash
+npm install page-agent
+```
+
+与你自己的 LLM endpoint 进行对接 —— **切勿将 demo CDN 发布给真实用户**：
+
+```javascript
+import { PageAgent } from 'page-agent'
+
+const agent = new PageAgent({
+    model: 'qwen3.5-plus',
+    baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+    apiKey: process.env.LLM_API_KEY,   // 绝不硬编码
+    language: 'en-US',
+})
+
+// 为终端用户显示面板：
+agent.panel.show()
+
+// 或者以编程方式驱动它：
+await agent.execute('Click submit button, then fill username as John')
+```
+
+Provider 示例（任何兼容 OpenAI 的 endpoint 均可工作）：
+
+| Provider | `baseURL` | `model` |
+| ---------- | ----------- | --------- |
+| Qwen / DashScope | `https://dashscope.aliyuncs.com/compatible-mode/v1` | `qwen3.5-plus` |
+| OpenAI | `https://api.openai.com/v1` | `gpt-4o-mini` |
+| Ollama (local) | `http://localhost:11434/v1` | `qwen3:14b` |
+| OpenRouter | `https://openrouter.ai/api/v1` | `anthropic/claude-sonnet-4.6` |
+
+**关键配置字段**（传给 `new PageAgent({...})`）：
+
+- `model`, `baseURL`, `apiKey` —— LLM 连接
+- `language` —— UI 语言 (`en-US`, `zh-CN` 等)
+- 存在 Allowlist 和 data-masking hooks 用于限制 agent 可以触碰的内容 —— 完整选项列表请参见 https://alibaba.github.io/page-agent/
+
+**安全性。** 在真实的部署环境中，不要将你的 `apiKey` 放在客户端代码中 —— 请通过你的后端代理 LLM 调用，并将 `baseURL` 指向你的代理。演示 CDN 之所以存在，是因为 alibaba 运行了该代理以供评估使用。
+
+## 路径 3 —— 克隆源码仓库（用于贡献代码或进行深度定制）
+
+当用户想要修改 page-agent 本身，通过本地 IIFE bundle 在任意站点上测试它，或开发浏览器扩展时，请使用此路径。
+
+```bash
+git clone https://github.com/alibaba/page-agent.git
+cd page-agent
+npm ci              # 按照 lockfile 精确安装（或使用 `npm i` 允许更新）
+```
+
+在仓库根目录创建带有 LLM endpoint 的 `.env` 文件。示例：
+
+```
+LLM_MODEL_NAME=gpt-4o-mini
+LLM_API_KEY=sk-...
+LLM_BASE_URL=https://api.openai.com/v1
+```
+
+Ollama 配置形式：
+
+```
+LLM_BASE_URL=http://localhost:11434/v1
+LLM_API_KEY=NA
+LLM_MODEL_NAME=qwen3:14b
+```
+
+常用命令：
+
+```bash
+npm start           # 文档/网站开发服务器
+npm run build       # 构建每个包
+npm run dev:demo    # 在 http://localhost:5174/page-agent.demo.js 提供 IIFE bundle
+npm run dev:ext     # 开发浏览器扩展 (WXT + React)
+npm run build:ext   # 构建扩展
+```
+
+使用本地 IIFE bundle **在任何网站上进行测试**。添加此 bookmarklet：
+
+```javascript
+javascript:(function(){var s=document.createElement('script');s.src=`http://localhost:5174/page-agent.demo.js?t=${Math.random()}`;s.onload=()=>console.log('PageAgent ready!');document.head.appendChild(s);})();
+```
+
+然后：运行 `npm run dev:demo`，在任何页面上点击 bookmarklet，本地构建版本就会被注入。保存时会自动重新构建。
+
+**警告：** 在开发构建期间，你的 `.env` `LLM_API_KEY` 会被内联到 IIFE bundle 中。不要分享该 bundle。不要提交它。不要将该 URL 粘贴到 Slack 中。（已验证：在公开的开发 bundle 中 grep 搜索会返回 `.env` 中的字面值。）
+
+## 仓库结构（路径 3）
+
+使用 npm workspaces 的 Monorepo。关键包：
+
+| Package | Path | Purpose |
+| --------- | ------ | --------- |
+| `page-agent` | `packages/page-agent/` | 主入口，包含 UI 面板 |
+| `@page-agent/core` | `packages/core/` | 核心 agent 逻辑，无 UI |
+| `@page-agent/mcp` | `packages/mcp/` | MCP server (beta) |
+| — | `packages/llms/` | LLM client |
+| — | `packages/page-controller/` | DOM ops + visual feedback |
+| — | `packages/ui/` | Panel + i18n |
+| — | `packages/extension/` | Chrome/Firefox extension |
+| — | `packages/website/` | Docs + landing site |
+
+## 验证是否生效
+
+路径 1 或 路径 2 之后：
+1. 在浏览器中打开开发者工具，然后在打开页面的情况下进行查看
+2. 你应该会看到一个浮动面板。如果没有，请检查控制台是否有错误（最常见：LLM endpoint 的 CORS 问题、`baseURL` 错误或 API key 无效）
+3. 输入一个与页面上可见内容匹配的简单指令（“点击登录链接”）
+4. 观察 Network 选项卡 —— 你应该会看到发往你的 `baseURL` 的请求
+
+路径 3 之后：
+1. `npm run dev:demo` 会输出 `Accepting connections at http://localhost:5174`
+2. `curl -I http://localhost:5174/page-agent.demo.js` 返回带有 `Content-Type: application/javascript` 的 `HTTP/1.1 200 OK`
+3. 在任何网站上点击 bookmarklet；面板出现
+
+## 避坑指南
+
+- **在生产环境使用 Demo CDN** —— 千万别这么做。它有速率限制，使用的是 alibaba 的免费代理，且他们的条款禁止将其用于生产环境。
+- **API key 泄露** —— 任何传给 `new PageAgent({apiKey: ...})` 的 key 都会包含在你的 JS bundle 中。对于真实的部署环境，请务必通过你自己的后端进行代理。
+- **非兼容 OpenAI 的 endpoint** 会静默失败或报出难以理解的错误。如果你的 provider 需要原生的 Anthropic/Gemini 格式，请在前面使用 OpenAI 兼容代理（LiteLLM、OpenRouter）。
+- **CSP 阻止** —— 具有严格 Content-Security-Policy 的网站可能会拒绝加载 CDN 脚本或不允许内联 eval。在这种情况下，请从你的源进行自托管。
+- 在路径 3 中编辑 `.env` 后 **重启开发服务器** —— Vite 仅在启动时读取环境变量。
+- **Node 版本** —— 该仓库声明需要 `^22.13.0 || >=24`。Node 20 会因为引擎错误导致 `npm ci` 失败。
+- **npm 10 vs 11** —— 文档说需要 npm 11+；实际上 npm 10.9 也能正常工作。
+
+## 参考信息
+
+- 仓库: https://github.com/alibaba/page-agent
+- 文档: https://alibaba.github.io/page-agent/
+- 许可证: MIT (基于 browser-use 的 DOM 处理内部机制构建，Copyright 2024 Gregor Zunic)

package/interfaces/__init__.py

@@ -0,0 +1 @@
+"""Interface surfaces: CLI / API / gateway / web."""

package/interfaces/api/__init__.py

@@ -0,0 +1 @@
+from interfaces.api._impl.server import *  # noqa: F401,F403

package/interfaces/api/_impl/_models.py

@@ -0,0 +1,105 @@
+from __future__ import annotations
+from typing import Any, Optional
+from pydantic import BaseModel, Field
+
+
+class ModelSelection(BaseModel):
+    provider: str
+    model: str
+
+
+class AgentModelSelection(BaseModel):
+    provider: str
+    model: str
+
+
+class AgentConfigMutation(BaseModel):
+    """用于 PATCH /api/agents/{name}/config"""
+    description: Optional[str] = None
+    verification: Optional[str] = None
+    display_name: Optional[str] = None
+    provider: Optional[str] = None
+    model: Optional[str] = None
+    system_prompt: Optional[str] = None
+    tools: Optional[list[str]] = None
+    guardrails: Optional[list[str]] = None
+    verification_rules: Optional[list[str]] = None
+    fallback_models: Optional[list[str]] = None
+    verification_level: Optional[str] = None
+    error_strategy: Optional[str] = None
+    timeout: Optional[int] = None
+    max_retries: Optional[int] = None
+    prompt_file: Optional[str] = None
+    allowed_models: Optional[list[str]] = None
+    max_iterations: Optional[int] = None
+    temperature: Optional[float] = None
+    enabled: Optional[bool] = None
+
+
+class McpServerMutation(BaseModel):
+    name: Optional[str] = None
+    command: Optional[str] = None
+    args: Optional[list[str]] = None
+    env: Optional[dict[str, str]] = None
+    transport: Optional[str] = None
+    url: Optional[str] = None
+    description: Optional[str] = None
+    enabled: Optional[bool] = True
+
+
+class McpToggleMutation(BaseModel):
+    enabled: Optional[bool] = None
+
+
+class McpConnectMutation(BaseModel):
+    refresh: bool = False
+
+
+class CronCreate(BaseModel):
+    name: str
+    schedule: str
+    agent: str
+    task: str
+    context: str = ""
+
+
+class SessionCreate(BaseModel):
+    title: str
+
+
+class ChatRequest(BaseModel):
+    """统一聊天接口请求 — POST 一次完成 session 创建/复用 + 消息发送 + 结果返回"""
+    message: str
+    session_id: str = ""
+    agent: str = "chat"
+    think_mode: bool = False
+    deep_search: bool = False
+
+
+class ProviderMutation(BaseModel):
+    """用于 PUT /api/providers/{name}"""
+    display_name: Optional[str] = None
+    base_url: Optional[str] = None
+    api_mode: Optional[str] = None
+    api_key: Optional[str] = None
+    api_keys: Optional[list[str]] = None
+    models: Optional[list[str]] = None
+    max_retries: Optional[int] = None
+    request_timeout: Optional[int] = None
+    description: Optional[str] = None
+    enabled: Optional[bool] = None
+
+
+class ModelAddition(BaseModel):
+    name: str
+
+
+class SoulCreatePayload(BaseModel):
+    name: str
+    content: str = ""  # HTML from TipTap editor
+
+
+class SkillPatch(BaseModel):
+    visibility: Optional[str] = None
+    description: Optional[str] = None
+    assigned_agents: Optional[list[str]] = None