craftdriver 0.0.3 → 0.2.0

package/dist/cli/mcp/tools.js

@@ -0,0 +1,236 @@
+import { dispatch } from '../dispatcher.js';
+const STRING_SELECTOR = {
+    type: 'string',
+    description: "CSS by default. Switch kind with a prefix: 'role=button[name=Submit]', " +
+        "'text=Sign In', 'text*=Sign', 'label=Email', 'placeholder=...', " +
+        "'testid=...', 'xpath=...', 'id=...', 'name=...'.",
+};
+export const TOOLS = [
+    {
+        name: 'browser_navigate',
+        description: 'Navigate the active page to a URL. Waits for load.',
+        inputSchema: {
+            type: 'object',
+            properties: { url: { type: 'string' } },
+            required: ['url'],
+        },
+        mutating: true,
+        toDispatch: (a) => ({ cmd: 'go', args: { url: a.url } }),
+    },
+    {
+        name: 'browser_click',
+        description: 'Click an element. Auto-waits for visible+enabled. Returns NO_MATCH immediately ' +
+            'when the selector matches zero elements at t=0.',
+        inputSchema: {
+            type: 'object',
+            properties: { selector: STRING_SELECTOR, timeout_ms: { type: 'number' } },
+            required: ['selector'],
+        },
+        mutating: true,
+        toDispatch: (a) => ({ cmd: 'click', args: { selector: a.selector, timeout: a.timeout_ms } }),
+    },
+    {
+        name: 'browser_fill',
+        description: 'Fill an input/textarea/select. The library auto-clears before typing. ' +
+            'For checkboxes prefer browser_click with the matching label.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                selector: STRING_SELECTOR,
+                value: { type: 'string' },
+                timeout_ms: { type: 'number' },
+            },
+            required: ['selector', 'value'],
+        },
+        mutating: true,
+        toDispatch: (a) => ({
+            cmd: 'fill',
+            args: { selector: a.selector, value: a.value, timeout: a.timeout_ms },
+        }),
+    },
+    {
+        name: 'browser_press',
+        description: 'Press a keyboard key (e.g. "Enter", "Tab", "Control+A"). Optional selector ' +
+            'focuses an element first.',
+        inputSchema: {
+            type: 'object',
+            properties: { key: { type: 'string' }, selector: STRING_SELECTOR },
+            required: ['key'],
+        },
+        mutating: true,
+        toDispatch: (a) => ({
+            cmd: 'press',
+            args: { key: a.key, ...(a.selector ? { selector: a.selector } : {}) },
+        }),
+    },
+    {
+        name: 'browser_hover',
+        description: 'Hover over an element.',
+        inputSchema: {
+            type: 'object',
+            properties: { selector: STRING_SELECTOR, timeout_ms: { type: 'number' } },
+            required: ['selector'],
+        },
+        mutating: true,
+        toDispatch: (a) => ({ cmd: 'hover', args: { selector: a.selector, timeout: a.timeout_ms } }),
+    },
+    {
+        name: 'browser_find',
+        description: 'Locate elements without acting on them. Returns up to `limit` matches with ' +
+            'tag, text snippet, and visibility. Use `all: true` to enumerate.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                selector: STRING_SELECTOR,
+                all: { type: 'boolean' },
+                limit: { type: 'number' },
+                offset: { type: 'number' },
+            },
+            required: ['selector'],
+        },
+        mutating: false,
+        toDispatch: (a) => ({
+            cmd: 'find',
+            args: { selector: a.selector, all: a.all, limit: a.limit, offset: a.offset },
+        }),
+    },
+    {
+        name: 'browser_exists',
+        description: 'Zero-wait probe: returns { exists, count } immediately. Call this BEFORE ' +
+            'browser_click/wait when you are guessing a selector — it costs one BiDi ' +
+            "roundtrip instead of the full 5 s timeout.",
+        inputSchema: {
+            type: 'object',
+            properties: { selector: STRING_SELECTOR },
+            required: ['selector'],
+        },
+        mutating: false,
+        toDispatch: (a) => ({ cmd: 'exists', args: { selector: a.selector } }),
+    },
+    {
+        name: 'browser_wait',
+        description: 'Wait for a condition: selector to become visible/hidden/attached/detached, ' +
+            'or a load state (load|domcontentloaded|networkidle).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                target: { type: 'string' },
+                kind: { type: 'string', enum: ['selector', 'load'] },
+                state: { type: 'string' },
+                timeout_ms: { type: 'number' },
+            },
+            required: ['target'],
+        },
+        mutating: false,
+        toDispatch: (a) => ({
+            cmd: 'wait',
+            args: { target: a.target, kind: a.kind ?? 'selector', state: a.state, timeout: a.timeout_ms },
+        }),
+    },
+    {
+        name: 'browser_read',
+        description: 'Read text/attr/value/is-state from an element, or page body text when no ' +
+            'selector is given. `kind` defaults to "text".',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                selector: STRING_SELECTOR,
+                kind: { type: 'string', enum: ['text', 'attr', 'value', 'is'] },
+                name: { type: 'string', description: 'attribute name when kind=attr' },
+                what: {
+                    type: 'string',
+                    enum: ['visible', 'enabled', 'checked'],
+                    description: 'state when kind=is',
+                },
+            },
+        },
+        mutating: false,
+        toDispatch: (a) => {
+            const kind = a.kind ?? 'text';
+            if (kind === 'attr')
+                return { cmd: 'attr', args: { selector: a.selector, name: a.name } };
+            if (kind === 'value')
+                return { cmd: 'value', args: { selector: a.selector } };
+            if (kind === 'is')
+                return { cmd: 'is', args: { selector: a.selector, what: a.what } };
+            return { cmd: 'text', args: { ...(a.selector ? { selector: a.selector } : {}) } };
+        },
+    },
+    {
+        name: 'browser_pages',
+        description: 'List open pages with id/url/title. Use for tab/popup-aware flows.',
+        inputSchema: { type: 'object', properties: {} },
+        mutating: false,
+        toDispatch: () => ({ cmd: 'pages', args: {} }),
+    },
+    {
+        name: 'browser_snapshot',
+        description: 'Sanitized accessibility-tree summary of the active page: one line ' +
+            'per visible interactive element with role, accessible name, and a ' +
+            'stable ref (`e1`, `e2`, …). Use `ref=eN` as the selector for ' +
+            'subsequent tool calls — refs are auto-resolved without DOM hunting ' +
+            'and invalidate on the next snapshot or navigation. Cheaper and ' +
+            'more reliable than browser_screenshot for understanding the page.',
+        inputSchema: { type: 'object', properties: {} },
+        mutating: false,
+        toDispatch: () => ({ cmd: 'snapshot', args: {} }),
+    },
+    {
+        name: 'browser_screenshot',
+        description: 'Capture a PNG of the active page or a specific element. Always written ' +
+            'to disk under the per-session artifact directory; the response carries ' +
+            'the absolute path and byte count (zero image tokens). Pass `path` to ' +
+            'choose your own destination.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                selector: STRING_SELECTOR,
+                full_page: { type: 'boolean' },
+                path: {
+                    type: 'string',
+                    description: 'Absolute path to write the PNG to. If omitted, an artifact ' +
+                        'path is auto-allocated.',
+                },
+            },
+        },
+        mutating: false,
+        returnsImage: true,
+        toDispatch: (a) => ({
+            cmd: 'screenshot',
+            args: {
+                ...(a.selector ? { selector: a.selector } : {}),
+                fullPage: a.full_page,
+                ...(a.path ? { path: a.path } : {}),
+            },
+        }),
+    },
+    {
+        name: 'browser_status',
+        description: 'Report whether a browser is up and which URL is active.',
+        inputSchema: { type: 'object', properties: {} },
+        mutating: false,
+        toDispatch: () => ({ cmd: 'status', args: {} }),
+    },
+    {
+        name: 'browser_advanced_eval',
+        description: 'Evaluate arbitrary JavaScript in the page. LAST RESORT — prefer ' +
+            'browser_find/click/fill when possible. Costs tokens and bypasses auto-wait.',
+        inputSchema: {
+            type: 'object',
+            properties: { js: { type: 'string' } },
+            required: ['js'],
+        },
+        mutating: true,
+        toDispatch: (a) => ({ cmd: 'eval', args: { js: a.js } }),
+    },
+];
+const BY_NAME = new Map(TOOLS.map((t) => [t.name, t]));
+export function getTool(name) {
+    return BY_NAME.get(name);
+}
+/** Run a tool against the dispatcher. Throws CraftdriverError on failure. */
+export async function runTool(ctx, tool, args) {
+    const mapped = tool.toDispatch(args);
+    return dispatch(ctx, mapped.cmd, mapped.args);
+}
+//# sourceMappingURL=tools.js.map

