@flrande/browserctl 0.5.0 → 0.6.0

package/INSTALL.md

@@ -1,92 +0,0 @@
-# Install browserctl Skills
-
-English | [简体中文](INSTALL-CN.md)
-
-This repository publishes one default installable skill:
-
-- `skills/browserctl`
-
-## Primary Agent Prompt
-
-Paste this to your agent:
-
-```text
-Fetch and follow instructions from https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/INSTALL.md
-```
-
-## Platform Guides
-
-- Codex: `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.codex/INSTALL.md`
-- Claude Code: `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.claude-plugin/INSTALL.md`
-- Cursor: `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.cursor-plugin/INSTALL.md`
-- OpenCode: `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.opencode/INSTALL.md`
-
-## Update After Install
-
-Recommended default: use repository-synced updates so skill, extension, and CLI stay aligned.
-
-PowerShell 7:
-
-```powershell
-$repoPath = Join-Path $env:USERPROFILE ".codex\\browserctl" # adjust to your local clone path
-
-git -C $repoPath pull --ff-only
-npm install --global "$repoPath"
-
-browserctl daemon-stop --json
-browserctl daemon-start --json
-```
-
-Bash:
-
-```bash
-repoPath="$HOME/.codex/browserctl" # adjust to your local clone path
-
-git -C "$repoPath" pull --ff-only
-npm install --global "$repoPath"
-
-browserctl daemon-stop --json
-browserctl daemon-start --json
-```
-
-Reload the extension in `edge://extensions` or `chrome://extensions` after pulling:
-
-1. Open extension management page.
-2. Find `BrowserCtl Relay`.
-3. Click `Reload`.
-
-Verify:
-
-PowerShell 7:
-
-```powershell
-browserctl status --json --session relay --profile chrome-relay
-Invoke-WebRequest -UseBasicParsing -Uri "http://127.0.0.1:9223/browserctl/relay/status" -TimeoutSec 3
-```
-
-Bash:
-
-```bash
-browserctl status --json --session relay --profile chrome-relay
-curl --fail --max-time 3 "http://127.0.0.1:9223/browserctl/relay/status"
-```
-
-Optional fallback (not the default): update CLI from npm registry only.
-
-PowerShell 7:
-
-```powershell
-npm install --global @flrande/browserctl@latest
-```
-
-Bash:
-
-```bash
-npm install --global @flrande/browserctl@latest
-```
-
-## Fallback Contract
-
-If platform-specific install is unavailable, agents should fetch and follow:
-
-- `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/skills/browserctl/SKILL.md`

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 browserctl contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README-CN.md

@@ -1,69 +0,0 @@
-# browserctl
-
-[English](README.md) | 简体中文
-
-面向 coding agent 的扩展优先浏览器控制工具集。
-
-## 给 Agent 安装
-
-把下面文本贴给 agent：
-
-```text
-请抓取并遵循 https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/INSTALL.md 中的说明。
-```
-
-平台快捷入口：
-
-- Codex：`https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.codex/INSTALL.md`
-- Claude Code：`https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.claude-plugin/INSTALL.md`
-- Cursor：`https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.cursor-plugin/INSTALL.md`
-- OpenCode：`https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.opencode/INSTALL.md`
-
-默认 skill：
-
-- 名称：`browserctl`
-- 路径：`skills/browserctl`
-
-## 浏览器快速开始（扩展默认）
-
-PowerShell 7：
-
-```powershell
-npm install --global @flrande/browserctl
-
-$env:BROWSERD_DEFAULT_DRIVER = "chrome-relay"
-$env:BROWSERD_CHROME_RELAY_MODE = "extension"
-$env:BROWSERD_CHROME_RELAY_URL = "http://127.0.0.1:9223"
-$env:BROWSERD_CHROME_RELAY_EXTENSION_TOKEN = "browserctl-relay"
-
-browserctl daemon-stop --json
-browserctl daemon-start --json
-browserctl status --json --session relay --profile chrome-relay
-```
-
-Bash：
-
-```bash
-npm install --global @flrande/browserctl
-
-export BROWSERD_DEFAULT_DRIVER="chrome-relay"
-export BROWSERD_CHROME_RELAY_MODE="extension"
-export BROWSERD_CHROME_RELAY_URL="http://127.0.0.1:9223"
-export BROWSERD_CHROME_RELAY_EXTENSION_TOKEN="browserctl-relay"
-
-browserctl daemon-stop --json
-browserctl daemon-start --json
-browserctl status --json --session relay --profile chrome-relay
-```
-
-## 完整文档
-
-- [Install Guide (English)](INSTALL.md)
-- [安装指南（中文）](INSTALL-CN.md)
-- [User Guide (English)](docs/user-guide.md)
-- [使用指南（中文）](docs/user-guide-cn.md)
-- 安装后更新（skill + 扩展 + CLI）：[使用指南](docs/user-guide-cn.md)、[CLI 参考](docs/cli-reference-cn.md)
-- [CLI Reference (English)](docs/cli-reference.md)
-- [CLI 参考（中文）](docs/cli-reference-cn.md)
-- [Maintainer Onboarding (English)](docs/maintainer-onboarding.md)
-- [维护者上手文档（中文）](docs/maintainer-onboarding-cn.md)

