@cleocode/core 2026.6.11 → 2026.6.13

package/dist/tools/agent-tool-families.js.map

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

package/dist/tools/browser-driver.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Playwright browser driver — the OPTIONAL, lazily-loaded automation backend
+ * (T1742 · epic T11456 · SG-TOOLS).
+ *
+ * The `browser_*` tools' execution backend. Playwright is an OPTIONAL dependency
+ * (publish-surface discipline · D11136): it is NEVER a hard dependency of
+ * `@cleocode/core`. Like `node-pty` (see {@link ./pty.js}), it is deliberately
+ * NOT declared in `core`'s `dependencies` / `optionalDependencies` and is loaded
+ * ONLY via a dynamic `import()` whose specifier is held in a variable — so
+ * neither the bundler nor TS treats the missing package as a hard,
+ * statically-resolved dependency, the published `@cleocode/core` carries no
+ * Playwright weight, and `core` builds + tests pass with Playwright NOT installed.
+ * An environment that wants the browser tools opts in by installing `playwright`
+ * itself (`pnpm add playwright && pnpm exec playwright install chromium`).
+ *
+ * Import-time side-effect-free: NO top-level `playwright` import; the browser is
+ * launched lazily on the first navigation through a {@link BrowserSession}. When
+ * Playwright is absent, {@link isPlaywrightAvailable} resolves `false` and the
+ * browser tools' availability predicate hides them with an install hint —
+ * nothing throws at import.
+ *
+ * @epic T11456
+ * @task T1742
+ * @see ./pty.js — the analogous optional-native-dep (node-pty) lazy-load pattern
+ */
+import type { AccessibilityNode, BrowserNavigateInput, BrowserPageState } from '@cleocode/contracts/tools/web-tools';
+/**
+ * The npm install hint surfaced to the model when a browser tool is unavailable
+ * because Playwright is not installed. Playwright is an OPTIONAL dep — the
+ * browser tools are registered regardless, but report unavailable until this
+ * runs (AC8).
+ */
+export declare const PLAYWRIGHT_INSTALL_HINT: string;
+/** A keyboard handle (`page.keyboard`). */
+interface PwKeyboard {
+    press(key: string): Promise<void>;
+}
+/** A located element handle (`page.locator(...)`). */
+interface PwLocator {
+    click(options?: {
+        timeout?: number;
+    }): Promise<void>;
+    fill(value: string, options?: {
+        timeout?: number;
+    }): Promise<void>;
+    focus(options?: {
+        timeout?: number;
+    }): Promise<void>;
+}
+/** The accessibility snapshot surface (`page.accessibility`). */
+interface PwAccessibility {
+    snapshot(): Promise<AccessibilityNode | null>;
+}
+/** A Playwright `Page`. */
+interface PwPage {
+    goto(url: string, options?: {
+        waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+        timeout?: number;
+    }): Promise<unknown>;
+    url(): string;
+    title(): Promise<string>;
+    locator(selector: string): PwLocator;
+    readonly keyboard: PwKeyboard;
+    readonly accessibility: PwAccessibility;
+    screenshot(options?: {
+        fullPage?: boolean;
+    }): Promise<Buffer | Uint8Array>;
+    evaluate<T>(fn: string): Promise<T>;
+}
+/** A Playwright `Browser`. */
+interface PwBrowser {
+    newPage(): Promise<PwPage>;
+    close(): Promise<void>;
+}
+/** The `chromium` browser-type launcher. */
+interface PwBrowserType {
+    launch(options?: {
+        headless?: boolean;
+    }): Promise<PwBrowser>;
+}
+/** The minimal shape of the `playwright` module we depend on. */
+interface PlaywrightModule {
+    readonly chromium: PwBrowserType;
+}
+export declare function isPlaywrightAvailable(): Promise<boolean>;
+/**
+ * Reset the cached Playwright-availability probe.
+ *
+ * EXPORTED FOR TESTS ONLY — lets a unit test toggle the mocked availability of
+ * the optional dep between cases without a fresh module graph.
+ *
+ * @internal
+ */
+export declare function __resetPlaywrightAvailabilityCache(): void;
+/**
+ * The injectable factory the {@link BrowserSession} uses to obtain a Playwright
+ * module. Defaults to the real lazy {@link loadPlaywright}; unit tests inject a
+ * fake so NO real browser is ever launched (AC9).
+ */
+export type PlaywrightLoader = () => Promise<PlaywrightModule | null>;
+/**
+ * A single browser session: lazily launches a headless Chromium on the first
+ * navigation, then reuses the same page for subsequent interactions. Holds no
+ * Playwright reference until {@link BrowserSession.navigate} is first called, so
+ * constructing one is free and import-time side-effect-free.
+ *
+ * The browser tools share ONE session per registry run (created by the browser
+ * tool family at registration). All Playwright access funnels through here so
+ * the lazy-load + teardown live in one place.
+ */
+export declare class BrowserSession {
+    #private;
+    /**
+     * @param load - Optional Playwright loader (defaults to the real lazy import).
+     *   Tests pass a fake that returns a mock module — no real browser launches.
+     */
+    constructor(load?: PlaywrightLoader);
+    /**
+     * Navigate to a URL (launching the browser on first call).
+     *
+     * @param input - {@link BrowserNavigateInput}.
+     * @returns The page state after navigation.
+     */
+    navigate(input: BrowserNavigateInput): Promise<BrowserPageState>;
+    /**
+     * Click the element matching `selector`.
+     *
+     * @param selector - CSS / Playwright selector.
+     * @param timeoutMs - Per-action timeout.
+     * @returns The page state after the click.
+     */
+    click(selector: string, timeoutMs?: number): Promise<BrowserPageState>;
+    /**
+     * Type `text` into the element matching `selector`.
+     *
+     * @param selector - CSS / Playwright selector.
+     * @param text - Text to enter (`fill` replaces the field's content).
+     * @param timeoutMs - Per-action timeout.
+     * @returns The page state after typing.
+     */
+    type(selector: string, text: string, timeoutMs?: number): Promise<BrowserPageState>;
+    /**
+     * Press a key / chord, optionally focusing `selector` first.
+     *
+     * @param key - Playwright key syntax (e.g. `Enter`, `Control+A`).
+     * @param selector - Optional element to focus before pressing.
+     * @param timeoutMs - Per-action timeout (for the focus step).
+     * @returns The page state after the keypress.
+     */
+    press(key: string, selector?: string, timeoutMs?: number): Promise<BrowserPageState>;
+    /**
+     * Capture the page's accessibility tree.
+     *
+     * @returns The page state plus the accessibility tree root (or `null`).
+     */
+    snapshot(): Promise<BrowserPageState & {
+        tree: AccessibilityNode | null;
+    }>;
+    /**
+     * Scroll the page vertically by `amountPx` in `direction` and report the new
+     * scroll offset.
+     *
+     * @param direction - `up` or `down`.
+     * @param amountPx - Pixels to scroll (defaults to ~one viewport).
+     * @returns The page state plus the post-scroll `scrollY`.
+     */
+    scroll(direction: 'up' | 'down', amountPx?: number): Promise<BrowserPageState & {
+        scrollY: number;
+    }>;
+    /**
+     * Capture a screenshot of the current page as base64-encoded PNG bytes.
+     *
+     * @param fullPage - Capture the full scrollable page when `true`.
+     * @returns The page state plus the base64 PNG and the page state.
+     */
+    screenshot(fullPage?: boolean): Promise<BrowserPageState & {
+        base64Png: string;
+    }>;
+    /** Close the browser and release the page (idempotent). */
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=browser-driver.d.ts.map

package/dist/tools/browser-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-driver.d.ts","sourceRoot":"","sources":["../../src/tools/browser-driver.ts"],"names":[],"mappings":"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"}

package/dist/tools/browser-driver.js

@@ -0,0 +1,242 @@
+/**
+ * Playwright browser driver — the OPTIONAL, lazily-loaded automation backend
+ * (T1742 · epic T11456 · SG-TOOLS).
+ *
+ * The `browser_*` tools' execution backend. Playwright is an OPTIONAL dependency
+ * (publish-surface discipline · D11136): it is NEVER a hard dependency of
+ * `@cleocode/core`. Like `node-pty` (see {@link ./pty.js}), it is deliberately
+ * NOT declared in `core`'s `dependencies` / `optionalDependencies` and is loaded
+ * ONLY via a dynamic `import()` whose specifier is held in a variable — so
+ * neither the bundler nor TS treats the missing package as a hard,
+ * statically-resolved dependency, the published `@cleocode/core` carries no
+ * Playwright weight, and `core` builds + tests pass with Playwright NOT installed.
+ * An environment that wants the browser tools opts in by installing `playwright`
+ * itself (`pnpm add playwright && pnpm exec playwright install chromium`).
+ *
+ * Import-time side-effect-free: NO top-level `playwright` import; the browser is
+ * launched lazily on the first navigation through a {@link BrowserSession}. When
+ * Playwright is absent, {@link isPlaywrightAvailable} resolves `false` and the
+ * browser tools' availability predicate hides them with an install hint —
+ * nothing throws at import.
+ *
+ * @epic T11456
+ * @task T1742
+ * @see ./pty.js — the analogous optional-native-dep (node-pty) lazy-load pattern
+ */
+import { getLogger } from '../logger.js';
+const log = getLogger('tool-browser');
+/**
+ * The npm install hint surfaced to the model when a browser tool is unavailable
+ * because Playwright is not installed. Playwright is an OPTIONAL dep — the
+ * browser tools are registered regardless, but report unavailable until this
+ * runs (AC8).
+ */
+export const PLAYWRIGHT_INSTALL_HINT = 'Browser tools require the optional "playwright" package. Install it with ' +
+    '`pnpm add playwright && pnpm exec playwright install chromium`, then retry.';
+/**
+ * Attempt to lazily load `playwright`. Returns `null` when the optional dep is
+ * not installed or fails to load (any reason), so callers can report the browser
+ * tools as unavailable rather than crashing.
+ *
+ * The import specifier is held in a variable so bundlers / TS do not treat the
+ * missing optional dep as a hard, statically-resolved dependency (same technique
+ * as {@link ./pty.js}'s `node-pty` load).
+ *
+ * @returns The loaded module shape, or `null` when unavailable.
+ */
+async function loadPlaywright() {
+    const specifier = 'playwright';
+    try {
+        const mod = await import(specifier);
+        const candidate = mod.default ?? mod;
+        if (candidate !== null &&
+            typeof candidate === 'object' &&
+            typeof candidate.chromium === 'object') {
+            return candidate;
+        }
+        return null;
+    }
+    catch (err) {
+        log.debug({ err }, 'playwright not loadable — browser tools unavailable');
+        return null;
+    }
+}
+/**
+ * Whether the optional `playwright` package can be loaded in this process.
+ *
+ * Used by the browser tools' {@link import('./agent-registry.js').AvailabilityCheck}
+ * (via the registry's `capabilities` flag) so they are hidden — with
+ * {@link PLAYWRIGHT_INSTALL_HINT} — when Playwright is absent (AC8). The result is
+ * cached after the first probe so availability checks stay cheap.
+ *
+ * @returns `true` when `playwright` is importable, else `false`.
+ */
+let cachedAvailable;
+export async function isPlaywrightAvailable() {
+    if (cachedAvailable !== undefined)
+        return cachedAvailable;
+    cachedAvailable = (await loadPlaywright()) !== null;
+    return cachedAvailable;
+}
+/**
+ * Reset the cached Playwright-availability probe.
+ *
+ * EXPORTED FOR TESTS ONLY — lets a unit test toggle the mocked availability of
+ * the optional dep between cases without a fresh module graph.
+ *
+ * @internal
+ */
+export function __resetPlaywrightAvailabilityCache() {
+    cachedAvailable = undefined;
+}
+/**
+ * A single browser session: lazily launches a headless Chromium on the first
+ * navigation, then reuses the same page for subsequent interactions. Holds no
+ * Playwright reference until {@link BrowserSession.navigate} is first called, so
+ * constructing one is free and import-time side-effect-free.
+ *
+ * The browser tools share ONE session per registry run (created by the browser
+ * tool family at registration). All Playwright access funnels through here so
+ * the lazy-load + teardown live in one place.
+ */
+export class BrowserSession {
+    #browser = null;
+    #page = null;
+    #load;
+    /**
+     * @param load - Optional Playwright loader (defaults to the real lazy import).
+     *   Tests pass a fake that returns a mock module — no real browser launches.
+     */
+    constructor(load = loadPlaywright) {
+        this.#load = load;
+    }
+    /**
+     * Ensure a page exists, launching the browser on first use. Throws a typed
+     * error when Playwright is unavailable so the tool executable can surface the
+     * install hint (the tool's `available()` predicate normally hides it first).
+     *
+     * @returns The active page.
+     */
+    async #ensurePage() {
+        if (this.#page !== null)
+            return this.#page;
+        const pw = await this.#load();
+        if (pw === null) {
+            throw new Error(`E_BROWSER_UNAVAILABLE: ${PLAYWRIGHT_INSTALL_HINT}`);
+        }
+        this.#browser = await pw.chromium.launch({ headless: true });
+        this.#page = await this.#browser.newPage();
+        return this.#page;
+    }
+    /** The current page state (url + title). */
+    async #state(page) {
+        return { url: page.url(), title: await page.title() };
+    }
+    /**
+     * Navigate to a URL (launching the browser on first call).
+     *
+     * @param input - {@link BrowserNavigateInput}.
+     * @returns The page state after navigation.
+     */
+    async navigate(input) {
+        const page = await this.#ensurePage();
+        await page.goto(input.url, {
+            waitUntil: input.waitUntil ?? 'load',
+            timeout: input.timeoutMs ?? 30000,
+        });
+        return this.#state(page);
+    }
+    /**
+     * Click the element matching `selector`.
+     *
+     * @param selector - CSS / Playwright selector.
+     * @param timeoutMs - Per-action timeout.
+     * @returns The page state after the click.
+     */
+    async click(selector, timeoutMs = 15000) {
+        const page = await this.#ensurePage();
+        await page.locator(selector).click({ timeout: timeoutMs });
+        return this.#state(page);
+    }
+    /**
+     * Type `text` into the element matching `selector`.
+     *
+     * @param selector - CSS / Playwright selector.
+     * @param text - Text to enter (`fill` replaces the field's content).
+     * @param timeoutMs - Per-action timeout.
+     * @returns The page state after typing.
+     */
+    async type(selector, text, timeoutMs = 15000) {
+        const page = await this.#ensurePage();
+        await page.locator(selector).fill(text, { timeout: timeoutMs });
+        return this.#state(page);
+    }
+    /**
+     * Press a key / chord, optionally focusing `selector` first.
+     *
+     * @param key - Playwright key syntax (e.g. `Enter`, `Control+A`).
+     * @param selector - Optional element to focus before pressing.
+     * @param timeoutMs - Per-action timeout (for the focus step).
+     * @returns The page state after the keypress.
+     */
+    async press(key, selector, timeoutMs = 15000) {
+        const page = await this.#ensurePage();
+        if (selector !== undefined) {
+            await page.locator(selector).focus({ timeout: timeoutMs });
+        }
+        await page.keyboard.press(key);
+        return this.#state(page);
+    }
+    /**
+     * Capture the page's accessibility tree.
+     *
+     * @returns The page state plus the accessibility tree root (or `null`).
+     */
+    async snapshot() {
+        const page = await this.#ensurePage();
+        const tree = await page.accessibility.snapshot();
+        return { ...(await this.#state(page)), tree };
+    }
+    /**
+     * Scroll the page vertically by `amountPx` in `direction` and report the new
+     * scroll offset.
+     *
+     * @param direction - `up` or `down`.
+     * @param amountPx - Pixels to scroll (defaults to ~one viewport).
+     * @returns The page state plus the post-scroll `scrollY`.
+     */
+    async scroll(direction, amountPx = 800) {
+        const page = await this.#ensurePage();
+        const delta = direction === 'down' ? amountPx : -amountPx;
+        // `evaluate(string)` so this file never imports playwright's function-arg
+        // serialization types; the page runs the scroll + returns the new offset.
+        const scrollY = await page.evaluate(`(() => { window.scrollBy(0, ${delta}); return window.scrollY; })()`);
+        return { ...(await this.#state(page)), scrollY };
+    }
+    /**
+     * Capture a screenshot of the current page as base64-encoded PNG bytes.
+     *
+     * @param fullPage - Capture the full scrollable page when `true`.
+     * @returns The page state plus the base64 PNG and the page state.
+     */
+    async screenshot(fullPage = false) {
+        const page = await this.#ensurePage();
+        const buf = await page.screenshot({ fullPage });
+        const base64Png = Buffer.from(buf).toString('base64');
+        return { ...(await this.#state(page)), base64Png };
+    }
+    /** Close the browser and release the page (idempotent). */
+    async close() {
+        if (this.#browser !== null) {
+            try {
+                await this.#browser.close();
+            }
+            catch (err) {
+                log.debug({ err }, 'browser close failed (ignored)');
+            }
+        }
+        this.#browser = null;
+        this.#page = null;
+    }
+}
+//# sourceMappingURL=browser-driver.js.map

package/dist/tools/browser-driver.js.map

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

package/dist/tools/builtin-agent-tools.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Built-in agent tools (T1739 · epic T11456 · SG-TOOLS).
+ *
+ * Wires the existing CORE-SDK atomic primitives ({@link ./fs.js} +
+ * {@link ./shell.js}) into the agent-facing {@link ./agent-registry.js |
+ * AgentToolRegistry} as its FIRST registered tools, so the registry is never
+ * empty and the Pi adapter / ModelRunner can consume them immediately. Every
+ * built-in tool:
+ *
+ *   - declares a Zod parameter schema (→ OpenAI-format schema via AC3);
+ *   - declares its agent-facing {@link Toolset} group (AC4) and side-effect
+ *     {@link ToolClass};
+ *   - declares an {@link AvailabilityCheck} (AC5) — e.g. `run_git` is only
+ *     available when a `git` binary is known to be on PATH;
+ *   - performs ALL side effects through the injected {@link GuardedToolSurface}
+ *     (NEVER raw `fs`/`shell`), so the deny-first guard chokepoint
+ *     ({@link ./guard.js}) policy still applies — there is no bypass.
+ *
+ * The model-visible names are snake_case (OpenAI-function convention); the
+ * underlying primitive names live in `@cleocode/contracts/tools/atomic`.
+ *
+ * @task T1739
+ * @epic T11456
+ */
+import type { AgentToolRegistry } from './agent-registry.js';
+/**
+ * Register the built-in atomic-primitive tools into `registry`.
+ *
+ * Invoked by {@link AgentToolRegistry.init} (unless `skipBuiltins`). Pure
+ * registration — no I/O, no scan; the tools' side effects happen later through
+ * the {@link GuardedToolSurface} their executables receive.
+ *
+ * @param registry - The registry to populate.
+ */
+export declare function registerBuiltinAgentTools(registry: AgentToolRegistry): void;
+//# sourceMappingURL=builtin-agent-tools.d.ts.map

package/dist/tools/builtin-agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-agent-tools.d.ts","sourceRoot":"","sources":["../../src/tools/builtin-agent-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAqB,MAAM,qBAAqB,CAAC;AAUhF;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAkH3E"}