@xoxoai/checkmate 0.4.27 → 0.5.0

package/dist/driver.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod/v4';
+import type { RuntimeLogger } from './logging/types.js';
+export type DriverLogger = RuntimeLogger;
+export type StepIntent = Readonly<{
+    id: string;
+    action: string;
+    expect: string;
+}>;
+export type DriverSecretReader = Readonly<{
+    read(slot: string): string;
+}>;
+export type DriverEvidenceSink = Readonly<{
+    capture(input: {
+        kind: string;
+        mediaType: string;
+        content: string | Uint8Array;
+        stepId?: string;
+    }): Promise<{
+        status: 'accepted' | 'discarded';
+    }>;
+}>;
+export type DriverStartInput = Readonly<{
+    target: unknown;
+    settings: unknown;
+    secrets: DriverSecretReader;
+    evidence: DriverEvidenceSink;
+    logger: DriverLogger;
+    signal: AbortSignal;
+}>;
+export type DriverStepContext = Readonly<{
+    step: StepIntent;
+    signal: AbortSignal;
+}>;
+export type DriverToolContext = Readonly<{
+    step: StepIntent;
+    turn: number;
+    signal: AbortSignal;
+}>;
+export type DriverToolResult = string | void | {
+    response: string;
+    status?: 'success' | 'error';
+};
+export type DriverToolDefinition = Readonly<{
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    strict: boolean;
+}>;
+export type DriverTool = Readonly<{
+    definition: DriverToolDefinition;
+    execute(args: unknown, context: DriverToolContext): Promise<DriverToolResult> | DriverToolResult;
+}>;
+export type DriverToolExecution = Readonly<{
+    toolCallId: string;
+    name: string;
+    arguments: unknown;
+    response: string;
+    status: 'success' | 'error';
+}>;
+export type ToolResponseContext = DriverStepContext & Readonly<{
+    turn: number;
+    toolResponses: readonly DriverToolExecution[];
+}>;
+export type DriverCloseContext = Readonly<{
+    signal: AbortSignal;
+}>;
+export type DriverContextMessage = Readonly<{
+    content: string | ReadonlyArray<Readonly<{
+        type: 'text';
+        text: string;
+    }> | Readonly<{
+        type: 'image';
+        mediaType: string;
+        data: string;
+    }>>;
+    ephemeral: boolean;
+}>;
+export type DriverSession = Readonly<{
+    tools: readonly DriverTool[];
+    instructions: readonly string[];
+    buildInitialContext(input: DriverStepContext): Promise<DriverContextMessage[]>;
+    handleToolResponses(input: ToolResponseContext): Promise<DriverContextMessage[]>;
+    close(input: DriverCloseContext): Promise<void>;
+}>;
+export type CheckmateDriverV1 = Readonly<{
+    id: string;
+    driverContractVersion: 1;
+    start(input: DriverStartInput): Promise<DriverSession>;
+}>;
+export declare function defineDriverTool<TSchema extends z.ZodType>(input: {
+    name: string;
+    description: string;
+    schema: TSchema;
+    strict?: boolean;
+    handler: (args: z.infer<TSchema>, context: DriverToolContext) => Promise<DriverToolResult> | DriverToolResult;
+}): DriverTool;
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

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

package/dist/driver.js