package/README.md

@@ -1,69 +0,0 @@
-# browserctl
-
-English | [简体中文](README-CN.md)
-
-Extension-first browser control toolkit for coding agents.
-
-## Install In Agents
-
-Paste this to your agent:
-
-```text
-Fetch and follow instructions from https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/INSTALL.md
-```
-
-Platform shortcuts:
-
-- Codex: `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.codex/INSTALL.md`
-- Claude Code: `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.claude-plugin/INSTALL.md`
-- Cursor: `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.cursor-plugin/INSTALL.md`
-- OpenCode: `https://raw.githubusercontent.com/Flrande/browserctl/refs/heads/master/.opencode/INSTALL.md`
-
-Default skill:
-
-- Name: `browserctl`
-- Path: `skills/browserctl`
-
-## Browser Quick Start (Extension Default)
-
-PowerShell 7:
-
-```powershell
-npm install --global @flrande/browserctl
-
-$env:BROWSERD_DEFAULT_DRIVER = "chrome-relay"
-$env:BROWSERD_CHROME_RELAY_MODE = "extension"
-$env:BROWSERD_CHROME_RELAY_URL = "http://127.0.0.1:9223"
-$env:BROWSERD_CHROME_RELAY_EXTENSION_TOKEN = "browserctl-relay"
-
-browserctl daemon-stop --json
-browserctl daemon-start --json
-browserctl status --json --session relay --profile chrome-relay
-```
-
-Bash:
-
-```bash
-npm install --global @flrande/browserctl
-
-export BROWSERD_DEFAULT_DRIVER="chrome-relay"
-export BROWSERD_CHROME_RELAY_MODE="extension"
-export BROWSERD_CHROME_RELAY_URL="http://127.0.0.1:9223"
-export BROWSERD_CHROME_RELAY_EXTENSION_TOKEN="browserctl-relay"
-
-browserctl daemon-stop --json
-browserctl daemon-start --json
-browserctl status --json --session relay --profile chrome-relay
-```
-
-## Full Docs
-
-- [Install Guide (English)](INSTALL.md)
-- [安装指南（中文）](INSTALL-CN.md)
-- [User Guide (English)](docs/user-guide.md)
-- [使用指南（中文）](docs/user-guide-cn.md)
-- Update after install (skill + extension + CLI): [User Guide](docs/user-guide.md), [CLI Reference](docs/cli-reference.md)
-- [CLI Reference (English)](docs/cli-reference.md)
-- [CLI 参考（中文）](docs/cli-reference-cn.md)
-- [Maintainer Onboarding (English)](docs/maintainer-onboarding.md)
-- [维护者上手文档（中文）](docs/maintainer-onboarding-cn.md)

package/apps/browserctl/src/commands/a11y-snapshot.ts

@@ -1,20 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type A11ySnapshotCommandResult = Record<string, unknown>;
-
-export async function runA11ySnapshotCommand(args: string[]): Promise<A11ySnapshotCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-  const selector = context.positional[1];
-
-  return await callDaemonTool<A11ySnapshotCommandResult>(
-    "browser.a11y.snapshot",
-    buildToolArguments(context, {
-      targetId,
-      ...(typeof selector === "string" && selector.trim().length > 0
-        ? { selector: selector.trim() }
-        : {})
-    })
-  );
-}

