@crosshands/contract 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CrossHands contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/context.d.ts

@@ -0,0 +1,19 @@
+import type { InteractionContext, ReferenceBindings, TargetReference } from './schemas.js';
+export declare const DEFAULT_INTERACTION_CONTEXT_TTL_MS = 120000;
+export declare const DEFAULT_INTERACTION_CONTEXT_LIMIT = 32;
+type InteractionContextStoreOptions = {
+    ttlMs?: number;
+    limit?: number;
+    now?: () => number;
+    tokenFactory?: () => string;
+};
+export declare class InteractionContextStore {
+    #private;
+    constructor(options?: InteractionContextStoreOptions);
+    issue(bindings: ReferenceBindings): InteractionContext;
+    resolve(token: string, now?: number): InteractionContext;
+    invalidateAll(): void;
+}
+export declare function assertReferenceFresh(reference: TargetReference, context: InteractionContext, current: ReferenceBindings, now?: number): void;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE1F,eAAO,MAAM,kCAAkC,SAAU,CAAA;AACzD,eAAO,MAAM,iCAAiC,KAAK,CAAA;AAEnD,KAAK,8BAA8B,GAAG;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,MAAM,CAAA;CAC5B,CAAA;AAED,qBAAa,uBAAuB;;gBAOtB,OAAO,GAAE,8BAAmC;IAUxD,KAAK,CAAC,QAAQ,EAAE,iBAAiB,GAAG,kBAAkB;IAkBtD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAc,GAAG,kBAAkB;IAe7D,aAAa,IAAI,IAAI;CAGtB;AAUD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,GAAG,SAAa,GACf,IAAI,CAuBN"}

package/dist/context.js