@@ -0,0 +1,24 @@
+import { z } from 'zod/v4';
+export function defineDriverTool(input) {
+    const parameters = z.toJSONSchema(input.schema);
+    delete parameters.$schema;
+    return {
+        definition: {
+            name: input.name,
+            description: input.description,
+            parameters,
+            strict: input.strict ?? true,
+        },
+        execute: async (args, context) => {
+            const parsed = input.schema.safeParse(args);
+            if (!parsed.success) {
+                return {
+                    response: JSON.stringify({ error: `Invalid args for '${input.name}': ${parsed.error.message}` }),
+                    status: 'error',
+                };
+            }
+            return input.handler(parsed.data, context);
+        },
+    };
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAmG1B,MAAM,UAAU,gBAAgB,CAA4B,KAM3D;IACA,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAA;IAC1E,OAAO,UAAU,CAAC,OAAO,CAAA;IAEzB,OAAO;QACN,UAAU,EAAE;YACX,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,UAAU;YACV,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;SAC5B;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;YAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACrB,OAAO;oBACN,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,KAAK,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;oBAChG,MAAM,EAAE,OAAO;iBACf,CAAA;YACF,CAAC;YACD,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC3C,CAAC;KACD,CAAA;AACF,CAAC"}

package/dist/drivers/descriptor.d.ts

@@ -0,0 +1,15 @@
+import type { Diagnostic, DriverDescriptorV1, JsonObject, Validation } from '../contracts/types.js';
+import { resolveDriverDescriptorPath } from '../config/package-resolution.js';
+export type DescriptorResolver = typeof resolveDriverDescriptorPath;
+export declare function loadDriverDescriptor(input: {
+    invocationRoot: string;
+    driverId: string;
+    packageName: string;
+    registrationPath: string;
+    resolveDescriptorPath?: DescriptorResolver;
+}): Promise<Validation<DriverDescriptorV1> & {
+    status?: 'invalid' | 'error';
+}>;
+export declare function descriptorDiagnostics(descriptor: DriverDescriptorV1, registeredId: string, registrationPath: string): Diagnostic[];
+export declare function validateDriverValue(schema: JsonObject, value: unknown, path: string): Diagnostic[];
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/drivers/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/drivers/descriptor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEnG,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAA;AAO7E,MAAM,MAAM,kBAAkB,GAAG,OAAO,2BAA2B,CAAA;AAEnE,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IACjD,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;IACxB,qBAAqB,CAAC,EAAE,kBAAkB,CAAA;CAC1C,GAAG,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;CAAE,CAAC,CAc7E;AAED,wBAAgB,qBAAqB,CACpC,UAAU,EAAE,kBAAkB,EAC9B,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,GACtB,UAAU,EAAE,CAad;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAUlG"}

package/dist/drivers/descriptor.js

@@ -0,0 +1,122 @@
+import { createRequire } from 'node:module';
+import { schemaDiagnostics } from '../contracts/diagnostics.js';
+import { appendPointer, inspectJsonStructure, readJsonDocument } from '../config/ingestion.js';
+import { resolveDriverDescriptorPath } from '../config/package-resolution.js';
+import { hasOwn, ownValue } from '../config/record.js';
+const require = createRequire(import.meta.url);
+const Ajv2020Constructor = require('ajv/dist/2020.js');
+const addFormats = require('ajv-formats');
+export async function loadDriverDescriptor(input) {
+    const resolveDescriptor = input.resolveDescriptorPath ?? resolveDriverDescriptorPath;
+    const resolved = resolveDescriptor(input.invocationRoot, input.packageName, `${input.registrationPath}/package`);
+    if (resolved.ok === false)
+        return { ok: false, diagnostics: resolved.diagnostics };
+    const document = await readJsonDocument(resolved.value, input.registrationPath);
+    if (document.ok === false)
+        return { ok: false, status: document.status, diagnostics: document.diagnostics };
+    const { validateDescriptor } = await import('../contracts/validator.js');
+    const validation = validateDescriptor(document.value);
+    if (validation.ok === false)
+        return prefixDiagnostics(validation, input.registrationPath);
+    const diagnostics = descriptorDiagnostics(validation.value, input.driverId, input.registrationPath);
+    return diagnostics.length === 0 ? validation : { ok: false, diagnostics };
+}
+export function descriptorDiagnostics(descriptor, registeredId, registrationPath) {
+    const diagnostics = [];
+    if (descriptor.id !== registeredId) {
+        diagnostics.push({
+            code: 'driver.id-mismatch',
+            path: `${registrationPath}/package`,
+            message: `descriptor id '${descriptor.id}' does not match registered driver '${registeredId}'`,
+        });
+    }
+    diagnostics.push(...driverSchemaDiagnostics(descriptor.targetSchema, `${registrationPath}/targetSchema`));
+    diagnostics.push(...driverSchemaDiagnostics(descriptor.settingsSchema, `${registrationPath}/settingsSchema`));
+    return diagnostics;
+}
+export function validateDriverValue(schema, value, path) {
+    const schemaProblems = driverSchemaDiagnostics(schema, path);
+    if (schemaProblems.length > 0)
+        return schemaProblems;
+    try {
+        const validate = createAjv().compile(schema);
+        return prefixedAjvDiagnostics(validate, value, path);
+    }
+    catch {
+        return [{ code: 'driver.schema-invalid', path, message: 'driver schema could not be compiled' }];
+    }
+}
+function driverSchemaDiagnostics(schema, path) {
+    const structure = inspectJsonStructure(schema, path);
+    if (structure.ok === false)
+        return structure.diagnostics;
+    const diagnostics = [];
+    const pending = [{ value: schema, path }];
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (!current.value || typeof current.value !== 'object')
+            continue;
+        if (!Array.isArray(current.value)) {
+            const object = current.value;
+            if (hasOwn(object, '$id')) {
+                diagnostics.push({
+                    code: 'driver.schema-unsupported',
+                    path: appendPointer(current.path, '$id'),
+                    message: 'driver-owned schemas must not declare $id',
+                });
+            }
+            const reference = ownValue(object, '$ref');
+            if (typeof reference === 'string' && !reference.startsWith('#')) {
+                diagnostics.push({
+                    code: 'driver.schema-unsupported',
+                    path: appendPointer(current.path, '$ref'),
+                    message: 'driver-owned schemas may use only local # references',
+                });
+            }
+        }
+        for (const [key, value] of Object.entries(current.value)) {
+            pending.push({ value, path: appendPointer(current.path, key) });
+        }
+    }
+    if (diagnostics.length > 0)
+        return diagnostics;
+    try {
+        createAjv().compile(schema);
+        return [];
+    }
+    catch {
+        return [{ code: 'driver.schema-invalid', path, message: 'must be a valid strict JSON Schema' }];
+    }
+}
+function prefixedAjvDiagnostics(validate, value, path) {
+    if (validate(value))
+        return [];
+    return schemaDiagnostics(validate.errors).map((diagnostic) => ({
+        ...diagnostic,
+        path: `${path}${diagnostic.path}`,
+    }));
+}
+function prefixDiagnostics(validation, path) {
+    if (validation.ok === true)
+        return validation;
+    return {
+        ok: false,
+        diagnostics: validation.diagnostics.map((diagnostic) => ({
+            ...diagnostic,
+            path: `${path}${diagnostic.path}`,
+        })),
+    };
+}
+function createAjv() {
+    const ajv = new Ajv2020Constructor({
+        allErrors: true,
+        strict: true,
+        coerceTypes: false,
+        removeAdditional: false,
+        useDefaults: false,
+        ownProperties: true,
+    });
+    addFormats(ajv);
+    return ajv;
+}
+//# sourceMappingURL=descriptor.js.map

