@cleocode/core 2026.6.12 → 2026.6.13

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"}

package/dist/tools/builtin-agent-tools.js

@@ -0,0 +1,150 @@
+/**
+ * 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 { z } from 'zod';
+import { ALWAYS_AVAILABLE } from './agent-registry.js';
+import { registerAgentToolFamilies } from './agent-tool-families.js';
+import { registerWebAgentTools } from './web-agent-tools.js';
+/** Available only when the named binary is known on PATH (AC5 example). */
+function binaryAvailable(name) {
+    return (ctx) => ctx.availableBinaries === undefined || ctx.availableBinaries.includes(name);
+}
+/**
+ * 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 function registerBuiltinAgentTools(registry) {
+    // --- file toolset (fs class) ---------------------------------------------
+    registry.register({
+        name: 'read_file',
+        class: 'fs',
+        description: 'Read a file as UTF-8 text.',
+        toolset: 'file',
+        stateless: true,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            path: z.string().describe('Absolute path to the file to read.'),
+        }),
+        execute: async (args, tools) => {
+            const path = String(args.path);
+            return tools.readFileText({ path });
+        },
+    });
+    registry.register({
+        name: 'write_file',
+        class: 'fs',
+        description: 'Atomically write a file (tmp-then-rename), creating parent dirs.',
+        toolset: 'file',
+        stateless: true,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            path: z.string().describe('Absolute path to write.'),
+            content: z.string().describe('File content to write.'),
+        }),
+        execute: async (args, tools) => {
+            const path = String(args.path);
+            const content = String(args.content);
+            return tools.writeFileAtomic({ path, content });
+        },
+    });
+    registry.register({
+        name: 'path_exists',
+        class: 'fs',
+        description: 'Test whether a path exists and what kind of entry it is.',
+        toolset: 'file',
+        stateless: true,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            path: z.string().describe('Absolute path to test.'),
+        }),
+        execute: async (args, tools) => {
+            const path = String(args.path);
+            return tools.pathExists({ path });
+        },
+    });
+    // --- terminal toolset (shell class) --------------------------------------
+    registry.register({
+        name: 'run_command',
+        class: 'shell',
+        description: 'Run a single executable (argv form, no shell) with cwd/timeout.',
+        toolset: 'terminal',
+        stateless: true,
+        available: ALWAYS_AVAILABLE,
+        parameters: z.object({
+            command: z.string().describe('Executable to run (NOT a shell string).'),
+            args: z.array(z.string()).optional().describe('Arguments for the command.'),
+            cwd: z.string().optional().describe('Working directory.'),
+            timeoutMs: z.number().int().positive().optional().describe('Hard timeout in ms.'),
+        }),
+        execute: async (args, tools) => {
+            const command = String(args.command);
+            const argv = Array.isArray(args.args) ? args.args.map(String) : undefined;
+            const cwd = args.cwd === undefined ? undefined : String(args.cwd);
+            const timeoutMs = typeof args.timeoutMs === 'number' ? args.timeoutMs : undefined;
+            return tools.executeShell({ command, args: argv, cwd, timeoutMs });
+        },
+    });
+    registry.register({
+        name: 'run_git',
+        class: 'shell',
+        description: 'Run a git subcommand and capture stdout/stderr/exit-code.',
+        toolset: 'terminal',
+        stateless: true,
+        available: binaryAvailable('git'),
+        parameters: z.object({
+            args: z.array(z.string()).describe("Git arguments, e.g. ['status', '--porcelain']."),
+            cwd: z.string().optional().describe('Repository working directory.'),
+            timeoutMs: z.number().int().positive().optional().describe('Hard timeout in ms.'),
+        }),
+        execute: async (args, tools) => {
+            const gitArgs = Array.isArray(args.args) ? args.args.map(String) : [];
+            const cwd = args.cwd === undefined ? undefined : String(args.cwd);
+            const timeoutMs = typeof args.timeoutMs === 'number' ? args.timeoutMs : undefined;
+            return tools.runGit({ args: gitArgs, cwd, timeoutMs });
+        },
+    });
+    // Note: the `media` (notebook) primitives are NOT yet implemented in
+    // `core/src/tools/*` (only their contracts exist in atomic.ts). That toolset is
+    // intentionally empty until a later stage ships its primitives; the registry
+    // already supports it (AC4) so registration is a one-liner then.
+    // The richer agent-facing tool families (T1741): terminal `run_shell` (PTY +
+    // spawn), paginated `read_file_paged`, atomic `write_file_atomic`, fuzzy
+    // `apply_patch`, ripgrep `search_files`, and the git family
+    // (status/diff/log/commit). All route through the same guarded surface.
+    registerAgentToolFamilies(registry);
+    // The web + browser family (T1742): `web` toolset — `web_search` (pluggable,
+    // keyless backends), `web_extract` (HTML→markdown), and the Playwright-driven
+    // `browser_*` tools. Playwright is an OPTIONAL, lazily-loaded dependency: the
+    // browser tools register but their availability predicate hides them (with an
+    // install hint) until a context advertises the playwright capability, so core
+    // builds + runs with playwright NOT installed. The web tools' network egress +
+    // the `browser_vision` AI call (via resolveLLMForSystem) use no raw bypass.
+    registerWebAgentTools(registry);
+}
+//# sourceMappingURL=builtin-agent-tools.js.map

package/dist/tools/builtin-agent-tools.js.map

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