orient-cli 0.2.2 → 0.3.1

package/dist/integrations/playwright/bridge.js

@@ -0,0 +1,225 @@
+/**
+ * Playwright bridge for ORIENT CLI
+ * =================================
+ *
+ * Thin subprocess wrapper around `playwright-cli` (the active
+ * microsoft/playwright-cli repo, published as `@playwright/cli`).
+ * ORIENT ships `@playwright/cli` as a default dependency so browser
+ * automation works out of the box — the same pattern Gemini CLI,
+ * OpenCode, and Droid use for their own browser tools.
+ *
+ * Why subprocess and not programmatic?
+ *   - @playwright/cli maintains its own per-session browser state
+ *     under `PLAYWRIGHT_CLI_SESSION=<name>`. Reusing that session
+ *     machinery through the CLI is free; reimplementing it on top
+ *     of the `playwright` library would duplicate work.
+ *   - The agent can also invoke `playwright-cli` directly via the
+ *     bash tool, so having our extension call the same binary keeps
+ *     both entry points consistent (no drift between "ORIENT tool"
+ *     and "bash playwright-cli").
+ *   - Upgrading playwright-cli is a pure npm dependency bump; no
+ *     extension code changes required.
+ *
+ * Chromium browser binaries are NOT shipped with this package —
+ * `playwright install chromium` has to be run once per machine
+ * (~170 MB download). The bridge detects when the binary is
+ * missing and returns a helpful error pointing at the install
+ * command. Users can pre-warm via `/orient.playwright.setup`.
+ */
+import { execFile, spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/**
+ * Resolve the `playwright-cli` binary that ships inside this package's
+ * node_modules. When orient-cli is installed globally, npm places the
+ * playwright-cli entry at `<orient-cli>/node_modules/.bin/playwright-cli`.
+ * We find it via require.resolve of the `@playwright/cli` package.json,
+ * then walk up to the nearest `.bin`. Falling back to $PATH keeps
+ * workspace-dev runs working even when the binary isn't hoisted the
+ * same way a global install would hoist it.
+ */
+function resolvePlaywrightCliBinary() {
+    // import.meta.url → file:///.../dist/integrations/playwright/bridge.js
+    // Walk up to the orient package root, then look in node_modules/.bin.
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const candidates = [
+            resolve(here, "..", "..", "..", "..", "node_modules", ".bin", "playwright-cli"),
+            resolve(here, "..", "..", "..", "node_modules", ".bin", "playwright-cli"),
+            resolve(here, "..", "..", "node_modules", ".bin", "playwright-cli"),
+        ];
+        for (const candidate of candidates) {
+            if (existsSync(candidate))
+                return candidate;
+        }
+    }
+    catch {
+        // Fall through.
+    }
+    // Last resort: assume it's on PATH.
+    return "playwright-cli";
+}
+const PLAYWRIGHT_CLI = resolvePlaywrightCliBinary();
+const DEFAULT_TIMEOUT = 60_000; // 60s — long enough for heavy pages
+// ============================================================================
+// Availability + setup
+// ============================================================================
+/**
+ * Check whether `playwright-cli` is resolvable and whether the
+ * Chromium browser binary has been installed. Chromium absence is
+ * treated as an expected first-run state, not an error.
+ */
+export async function checkPlaywrightAvailability(sessionName = "orient") {
+    let cliInstalled = false;
+    try {
+        await execFileAsync(PLAYWRIGHT_CLI, ["--version"], { timeout: 10_000 });
+        cliInstalled = true;
+    }
+    catch {
+        cliInstalled = false;
+    }
+    let chromiumInstalled = false;
+    if (cliInstalled) {
+        try {
+            // `playwright-cli list` works without an active session and
+            // doesn't require a browser binary. A failing invocation
+            // usually means the browser hasn't been downloaded yet.
+            await execFileAsync(PLAYWRIGHT_CLI, ["list"], {
+                timeout: 10_000,
+                env: { ...process.env, PLAYWRIGHT_CLI_SESSION: sessionName },
+            });
+            chromiumInstalled = true;
+        }
+        catch {
+            chromiumInstalled = false;
+        }
+    }
+    return { cliInstalled, chromiumInstalled, sessionName };
+}
+/**
+ * Run `npx playwright install chromium` to fetch the Chromium
+ * browser binary. Streams stdout / stderr via the onProgress
+ * callback so callers can surface the ~170 MB download in the TUI.
+ */
+export async function installChromium(onProgress) {
+    return new Promise((resolve, reject) => {
+        // Use `npx` so we don't need playwright itself on PATH.
+        const proc = spawn("npx", ["--yes", "playwright", "install", "chromium"], {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stderr = "";
+        proc.stdout.on("data", (chunk) => onProgress?.(chunk.toString()));
+        proc.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+            onProgress?.(chunk.toString());
+        });
+        proc.on("error", reject);
+        proc.on("close", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`playwright install chromium failed (exit ${code}): ${stderr.slice(0, 400)}`));
+        });
+    });
+}
+// ============================================================================
+// Browser operations (thin wrappers — agent can also call playwright-cli directly)
+// ============================================================================
+function baseEnv(sessionName) {
+    return { ...process.env, PLAYWRIGHT_CLI_SESSION: sessionName };
+}
+/**
+ * Navigate the session's browser to a URL. Opens the page if no page
+ * is active for the session yet.
+ */
+export async function goto(url, sessionName = "orient") {
+    const { stdout } = await execFileAsync(PLAYWRIGHT_CLI, ["goto", url], {
+        timeout: DEFAULT_TIMEOUT,
+        env: baseEnv(sessionName),
+    });
+    return stdout.trim();
+}
+/**
+ * Take a snapshot of the current page. `playwright-cli snapshot`
+ * returns an accessibility-tree-style text representation optimized
+ * for LLM consumption (same pattern as Playwright MCP).
+ */
+export async function snapshot(sessionName = "orient") {
+    const { stdout } = await execFileAsync(PLAYWRIGHT_CLI, ["snapshot"], {
+        timeout: DEFAULT_TIMEOUT,
+        env: baseEnv(sessionName),
+    });
+    try {
+        const parsed = JSON.parse(stdout);
+        return {
+            url: parsed.url ?? "",
+            title: parsed.title ?? "",
+            text: parsed.text ?? parsed.snapshot ?? stdout,
+        };
+    }
+    catch {
+        return { url: "", title: "", text: stdout };
+    }
+}
+/**
+ * Click an element matched by a Playwright selector (CSS, text, role,
+ * or one of playwright-cli's own locator shortcuts).
+ */
+export async function click(selector, sessionName = "orient") {
+    const { stdout } = await execFileAsync(PLAYWRIGHT_CLI, ["click", selector], {
+        timeout: DEFAULT_TIMEOUT,
+        env: baseEnv(sessionName),
+    });
+    return stdout.trim();
+}
+/**
+ * Fill a text input matched by `selector` with `value`.
+ */
+export async function fill(selector, value, sessionName = "orient") {
+    const { stdout } = await execFileAsync(PLAYWRIGHT_CLI, ["fill", selector, value], {
+        timeout: DEFAULT_TIMEOUT,
+        env: baseEnv(sessionName),
+    });
+    return stdout.trim();
+}
+/**
+ * Take a screenshot of the current page and save it to `outputPath`.
+ * Returns the full path of the saved file.
+ */
+export async function screenshot(outputPath, sessionName = "orient") {
+    await execFileAsync(PLAYWRIGHT_CLI, ["screenshot", outputPath], {
+        timeout: DEFAULT_TIMEOUT,
+        env: baseEnv(sessionName),
+    });
+    return outputPath;
+}
+/**
+ * Evaluate JavaScript against the current page. Used for ad-hoc
+ * DOM extraction the agent couldn't get from `snapshot`.
+ */
+export async function evaluate(expression, sessionName = "orient") {
+    const { stdout } = await execFileAsync(PLAYWRIGHT_CLI, ["eval", expression], {
+        timeout: DEFAULT_TIMEOUT,
+        env: baseEnv(sessionName),
+    });
+    return stdout.trim();
+}
+/**
+ * Close the session's browser cleanly. Call this at end-of-packet so
+ * headless chromium processes don't linger.
+ */
+export async function close(sessionName = "orient") {
+    try {
+        await execFileAsync(PLAYWRIGHT_CLI, ["close"], {
+            timeout: 10_000,
+            env: baseEnv(sessionName),
+        });
+    }
+    catch {
+        // Best-effort cleanup; ignore errors if already closed.
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/integrations/playwright/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/integrations/playwright/bridge.ts"],"names":[],"mappings":"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"}

package/dist/integrations/playwright/playwright-extension.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Playwright extension for ORIENT CLI
+ * ====================================
+ *
+ * Registers a compact set of browser-driving tools (goto, snapshot,
+ * click, fill, screenshot, eval, close) backed by the `playwright-cli`
+ * binary that ships as a default dependency of orient-cli.
+ *
+ * Shipping playwright-cli by default matches the pattern the user
+ * requested: browser automation should "just work" after
+ * `npm install -g orient-cli@latest` — no manual opt-in, no secondary
+ * install step (the chromium browser binary is fetched during the
+ * orient-cli postinstall script, ~170 MB one-time).
+ *
+ * The tools here are deliberately thin wrappers. The agent can drive
+ * far more of playwright-cli's surface via the bash tool — this
+ * extension just exposes the half-dozen highest-value operations as
+ * first-class LLM-callable tools so the model doesn't have to think
+ * about the subprocess layer for common flows.
+ */
+import type { ExtensionAPI } from "@orient-cli/coding-agent";
+export default function playwrightExtension(pi: ExtensionAPI): Promise<void>;

package/dist/integrations/playwright/playwright-extension.js

@@ -0,0 +1,207 @@
+/**
+ * Playwright extension for ORIENT CLI
+ * ====================================
+ *
+ * Registers a compact set of browser-driving tools (goto, snapshot,
+ * click, fill, screenshot, eval, close) backed by the `playwright-cli`
+ * binary that ships as a default dependency of orient-cli.
+ *
+ * Shipping playwright-cli by default matches the pattern the user
+ * requested: browser automation should "just work" after
+ * `npm install -g orient-cli@latest` — no manual opt-in, no secondary
+ * install step (the chromium browser binary is fetched during the
+ * orient-cli postinstall script, ~170 MB one-time).
+ *
+ * The tools here are deliberately thin wrappers. The agent can drive
+ * far more of playwright-cli's surface via the bash tool — this
+ * extension just exposes the half-dozen highest-value operations as
+ * first-class LLM-callable tools so the model doesn't have to think
+ * about the subprocess layer for common flows.
+ */
+import { Type } from "@sinclair/typebox";
+import { checkPlaywrightAvailability, click, close, evaluate, fill, goto, installChromium, screenshot, snapshot, } from "./bridge.js";
+const DEFAULT_SESSION = "orient";
+export default async function playwrightExtension(pi) {
+    const availability = await checkPlaywrightAvailability(DEFAULT_SESSION);
+    if (!availability.cliInstalled) {
+        pi.on("session_start", (_event, ctx) => {
+            ctx.ui.setStatus("playwright", "@playwright/cli missing — reinstall orient-cli or run `npm install -g @playwright/cli`");
+        });
+        return;
+    }
+    pi.on("session_start", (_event, ctx) => {
+        if (availability.chromiumInstalled) {
+            ctx.ui.setStatus("playwright", "playwright-cli ready (chromium installed)");
+        }
+        else {
+            ctx.ui.setStatus("playwright", "playwright-cli ready, chromium missing — run /orient.playwright.setup");
+        }
+    });
+    // ========================================================================
+    // Setup command
+    // ========================================================================
+    pi.registerCommand("orient.playwright.setup", {
+        description: "Install the Chromium browser binary that playwright-cli drives",
+        handler: async (_args, ctx) => {
+            ctx.ui.notify("Installing Chromium via `npx playwright install chromium` (~170 MB one-time download)…", "info");
+            try {
+                await installChromium((chunk) => {
+                    // Stream periodic progress ticks into the chat so the user sees the download is alive.
+                    const trimmed = chunk.trim();
+                    if (trimmed.length > 0)
+                        ctx.ui.notify(trimmed, "info");
+                });
+                ctx.ui.notify("✓ Chromium installed. Browser tools are ready.", "info");
+            }
+            catch (err) {
+                ctx.ui.notify(`Chromium install failed: ${err.message}`, "error");
+            }
+        },
+    });
+    // ========================================================================
+    // Browser tools
+    // ========================================================================
+    pi.registerTool({
+        name: "playwright_goto",
+        label: "Browser Navigate",
+        description: "Navigate the shared orient browser session to a URL. Opens a Chromium window backed by playwright-cli if none is open yet.",
+        promptSnippet: "Open a URL in the orient browser session.",
+        parameters: Type.Object({
+            url: Type.String({ description: "Absolute URL to navigate to (https://...)" }),
+        }),
+        async execute(_toolCallId, params) {
+            try {
+                const out = await goto(params.url);
+                return {
+                    content: [{ type: "text", text: `Navigated to ${params.url}\n${out}` }],
+                    details: null,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `goto failed: ${err.message}` }],
+                    details: null,
+                };
+            }
+        },
+    });
+    pi.registerTool({
+        name: "playwright_snapshot",
+        label: "Browser Snapshot",
+        description: "Take an accessibility-tree snapshot of the current page — the LLM-friendly text representation playwright-cli emits. Use this instead of raw HTML for understanding what's on the page.",
+        promptSnippet: "Snapshot the current browser page as accessibility-tree text.",
+        parameters: Type.Object({}),
+        async execute() {
+            try {
+                const snap = await snapshot();
+                const body = snap.url || snap.title ? `URL: ${snap.url}\nTitle: ${snap.title}\n\n${snap.text}` : snap.text;
+                return {
+                    content: [{ type: "text", text: body }],
+                    details: null,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `snapshot failed: ${err.message}` }],
+                    details: null,
+                };
+            }
+        },
+    });
+    pi.registerTool({
+        name: "playwright_click",
+        label: "Browser Click",
+        description: "Click an element on the current page. Accepts a Playwright selector (CSS, text=, role=, etc.).",
+        promptSnippet: "Click an element in the browser.",
+        parameters: Type.Object({
+            selector: Type.String({
+                description: "Playwright selector. Examples: 'button.submit', 'text=Sign in', 'role=link[name=Docs]'",
+            }),
+        }),
+        async execute(_toolCallId, params) {
+            try {
+                const out = await click(params.selector);
+                return { content: [{ type: "text", text: out || `clicked ${params.selector}` }], details: null };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `click failed: ${err.message}` }], details: null };
+            }
+        },
+    });
+    pi.registerTool({
+        name: "playwright_fill",
+        label: "Browser Fill",
+        description: "Type text into a form field matched by a Playwright selector.",
+        promptSnippet: "Fill a text input in the browser.",
+        parameters: Type.Object({
+            selector: Type.String({ description: "Playwright selector for the input (e.g. 'input[name=email]')" }),
+            value: Type.String({ description: "Text to type into the field" }),
+        }),
+        async execute(_toolCallId, params) {
+            try {
+                const out = await fill(params.selector, params.value);
+                return { content: [{ type: "text", text: out || `filled ${params.selector}` }], details: null };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `fill failed: ${err.message}` }], details: null };
+            }
+        },
+    });
+    pi.registerTool({
+        name: "playwright_screenshot",
+        label: "Browser Screenshot",
+        description: "Capture a PNG screenshot of the current page and save to a local file path.",
+        promptSnippet: "Take a screenshot of the current browser page.",
+        parameters: Type.Object({
+            outputPath: Type.String({
+                description: "Local file path where the PNG should be written (e.g. '.orient-cli/screenshots/home.png')",
+            }),
+        }),
+        async execute(_toolCallId, params) {
+            try {
+                const saved = await screenshot(params.outputPath);
+                return { content: [{ type: "text", text: `Saved screenshot to ${saved}` }], details: null };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `screenshot failed: ${err.message}` }], details: null };
+            }
+        },
+    });
+    pi.registerTool({
+        name: "playwright_eval",
+        label: "Browser Evaluate JS",
+        description: "Evaluate a JavaScript expression against the current page. Returns the result as JSON. Use when snapshot text is not enough to extract what you need (e.g. pulling an array of prices from a table).",
+        promptSnippet: "Run a JavaScript expression against the current browser page.",
+        parameters: Type.Object({
+            expression: Type.String({
+                description: "JavaScript expression. Example: `Array.from(document.querySelectorAll('.price')).map(el => el.textContent)`",
+            }),
+        }),
+        async execute(_toolCallId, params) {
+            try {
+                const out = await evaluate(params.expression);
+                return { content: [{ type: "text", text: out || "(no result)" }], details: null };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `eval failed: ${err.message}` }], details: null };
+            }
+        },
+    });
+    pi.registerTool({
+        name: "playwright_close",
+        label: "Browser Close",
+        description: "Close the shared orient browser session cleanly. Call at end-of-task to release the chromium process.",
+        promptSnippet: "Close the browser session.",
+        parameters: Type.Object({}),
+        async execute() {
+            try {
+                await close();
+                return { content: [{ type: "text", text: "Browser session closed." }], details: null };
+            }
+            catch (err) {
+                return { content: [{ type: "text", text: `close failed: ${err.message}` }], details: null };
+            }
+        },
+    });
+}
+//# sourceMappingURL=playwright-extension.js.map

