@docyrus/docyrus 0.0.59 → 0.0.60

package/resources/browser-tools/browser-connect.js

@@ -1,172 +0,0 @@
-/**
- * Shared browser connection module.
- *
- * Reads `.docyrus/browser.json` (or DOCYRUS_BROWSER_SANDBOX env) to decide
- * between local Chrome on :9222 and a remote Cloudflare Browser Rendering
- * session. Remote sessions are cached in `.docyrus/browser-session.json` and
- * reused until they expire.
- *
- * Exports:
- *   connectBrowser()  → { browser, mode, session }
- *   isSandboxMode()   → boolean
- *   getSessionInfo()  → cached session object | null
- */
-
-import puppeteer from "puppeteer-core";
-import { spawnSync } from "node:child_process";
-import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-
-const DOCYRUS_DIR = ".docyrus";
-const BROWSER_CONFIG_FILE = "browser.json";
-const BROWSER_SESSION_FILE = "browser-session.json";
-const LOCAL_TIMEOUT_MS = 5_000;
-const REMOTE_TIMEOUT_MS = 30_000;
-const SESSION_EXPIRY_BUFFER_MS = 30_000;
-
-function resolveDocyrusDir() {
-  return join(process.cwd(), DOCYRUS_DIR);
-}
-
-function readJsonFile(filePath) {
-  try {
-    return JSON.parse(readFileSync(filePath, "utf8"));
-  } catch {
-    return null;
-  }
-}
-
-function writeJsonFile(filePath, data) {
-  const dir = join(filePath, "..");
-  mkdirSync(dir, { recursive: true, mode: 0o700 });
-  writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", {
-    encoding: "utf8",
-    mode: 0o600,
-  });
-}
-
-function readBrowserConfig() {
-  return readJsonFile(join(resolveDocyrusDir(), BROWSER_CONFIG_FILE));
-}
-
-function readCachedSession() {
-  return readJsonFile(join(resolveDocyrusDir(), BROWSER_SESSION_FILE));
-}
-
-function writeCachedSession(session) {
-  writeJsonFile(join(resolveDocyrusDir(), BROWSER_SESSION_FILE), session);
-}
-
-export function isSandboxMode() {
-  if (process.env.DOCYRUS_BROWSER_SANDBOX === "1") {
-    return true;
-  }
-  const config = readBrowserConfig();
-  return config?.mode === "sandbox";
-}
-
-export function getSessionInfo() {
-  if (!isSandboxMode()) {
-    return null;
-  }
-  const cached = readCachedSession();
-  if (!cached?.expiresAt) {
-    return null;
-  }
-  if (new Date(cached.expiresAt).getTime() - SESSION_EXPIRY_BUFFER_MS <= Date.now()) {
-    return null;
-  }
-  return cached;
-}
-
-function resolveAppId() {
-  const config = readBrowserConfig();
-  return config?.appId || process.env.DOCYRUS_SANDBOX_APP_ID || null;
-}
-
-function createRemoteSession(appId) {
-  const result = spawnSync("docyrus", [
-    "curl", "-X", "POST",
-    `/api/v1/ai/sandbox/app/${appId}/createBrowserSession`,
-    "--format", "json",
-  ], {
-    encoding: "utf8",
-    env: { ...process.env },
-  });
-
-  if (result.status !== 0) {
-    const msg = result.stderr?.trim() || "unknown error";
-    console.error(`✗ Failed to create browser session: ${msg}`);
-    process.exit(1);
-  }
-
-  let data;
-  try {
-    data = JSON.parse(result.stdout);
-  } catch (e) {
-    console.error("✗ Invalid session response:", e.message);
-    process.exit(1);
-  }
-
-  const now = Date.now();
-  const session = {
-    ...data,
-    createdAt: new Date(now).toISOString(),
-    expiresAt: new Date(now + (data.keepAliveMs || 600_000)).toISOString(),
-  };
-
-  writeCachedSession(session);
-  return session;
-}
-
-async function connectRemote(session) {
-  const browser = await Promise.race([
-    puppeteer.connect({
-      browserWSEndpoint: session.browserWSEndpoint,
-      headers: { Authorization: session.authHeader },
-    }),
-    new Promise((_, reject) =>
-      setTimeout(() => reject(new Error("Timed out connecting to remote browser")), REMOTE_TIMEOUT_MS),
-    ),
-  ]);
-  return browser;
-}
-
-async function connectLocal() {
-  const browser = await Promise.race([
-    puppeteer.connect({
-      browserURL: "http://localhost:9222",
-      defaultViewport: null,
-    }),
-    new Promise((_, reject) =>
-      setTimeout(() => reject(new Error("timeout")), LOCAL_TIMEOUT_MS),
-    ),
-  ]).catch((e) => {
-    console.error("✗ Could not connect to browser:", e.message);
-    console.error("  Run: docyrus browser start");
-    process.exit(1);
-  });
-  return browser;
-}
-
-export async function connectBrowser() {
-  if (isSandboxMode()) {
-    const appId = resolveAppId();
-    if (!appId) {
-      console.error("✗ Sandbox mode active but no app ID found.");
-      console.error("  Set DOCYRUS_SANDBOX_APP_ID or configure .docyrus/browser.json");
-      process.exit(1);
-    }
-
-    let session = getSessionInfo();
-    if (!session) {
-      session = createRemoteSession(appId);
-    }
-
-    const browser = await connectRemote(session);
-    return { browser, mode: "remote", session };
-  }
-
-  const browser = await connectLocal();
-  return { browser, mode: "local", session: null };
-}

