@mercuryo-ai/agentbrowse 0.2.50

package/dist/index.js

@@ -0,0 +1,350 @@
+#!/usr/bin/env node
+import { config as loadEnv } from 'dotenv';
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+loadEnv();
+import { browseCommand, browseCommandName } from './command-name.js';
+import { assertSemanticObserveRuntimeSupport } from './commands/semantic-observe-lexical.js';
+import { loadSession } from './session.js';
+import { outputContractFailure, outputError, outputJSON, fatal, info } from './output.js';
+function usageText() {
+    return `Usage: ${browseCommandName()} <command> [args] [options]
+
+Commands:
+  launch [url] [options]          Launch browser, optionally navigate to URL
+  attach <cdp-url> [options]      Attach to an existing browser over CDP
+  browser-status                  Check live browser/page/runtime state
+  navigate <url>                  Navigate current tab to URL
+  act <targetRef> <action> [value] Perform action on a previously observed target
+  extract '<schema-json>' [scopeRef] Extract structured data from the page or a stored scope
+  observe ["<goal>"]              Discover available targets/elements
+  screenshot [--path <file>]      Capture a screenshot
+  close                           Close browser and clean up
+
+Options:
+  --compact                       Launch browser in compact window size (1280x900, default)
+  --full                          Launch browser in full-size window
+  --profile <name>                Solver profile name for launch (default: "default")
+  --proxy [url]                   Launch through configured proxy, or use one-off override URL
+  --provider <name>               Optional provider label for attach (for example "browserbase")
+  --headful                       Explicit alias for headful browser mode (default)
+  --headless                      Launch browser in headless mode
+  --path <file>                   Output path for screenshot
+  --help                          Show this help message`;
+}
+const KNOWN_COMMANDS = new Set([
+    'launch',
+    'attach',
+    'browser-status',
+    'navigate',
+    'act',
+    'extract',
+    'observe',
+    'screenshot',
+    'close',
+]);
+function getCommand(argv = process.argv) {
+    const rawArgs = argv.slice(2);
+    if (rawArgs.length === 0 || rawArgs[0] === '--help') {
+        info(usageText());
+        process.exit(0);
+    }
+    const command = rawArgs[0];
+    const args = rawArgs.slice(1);
+    return { command, args };
+}
+/** Parse --key value or --key 'value' from args array. */
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    return args[idx + 1];
+}
+function hasFlag(args, flag) {
+    return args.includes(flag);
+}
+/** Get the first positional argument (not starting with --). */
+function getPositional(args, valueFlags = []) {
+    const valueFlagSet = new Set(valueFlags);
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            if (valueFlagSet.has(arg)) {
+                i += 1;
+            }
+            continue;
+        }
+        return arg;
+    }
+    return undefined;
+}
+function getPositionals(args, valueFlags = []) {
+    const valueFlagSet = new Set(valueFlags);
+    const values = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            if (valueFlagSet.has(arg)) {
+                i += 1;
+            }
+            continue;
+        }
+        values.push(arg);
+    }
+    return values;
+}
+function parseLaunchArgs(args) {
+    let url;
+    let compact = true;
+    let profile;
+    let headless = false;
+    let useProxy = false;
+    let proxy;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--headless') {
+            headless = true;
+            continue;
+        }
+        if (arg === '--headful') {
+            headless = false;
+            continue;
+        }
+        if (arg === '--compact') {
+            compact = true;
+            continue;
+        }
+        if (arg === '--full') {
+            compact = false;
+            continue;
+        }
+        if (arg === '--profile') {
+            const value = args[i + 1];
+            if (!value || value.startsWith('--')) {
+                outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
+            }
+            profile = value;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--proxy=')) {
+            const value = arg.slice('--proxy='.length).trim();
+            if (!value) {
+                outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
+            }
+            useProxy = true;
+            proxy = value;
+            continue;
+        }
+        if (arg === '--proxy') {
+            useProxy = true;
+            const value = args[i + 1];
+            const trailingPositionals = args.slice(i + 1).filter((entry) => !entry.startsWith('--'));
+            if (value && !value.startsWith('--') && (url || trailingPositionals.length > 1)) {
+                proxy = value;
+                i += 1;
+            }
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            outputError(`Unknown launch option: ${arg}`);
+        }
+        if (url) {
+            outputError(`Usage: ${browseCommand('launch', '[url]', '[--profile <name>]', '[--proxy [url]]', '[--headful|--headless]')}`);
+        }
+        url = arg;
+    }
+    return { url, compact, profile, headless, useProxy, proxy };
+}
+function parseAttachArgs(args) {
+    let cdpUrl;
+    let provider;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--provider') {
+            const value = args[i + 1];
+            if (!value || value.startsWith('--')) {
+                outputError(`Usage: ${browseCommand('attach', '<cdp-url>', '[--provider <name>]')}`);
+            }
+            provider = value;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            outputError(`Unknown attach option: ${arg}`);
+        }
+        if (cdpUrl) {
+            outputError(`Usage: ${browseCommand('attach', '<cdp-url>', '[--provider <name>]')}`);
+        }
+        cdpUrl = arg;
+    }
+    if (!cdpUrl) {
+        outputError(`Usage: ${browseCommand('attach', '<cdp-url>', '[--provider <name>]')}`);
+    }
+    return {
+        cdpUrl: cdpUrl,
+        ...(provider ? { provider } : {}),
+    };
+}
+/** Require an active browser session. */
+function requireLaunchedBrowserSessionRecord(command) {
+    const session = loadSession();
+    if (session) {
+        return session;
+    }
+    return outputContractFailure({
+        error: 'browser_session_required',
+        outcomeType: 'blocked',
+        message: `The \`${command}\` command requires an active browser session.`,
+        reason: `No persisted browser session was found. Run \`${browseCommandName()} launch [url]\` or \`${browseCommandName()} attach <cdp-url>\` first.`,
+    });
+}
+async function main(argv = process.argv) {
+    const parsed = getCommand(argv);
+    if (!parsed)
+        process.exit(1);
+    const { command, args } = parsed;
+    if (!KNOWN_COMMANDS.has(command)) {
+        outputError(`Unknown command: ${command}\n\n${usageText()}`);
+    }
+    try {
+        assertSemanticObserveRuntimeSupport();
+    }
+    catch (err) {
+        outputError(err instanceof Error ? err.message : String(err));
+    }
+    switch (command) {
+        case 'launch': {
+            const { launch } = await import('./commands/launch.js');
+            const { close } = await import('./commands/close.js');
+            const { saveBrowserSession } = await import('./browser-session-state.js');
+            const { deleteWorkflowContext } = await import('./session.js');
+            const { checkForLaunchUpdate } = await import('./update-check.js');
+            const launchArgs = parseLaunchArgs(args);
+            const updateNoticePromise = checkForLaunchUpdate().catch(() => null);
+            const existingSession = loadSession();
+            await Promise.resolve(close(existingSession)).catch(() => undefined);
+            deleteWorkflowContext();
+            const launchResult = await launch(launchArgs.url, {
+                compact: launchArgs.compact,
+                profile: launchArgs.profile,
+                headless: launchArgs.headless,
+                useProxy: launchArgs.useProxy,
+                proxy: launchArgs.proxy,
+            });
+            if (launchResult.success) {
+                saveBrowserSession(launchResult.session);
+            }
+            const updateNotice = await Promise.race([
+                updateNoticePromise,
+                new Promise((resolve) => {
+                    queueMicrotask(() => resolve(null));
+                }),
+            ]);
+            if (updateNotice) {
+                info(updateNotice.message);
+            }
+            outputJSON(launchResult);
+            break;
+        }
+        case 'attach': {
+            const { attach } = await import('./commands/attach.js');
+            const { close } = await import('./commands/close.js');
+            const { saveBrowserSession } = await import('./browser-session-state.js');
+            const { deleteWorkflowContext } = await import('./session.js');
+            const attachArgs = parseAttachArgs(args);
+            const existingSession = loadSession();
+            await Promise.resolve(close(existingSession)).catch(() => undefined);
+            deleteWorkflowContext();
+            const attachResult = await attach(attachArgs.cdpUrl, {
+                ...(attachArgs.provider ? { provider: attachArgs.provider } : {}),
+            });
+            if (attachResult.success) {
+                saveBrowserSession(attachResult.session);
+            }
+            outputJSON(attachResult);
+            break;
+        }
+        case 'navigate': {
+            const url = getPositional(args);
+            if (!url)
+                outputError(`Usage: ${browseCommand('navigate', '<url>')}`);
+            const { navigate } = await import('./commands/navigate.js');
+            await navigate(requireLaunchedBrowserSessionRecord(command), url);
+            break;
+        }
+        case 'act': {
+            const positionals = getPositionals(args);
+            const [targetRef, action, ...valueParts] = positionals;
+            if (!targetRef || !action) {
+                outputError(`Usage: ${browseCommand('act', '<targetRef>', '<action>', '[value]')}`);
+            }
+            const { act, isBrowseAction } = await import('./commands/act.js');
+            if (!isBrowseAction(action)) {
+                outputError(`Unsupported act action: ${action}. Expected one of: click, fill, type, select, press.`);
+            }
+            await act(requireLaunchedBrowserSessionRecord(command), targetRef, action, valueParts.length > 0 ? valueParts.join(' ') : undefined);
+            break;
+        }
+        case 'extract': {
+            const positionals = getPositionals(args);
+            const [schemaJson, scopeRef] = positionals;
+            if (!schemaJson) {
+                outputError(`Usage: ${browseCommand('extract', "'<schema-json>'", '[scopeRef]')}`);
+            }
+            const { extract } = await import('./commands/extract.js');
+            await extract(requireLaunchedBrowserSessionRecord(command), schemaJson, scopeRef);
+            break;
+        }
+        case 'observe': {
+            const instruction = getPositional(args);
+            const { observe } = await import('./commands/observe.js');
+            await observe(requireLaunchedBrowserSessionRecord(command), instruction);
+            break;
+        }
+        case 'screenshot': {
+            if (hasFlag(args, '--help')) {
+                info(`Usage: ${browseCommand('screenshot', '[--path <file>]')}`);
+                process.exit(0);
+            }
+            const filePath = getFlag(args, '--path');
+            const { screenshot } = await import('./commands/screenshot.js');
+            await screenshot(requireLaunchedBrowserSessionRecord(command), filePath);
+            break;
+        }
+        case 'browser-status': {
+            const { browserStatus } = await import('./commands/browser-status.js');
+            outputJSON(await browserStatus(requireLaunchedBrowserSessionRecord(command)));
+            break;
+        }
+        case 'close': {
+            const session = loadSession();
+            const { close } = await import('./commands/close.js');
+            const { deleteSession } = await import('./session.js');
+            const result = await close(session);
+            if (result.success) {
+                deleteSession();
+            }
+            outputJSON(result);
+            break;
+        }
+    }
+}
+export { main };
+export function isDirectExecution(metaUrl, argv = process.argv) {
+    const entry = argv[1];
+    if (!entry) {
+        return false;
+    }
+    try {
+        return realpathSync(entry) === realpathSync(fileURLToPath(metaUrl));
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectExecution(import.meta.url)) {
+    main().catch((err) => {
+        fatal(err instanceof Error ? err.message : String(err));
+    });
+}

package/dist/library.d.ts

@@ -0,0 +1,17 @@
+export { createBrowserSessionStore, deleteBrowserSession, getSessionPort, isAttachedSession, isOwnedSession, isSessionAlive, loadBrowserSession, resolveBrowserSessionId, saveBrowserSession, serializeBrowserSession, supportsCaptchaSolve, buildAttachedSession, buildOwnedSession, type BrowserSessionCapabilities, type BrowserSessionStore, type BrowserSessionState, type BrowseSessionIdentity, type BrowseSessionTransport, } from './browser-session-state.js';
+export { attach, ATTACH_ERROR_CODES, ATTACH_OUTCOME_TYPES, type AttachErrorCode, type AttachFailureResult, type AttachOutcomeType, type AttachOptions, type AttachResult, type AttachSuccessResult, } from './commands/attach.js';
+export { AgentbrowseAssistiveRuntimeMissingError, AssistiveStructuredOutputTruncatedError, configureAgentbrowseAssistiveRuntime, resetAgentbrowseAssistiveRuntime, type AgentbrowseAssistiveChatCompletionOptions, type AgentbrowseAssistiveChatCompletionRequest, type AgentbrowseAssistiveChatCompletionResult, type AgentbrowseAssistiveChatMessage, type AgentbrowseAssistiveImageInput, type AgentbrowseAssistiveLlmClient, type AgentbrowseAssistiveLlmUsage, type AgentbrowseAssistiveMessageContentPart, type AgentbrowseAssistiveResponseModel, type AgentbrowseAssistiveRuntime, } from './assistive-runtime.js';
+export { createAgentbrowseClient, type AgentbrowseClient, type AgentbrowseClientOptions, } from './client.js';
+export { configureAgentbrowseDiagnostics, resetAgentbrowseDiagnostics, type DiagnosticArtifactManifest, type DiagnosticArtifactManifestInput, type AgentbrowseDiagnosticsHooks, type DiagnosticChildSpanInput, type DiagnosticLifecycleEventInput, type DiagnosticSnapshotInput, type DiagnosticStepFinishInput, type DiagnosticStepHandle, type DiagnosticStepStartInput, } from './diagnostics.js';
+export { setSolverConfigStoreOverride, type SolverConfigStoreOverride, } from './solver/config.js';
+export type { BrowserCommandSession } from './browser-session-state.js';
+export { browserStatus as status, BROWSER_STATUS_OUTCOME_TYPES, type BrowserStatusAliveResult, type BrowserStatusCurrentPageMismatch, type BrowserStatusNotRunningResult, type BrowserStatusOutcomeType, type BrowserStatusProtectedExposureResult, type BrowserStatusResult, type BrowserStatusRuntimeSummary, } from './commands/browser-status.js';
+export { actBrowser as act, ACT_ERROR_CODES, ACT_OUTCOME_TYPES, isBrowseAction, BROWSE_ACTIONS, type ActErrorCode, type ActExecutionFailureResult, type ActFailureResult, type ActOutcomeType, type ActPreflightFailureResult, type ActResult, type ActSuccessResult, type BrowseAction, } from './commands/act.js';
+export { extractBrowser as extract, EXTRACT_ERROR_CODES, EXTRACT_OUTCOME_TYPES, type ExtractErrorCode, type ExtractFailureResult, type ExtractOutcomeType, type ExtractResult, type ExtractSchemaDescriptor, type ExtractSchemaInput, type ExtractSchemaValue, type ExtractSuccessResult, } from './commands/extract.js';
+export { observeBrowser as observe, OBSERVE_ERROR_CODES, OBSERVE_OUTCOME_TYPES, type ObserveErrorCode, type ObserveExecutionMode, type ObserveFailureResult, type ObserveFillableForm, type ObserveOutcomeType, type ObserveResult, type ObserveScope, type ObserveSuccessResult, type ObserveSignal, type ObserveTarget, } from './commands/observe.js';
+export { close, CLOSE_ERROR_CODES, CLOSE_OUTCOME_TYPES, type CloseErrorCode, type CloseFailureResult, type CloseOutcomeType, type CloseResult, type CloseSuccessResult, } from './commands/close.js';
+export { launch, LAUNCH_ERROR_CODES, LAUNCH_OUTCOME_TYPES, type LaunchErrorCode, type LaunchOptions, type LaunchFailureResult, type LaunchOutcomeType, type LaunchResult, type LaunchSuccessResult, } from './commands/launch.js';
+export { navigateBrowser as navigate, NAVIGATE_ERROR_CODES, NAVIGATE_OUTCOME_TYPES, type NavigateErrorCode, type NavigateFailureResult, type NavigateOutcomeType, type NavigateResult, type NavigateSuccessResult, } from './commands/navigate.js';
+export { screenshotBrowser as screenshot, SCREENSHOT_ERROR_CODES, SCREENSHOT_OUTCOME_TYPES, type ScreenshotErrorCode, type ScreenshotFailureResult, type ScreenshotOutcomeType, type ScreenshotResult, type ScreenshotSuccessResult, } from './commands/screenshot.js';
+export type { ProtectedFieldPolicies, ProtectedFillForm } from './protected-fill.js';
+//# sourceMappingURL=library.d.ts.map

package/dist/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,MAAM,EACN,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uCAAuC,EACvC,uCAAuC,EACvC,oCAAoC,EACpC,gCAAgC,EAChC,KAAK,yCAAyC,EAC9C,KAAK,yCAAyC,EAC9C,KAAK,wCAAwC,EAC7C,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,sCAAsC,EAC3C,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,GACjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,4BAA4B,EAC5B,KAAK,yBAAyB,GAC/B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EACL,aAAa,IAAI,MAAM,EACvB,4BAA4B,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,gCAAgC,EACrC,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,oCAAoC,EACzC,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,GACjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,UAAU,IAAI,GAAG,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,IAAI,OAAO,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,IAAI,OAAO,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,EACL,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,MAAM,EACN,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,IAAI,QAAQ,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,IAAI,UAAU,EAC/B,sBAAsB,EACtB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/library.js

@@ -0,0 +1,14 @@
+export { createBrowserSessionStore, deleteBrowserSession, getSessionPort, isAttachedSession, isOwnedSession, isSessionAlive, loadBrowserSession, resolveBrowserSessionId, saveBrowserSession, serializeBrowserSession, supportsCaptchaSolve, buildAttachedSession, buildOwnedSession, } from './browser-session-state.js';
+export { attach, ATTACH_ERROR_CODES, ATTACH_OUTCOME_TYPES, } from './commands/attach.js';
+export { AgentbrowseAssistiveRuntimeMissingError, AssistiveStructuredOutputTruncatedError, configureAgentbrowseAssistiveRuntime, resetAgentbrowseAssistiveRuntime, } from './assistive-runtime.js';
+export { createAgentbrowseClient, } from './client.js';
+export { configureAgentbrowseDiagnostics, resetAgentbrowseDiagnostics, } from './diagnostics.js';
+export { setSolverConfigStoreOverride, } from './solver/config.js';
+export { browserStatus as status, BROWSER_STATUS_OUTCOME_TYPES, } from './commands/browser-status.js';
+export { actBrowser as act, ACT_ERROR_CODES, ACT_OUTCOME_TYPES, isBrowseAction, BROWSE_ACTIONS, } from './commands/act.js';
+export { extractBrowser as extract, EXTRACT_ERROR_CODES, EXTRACT_OUTCOME_TYPES, } from './commands/extract.js';
+export { observeBrowser as observe, OBSERVE_ERROR_CODES, OBSERVE_OUTCOME_TYPES, } from './commands/observe.js';
+export { close, CLOSE_ERROR_CODES, CLOSE_OUTCOME_TYPES, } from './commands/close.js';
+export { launch, LAUNCH_ERROR_CODES, LAUNCH_OUTCOME_TYPES, } from './commands/launch.js';
+export { navigateBrowser as navigate, NAVIGATE_ERROR_CODES, NAVIGATE_OUTCOME_TYPES, } from './commands/navigate.js';
+export { screenshotBrowser as screenshot, SCREENSHOT_ERROR_CODES, SCREENSHOT_OUTCOME_TYPES, } from './commands/screenshot.js';

package/dist/output.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Structured output helpers.
+ * Machine-readable JSON to stdout.
+ */
+export interface BrowseResult {
+    success: boolean;
+    error?: string;
+    url?: string;
+    title?: string;
+    [key: string]: unknown;
+}
+export interface BrowseContractFailure extends Omit<BrowseResult, 'success'> {
+    error: string;
+    outcomeType: string;
+    message: string;
+    reason: string;
+}
+/** Write final structured result to stdout and exit. */
+export declare function outputJSON(result: BrowseResult): never;
+/** Write structured failure result to stdout and exit 1. */
+export declare function outputFailure(result: Omit<BrowseResult, 'success'> & {
+    error: string;
+}): never;
+/** Write a normalized contract failure result to stderr and exit 1. */
+export declare function outputContractFailure(result: BrowseContractFailure): never;
+/** Write error to stderr and exit 1. */
+export declare function outputError(error: string): never;
+/** Write a progress/info message to stderr. */
+export declare function info(message: string): void;
+/** Fatal crash — unhandled error, exit 1. */
+export declare function fatal(message: string): never;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAMtD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAE9F;AAED,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,CAE1E;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAEhD;AAED,+CAA+C;AAC/C,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,6CAA6C;AAC7C,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAG5C"}

package/dist/output.js

@@ -0,0 +1,33 @@
+import { browseCommandName } from './command-name.js';
+function serializeResult(result) {
+    return `${JSON.stringify(result, null, 2)}\n`;
+}
+/** Write final structured result to stdout and exit. */
+export function outputJSON(result) {
+    const normalizedResult = result.success
+        ? result
+        : { ...result, error: result.error ?? 'Unknown error' };
+    process.stdout.write(serializeResult(normalizedResult));
+    process.exit(result.success ? 0 : 1);
+}
+/** Write structured failure result to stdout and exit 1. */
+export function outputFailure(result) {
+    outputJSON({ success: false, ...result });
+}
+/** Write a normalized contract failure result to stderr and exit 1. */
+export function outputContractFailure(result) {
+    outputFailure(result);
+}
+/** Write error to stderr and exit 1. */
+export function outputError(error) {
+    outputFailure({ error });
+}
+/** Write a progress/info message to stderr. */
+export function info(message) {
+    process.stderr.write(`${message}\n`);
+}
+/** Fatal crash — unhandled error, exit 1. */
+export function fatal(message) {
+    process.stderr.write(`[${browseCommandName()}] Fatal: ${message}\n`);
+    process.exit(1);
+}

package/dist/owned-browser.d.ts

@@ -0,0 +1,12 @@
+import { type BrowserSessionState } from './browser-session-state.js';
+export type CloseOwnedBrowserResult = {
+    success: true;
+    method: 'already_closed' | 'cdp' | 'signal' | 'cleanup';
+} | {
+    success: false;
+    reason: string;
+};
+export declare function closeOwnedBrowser(session: BrowserSessionState & {
+    pid: number;
+}): Promise<CloseOwnedBrowserResult>;
+//# sourceMappingURL=owned-browser.d.ts.map

package/dist/owned-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-browser.d.ts","sourceRoot":"","sources":["../src/owned-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAQtF,MAAM,MAAM,uBAAuB,GAC/B;IACE,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;CACzD,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,mBAAmB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,uBAAuB,CAAC,CAuClC"}

package/dist/owned-browser.js

@@ -0,0 +1,69 @@
+import { getSessionPort } from './browser-session-state.js';
+import { connectPlaywright } from './playwright-runtime.js';
+import { cleanupManagedBrowserPids, terminateOwnedPid } from './owned-process.js';
+import { getUserDataDir } from './solver/config.js';
+const ENDPOINT_WAIT_ATTEMPTS = 10;
+const ENDPOINT_WAIT_MS = 100;
+export async function closeOwnedBrowser(session) {
+    const port = getSessionPort(session);
+    const endpointAliveBeforeClose = await isBrowserEndpointAlive(port);
+    if (endpointAliveBeforeClose) {
+        await tryCloseBrowserViaCdp(session.cdpUrl);
+        if (await waitForBrowserEndpointToClose(port)) {
+            return { success: true, method: 'cdp' };
+        }
+    }
+    const termination = await terminateOwnedPid(session.pid);
+    if (await waitForBrowserEndpointToClose(port)) {
+        return {
+            success: true,
+            method: endpointAliveBeforeClose ? 'signal' : 'already_closed',
+        };
+    }
+    if (session.profile) {
+        const cleanup = await cleanupManagedBrowserPids({
+            userDataDir: getUserDataDir(session.profile),
+        });
+        if (await waitForBrowserEndpointToClose(port)) {
+            return {
+                success: true,
+                method: cleanup.terminated.length > 0 ? 'cleanup' : 'already_closed',
+            };
+        }
+    }
+    if (!endpointAliveBeforeClose && termination === 'not_found') {
+        return { success: true, method: 'already_closed' };
+    }
+    return {
+        success: false,
+        reason: `Owned browser endpoint on port ${port} remained reachable after close attempts (termination=${termination}).`,
+    };
+}
+async function tryCloseBrowserViaCdp(cdpUrl) {
+    try {
+        const browser = await connectPlaywright(cdpUrl);
+        await browser.close();
+    }
+    catch { }
+}
+async function isBrowserEndpointAlive(port) {
+    try {
+        const response = await fetch(`http://127.0.0.1:${port}/json/version`);
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForBrowserEndpointToClose(port) {
+    for (let attempt = 0; attempt < ENDPOINT_WAIT_ATTEMPTS; attempt++) {
+        if (!(await isBrowserEndpointAlive(port))) {
+            return true;
+        }
+        await sleep(ENDPOINT_WAIT_MS);
+    }
+    return !(await isBrowserEndpointAlive(port));
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/dist/owned-process.d.ts

@@ -0,0 +1,19 @@
+export type OwnedPidTerminationResult = 'not_found' | 'terminated' | 'sigkilled' | 'still_alive';
+export type ManagedBrowserCleanupResult = {
+    terminated: number[];
+    blocked: number[];
+};
+export declare function isPidAlive(pid: number): boolean;
+export declare function terminateOwnedPid(pid: number): Promise<OwnedPidTerminationResult>;
+export declare function cleanupManagedBrowserPids(options?: {
+    excludePids?: Iterable<number>;
+    userDataDir?: string;
+}): Promise<ManagedBrowserCleanupResult>;
+export declare function listManagedBrowserPids(options?: {
+    processTable?: string;
+    userDataDir?: string;
+}): number[];
+export declare function isManagedBrowserPid(pid: number, options?: {
+    processTable?: string;
+}): boolean;
+//# sourceMappingURL=owned-process.d.ts.map

package/dist/owned-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-process.d.ts","sourceRoot":"","sources":["../src/owned-process.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AACjG,MAAM,MAAM,2BAA2B,GAAG;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW/C;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAOvF;AAiCD,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrE,OAAO,CAAC,2BAA2B,CAAC,CAqBtC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,MAAM,EAAE,CAwBV;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,OAAO,CAET"}