orient-cli 0.2.1 → 0.3.0

package/dist/extensions/orient-playwright.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Bundled pi extension re-export for the playwright integration.
+ *
+ * Lives at `dist/extensions/orient-playwright.js` after build so the
+ * CLI bootstrap can inject it via `--extension <path>`.
+ */
+export { default } from "../integrations/playwright/playwright-extension.js";

package/dist/extensions/orient-playwright.js

@@ -0,0 +1,8 @@
+/**
+ * Bundled pi extension re-export for the playwright integration.
+ *
+ * Lives at `dist/extensions/orient-playwright.js` after build so the
+ * CLI bootstrap can inject it via `--extension <path>`.
+ */
+export { default } from "../integrations/playwright/playwright-extension.js";
+//# sourceMappingURL=orient-playwright.js.map

package/dist/extensions/orient-playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient-playwright.js","sourceRoot":"","sources":["../../src/extensions/orient-playwright.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/extensions/orient-web-search.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Bundled pi extension re-export for the web-search integration.
+ * Lives at `dist/extensions/orient-web-search.js` after build.
+ */
+export { default } from "../integrations/web-search/web-search-extension.js";

package/dist/extensions/orient-web-search.js

@@ -0,0 +1,6 @@
+/**
+ * Bundled pi extension re-export for the web-search integration.
+ * Lives at `dist/extensions/orient-web-search.js` after build.
+ */
+export { default } from "../integrations/web-search/web-search-extension.js";
+//# sourceMappingURL=orient-web-search.js.map

package/dist/extensions/orient-web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient-web-search.js","sourceRoot":"","sources":["../../src/extensions/orient-web-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/integrations/notebooklm/setup.d.ts

@@ -0,0 +1,94 @@
+/**
+ * NotebookLM setup flow
+ * ======================
+ *
+ * Interactive installer + authenticator for `notebooklm-py`, invoked
+ * on-demand when the user enters the Research phase in ORIENT mode at
+ * verbosity tier 3 (thorough). At lower tiers the Research phase
+ * works without NotebookLM — it falls back to pi's built-in read /
+ * grep / find / web-fetch tools. Tier 3 is where NotebookLM is worth
+ * the setup cost (real Google auth, browser install, cookie harvest).
+ *
+ * The flow:
+ *
+ *   1. Check whether Python + pip are available on PATH.
+ *   2. Check whether `notebooklm-py` is already installed and
+ *      authenticated by asking the existing bridge's
+ *      `checkAvailability()`.
+ *   3. If not installed, run `pip install "notebooklm-py[browser]"`
+ *      — the `[browser]` extra pulls in Playwright's Python bindings
+ *      required for the headed login flow. Then run
+ *      `playwright install chromium` to fetch the Chromium browser
+ *      binary the login flow drives.
+ *   4. If not authenticated, run `notebooklm login`. This opens a
+ *      real Chromium window where the user signs into their Google
+ *      account. The library then harvests session cookies (SID,
+ *      HSID, SSID, APISID, SAPISID, __Secure-1PSID, __Secure-3PSID)
+ *      and persists them at `~/.notebooklm/profiles/default/
+ *      storage_state.json`.
+ *   5. Re-check availability and report success / failure.
+ *
+ * On headless servers (no X display), the `notebooklm login` command
+ * will fail because it needs a visible browser window. We detect this
+ * via `process.env.DISPLAY` and print fallback instructions that tell
+ * the user how to (a) run the login on a workstation, (b) copy the
+ * `~/.notebooklm/` profile directory to the server, and (c) set
+ * `NOTEBOOKLM_HOME` to point at it.
+ *
+ * This file is a pure async module — the actual ctx.ui.select() /
+ * ctx.ui.notify() wiring happens in the orient extension.
+ */
+import { exec } from "node:child_process";
+declare const execAsync: typeof exec.__promisify__;
+export interface SetupStep {
+    label: string;
+    status: "pending" | "running" | "ok" | "skipped" | "failed";
+    detail?: string;
+}
+export interface SetupResult {
+    success: boolean;
+    steps: SetupStep[];
+    /** Final availability state after the flow. */
+    installed: boolean;
+    authenticated: boolean;
+    /** Terminal-friendly summary message for ctx.ui.notify(). */
+    message: string;
+}
+export interface SetupOptions {
+    /**
+     * Callback invoked after each step transitions. Lets callers stream
+     * progress to the TUI in real time instead of waiting for the whole
+     * flow to finish.
+     */
+    onProgress?: (step: SetupStep) => void;
+    /**
+     * Skip the `notebooklm login` step. Useful when the setup is running
+     * on a headless server and the caller wants to run the install
+     * portion now and defer the auth to a workstation.
+     */
+    skipAuth?: boolean;
+    /**
+     * Maximum number of seconds the login subprocess is allowed to run.
+     * The Google sign-in can legitimately take a minute or two, so the
+     * default is 5 minutes. Set to 0 to disable the timeout.
+     */
+    loginTimeoutSeconds?: number;
+}
+/**
+ * Full setup flow. Updates the provided `steps` array and invokes
+ * `onProgress` after every status change so the caller can stream
+ * the UI. Returns a structured `SetupResult`.
+ */
+export declare function setupNotebookLM(options?: SetupOptions): Promise<SetupResult>;
+/**
+ * Check whether the caller's environment has a notebooklm profile
+ * directory already (useful for detecting "setup has been run before"
+ * without invoking the bridge's auth-check subprocess).
+ */
+export declare function hasExistingProfile(): boolean;
+/**
+ * Compact one-liner describing current setup state. Used by the
+ * session_start hook to surface status without running the full flow.
+ */
+export declare function describeStatus(): Promise<string>;
+export { execAsync };