@@ -0,0 +1,82 @@
+import { randomBytes } from 'node:crypto';
+import { createComputerError } from './errors.js';
+export const DEFAULT_INTERACTION_CONTEXT_TTL_MS = 120_000;
+export const DEFAULT_INTERACTION_CONTEXT_LIMIT = 32;
+export class InteractionContextStore {
+    #ttlMs;
+    #limit;
+    #now;
+    #tokenFactory;
+    #contexts = new Map();
+    constructor(options = {}) {
+        this.#ttlMs = options.ttlMs ?? DEFAULT_INTERACTION_CONTEXT_TTL_MS;
+        this.#limit = options.limit ?? DEFAULT_INTERACTION_CONTEXT_LIMIT;
+        this.#now = options.now ?? Date.now;
+        this.#tokenFactory =
+            options.tokenFactory ?? (() => `ctx_${randomBytes(24).toString('base64url')}`);
+        if (this.#ttlMs <= 0 || this.#limit <= 0)
+            throw new RangeError('Context TTL and limit must be positive');
+    }
+    issue(bindings) {
+        const issuedAtMs = this.#now();
+        const context = {
+            token: this.#tokenFactory(),
+            ...bindings,
+            issuedAt: new Date(issuedAtMs).toISOString(),
+            expiresAt: new Date(issuedAtMs + this.#ttlMs).toISOString()
+        };
+        this.#contexts.delete(context.token);
+        this.#contexts.set(context.token, context);
+        while (this.#contexts.size > this.#limit) {
+            const oldest = this.#contexts.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.#contexts.delete(oldest);
+        }
+        return context;
+    }
+    resolve(token, now = this.#now()) {
+        const context = this.#contexts.get(token);
+        if (context === undefined) {
+            throw createComputerError('interaction_context_invalid', 'Interaction context is unknown or forged');
+        }
+        if (Date.parse(context.expiresAt) < now) {
+            this.#contexts.delete(token);
+            throw createComputerError('interaction_context_expired', 'Interaction context has expired');
+        }
+        return context;
+    }
+    invalidateAll() {
+        this.#contexts.clear();
+    }
+}
+function sameProcess(a, b) {
+    return a.pid === b.pid && a.startedAt === b.startedAt && a.executableId === b.executableId;
+}
+function sameWindow(a, b) {
+    return a.id === b.id && a.ownerPid === b.ownerPid;
+}
+export function assertReferenceFresh(reference, context, current, now = Date.now()) {
+    const stale = reference.contextToken !== context.token ||
+        reference.brokerGeneration !== context.brokerGeneration ||
+        reference.providerGeneration !== context.providerGeneration ||
+        reference.graphicalSessionId !== context.graphicalSessionId ||
+        reference.brokerGeneration !== current.brokerGeneration ||
+        reference.providerGeneration !== current.providerGeneration ||
+        reference.graphicalSessionId !== current.graphicalSessionId ||
+        !sameProcess(reference.process, context.process) ||
+        !sameProcess(reference.process, current.process) ||
+        reference.appId !== context.appId ||
+        reference.appId !== current.appId ||
+        !sameWindow(reference.window, context.window) ||
+        !sameWindow(reference.window, current.window) ||
+        reference.snapshotId !== context.snapshotId ||
+        reference.snapshotId !== current.snapshotId ||
+        reference.desktopEpoch !== context.desktopEpoch ||
+        reference.desktopEpoch !== current.desktopEpoch ||
+        Date.parse(reference.expiresAt) < now ||
+        Date.parse(context.expiresAt) < now;
+    if (stale)
+        throw createComputerError('stale_target', 'Target reference is no longer fresh');
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGjD,MAAM,CAAC,MAAM,kCAAkC,GAAG,OAAO,CAAA;AACzD,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAA;AASnD,MAAM,OAAO,uBAAuB;IACzB,MAAM,CAAQ;IACd,MAAM,CAAQ;IACd,IAAI,CAAc;IAClB,aAAa,CAAc;IAC3B,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAA;IAE1D,YAAY,UAA0C,EAAE;QACtD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,kCAAkC,CAAA;QACjE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,iCAAiC,CAAA;QAChE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;QACnC,IAAI,CAAC,aAAa;YAChB,OAAO,CAAC,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAChF,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC;YACtC,MAAM,IAAI,UAAU,CAAC,wCAAwC,CAAC,CAAA;IAClE,CAAC;IAED,KAAK,CAAC,QAA2B;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC9B,MAAM,OAAO,GAAuB;YAClC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE;YAC3B,GAAG,QAAQ;YACX,QAAQ,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE;YAC5C,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE;SAC5D,CAAA;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAA2B,CAAA;YACvE,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAK;YAC/B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,OAAO,CAAC,KAAa,EAAE,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,mBAAmB,CACvB,6BAA6B,EAC7B,0CAA0C,CAC3C,CAAA;QACH,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,GAAG,EAAE,CAAC;YACxC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC5B,MAAM,mBAAmB,CAAC,6BAA6B,EAAE,iCAAiC,CAAC,CAAA;QAC7F,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,aAAa;QACX,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;CACF;AAED,SAAS,WAAW,CAAC,CAA+B,EAAE,CAA+B;IACnF,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,YAAY,CAAA;AAC5F,CAAC;AAED,SAAS,UAAU,CAAC,CAA8B,EAAE,CAA8B;IAChF,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAA0B,EAC1B,OAA2B,EAC3B,OAA0B,EAC1B,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAEhB,MAAM,KAAK,GACT,SAAS,CAAC,YAAY,KAAK,OAAO,CAAC,KAAK;QACxC,SAAS,CAAC,gBAAgB,KAAK,OAAO,CAAC,gBAAgB;QACvD,SAAS,CAAC,kBAAkB,KAAK,OAAO,CAAC,kBAAkB;QAC3D,SAAS,CAAC,kBAAkB,KAAK,OAAO,CAAC,kBAAkB;QAC3D,SAAS,CAAC,gBAAgB,KAAK,OAAO,CAAC,gBAAgB;QACvD,SAAS,CAAC,kBAAkB,KAAK,OAAO,CAAC,kBAAkB;QAC3D,SAAS,CAAC,kBAAkB,KAAK,OAAO,CAAC,kBAAkB;QAC3D,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;QAChD,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;QAChD,SAAS,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;QACjC,SAAS,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;QACjC,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;QAC7C,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;QAC7C,SAAS,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;QAC3C,SAAS,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;QAC3C,SAAS,CAAC,YAAY,KAAK,OAAO,CAAC,YAAY;QAC/C,SAAS,CAAC,YAAY,KAAK,OAAO,CAAC,YAAY;QAC/C,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,GAAG;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,GAAG,CAAA;IAErC,IAAI,KAAK;QAAE,MAAM,mBAAmB,CAAC,cAAc,EAAE,qCAAqC,CAAC,CAAA;AAC7F,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,164 @@
+import { z } from 'zod';
+export declare const ERROR_CATALOG: {
+    readonly app_not_found: {
+        readonly retry: true;
+        readonly remediation: "refresh_apps";
+    };
+    readonly app_unavailable: {
+        readonly retry: true;
+        readonly remediation: "refresh_apps";
+    };
+    readonly app_blocked: {
+        readonly retry: false;
+        readonly remediation: "choose_non_sensitive_target";
+    };
+    readonly window_not_found: {
+        readonly retry: true;
+        readonly remediation: "refresh_windows";
+    };
+    readonly window_unavailable: {
+        readonly retry: true;
+        readonly remediation: "refresh_windows";
+    };
+    readonly window_not_focused: {
+        readonly retry: true;
+        readonly remediation: "focus_window";
+    };
+    readonly permission_denied: {
+        readonly retry: false;
+        readonly remediation: "grant_permission";
+    };
+    readonly stale_target: {
+        readonly retry: true;
+        readonly remediation: "refresh_state";
+    };
+    readonly element_not_found: {
+        readonly retry: true;
+        readonly remediation: "refresh_state";
+    };
+    readonly element_not_clickable: {
+        readonly retry: true;
+        readonly remediation: "choose_actionable_target";
+    };
+    readonly action_not_supported: {
+        readonly retry: false;
+        readonly remediation: "choose_supported_operation";
+    };
+    readonly value_not_settable: {
+        readonly retry: false;
+        readonly remediation: "choose_settable_target";
+    };
+    readonly invalid_argument: {
+        readonly retry: false;
+        readonly remediation: "correct_request";
+    };
+    readonly timeout: {
+        readonly retry: false;
+        readonly remediation: "inspect_state_before_retry";
+    };
+    readonly unsupported_capability: {
+        readonly retry: false;
+        readonly remediation: "choose_supported_operation";
+    };
+    readonly provider_unavailable: {
+        readonly retry: true;
+        readonly remediation: "run_doctor";
+    };
+    readonly provider_crashed: {
+        readonly retry: true;
+        readonly remediation: "refresh_state";
+    };
+    readonly version_incompatible: {
+        readonly retry: false;
+        readonly remediation: "upgrade_or_downgrade";
+    };
+    readonly interaction_context_invalid: {
+        readonly retry: true;
+        readonly remediation: "refresh_state";
+    };
+    readonly interaction_context_expired: {
+        readonly retry: true;
+        readonly remediation: "refresh_state";
+    };
+    readonly session_unavailable: {
+        readonly retry: true;
+        readonly remediation: "unlock_graphical_session";
+    };
+    readonly screenshot_failed: {
+        readonly retry: true;
+        readonly remediation: "check_screenshot_permission";
+    };
+    readonly accessibility_error: {
+        readonly retry: true;
+        readonly remediation: "check_accessibility_permission";
+    };
+};
+export type ComputerErrorCode = keyof typeof ERROR_CATALOG;
+export type ComputerErrorRemediation = (typeof ERROR_CATALOG)[ComputerErrorCode]['remediation'];
+export declare const ComputerErrorCodeSchema: z.ZodEnum<{
+    app_not_found: "app_not_found";
+    app_unavailable: "app_unavailable";
+    app_blocked: "app_blocked";
+    window_not_found: "window_not_found";
+    window_unavailable: "window_unavailable";
+    window_not_focused: "window_not_focused";
+    permission_denied: "permission_denied";
+    stale_target: "stale_target";
+    element_not_found: "element_not_found";
+    element_not_clickable: "element_not_clickable";
+    action_not_supported: "action_not_supported";
+    value_not_settable: "value_not_settable";
+    invalid_argument: "invalid_argument";
+    timeout: "timeout";
+    unsupported_capability: "unsupported_capability";
+    provider_unavailable: "provider_unavailable";
+    provider_crashed: "provider_crashed";
+    version_incompatible: "version_incompatible";
+    interaction_context_invalid: "interaction_context_invalid";
+    interaction_context_expired: "interaction_context_expired";
+    session_unavailable: "session_unavailable";
+    screenshot_failed: "screenshot_failed";
+    accessibility_error: "accessibility_error";
+}>;
+export declare const SerializedComputerErrorSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        app_not_found: "app_not_found";
+        app_unavailable: "app_unavailable";
+        app_blocked: "app_blocked";
+        window_not_found: "window_not_found";
+        window_unavailable: "window_unavailable";
+        window_not_focused: "window_not_focused";
+        permission_denied: "permission_denied";
+        stale_target: "stale_target";
+        element_not_found: "element_not_found";
+        element_not_clickable: "element_not_clickable";
+        action_not_supported: "action_not_supported";
+        value_not_settable: "value_not_settable";
+        invalid_argument: "invalid_argument";
+        timeout: "timeout";
+        unsupported_capability: "unsupported_capability";
+        provider_unavailable: "provider_unavailable";
+        provider_crashed: "provider_crashed";
+        version_incompatible: "version_incompatible";
+        interaction_context_invalid: "interaction_context_invalid";
+        interaction_context_expired: "interaction_context_expired";
+        session_unavailable: "session_unavailable";
+        screenshot_failed: "screenshot_failed";
+        accessibility_error: "accessibility_error";
+    }>;
+    message: z.ZodString;
+    retry: z.ZodBoolean;
+    remediation: z.ZodString;
+    details: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>;
+export type SerializedComputerError = z.infer<typeof SerializedComputerErrorSchema>;
+export declare class ComputerError extends Error {
+    readonly code: ComputerErrorCode;
+    readonly retry: boolean;
+    readonly remediation: ComputerErrorRemediation;
+    readonly details: unknown;
+    constructor(code: ComputerErrorCode, message: string, details?: unknown);
+    toJSON(): SerializedComputerError;
+}
+export declare function createComputerError(code: ComputerErrorCode, message: string, details?: unknown): ComputerError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBhB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,aAAa,CAAA;AAC1D,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,iBAAiB,CAAC,CAAC,aAAa,CAAC,CAAA;AAE/F,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;EAEnC,CAAA;AAED,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQ/B,CAAA;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;gBAEb,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IASvE,MAAM,IAAI,uBAAuB;CAWlC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,GAChB,aAAa,CAEf"}

package/dist/errors.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+export const ERROR_CATALOG = {
+    app_not_found: { retry: true, remediation: 'refresh_apps' },
+    app_unavailable: { retry: true, remediation: 'refresh_apps' },
+    app_blocked: { retry: false, remediation: 'choose_non_sensitive_target' },
+    window_not_found: { retry: true, remediation: 'refresh_windows' },
+    window_unavailable: { retry: true, remediation: 'refresh_windows' },
+    window_not_focused: { retry: true, remediation: 'focus_window' },
+    permission_denied: { retry: false, remediation: 'grant_permission' },
+    stale_target: { retry: true, remediation: 'refresh_state' },
+    element_not_found: { retry: true, remediation: 'refresh_state' },
+    element_not_clickable: { retry: true, remediation: 'choose_actionable_target' },
+    action_not_supported: { retry: false, remediation: 'choose_supported_operation' },
+    value_not_settable: { retry: false, remediation: 'choose_settable_target' },
+    invalid_argument: { retry: false, remediation: 'correct_request' },
+    timeout: { retry: false, remediation: 'inspect_state_before_retry' },
+    unsupported_capability: { retry: false, remediation: 'choose_supported_operation' },
+    provider_unavailable: { retry: true, remediation: 'run_doctor' },
+    provider_crashed: { retry: true, remediation: 'refresh_state' },
+    version_incompatible: { retry: false, remediation: 'upgrade_or_downgrade' },
+    interaction_context_invalid: { retry: true, remediation: 'refresh_state' },
+    interaction_context_expired: { retry: true, remediation: 'refresh_state' },
+    session_unavailable: { retry: true, remediation: 'unlock_graphical_session' },
+    screenshot_failed: { retry: true, remediation: 'check_screenshot_permission' },
+    accessibility_error: { retry: true, remediation: 'check_accessibility_permission' }
+};
+export const ComputerErrorCodeSchema = z.enum(Object.keys(ERROR_CATALOG));
+export const SerializedComputerErrorSchema = z
+    .object({
+    code: ComputerErrorCodeSchema,
+    message: z.string().min(1),
+    retry: z.boolean(),
+    remediation: z.string().min(1),
+    details: z.unknown().optional()
+})
+    .strict();
+export class ComputerError extends Error {
+    code;
+    retry;
+    remediation;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'ComputerError';
+        this.code = code;
+        this.retry = ERROR_CATALOG[code].retry;
+        this.remediation = ERROR_CATALOG[code].remediation;
+        this.details = details;
+    }
+    toJSON() {
+        return this.details === undefined
+            ? { code: this.code, message: this.message, retry: this.retry, remediation: this.remediation }
+            : {
+                code: this.code,
+                message: this.message,
+                retry: this.retry,
+                remediation: this.remediation,
+                details: this.details
+            };
+    }
+}
+export function createComputerError(code, message, details) {
+    return new ComputerError(code, message, details);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/generate-schemas.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generate-schemas.d.ts.map

package/dist/generate-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-schemas.d.ts","sourceRoot":"","sources":["../src/generate-schemas.ts"],"names":[],"mappings":""}

package/dist/generate-schemas.js

@@ -0,0 +1,8 @@
+import { writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { contractJsonSchemas } from './json-schema.js';
+const here = dirname(fileURLToPath(import.meta.url));
+const output = resolve(here, '../schemas/contract.json');
+await writeFile(output, `${JSON.stringify(contractJsonSchemas, null, 2)}\n`, 'utf8');
+//# sourceMappingURL=generate-schemas.js.map

package/dist/generate-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-schemas.js","sourceRoot":"","sources":["../src/generate-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAEtD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACpD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAA;AACxD,MAAM,SAAS,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './context.js';
+export * from './errors.js';
+export * from './json-schema.js';
+export * from './operations.js';
+export * from './provider.js';
+export * from './schemas.js';
+export * from './versions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './context.js';
+export * from './errors.js';
+export * from './json-schema.js';
+export * from './operations.js';
+export * from './provider.js';
+export * from './schemas.js';
+export * from './versions.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}