package/dist/integrations/playwright/playwright-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-extension.js","sourceRoot":"","sources":["../../../src/integrations/playwright/playwright-extension.ts"],"names":[],"mappings":"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"}

package/dist/integrations/web-search/bridge.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Web search bridge (MIT, derived from mrkrsl/web-search-mcp)
+ * ============================================================
+ *
+ * ORIENT ships a default web-search layer that uses the same
+ * "scrape Bing / Brave / DuckDuckGo via playwright" pattern that
+ * https://github.com/mrkrsl/web-search-mcp@MIT implements as a
+ * standalone MCP server. We adopt that approach directly in
+ * TypeScript here instead of spawning the MCP server as a
+ * subprocess — it avoids (a) the MCP protocol overhead, (b) the
+ * extra install step, and (c) the dependency on an 8-month-stale
+ * upstream build. All three engine scrapers, the priority-order
+ * fallback, and the content extraction pattern are reimplemented
+ * from the upstream's published README + source layout.
+ *
+ * Upstream attribution: https://github.com/mrkrsl/web-search-mcp
+ * Upstream license: MIT
+ *
+ * Three operations match the upstream MCP tool surface:
+ *
+ *   - `search(query, { limit, includeContent })` — "full-web-search"
+ *     equivalent. Returns an array of `SearchResult` with optional
+ *     full page text content per result.
+ *
+ *   - `searchSummaries(query, { limit })` — "get-web-search-summaries"
+ *     equivalent. Returns the same shape but with content omitted
+ *     (faster, no second-pass fetch per URL).
+ *
+ *   - `getPageContent(url)` — "get-single-web-page-content"
+ *     equivalent. Direct content extraction for one URL the agent
+ *     already has.
+ *
+ * Environment variables honored (names match upstream):
+ *
+ *   MAX_CONTENT_LENGTH      — max chars returned per page (default 8000)
+ *   DEFAULT_TIMEOUT         — per-navigation timeout in ms   (default 20000)
+ *   BROWSER_HEADLESS        — "true" or "false"              (default true)
+ *   FORCE_MULTI_ENGINE_SEARCH — force fallback engines even on Bing hit
+ *
+ * Playwright is already a dependency of orient-cli (shipped for
+ * @playwright/cli and the notebooklm login flow), so importing
+ * `playwright` here adds zero additional install weight.
+ */
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    /** Populated only when `includeContent` is true. */
+    content?: string;
+    /** Which engine produced this result (bing | brave | duckduckgo). */
+    engine: "bing" | "brave" | "duckduckgo";
+}
+export interface SearchOptions {
+    limit?: number;
+    includeContent?: boolean;
+    /** Override the default engine priority. */
+    engines?: Array<"bing" | "brave" | "duckduckgo">;
+}
+export interface EnvOptions {
+    maxContentLength: number;
+    defaultTimeout: number;
+    headless: boolean;
+    forceMulti: boolean;
+}
+export declare function closeBrowser(): Promise<void>;
+export declare function getPageContent(url: string): Promise<{
+    url: string;
+    title: string;
+    content: string;
+}>;
+/**
+ * Run a web search with the priority-order fallback pattern mrkrsl/
+ * web-search-mcp established: try Bing first, fall through to Brave,
+ * fall through to DuckDuckGo. If `includeContent` is true, fetch full
+ * page text for each result in parallel (bounded to 5 concurrent).
+ */
+export declare function search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+/** Shortcut: search without full content fetch. */
+export declare function searchSummaries(query: string, options?: Omit<SearchOptions, "includeContent">): Promise<SearchResult[]>;