package/apps/browserctl/src/commands/act.test.ts

@@ -1,71 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-
-const { callDaemonToolMock } = vi.hoisted(() => ({
-  callDaemonToolMock: vi.fn()
-}));
-
-vi.mock("../daemon-client", () => ({
-  callDaemonTool: callDaemonToolMock
-}));
-
-import { runActCommand } from "./act";
-
-afterEach(() => {
-  callDaemonToolMock.mockReset();
-});
-
-describe("runActCommand", () => {
-  it("forwards --payload-json into action payload", async () => {
-    callDaemonToolMock.mockResolvedValue({
-      ok: true
-    });
-
-    await runActCommand([
-      "click",
-      "target:1",
-      "--payload-json",
-      "{\"selector\":\"#submit\",\"delayMs\":200}"
-    ]);
-
-    expect(callDaemonToolMock).toHaveBeenCalledTimes(1);
-    expect(callDaemonToolMock).toHaveBeenCalledWith("browser.act", {
-      sessionId: "cli:local",
-      targetId: "target:1",
-      action: {
-        type: "click",
-        payload: {
-          selector: "#submit",
-          delayMs: 200
-        }
-      }
-    });
-  });
-
-  it("throws when --payload-json value is missing", async () => {
-    await expect(runActCommand(["click", "target:1", "--payload-json"])).rejects.toThrow(
-      "Missing value for --payload-json."
-    );
-    expect(callDaemonToolMock).not.toHaveBeenCalled();
-  });
-
-  it("throws when --payload-json is invalid JSON", async () => {
-    await expect(
-      runActCommand(["click", "target:1", "--payload-json", "{not-json}"])
-    ).rejects.toThrow("Invalid JSON for --payload-json:");
-    expect(callDaemonToolMock).not.toHaveBeenCalled();
-  });
-
-  it("throws when --payload-json is not a JSON object", async () => {
-    await expect(runActCommand(["click", "target:1", "--payload-json", "[1,2,3]"])).rejects.toThrow(
-      "--payload-json must decode to a JSON object."
-    );
-    expect(callDaemonToolMock).not.toHaveBeenCalled();
-  });
-
-  it("throws on unknown act options", async () => {
-    await expect(runActCommand(["click", "target:1", "--payload", "{}"])).rejects.toThrow(
-      "Unknown act option: --payload"
-    );
-    expect(callDaemonToolMock).not.toHaveBeenCalled();
-  });
-});

package/apps/browserctl/src/commands/act.ts

@@ -1,64 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type ActCommandResult = Record<string, unknown>;
-
-function isObjectRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function parseActPayload(tokens: string[]): Record<string, unknown> | undefined {
-  let payloadJson: string | undefined;
-
-  for (let index = 0; index < tokens.length; index += 1) {
-    const token = tokens[index];
-    if (token === "--payload-json") {
-      const value = tokens[index + 1];
-      if (value === undefined) {
-        throw new Error("Missing value for --payload-json.");
-      }
-
-      payloadJson = value;
-      index += 1;
-      continue;
-    }
-
-    throw new Error(`Unknown act option: ${token}`);
-  }
-
-  if (payloadJson === undefined) {
-    return undefined;
-  }
-
-  let parsedPayload: unknown;
-  try {
-    parsedPayload = JSON.parse(payloadJson);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Invalid JSON for --payload-json: ${message}`);
-  }
-
-  if (!isObjectRecord(parsedPayload)) {
-    throw new Error("--payload-json must decode to a JSON object.");
-  }
-
-  return parsedPayload;
-}
-
-export async function runActCommand(args: string[]): Promise<ActCommandResult> {
-  const context = parseCommandContext(args);
-  const actionType = requirePositionalArg(context, 0, "actionType");
-  const targetId = requirePositionalArg(context, 1, "targetId");
-  const payload = parseActPayload(context.positional.slice(2));
-
-  return await callDaemonTool<ActCommandResult>(
-    "browser.act",
-    buildToolArguments(context, {
-      targetId,
-      action: {
-        type: actionType,
-        ...(payload !== undefined ? { payload } : {})
-      }
-    })
-  );
-}