package/resources/browser-tools/browser-pick.js

@@ -1,143 +0,0 @@
-#!/usr/bin/env node
-
-import { connectBrowser } from "./browser-connect.js";
-
-const message = process.argv.slice(2).join(" ");
-if (!message) {
-  console.log("Usage: browser-pick.js 'message'");
-  console.log("\nExample:");
-  console.log('  browser-pick.js "Click the submit button"');
-  process.exit(1);
-}
-
-const { browser: b, mode, session } = await connectBrowser();
-
-const p = (await b.pages()).at(-1);
-
-if (!p) {
-  console.error("✗ No active tab found");
-  process.exit(1);
-}
-
-// Inject pick() helper into current page
-await p.evaluate(() => {
-  if (!window.pick) {
-    window.pick = async(message) => {
-      if (!message) {
-        throw new Error("pick() requires a message parameter");
-      }
-      return new Promise((resolve) => {
-        const selections = [];
-        const selectedElements = new Set();
-
-        const overlay = document.createElement("div");
-        overlay.style.cssText =
-					"position:fixed;top:0;left:0;width:100%;height:100%;z-index:2147483647;pointer-events:none";
-
-        const highlight = document.createElement("div");
-        highlight.style.cssText =
-					"position:absolute;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);transition:all 0.1s";
-        overlay.appendChild(highlight);
-
-        const banner = document.createElement("div");
-        banner.style.cssText =
-					"position:fixed;bottom:20px;left:50%;transform:translateX(-50%);background:#1f2937;color:white;padding:12px 24px;border-radius:8px;font:14px sans-serif;box-shadow:0 4px 12px rgba(0,0,0,0.3);pointer-events:auto;z-index:2147483647";
-
-        const updateBanner = () => {
-          banner.textContent = `${message} (${selections.length} selected, Cmd/Ctrl+click to add, Enter to finish, ESC to cancel)`;
-        };
-        updateBanner();
-
-        document.body.append(banner, overlay);
-
-        const cleanup = () => {
-          document.removeEventListener("mousemove", onMove, true);
-          document.removeEventListener("click", onClick, true);
-          document.removeEventListener("keydown", onKey, true);
-          overlay.remove();
-          banner.remove();
-          selectedElements.forEach((el) => {
-            el.style.outline = "";
-          });
-        };
-
-        const onMove = (e) => {
-          const el = document.elementFromPoint(e.clientX, e.clientY);
-          if (!el || overlay.contains(el) || banner.contains(el)) {return;}
-          const r = el.getBoundingClientRect();
-          highlight.style.cssText = `position:absolute;border:2px solid #3b82f6;background:rgba(59,130,246,0.1);top:${r.top}px;left:${r.left}px;width:${r.width}px;height:${r.height}px`;
-        };
-
-        const buildElementInfo = (el) => {
-          const parents = [];
-          let current = el.parentElement;
-          while (current && current !== document.body) {
-            const parentInfo = current.tagName.toLowerCase();
-            const id = current.id ? `#${current.id}` : "";
-            const cls = current.className
-              ? `.${current.className.trim().split(/\s+/).join(".")}`
-              : "";
-            parents.push(parentInfo + id + cls);
-            current = current.parentElement;
-          }
-
-          return {
-            tag: el.tagName.toLowerCase(),
-            id: el.id || null,
-            class: el.className || null,
-            text: el.textContent?.trim().slice(0, 200) || null,
-            html: el.outerHTML.slice(0, 500),
-            parents: parents.join(" > "),
-          };
-        };
-
-        const onClick = (e) => {
-          if (banner.contains(e.target)) {return;}
-          e.preventDefault();
-          e.stopPropagation();
-          const el = document.elementFromPoint(e.clientX, e.clientY);
-          if (!el || overlay.contains(el) || banner.contains(el)) {return;}
-
-          if (e.metaKey || e.ctrlKey) {
-            if (!selectedElements.has(el)) {
-              selectedElements.add(el);
-              el.style.outline = "3px solid #10b981";
-              selections.push(buildElementInfo(el));
-              updateBanner();
-            }
-          } else {
-            cleanup();
-            const info = buildElementInfo(el);
-            resolve(selections.length > 0 ? selections : info);
-          }
-        };
-
-        const onKey = (e) => {
-          if (e.key === "Escape") {
-            e.preventDefault();
-            cleanup();
-            resolve(null);
-          } else if (e.key === "Enter" && selections.length > 0) {
-            e.preventDefault();
-            cleanup();
-            resolve(selections);
-          }
-        };
-
-        document.addEventListener("mousemove", onMove, true);
-        document.addEventListener("click", onClick, true);
-        document.addEventListener("keydown", onKey, true);
-      });
-    };
-  }
-});
-
-const selection = await p.evaluate((msg) => window.pick(msg), message);
-
-const output = { mode, selection };
-if (session?.devtoolsFrontendUrl) {
-  output.devtoolsFrontendUrl = session.devtoolsFrontendUrl;
-}
-console.log(JSON.stringify(output));
-
-await b.disconnect();