package/dist/integrations/notebooklm/setup.js

@@ -0,0 +1,311 @@
+/**
+ * NotebookLM setup flow
+ * ======================
+ *
+ * Interactive installer + authenticator for `notebooklm-py`, invoked
+ * on-demand when the user enters the Research phase in ORIENT mode at
+ * verbosity tier 3 (thorough). At lower tiers the Research phase
+ * works without NotebookLM — it falls back to pi's built-in read /
+ * grep / find / web-fetch tools. Tier 3 is where NotebookLM is worth
+ * the setup cost (real Google auth, browser install, cookie harvest).
+ *
+ * The flow:
+ *
+ *   1. Check whether Python + pip are available on PATH.
+ *   2. Check whether `notebooklm-py` is already installed and
+ *      authenticated by asking the existing bridge's
+ *      `checkAvailability()`.
+ *   3. If not installed, run `pip install "notebooklm-py[browser]"`
+ *      — the `[browser]` extra pulls in Playwright's Python bindings
+ *      required for the headed login flow. Then run
+ *      `playwright install chromium` to fetch the Chromium browser
+ *      binary the login flow drives.
+ *   4. If not authenticated, run `notebooklm login`. This opens a
+ *      real Chromium window where the user signs into their Google
+ *      account. The library then harvests session cookies (SID,
+ *      HSID, SSID, APISID, SAPISID, __Secure-1PSID, __Secure-3PSID)
+ *      and persists them at `~/.notebooklm/profiles/default/
+ *      storage_state.json`.
+ *   5. Re-check availability and report success / failure.
+ *
+ * On headless servers (no X display), the `notebooklm login` command
+ * will fail because it needs a visible browser window. We detect this
+ * via `process.env.DISPLAY` and print fallback instructions that tell
+ * the user how to (a) run the login on a workstation, (b) copy the
+ * `~/.notebooklm/` profile directory to the server, and (c) set
+ * `NOTEBOOKLM_HOME` to point at it.
+ *
+ * This file is a pure async module — the actual ctx.ui.select() /
+ * ctx.ui.notify() wiring happens in the orient extension.
+ */
+import { exec, execFile, spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { promisify } from "node:util";
+import { NotebookLMBridge } from "./bridge.js";
+const execAsync = promisify(exec);
+const execFileAsync = promisify(execFile);
+// ============================================================================
+// Capability probes
+// ============================================================================
+/**
+ * Check whether a binary is resolvable via `which`. Returns the path if
+ * found, or `null` otherwise. Works on Linux/macOS; on Windows a
+ * caller should provide a PowerShell fallback.
+ */
+async function which(binary) {
+    try {
+        const { stdout } = await execFileAsync("which", [binary], { timeout: 5_000 });
+        const path = stdout.trim();
+        return path.length > 0 ? path : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect the Python interpreter to use. Prefers `python3` because on
+ * every modern distribution `python` either points at Python 2 or is
+ * absent entirely. Returns a binary name or null.
+ */
+async function detectPython() {
+    if (await which("python3"))
+        return "python3";
+    if (await which("python"))
+        return "python";
+    return null;
+}
+/**
+ * Detect a usable pip entry point. Prefers running pip as a Python
+ * module (`python3 -m pip ...`) because that guarantees the pip
+ * invocation matches the interpreter we just located — standalone
+ * `pip` can point at a different Python from `python3`.
+ */
+async function detectPip(python) {
+    try {
+        await execFileAsync(python, ["-m", "pip", "--version"], { timeout: 10_000 });
+        return [python, "-m", "pip"];
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Heuristic for "this is a headless box". If `$DISPLAY` is empty and
+ * `$WAYLAND_DISPLAY` is empty, no X / Wayland is available and the
+ * `notebooklm login` browser window will fail.
+ */
+function looksHeadless() {
+    if (process.platform === "win32" || process.platform === "darwin")
+        return false;
+    return !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY;
+}
+// ============================================================================
+// Install step implementations
+// ============================================================================
+async function runPipInstall(pip, onProgress) {
+    return new Promise((resolve, reject) => {
+        const args = [...pip.slice(1), "install", "--user", "notebooklm-py[browser]"];
+        const proc = spawn(pip[0], args, { 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(`pip install failed (exit ${code}): ${stderr.slice(0, 400)}`));
+        });
+    });
+}
+async function runPlaywrightInstall(python, onProgress) {
+    // Use `python -m playwright install chromium` because the playwright
+    // binary may not be on PATH even though the Python module is.
+    return new Promise((resolve, reject) => {
+        const proc = spawn(python, ["-m", "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)}`));
+        });
+    });
+}
+async function runNotebookLMLogin(timeoutSeconds) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn("notebooklm", ["login"], { stdio: "inherit" });
+        const timer = timeoutSeconds > 0
+            ? setTimeout(() => {
+                proc.kill("SIGTERM");
+                reject(new Error(`notebooklm login timed out after ${timeoutSeconds}s`));
+            }, timeoutSeconds * 1000)
+            : null;
+        proc.on("error", (err) => {
+            if (timer)
+                clearTimeout(timer);
+            reject(err);
+        });
+        proc.on("close", (code) => {
+            if (timer)
+                clearTimeout(timer);
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`notebooklm login exited with code ${code}`));
+        });
+    });
+}
+// ============================================================================
+// Orchestration
+// ============================================================================
+/**
+ * Full setup flow. Updates the provided `steps` array and invokes
+ * `onProgress` after every status change so the caller can stream
+ * the UI. Returns a structured `SetupResult`.
+ */
+export async function setupNotebookLM(options = {}) {
+    const steps = [
+        { label: "Detect Python interpreter", status: "pending" },
+        { label: "Detect pip", status: "pending" },
+        { label: "Install notebooklm-py[browser] via pip", status: "pending" },
+        { label: "Install Chromium via playwright", status: "pending" },
+        { label: "Authenticate with Google (notebooklm login)", status: "pending" },
+        { label: "Verify availability", status: "pending" },
+    ];
+    const emit = (step) => options.onProgress?.(step);
+    const mark = (i, patch) => {
+        steps[i] = { ...steps[i], ...patch };
+        emit(steps[i]);
+    };
+    // Step 1: Python
+    mark(0, { status: "running" });
+    const python = await detectPython();
+    if (!python) {
+        mark(0, {
+            status: "failed",
+            detail: "Python 3 not found. Install Python 3.10+ and re-run `/orient.research.setup`.",
+        });
+        return finalize(steps, false, false, "Python 3 is required for notebooklm-py. Install it first.");
+    }
+    mark(0, { status: "ok", detail: python });
+    // Step 2: pip
+    mark(1, { status: "running" });
+    const pip = await detectPip(python);
+    if (!pip) {
+        mark(1, {
+            status: "failed",
+            detail: `pip not available for ${python}. Install pip (e.g. \`sudo apt install python3-pip\`) and re-run.`,
+        });
+        return finalize(steps, false, false, "pip is required. Install python3-pip and re-run.");
+    }
+    mark(1, { status: "ok", detail: pip.join(" ") });
+    // Step 3: pip install (idempotent — pip will skip if already installed)
+    mark(2, { status: "running" });
+    try {
+        await runPipInstall(pip);
+        mark(2, { status: "ok" });
+    }
+    catch (err) {
+        mark(2, { status: "failed", detail: err.message });
+        return finalize(steps, false, false, "notebooklm-py install failed. Run `pip install --user notebooklm-py[browser]` manually and diagnose.");
+    }
+    // Step 4: playwright chromium
+    mark(3, { status: "running" });
+    try {
+        await runPlaywrightInstall(python);
+        mark(3, { status: "ok" });
+    }
+    catch (err) {
+        mark(3, { status: "failed", detail: err.message });
+        return finalize(steps, true, false, "Chromium install failed. Run `python3 -m playwright install chromium` manually.");
+    }
+    // Step 5: auth (conditionally skipped)
+    if (options.skipAuth) {
+        mark(4, { status: "skipped", detail: "skipAuth=true — run `notebooklm login` on a workstation later." });
+    }
+    else if (looksHeadless()) {
+        mark(4, {
+            status: "skipped",
+            detail: "No $DISPLAY detected. `notebooklm login` needs a visible browser. Run it on a workstation, then copy ~/.notebooklm/ to this host (or set NOTEBOOKLM_HOME).",
+        });
+    }
+    else {
+        mark(4, { status: "running" });
+        const timeout = options.loginTimeoutSeconds ?? 300;
+        try {
+            await runNotebookLMLogin(timeout);
+            mark(4, { status: "ok" });
+        }
+        catch (err) {
+            mark(4, { status: "failed", detail: err.message });
+        }
+    }
+    // Step 6: verify via the existing bridge
+    mark(5, { status: "running" });
+    const bridge = new NotebookLMBridge();
+    const availability = await bridge.checkAvailability();
+    mark(5, {
+        status: availability.authenticated ? "ok" : "failed",
+        detail: `installed=${availability.installed} authenticated=${availability.authenticated}`,
+    });
+    return finalize(steps, availability.installed, availability.authenticated, availability.authenticated
+        ? "NotebookLM is ready. Tier-3 Research phase now has notebook creation, source ingestion, web research, cited answers, and artifact generation."
+        : availability.installed
+            ? "NotebookLM installed but not authenticated. Run `/orient.research.setup` again once a display is available, or set NOTEBOOKLM_HOME to a pre-authenticated profile."
+            : "NotebookLM setup failed — see the step log above. Tier-3 Research will fall back to pi's built-in tools.");
+}
+function finalize(steps, installed, authenticated, message) {
+    return {
+        success: installed && authenticated,
+        steps,
+        installed,
+        authenticated,
+        message,
+    };
+}
+// ============================================================================
+// Shortcut helpers
+// ============================================================================
+/**
+ * Check whether the caller's environment has a notebooklm profile
+ * directory already (useful for detecting "setup has been run before"
+ * without invoking the bridge's auth-check subprocess).
+ */
+export function hasExistingProfile() {
+    const home = process.env.NOTEBOOKLM_HOME || `${process.env.HOME ?? "~"}/.notebooklm`;
+    const profile = process.env.NOTEBOOKLM_PROFILE || "default";
+    const stateFile = `${home}/profiles/${profile}/storage_state.json`;
+    return existsSync(stateFile);
+}
+/**
+ * Compact one-liner describing current setup state. Used by the
+ * session_start hook to surface status without running the full flow.
+ */
+export async function describeStatus() {
+    const bridge = new NotebookLMBridge();
+    const availability = await bridge.checkAvailability();
+    if (availability.authenticated)
+        return "notebooklm ready";
+    if (availability.installed)
+        return "notebooklm installed, not authenticated";
+    if (hasExistingProfile())
+        return "notebooklm profile found but CLI missing — reinstall via /orient.research.setup";
+    return "notebooklm not installed (auto-installs on tier-3 Research)";
+}
+// Re-export `execAsync` as a typed alias so callers that want to
+// extend the setup with custom steps can reuse the same promise-based
+// subprocess utility the module uses internally.
+export { execAsync };
+//# sourceMappingURL=setup.js.map