package/dist/cli/mcp/tools.js.map

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

package/dist/cli/parseArgs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Translate raw `argv` into a `(cmd, args)` pair that the dispatcher
+ * understands. Hand-rolled because v1 has ~20 commands; pulling in
+ * `commander`/`yargs` would dwarf the library footprint.
+ *
+ * Recognised global flags (anywhere on the command line):
+ *   --timeout <ms>          per-call timeout override
+ *   --json                  force JSON output even on a TTY
+ *   --pretty                force pretty output even when piped
+ *   --explain               include one-line BiDi step log (placeholder)
+ *   --headless / --headed   launch option (only honoured for ephemeral / first daemon start)
+ *   --browser <name>        chrome|chromium|firefox
+ *   --ephemeral             run from stdin, don't talk to daemon
+ *
+ * Returns `null` when the user only asked for help / version.
+ */
+import type { LaunchOptions } from '../lib/browser.js';
+export interface GlobalFlags {
+    json?: boolean;
+    pretty?: boolean;
+    explain?: boolean;
+    ephemeral?: boolean;
+    help?: boolean;
+    version?: boolean;
+    launch: LaunchOptions;
+    /** When set, `craftdriver` should set `process.env.HEADLESS` before launch. */
+    headless?: boolean;
+    timeout?: number;
+}
+export interface ParsedCommand {
+    cmd: string;
+    args: Record<string, unknown>;
+    flags: GlobalFlags;
+}
+export declare const HELP_TEXT = "craftdriver \u2014 agent-first WebDriver CLI\n\nUSAGE\n  craftdriver <command> [args...] [flags]\n\nCOMMON COMMANDS\n  go <url>                          navigate the active page\n  find <selector> [--all] [--limit N] [--offset M]\n  click <selector>\n  fill <selector> <value>\n  press <key> [selector]\n  hover <selector>\n  text [selector] [--limit N]\n  attr <selector> <name>\n  value <selector>\n  is visible|enabled|checked <selector>\n  wait <selector> [--state visible|hidden|attached|detached] [--timeout ms]\n  wait load [--state load|domcontentloaded|networkidle]\n  exists <selector>                 0-wait probe; exit 0 if any match\n  pages                             list open pages\n  snapshot                          sanitized DOM summary with refs\n                                    (use ref=eN as a selector)\n  screenshot [-o file.png] [--full-page] [--selector S]\n  eval <js>                         advanced; evaluate JS on active page\n  back | forward | reload | status | quit\n\nDAEMON\n  daemon start                      launch background browser (Unix socket)\n  daemon status                     PID, browser, active page URL\n  daemon stop                       graceful shutdown\n\nINIT (agent guide files for the current project)\n  init <flavor> [--force] [--dry-run]\n    flavors: agents | copilot | claude | cursor | gemini | all\n    writes a short rules file under the path each tool expects:\n      agents  \u2192 AGENTS.md\n      copilot \u2192 .github/copilot-instructions.md\n      claude  \u2192 CLAUDE.md\n      cursor  \u2192 .cursor/rules/craftdriver.mdc\n      gemini  \u2192 GEMINI.md\n      all     \u2192 every file above\n\nMCP SERVER (for hosted / sandboxed AI agents)\n  mcp                                speak Model Context Protocol on stdio\n    install snippet (Claude Code):\n      claude mcp add craftdriver -- npx -y craftdriver mcp\n    install snippet (Cursor / Windsurf / Zed):\n      { \"mcpServers\": { \"craftdriver\": {\n          \"command\": \"npx\", \"args\": [\"-y\", \"craftdriver\", \"mcp\"] } } }\n\nEPHEMERAL MODE (sandboxed agents)\n  craftdriver --ephemeral < script.txt\n  (one command per line; same syntax as on the CLI)\n\nSELECTOR SYNTAX\n  CSS by default. Prefix to switch kind:\n    role=button[name=Submit]   text=Sign In       label=Email\n    placeholder=Search\u2026        testid=login-btn   xpath=//div[1]\n\nFLAGS\n  --timeout <ms>                    per-call timeout (default 5000ms)\n  --json | --pretty                 force output format\n  --headless / --headed             override headless mode (first launch only)\n  --browser <chrome|chromium|firefox>\n  --ephemeral                       no daemon; read commands from stdin\n\nEXIT CODES\n  0 success    1 assertion/timeout/no-match    2 usage error\n";
+export declare function parseArgv(argv: string[]): ParsedCommand | null;
+//# sourceMappingURL=parseArgs.d.ts.map