package/dist/drivers/descriptor.js.map

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

package/dist/drivers/loader.d.ts

@@ -0,0 +1,18 @@
+import type { DriverDescriptorV1 } from '../contracts/types.js';
+import type { CheckmateDriverV1, DriverSession, DriverTool } from '../driver.js';
+export declare const RESERVED_TOOL_NAMES: Set<string>;
+export declare class DriverContractError extends Error {
+    constructor(message: string);
+}
+export declare class DriverLoadError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export type DriverModuleImporter = (specifier: string) => Promise<unknown>;
+export declare function loadValidatedDriver(input: {
+    invocationRoot: string;
+    packageName: string;
+    descriptor: DriverDescriptorV1;
+    importModule?: DriverModuleImporter;
+}): Promise<CheckmateDriverV1>;
+export declare function validateDriverSession(session: DriverSession, descriptor: DriverDescriptorV1, allowedTools: '*' | readonly string[]): readonly DriverTool[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/drivers/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/drivers/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGhF,eAAO,MAAM,mBAAmB,aAG9B,CAAA;AAEF,qBAAa,mBAAoB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAInD;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAE1E,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAChD,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,kBAAkB,CAAA;IAC9B,YAAY,CAAC,EAAE,oBAAoB,CAAA;CACnC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0B7B;AAED,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,kBAAkB,EAC9B,YAAY,EAAE,GAAG,GAAG,SAAS,MAAM,EAAE,GACnC,SAAS,UAAU,EAAE,CAsCvB"}

package/dist/drivers/loader.js

@@ -0,0 +1,97 @@
+import { createRequire } from 'node:module';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { StepResultTool } from '../tools/step/result-tool.js';
+export const RESERVED_TOOL_NAMES = new Set([
+    StepResultTool.TOOL_FAIL_TEST_STEP,
+    StepResultTool.TOOL_PASS_TEST_STEP,
+]);
+export class DriverContractError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DriverContractError';
+    }
+}
+export class DriverLoadError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'DriverLoadError';
+    }
+}
+export async function loadValidatedDriver(input) {
+    let module;
+    try {
+        const specifier = resolveDriverModule(input.invocationRoot, input.packageName);
+        module = await (input.importModule ?? importDriverModule)(specifier);
+    }
+    catch (error) {
+        throw new DriverLoadError(`Could not load registered driver package '${input.packageName}'`, { cause: error });
+    }
+    const driver = readDriverExport(module);
+    if (!driver) {
+        throw new DriverLoadError(`Registered driver package '${input.packageName}' must export a 'checkmateDriver' object`);
+    }
+    if (driver.id !== input.descriptor.id) {
+        throw new DriverLoadError(`Runtime driver id '${driver.id}' does not match descriptor id '${input.descriptor.id}'`);
+    }
+    if (driver.driverContractVersion !== input.descriptor.driverContractVersion) {
+        throw new DriverLoadError(`Runtime driver contract version '${driver.driverContractVersion}' does not match descriptor version '${input.descriptor.driverContractVersion}'`);
+    }
+    return driver;
+}
+export function validateDriverSession(session, descriptor, allowedTools) {
+    if (!session || !Array.isArray(session.tools))
+        throw new DriverContractError('Driver session must provide a tools array');
+    const runtimeNames = session.tools.map((tool) => tool.definition?.name);
+    if (runtimeNames.some((name) => typeof name !== 'string' || name.length === 0)) {
+        throw new DriverContractError('Every runtime driver tool must have a non-empty name');
+    }
+    const duplicate = runtimeNames.find((name, index) => runtimeNames.indexOf(name) !== index);
+    if (duplicate)
+        throw new DriverContractError(`Duplicate runtime driver tool '${duplicate}'`);
+    const reserved = runtimeNames.find((name) => RESERVED_TOOL_NAMES.has(name));
+    if (reserved)
+        throw new DriverContractError(`Driver tool '${reserved}' collides with a reserved harness tool`);
+    const descriptorNames = descriptor.tools.map((tool) => tool.name);
+    const declaredDuplicates = descriptorNames.find((name, index) => descriptorNames.indexOf(name) !== index);
+    if (declaredDuplicates) {
+        throw new DriverContractError(`Descriptor declares duplicate driver tool '${declaredDuplicates}'`);
+    }
+    const missing = descriptorNames.filter((name) => !runtimeNames.includes(name));
+    const additional = runtimeNames.filter((name) => !descriptorNames.includes(name));
+    if (missing.length > 0 || additional.length > 0) {
+        throw new DriverContractError([
+            missing.length > 0 ? `missing runtime tools: ${missing.join(', ')}` : '',
+            additional.length > 0 ? `undeclared runtime tools: ${additional.join(', ')}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n'));
+    }
+    if (allowedTools === '*')
+        return [...session.tools];
+    const allowed = new Set(allowedTools);
+    const unknown = allowedTools.filter((name) => !descriptorNames.includes(name));
+    if (unknown.length > 0)
+        throw new DriverContractError(`Policy allows undeclared tools: ${unknown.join(', ')}`);
+    return session.tools.filter((tool) => allowed.has(tool.definition.name));
+}
+function resolveDriverModule(invocationRoot, packageName) {
+    const require = createRequire(resolve(invocationRoot, 'package.json'));
+    return pathToFileURL(require.resolve(packageName)).href;
+}
+function importDriverModule(specifier) {
+    return import(specifier);
+}
+function readDriverExport(module) {
+    if (!module || typeof module !== 'object' || !('checkmateDriver' in module))
+        return undefined;
+    const driver = module.checkmateDriver;
+    if (!driver || typeof driver !== 'object')
+        return undefined;
+    const candidate = driver;
+    if (typeof candidate.id !== 'string' || typeof candidate.start !== 'function') {
+        return undefined;
+    }
+    return candidate;
+}
+//# sourceMappingURL=loader.js.map

package/dist/drivers/loader.js.map

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

package/dist/drivers/web/checkmate-driver.json

@@ -0,0 +1,44 @@
+{
+	"schemaVersion": 1,
+	"id": "web",
+	"driverContractVersion": 1,
+	"targetSchema": {
+		"type": "object",
+		"additionalProperties": false,
+		"required": ["baseUrl"],
+		"properties": {
+			"baseUrl": { "type": "string", "format": "uri" }
+		}
+	},
+	"settingsSchema": {
+		"type": "object",
+		"additionalProperties": false,
+		"properties": {
+			"headless": { "type": "boolean" },
+			"snapshotFilter": { "type": "boolean" },
+			"snapshotTopPercent": { "type": "number", "exclusiveMinimum": 0, "maximum": 100 },
+			"screenshotsInModelContext": { "type": "boolean" }
+		}
+	},
+	"requiredSecretSlots": [],
+	"tools": [
+		{ "name": "browser_navigate" },
+		{ "name": "browser_click_or_hover" },
+		{ "name": "browser_set_dialog_response" },
+		{ "name": "browser_drag" },
+		{ "name": "browser_upload" },
+		{ "name": "browser_type_or_select" },
+		{ "name": "browser_press_key" },
+		{ "name": "browser_snapshot" },
+		{ "name": "browser_wait" },
+		{ "name": "browser_list_tabs" },
+		{ "name": "browser_select_tab" },
+		{ "name": "browser_close_tab" },
+		{ "name": "browser_network_requests" },
+		{ "name": "browser_network_request" }
+	],
+	"evidenceKinds": [
+		{ "kind": "aria-snapshot", "mediaType": "application/yaml", "content": "text" },
+		{ "kind": "screenshot", "mediaType": "image/png", "content": "opaque" }
+	]
+}

package/dist/drivers/web/index.d.ts

@@ -0,0 +1,6 @@
+import type { CheckmateDriverV1 } from '../../driver.js';
+import { createWebDriverSession, webSettings, webTarget } from './session.js';
+export declare const checkmateDriver: CheckmateDriverV1;
+export { createWebDriverSession, webSettings, webTarget };
+export type { WebDriverSettings, WebDriverTarget } from './session.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/drivers/web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/drivers/web/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAwB,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAEnG,eAAO,MAAM,eAAe,EAAE,iBA6B7B,CAAA;AAED,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,SAAS,EAAE,CAAA;AACzD,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/dist/drivers/web/index.js

@@ -0,0 +1,27 @@
+import { chromium } from 'playwright';
+import { createWebDriverSession, rollbackWebResources, webSettings, webTarget } from './session.js';
+export const checkmateDriver = {
+    id: 'web',
+    driverContractVersion: 1,
+    start: async (input) => {
+        const target = webTarget(input.target);
+        const settings = webSettings(input.settings);
+        const resources = {};
+        try {
+            input.signal.throwIfAborted();
+            resources.browser = await chromium.launch({ headless: settings.headless });
+            input.signal.throwIfAborted();
+            resources.context = await resources.browser.newContext();
+            const page = await resources.context.newPage();
+            await page.goto(target.baseUrl);
+            input.signal.throwIfAborted();
+            return createWebDriverSession({ browser: resources.browser, context: resources.context, page }, settings, input.evidence, input.logger);
+        }
+        catch (error) {
+            await rollbackWebResources(resources);
+            throw new Error(`Web driver failed to start for '${target.baseUrl}'`, { cause: error });
+        }
+    },
+};
+export { createWebDriverSession, webSettings, webTarget };
+//# sourceMappingURL=index.js.map

package/dist/drivers/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/web/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAEnG,MAAM,CAAC,MAAM,eAAe,GAAsB;IACjD,EAAE,EAAE,KAAK;IACT,qBAAqB,EAAE,CAAC;IACxB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACtB,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAC5C,MAAM,SAAS,GAGX,EAAE,CAAA;QACN,IAAI,CAAC;YACJ,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,CAAA;YAC7B,SAAS,CAAC,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;YAC1E,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,CAAA;YAC7B,SAAS,CAAC,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,CAAA;YACxD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;YAC9C,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC/B,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,CAAA;YAC7B,OAAO,sBAAsB,CAC5B,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAChE,QAAQ,EACR,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,MAAM,CACZ,CAAA;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,oBAAoB,CAAC,SAAS,CAAC,CAAA;YACrC,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QACxF,CAAC;IACF,CAAC;CACD,CAAA;AAED,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,SAAS,EAAE,CAAA"}

package/dist/drivers/web/session.d.ts

@@ -0,0 +1,22 @@
+import type { Browser, BrowserContext, Page } from 'playwright';
+import type { DriverEvidenceSink, DriverLogger, DriverSession } from '../../driver.js';
+export type WebDriverTarget = {
+    baseUrl: string;
+};
+export type WebDriverSettings = {
+    headless: boolean;
+    snapshotFilter: boolean;
+    snapshotTopPercent: number;
+    screenshotsInModelContext: boolean;
+};
+type WebResources = {
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+};
+export declare function createWebDriverSession(resources: WebResources, settings: WebDriverSettings, evidence: DriverEvidenceSink | undefined, logger: DriverLogger): Promise<DriverSession>;
+export declare function webTarget(input: unknown): WebDriverTarget;
+export declare function webSettings(input: unknown): WebDriverSettings;
+export declare function rollbackWebResources(resources: Partial<WebResources>): Promise<void>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/drivers/web/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/drivers/web/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAEX,kBAAkB,EAClB,YAAY,EACZ,aAAa,EAIb,MAAM,iBAAiB,CAAA;AAMxB,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjD,MAAM,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,cAAc,EAAE,OAAO,CAAA;IACvB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,yBAAyB,EAAE,OAAO,CAAA;CAClC,CAAA;AAED,KAAK,YAAY,GAAG;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,IAAI,CAAA;CACV,CAAA;AAUD,wBAAsB,sBAAsB,CAC3C,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,MAAM,EAAE,YAAY,GAClB,OAAO,CAAC,aAAa,CAAC,CAsFxB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAKzD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAQ7D;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1F"}