package/resources/pi-agent/extensions/docyrus-web-browser.ts

@@ -1,31 +0,0 @@
-import { isToolCallEventType, type ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { buildDocyrusWebBrowserProtocolInstructions } from "../shared/docyrusWebBrowserProtocol";
-
-const DOCYRUS_BROWSER_COMMAND_PATTERN = /\bdocyrus\b(?:\s+-g|\s+--global)?\s+(?:browser|chrome)\b/;
-const DOCYRUS_BROWSER_BLOCK_REASON =
-  "Docyrus Server sessions must use the docyrus-web-browser preview tools instead of `docyrus browser`.";
-
-export default function docyrusWebBrowserExtension(pi: ExtensionAPI) {
-  pi.on("before_agent_start", async(event) => {
-    const protocolInstructions = buildDocyrusWebBrowserProtocolInstructions();
-    return {
-      systemPrompt: [event.systemPrompt, protocolInstructions].filter(Boolean).join("\n\n"),
-    };
-  });
-
-  pi.on("tool_call", async(event) => {
-    if (!isToolCallEventType("bash", event)) {
-      return;
-    }
-
-    const command = typeof event.input.command === "string" ? event.input.command.trim() : "";
-    if (!command || !DOCYRUS_BROWSER_COMMAND_PATTERN.test(command)) {
-      return;
-    }
-
-    return {
-      block: true,
-      reason: DOCYRUS_BROWSER_BLOCK_REASON,
-    };
-  });
-}

package/resources/pi-agent/shared/docyrusWebBrowserProtocol.ts

@@ -1,169 +0,0 @@
-export const DOCYRUS_WEB_BROWSER_EXTENSION_NAME = "docyrus-web-browser";
-export const DOCYRUS_WEB_BROWSER_TAG = "docyrus_web_browser";
-export const DOCYRUS_WEB_BROWSER_OPEN = `<${DOCYRUS_WEB_BROWSER_TAG}>`;
-export const DOCYRUS_WEB_BROWSER_CLOSE = `</${DOCYRUS_WEB_BROWSER_TAG}>`;
-export const DOCYRUS_WEB_BROWSER_RESULT_TAG = "docyrus_web_browser_result";
-export const DOCYRUS_WEB_BROWSER_RESULT_OPEN = `<${DOCYRUS_WEB_BROWSER_RESULT_TAG}>`;
-export const DOCYRUS_WEB_BROWSER_RESULT_CLOSE = `</${DOCYRUS_WEB_BROWSER_RESULT_TAG}>`;
-export const WEB_PREVIEW_CONTEXT_TOOL = "web_preview_context";
-export const WEB_PREVIEW_PLAYWRIGHT_TOOL = "web_preview_playwright";
-
-export const DOCYRUS_WEB_BROWSER_TOOL_NAMES = [
-  WEB_PREVIEW_CONTEXT_TOOL,
-  WEB_PREVIEW_PLAYWRIGHT_TOOL,
-] as const;
-
-export type IDocyrusWebBrowserToolName = typeof DOCYRUS_WEB_BROWSER_TOOL_NAMES[number];
-
-export interface IDocyrusWebBrowserToolRequest {
-  tool: IDocyrusWebBrowserToolName;
-  input?: Record<string, unknown>;
-}
-
-export interface IDocyrusWebBrowserToolResponsePrompt {
-  tool: IDocyrusWebBrowserToolName;
-  request?: Record<string, unknown>;
-  status: "success" | "error";
-  output?: unknown;
-  errorText?: string;
-}
-
-export interface IDocyrusWebBrowserClientToolInfo {
-  name: IDocyrusWebBrowserToolName;
-  description: string;
-  inputSchema?: Record<string, unknown>;
-}
-
-export const DOCYRUS_WEB_BROWSER_CLIENT_TOOLS: IDocyrusWebBrowserClientToolInfo[] = [
-  {
-    name: WEB_PREVIEW_CONTEXT_TOOL,
-    description:
-      "Inspect the current Docyrus web preview state before automation. Prefer this first when preview availability or bridge state is unknown.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        includeSnapshot: { type: "boolean" },
-      },
-      additionalProperties: false,
-    },
-  },
-  {
-    name: WEB_PREVIEW_PLAYWRIGHT_TOOL,
-    description:
-      "Run Playwright-style actions against the Docyrus web preview. Prefer structured steps over raw scripts.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        script: { type: "string" },
-        steps: {
-          type: "array",
-          items: {
-            type: "object",
-            properties: {
-              action: { type: "string" },
-              selector: { type: "string" },
-              url: { type: "string" },
-              value: { type: "string" },
-              values: {
-                type: "array",
-                items: { type: "string" },
-              },
-              key: { type: "string" },
-              attribute: { type: "string" },
-              timeoutMs: { type: "number" },
-              state: { type: "string" },
-            },
-            additionalProperties: true,
-          },
-        },
-        timeoutMs: { type: "number" },
-        stopOnError: { type: "boolean" },
-      },
-      additionalProperties: true,
-    },
-  },
-];
-
-function hashString(value: string): string {
-  let hash = 0;
-  for (let index = 0; index < value.length; index += 1) {
-    hash = ((hash << 5) - hash) + value.charCodeAt(index);
-    hash |= 0;
-  }
-  return Math.abs(hash).toString(36);
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-export function isDocyrusWebBrowserToolName(value: unknown): value is IDocyrusWebBrowserToolName {
-  return DOCYRUS_WEB_BROWSER_TOOL_NAMES.some((toolName) => toolName === value);
-}
-
-export function normalizeDocyrusWebBrowserToolRequest(value: unknown): IDocyrusWebBrowserToolRequest | undefined {
-  if (!isRecord(value) || !isDocyrusWebBrowserToolName(value.tool)) {
-    return undefined;
-  }
-
-  return {
-    tool: value.tool,
-    input: isRecord(value.input) ? value.input : undefined,
-  };
-}
-
-export function serializeDocyrusWebBrowserToolRequest(request: IDocyrusWebBrowserToolRequest): string {
-  return `${DOCYRUS_WEB_BROWSER_OPEN}\n${JSON.stringify(request, null, 2)}\n${DOCYRUS_WEB_BROWSER_CLOSE}`;
-}
-
-export function createDocyrusWebBrowserToolCallId(request: IDocyrusWebBrowserToolRequest): string {
-  return `docyrus_web_browser_${hashString(JSON.stringify(request))}`;
-}
-
-export function parseDocyrusWebBrowserRequestFromText(text: string): IDocyrusWebBrowserToolRequest | undefined {
-  const trimmed = text.trim();
-  if (!trimmed.startsWith(DOCYRUS_WEB_BROWSER_OPEN) || !trimmed.endsWith(DOCYRUS_WEB_BROWSER_CLOSE)) {
-    return undefined;
-  }
-
-  const body = trimmed.slice(DOCYRUS_WEB_BROWSER_OPEN.length, trimmed.length - DOCYRUS_WEB_BROWSER_CLOSE.length).trim();
-  if (!body) {
-    return undefined;
-  }
-
-  try {
-    return normalizeDocyrusWebBrowserToolRequest(JSON.parse(body));
-  } catch {
-    return undefined;
-  }
-}
-
-export function buildDocyrusWebBrowserProtocolInstructions(): string {
-  return [
-    "When you need to inspect or automate the Docyrus web preview in server-backed sessions, use the docyrus-web-browser client tools.",
-    "Do not use `docyrus browser` or any visible Chrome DevTools workflow in this environment.",
-    `Instead, output only a single ${DOCYRUS_WEB_BROWSER_OPEN}...${DOCYRUS_WEB_BROWSER_CLOSE} block and nothing else in the assistant message.`,
-    "Inside that block, emit strict JSON with this shape:",
-    "{\"tool\":\"web_preview_context\",\"input\":{\"includeSnapshot\":true}}",
-    "or",
-    "{\"tool\":\"web_preview_playwright\",\"input\":{\"steps\":[{\"action\":\"goto\",\"url\":\"/login\"},{\"action\":\"fill\",\"selector\":\"input[name='email']\",\"value\":\"demo@example.com\"}],\"timeoutMs\":10000,\"stopOnError\":true}}",
-    "Call `web_preview_context` first when preview state is unknown.",
-    "Prefer `steps` over `script` for `web_preview_playwright`.",
-    "Supported playwright step actions are: goto, click, dblclick, hover, fill, press, select, check, uncheck, waitForSelector, waitForTimeout, textContent, getAttribute, title, url, snapshot.",
-    "If the tool reports that the preview is unavailable or blocked by bridge/cross-origin constraints, stop and explain the exact blocker to the user.",
-  ].join("\n");
-}
-
-export function formatDocyrusWebBrowserToolResponsePrompt(
-  response: IDocyrusWebBrowserToolResponsePrompt,
-): string {
-  return [
-    "The docyrus-web-browser client tool returned a result.",
-    "",
-    `${DOCYRUS_WEB_BROWSER_RESULT_OPEN}`,
-    JSON.stringify(response, null, 2),
-    `${DOCYRUS_WEB_BROWSER_RESULT_CLOSE}`,
-    "",
-    "Continue the task using this result. If the tool reported an availability or bridge blocker, explain that blocker exactly and do not claim success.",
-  ].join("\n");
-}