package/dist/cli/parseArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.d.ts","sourceRoot":"","sources":["../../src/cli/parseArgs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,2vFAoErB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,GAAG,IAAI,CA2I9D"}

package/dist/cli/parseArgs.js

@@ -0,0 +1,215 @@
+export const HELP_TEXT = `craftdriver — agent-first WebDriver CLI
+
+USAGE
+  craftdriver <command> [args...] [flags]
+
+COMMON COMMANDS
+  go <url>                          navigate the active page
+  find <selector> [--all] [--limit N] [--offset M]
+  click <selector>
+  fill <selector> <value>
+  press <key> [selector]
+  hover <selector>
+  text [selector] [--limit N]
+  attr <selector> <name>
+  value <selector>
+  is visible|enabled|checked <selector>
+  wait <selector> [--state visible|hidden|attached|detached] [--timeout ms]
+  wait load [--state load|domcontentloaded|networkidle]
+  exists <selector>                 0-wait probe; exit 0 if any match
+  pages                             list open pages
+  snapshot                          sanitized DOM summary with refs
+                                    (use ref=eN as a selector)
+  screenshot [-o file.png] [--full-page] [--selector S]
+  eval <js>                         advanced; evaluate JS on active page
+  back | forward | reload | status | quit
+
+DAEMON
+  daemon start                      launch background browser (Unix socket)
+  daemon status                     PID, browser, active page URL
+  daemon stop                       graceful shutdown
+
+INIT (agent guide files for the current project)
+  init <flavor> [--force] [--dry-run]
+    flavors: agents | copilot | claude | cursor | gemini | all
+    writes a short rules file under the path each tool expects:
+      agents  → AGENTS.md
+      copilot → .github/copilot-instructions.md
+      claude  → CLAUDE.md
+      cursor  → .cursor/rules/craftdriver.mdc
+      gemini  → GEMINI.md
+      all     → every file above
+
+MCP SERVER (for hosted / sandboxed AI agents)
+  mcp                                speak Model Context Protocol on stdio
+    install snippet (Claude Code):
+      claude mcp add craftdriver -- npx -y craftdriver mcp
+    install snippet (Cursor / Windsurf / Zed):
+      { "mcpServers": { "craftdriver": {
+          "command": "npx", "args": ["-y", "craftdriver", "mcp"] } } }
+
+EPHEMERAL MODE (sandboxed agents)
+  craftdriver --ephemeral < script.txt
+  (one command per line; same syntax as on the CLI)
+
+SELECTOR SYNTAX
+  CSS by default. Prefix to switch kind:
+    role=button[name=Submit]   text=Sign In       label=Email
+    placeholder=Search…        testid=login-btn   xpath=//div[1]
+
+FLAGS
+  --timeout <ms>                    per-call timeout (default ${5000}ms)
+  --json | --pretty                 force output format
+  --headless / --headed             override headless mode (first launch only)
+  --browser <chrome|chromium|firefox>
+  --ephemeral                       no daemon; read commands from stdin
+
+EXIT CODES
+  0 success    1 assertion/timeout/no-match    2 usage error
+`;
+export function parseArgv(argv) {
+    const flags = { launch: {} };
+    const positional = [];
+    const opts = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--help' || a === '-h')
+            flags.help = true;
+        else if (a === '--version' || a === '-V')
+            flags.version = true;
+        else if (a === '--json')
+            flags.json = true;
+        else if (a === '--pretty')
+            flags.pretty = true;
+        else if (a === '--explain')
+            flags.explain = true;
+        else if (a === '--ephemeral')
+            flags.ephemeral = true;
+        else if (a === '--headless')
+            flags.headless = true;
+        else if (a === '--headed')
+            flags.headless = false;
+        else if (a === '--browser')
+            flags.launch.browserName = argv[++i];
+        else if (a === '--timeout') {
+            const n = Number(argv[++i]);
+            if (Number.isFinite(n)) {
+                flags.timeout = n;
+                opts.timeout = n;
+            }
+        }
+        else if (a === '--limit')
+            opts.limit = Number(argv[++i]);
+        else if (a === '--offset')
+            opts.offset = Number(argv[++i]);
+        else if (a === '--all')
+            opts.all = true;
+        else if (a === '--full-page' || a === '--fullPage')
+            opts.fullPage = true;
+        else if (a === '--state')
+            opts.state = argv[++i];
+        else if (a === '--selector')
+            opts.selector = argv[++i];
+        else if (a === '-o' || a === '--output')
+            opts.path = argv[++i];
+        else if (a === '--name')
+            opts.name = argv[++i];
+        else if (a.startsWith('--')) {
+            // Unknown long flag: take a value if next token is not another flag.
+            const key = a.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith('--')) {
+                opts[key] = next;
+                i++;
+            }
+            else
+                opts[key] = true;
+        }
+        else
+            positional.push(a);
+    }
+    if (flags.version)
+        return { cmd: '__version__', args: {}, flags };
+    if (flags.help && positional.length === 0)
+        return null;
+    if (positional.length === 0) {
+        if (flags.help)
+            return null;
+        // No command — special-case: --ephemeral with no command means "read
+        // commands from stdin". Otherwise fall through to help.
+        if (flags.ephemeral)
+            return { cmd: '__stdin__', args: {}, flags };
+        flags.help = true;
+        return { cmd: '__help__', args: {}, flags };
+    }
+    const [cmd0, ...rest] = positional;
+    const lower = cmd0.toLowerCase();
+    // Map surface command → dispatcher command + collect args.
+    switch (lower) {
+        case 'go':
+        case 'goto':
+        case 'navigate':
+            return { cmd: 'go', args: { url: rest[0], ...opts }, flags };
+        case 'click':
+            return { cmd: 'click', args: { selector: rest[0], ...opts }, flags };
+        case 'fill':
+        case 'type':
+            return { cmd: 'fill', args: { selector: rest[0], value: rest.slice(1).join(' '), ...opts }, flags };
+        case 'press':
+            // craftdriver press <key> [selector]
+            return { cmd: 'press', args: { key: rest[0], ...(rest[1] ? { selector: rest[1] } : {}), ...opts }, flags };
+        case 'hover':
+            return { cmd: 'hover', args: { selector: rest[0], ...opts }, flags };
+        case 'find':
+            return { cmd: 'find', args: { selector: rest[0], ...opts }, flags };
+        case 'exists':
+            return { cmd: 'exists', args: { selector: rest[0], ...opts }, flags };
+        case 'text':
+            return { cmd: 'text', args: { ...(rest[0] ? { selector: rest[0] } : {}), ...opts }, flags };
+        case 'attr':
+        case 'attribute':
+            return { cmd: 'attr', args: { selector: rest[0], name: rest[1], ...opts }, flags };
+        case 'value':
+            return { cmd: 'value', args: { selector: rest[0], ...opts }, flags };
+        case 'is':
+            // craftdriver is visible|enabled|checked <selector>
+            return { cmd: 'is', args: { what: rest[0], selector: rest[1], ...opts }, flags };
+        case 'wait': {
+            // craftdriver wait <selector> [--state X]   OR   craftdriver wait load
+            if (rest[0] === 'load') {
+                return { cmd: 'wait', args: { target: 'load', kind: 'load', ...opts }, flags };
+            }
+            return { cmd: 'wait', args: { target: rest[0], kind: 'selector', ...opts }, flags };
+        }
+        case 'pages':
+            return { cmd: 'pages', args: { ...opts }, flags };
+        case 'screenshot':
+        case 'shot':
+            return { cmd: 'screenshot', args: { ...opts }, flags };
+        case 'snapshot':
+            // craftdriver snapshot — sanitized DOM summary for locator building
+            return { cmd: 'snapshot', args: { ...opts }, flags };
+        case 'eval':
+            return { cmd: 'eval', args: { js: rest.join(' '), ...opts }, flags };
+        case 'back':
+        case 'forward':
+        case 'reload':
+        case 'status':
+        case 'quit':
+            return { cmd: lower, args: { ...opts }, flags };
+        case 'daemon': {
+            const sub = (rest[0] ?? 'status').toLowerCase();
+            return { cmd: `daemon:${sub}`, args: { ...opts }, flags };
+        }
+        case 'init': {
+            // craftdriver init <flavor> [--force] [--dry-run]
+            const flavor = (rest[0] ?? '').toLowerCase();
+            return { cmd: 'init', args: { flavor, ...opts }, flags };
+        }
+        case 'mcp':
+            return { cmd: 'mcp', args: { ...opts }, flags };
+        default:
+            return { cmd: '__unknown__', args: { cmd: cmd0 }, flags };
+    }
+}
+//# sourceMappingURL=parseArgs.js.map