package/dist/integrations/notebooklm/setup.js.map

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

package/dist/integrations/playwright/bridge.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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`.
+ */
+export interface PlaywrightAvailability {
+    cliInstalled: boolean;
+    chromiumInstalled: boolean;
+    sessionName: string;
+}
+export interface PlaywrightSnapshot {
+    url: string;
+    title: string;
+    text: string;
+}
+/**
+ * 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 declare function checkPlaywrightAvailability(sessionName?: string): Promise<PlaywrightAvailability>;
+/**
+ * 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 declare function installChromium(onProgress?: (chunk: string) => void): Promise<void>;
+/**
+ * Navigate the session's browser to a URL. Opens the page if no page
+ * is active for the session yet.
+ */
+export declare function goto(url: string, sessionName?: string): Promise<string>;
+/**
+ * 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 declare function snapshot(sessionName?: string): Promise<PlaywrightSnapshot>;
+/**
+ * Click an element matched by a Playwright selector (CSS, text, role,
+ * or one of playwright-cli's own locator shortcuts).
+ */
+export declare function click(selector: string, sessionName?: string): Promise<string>;
+/**
+ * Fill a text input matched by `selector` with `value`.
+ */
+export declare function fill(selector: string, value: string, sessionName?: string): Promise<string>;
+/**
+ * Take a screenshot of the current page and save it to `outputPath`.
+ * Returns the full path of the saved file.
+ */
+export declare function screenshot(outputPath: string, sessionName?: string): Promise<string>;
+/**
+ * Evaluate JavaScript against the current page. Used for ad-hoc
+ * DOM extraction the agent couldn't get from `snapshot`.
+ */
+export declare function evaluate(expression: string, sessionName?: string): Promise<string>;
+/**
+ * Close the session's browser cleanly. Call this at end-of-packet so
+ * headless chromium processes don't linger.
+ */
+export declare function close(sessionName?: string): Promise<void>;