package/dist/cli/parseArgs.js.map

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

package/dist/cli/protocol.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Wire protocol for the craftdriver daemon.
+ *
+ * Line-delimited JSON over a Unix domain socket. Each line is a
+ * single JSON object terminated by `\n`. Requests carry an `id`;
+ * the daemon mirrors it back on the matching response.
+ *
+ * v1 deliberately uses a hand-rolled framing rather than JSON-RPC
+ * to keep the surface tiny. If the MCP server later wants to reuse
+ * the dispatcher we can upgrade to JSON-RPC behind the same
+ * `Request`/`Response` shape — agents don't see the wire format.
+ */
+export interface Request {
+    id: number;
+    cmd: string;
+    args?: Record<string, unknown>;
+}
+export interface OkResponse {
+    id: number;
+    ok: true;
+    result: unknown;
+}
+export interface ErrResponse {
+    id: number;
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+        detail?: Record<string, unknown>;
+    };
+}
+export type Response = OkResponse | ErrResponse;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/cli/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/cli/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CACH;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC"}

package/dist/cli/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/cli/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/cli/protocol.ts"],"names":[],"mappings":""}

package/dist/cli/selector.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Selector syntax for the CLI / agent surface.
+ *
+ * Agents pick a "kind" by prefixing the selector with one of the
+ * known schemes; otherwise the value is treated as a CSS selector
+ * (the default everywhere in craftdriver). Examples:
+ *
+ *   #submit                  → By.css('#submit')
+ *   css=button.primary       → By.css('button.primary')
+ *   xpath=//button[1]        → By.xpath('//button[1]')
+ *   text=Sign In             → By.text('Sign In')
+ *   text*=Sign               → By.partialText('Sign')
+ *   role=button              → By.role('button')
+ *   role=button[name=Submit] → By.role('button', { name: 'Submit' })
+ *   label=Email              → By.labelText('Email')
+ *   testid=login-btn         → By.testId('login-btn')
+ *   placeholder=Search…      → By.placeholder('Search…')
+ *   alt=Logo                 → By.altText('Logo')
+ *   title=Help               → By.title('Help')
+ *   ref=e5                   → By.css('[data-craftdriver-ref="e5"]')
+ *                              (refs come from `craftdriver snapshot` /
+ *                              browser_snapshot; invalidated by the next
+ *                              snapshot or navigation)
+ */
+import { By } from '../lib/by.js';
+export declare function parseSelector(input: string): By;
+/** Short, log-friendly description of a By for error messages. */
+export declare function describeSelector(by: By): string;
+//# sourceMappingURL=selector.d.ts.map

package/dist/cli/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/cli/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAKlC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CA8E/C;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAE/C"}