@crosshands/contract 0.1.2

package/dist/schemas.d.ts

@@ -0,0 +1,499 @@
+import { z } from 'zod';
+export declare const InteractionContextTokenSchema: z.ZodString;
+export declare const ProcessIdentitySchema: z.ZodObject<{
+    pid: z.ZodNumber;
+    startedAt: z.ZodISODateTime;
+    executableId: z.ZodString;
+}, z.core.$strict>;
+export declare const WindowIdentitySchema: z.ZodObject<{
+    id: z.ZodString;
+    ownerPid: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ReferenceBindingsSchema: z.ZodObject<{
+    brokerGeneration: z.ZodString;
+    providerGeneration: z.ZodString;
+    graphicalSessionId: z.ZodString;
+    process: z.ZodObject<{
+        pid: z.ZodNumber;
+        startedAt: z.ZodISODateTime;
+        executableId: z.ZodString;
+    }, z.core.$strict>;
+    appId: z.ZodString;
+    window: z.ZodObject<{
+        id: z.ZodString;
+        ownerPid: z.ZodNumber;
+    }, z.core.$strict>;
+    snapshotId: z.ZodString;
+    desktopEpoch: z.ZodNumber;
+}, z.core.$strict>;
+export type ReferenceBindings = z.infer<typeof ReferenceBindingsSchema>;
+export declare const InteractionContextSchema: z.ZodObject<{
+    brokerGeneration: z.ZodString;
+    providerGeneration: z.ZodString;
+    graphicalSessionId: z.ZodString;
+    process: z.ZodObject<{
+        pid: z.ZodNumber;
+        startedAt: z.ZodISODateTime;
+        executableId: z.ZodString;
+    }, z.core.$strict>;
+    appId: z.ZodString;
+    window: z.ZodObject<{
+        id: z.ZodString;
+        ownerPid: z.ZodNumber;
+    }, z.core.$strict>;
+    snapshotId: z.ZodString;
+    desktopEpoch: z.ZodNumber;
+    token: z.ZodString;
+    issuedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type InteractionContext = z.infer<typeof InteractionContextSchema>;
+export declare const TargetReferenceSchema: z.ZodObject<{
+    brokerGeneration: z.ZodString;
+    providerGeneration: z.ZodString;
+    graphicalSessionId: z.ZodString;
+    process: z.ZodObject<{
+        pid: z.ZodNumber;
+        startedAt: z.ZodISODateTime;
+        executableId: z.ZodString;
+    }, z.core.$strict>;
+    appId: z.ZodString;
+    window: z.ZodObject<{
+        id: z.ZodString;
+        ownerPid: z.ZodNumber;
+    }, z.core.$strict>;
+    snapshotId: z.ZodString;
+    desktopEpoch: z.ZodNumber;
+    ref: z.ZodString;
+    kind: z.ZodEnum<{
+        window: "window";
+        app: "app";
+        element: "element";
+    }>;
+    contextToken: z.ZodString;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type TargetReference = z.infer<typeof TargetReferenceSchema>;
+export declare const AppInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    bundleId: z.ZodNullable<z.ZodString>;
+    pid: z.ZodNumber;
+    isRunning: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const WindowInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    appId: z.ZodString;
+    title: z.ZodString;
+    index: z.ZodNumber;
+    bounds: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+    minimized: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const ScreenshotSchema: z.ZodObject<{
+    format: z.ZodLiteral<"png">;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    scale: z.ZodNumber;
+    data: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+export declare const SnapshotSchema: z.ZodObject<{
+    id: z.ZodString;
+    app: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        bundleId: z.ZodNullable<z.ZodString>;
+        pid: z.ZodNumber;
+        isRunning: z.ZodBoolean;
+    }, z.core.$strict>;
+    window: z.ZodObject<{
+        id: z.ZodString;
+        appId: z.ZodString;
+        title: z.ZodString;
+        index: z.ZodNumber;
+        bounds: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        minimized: z.ZodBoolean;
+    }, z.core.$strict>;
+    treeText: z.ZodString;
+    elementCount: z.ZodNumber;
+    focusedElementRef: z.ZodNullable<z.ZodString>;
+    desktopEpoch: z.ZodNumber;
+}, z.core.$strict>;
+export declare const MutationOutcomeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    state: z.ZodLiteral<"verified">;
+    evidence: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>, z.ZodObject<{
+    state: z.ZodLiteral<"indeterminate">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    state: z.ZodLiteral<"failed">;
+    error: z.ZodOptional<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>>;
+}, z.core.$strict>, z.ZodObject<{
+    state: z.ZodLiteral<"not_attempted">;
+    error: z.ZodOptional<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>>;
+}, z.core.$strict>], "state">;
+export type MutationOutcome = z.infer<typeof MutationOutcomeSchema>;
+export declare const SnapshotResultSchema: z.ZodObject<{
+    context: z.ZodObject<{
+        brokerGeneration: z.ZodString;
+        providerGeneration: z.ZodString;
+        graphicalSessionId: z.ZodString;
+        process: z.ZodObject<{
+            pid: z.ZodNumber;
+            startedAt: z.ZodISODateTime;
+            executableId: z.ZodString;
+        }, z.core.$strict>;
+        appId: z.ZodString;
+        window: z.ZodObject<{
+            id: z.ZodString;
+            ownerPid: z.ZodNumber;
+        }, z.core.$strict>;
+        snapshotId: z.ZodString;
+        desktopEpoch: z.ZodNumber;
+        token: z.ZodString;
+        issuedAt: z.ZodISODateTime;
+        expiresAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    snapshot: z.ZodObject<{
+        id: z.ZodString;
+        app: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            bundleId: z.ZodNullable<z.ZodString>;
+            pid: z.ZodNumber;
+            isRunning: z.ZodBoolean;
+        }, z.core.$strict>;
+        window: z.ZodObject<{
+            id: z.ZodString;
+            appId: z.ZodString;
+            title: z.ZodString;
+            index: z.ZodNumber;
+            bounds: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+            minimized: z.ZodBoolean;
+        }, z.core.$strict>;
+        treeText: z.ZodString;
+        elementCount: z.ZodNumber;
+        focusedElementRef: z.ZodNullable<z.ZodString>;
+        desktopEpoch: z.ZodNumber;
+    }, z.core.$strict>;
+    screenshot: z.ZodNullable<z.ZodObject<{
+        format: z.ZodLiteral<"png">;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        scale: z.ZodNumber;
+        data: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    issues: z.ZodDefault<z.ZodArray<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>>>;
+}, z.core.$strict>;
+export declare const MutationResultSchema: z.ZodObject<{
+    outcome: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        state: z.ZodLiteral<"verified">;
+        evidence: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strict>, z.ZodObject<{
+        state: z.ZodLiteral<"indeterminate">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        state: z.ZodLiteral<"failed">;
+        error: z.ZodOptional<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>>;
+    }, z.core.$strict>, z.ZodObject<{
+        state: z.ZodLiteral<"not_attempted">;
+        error: z.ZodOptional<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>>;
+    }, z.core.$strict>], "state">;
+    freshState: z.ZodOptional<z.ZodObject<{
+        context: z.ZodObject<{
+            brokerGeneration: z.ZodString;
+            providerGeneration: z.ZodString;
+            graphicalSessionId: z.ZodString;
+            process: z.ZodObject<{
+                pid: z.ZodNumber;
+                startedAt: z.ZodISODateTime;
+                executableId: z.ZodString;
+            }, z.core.$strict>;
+            appId: z.ZodString;
+            window: z.ZodObject<{
+                id: z.ZodString;
+                ownerPid: z.ZodNumber;
+            }, z.core.$strict>;
+            snapshotId: z.ZodString;
+            desktopEpoch: z.ZodNumber;
+            token: z.ZodString;
+            issuedAt: z.ZodISODateTime;
+            expiresAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+        snapshot: z.ZodObject<{
+            id: z.ZodString;
+            app: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                bundleId: z.ZodNullable<z.ZodString>;
+                pid: z.ZodNumber;
+                isRunning: z.ZodBoolean;
+            }, z.core.$strict>;
+            window: z.ZodObject<{
+                id: z.ZodString;
+                appId: z.ZodString;
+                title: z.ZodString;
+                index: z.ZodNumber;
+                bounds: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>;
+                minimized: z.ZodBoolean;
+            }, z.core.$strict>;
+            treeText: z.ZodString;
+            elementCount: z.ZodNumber;
+            focusedElementRef: z.ZodNullable<z.ZodString>;
+            desktopEpoch: z.ZodNumber;
+        }, z.core.$strict>;
+        screenshot: z.ZodNullable<z.ZodObject<{
+            format: z.ZodLiteral<"png">;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            scale: z.ZodNumber;
+            data: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            expiresAt: z.ZodOptional<z.ZodISODateTime>;
+        }, z.core.$strict>>;
+        issues: z.ZodDefault<z.ZodArray<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>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const ProviderCapabilitiesSchema: z.ZodObject<{
+    platform: z.ZodEnum<{
+        darwin: "darwin";
+        win32: "win32";
+        linux: "linux";
+    }>;
+    provider: z.ZodString;
+    providerVersion: z.ZodString;
+    operations: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+    permissions: z.ZodRecord<z.ZodString, z.ZodEnum<{
+        unknown: "unknown";
+        granted: "granted";
+        denied: "denied";
+        not_required: "not_required";
+    }>>;
+}, z.core.$strict>;
+export declare const ProviderHandshakeSchema: z.ZodObject<{
+    provider: z.ZodString;
+    generation: z.ZodString;
+    graphicalSessionId: z.ZodString;
+    providerProtocol: z.ZodNumber;
+    publicContract: z.ZodString;
+    capabilities: z.ZodObject<{
+        platform: z.ZodEnum<{
+            darwin: "darwin";
+            win32: "win32";
+            linux: "linux";
+        }>;
+        provider: z.ZodString;
+        providerVersion: z.ZodString;
+        operations: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+        permissions: z.ZodRecord<z.ZodString, z.ZodEnum<{
+            unknown: "unknown";
+            granted: "granted";
+            denied: "denied";
+            not_required: "not_required";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAQvB,eAAO,MAAM,6BAA6B,aAA+C,CAAA;AAEzF,eAAO,MAAM,qBAAqB;;;;kBAMvB,CAAA;AAEX,eAAO,MAAM,oBAAoB;;;kBAKtB,CAAA;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;kBAWzB,CAAA;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;kBAI1B,CAAA;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;kBAKvB,CAAA;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,aAAa;;;;;;kBAQf,CAAA;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;kBAgBlB,CAAA;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;kBAazB,CAAA;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUhB,CAAA;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAShC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOtB,CAAA;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKtB,CAAA;AAEX,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;kBAQ5B,CAAA;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;kBASzB,CAAA"}

package/dist/schemas.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import { SerializedComputerErrorSchema } from './errors.js';
+const FiniteNumberSchema = z.number().finite();
+const NonNegativeIntegerSchema = z.number().int().nonnegative();
+const PositiveIntegerSchema = z.number().int().positive();
+const IdentifierSchema = z.string().min(1).max(512);
+export const InteractionContextTokenSchema = z.string().regex(/^ctx_[A-Za-z0-9_-]{32,}$/);
+export const ProcessIdentitySchema = z
+    .object({
+    pid: PositiveIntegerSchema,
+    startedAt: z.iso.datetime(),
+    executableId: IdentifierSchema
+})
+    .strict();
+export const WindowIdentitySchema = z
+    .object({
+    id: IdentifierSchema,
+    ownerPid: PositiveIntegerSchema
+})
+    .strict();
+export const ReferenceBindingsSchema = z
+    .object({
+    brokerGeneration: IdentifierSchema,
+    providerGeneration: IdentifierSchema,
+    graphicalSessionId: IdentifierSchema,
+    process: ProcessIdentitySchema,
+    appId: IdentifierSchema,
+    window: WindowIdentitySchema,
+    snapshotId: IdentifierSchema,
+    desktopEpoch: NonNegativeIntegerSchema
+})
+    .strict();
+export const InteractionContextSchema = ReferenceBindingsSchema.extend({
+    token: InteractionContextTokenSchema,
+    issuedAt: z.iso.datetime(),
+    expiresAt: z.iso.datetime()
+}).strict();
+export const TargetReferenceSchema = ReferenceBindingsSchema.extend({
+    ref: IdentifierSchema,
+    kind: z.enum(['app', 'window', 'element']),
+    contextToken: InteractionContextTokenSchema,
+    expiresAt: z.iso.datetime()
+}).strict();
+export const AppInfoSchema = z
+    .object({
+    id: IdentifierSchema,
+    name: z.string().min(1),
+    bundleId: z.string().min(1).nullable(),
+    pid: PositiveIntegerSchema,
+    isRunning: z.boolean()
+})
+    .strict();
+export const WindowInfoSchema = z
+    .object({
+    id: IdentifierSchema,
+    appId: IdentifierSchema,
+    title: z.string(),
+    index: NonNegativeIntegerSchema,
+    bounds: z
+        .object({
+        x: FiniteNumberSchema,
+        y: FiniteNumberSchema,
+        width: z.number().finite().positive(),
+        height: z.number().finite().positive()
+    })
+        .strict(),
+    minimized: z.boolean()
+})
+    .strict();
+export const ScreenshotSchema = z
+    .object({
+    format: z.literal('png'),
+    width: PositiveIntegerSchema,
+    height: PositiveIntegerSchema,
+    scale: z.number().finite().positive(),
+    data: z.string().min(1).optional(),
+    path: z.string().min(1).optional(),
+    expiresAt: z.iso.datetime().optional()
+})
+    .strict()
+    .refine((value) => value.data !== undefined || value.path !== undefined, {
+    message: 'Screenshot must include data or path'
+});
+export const SnapshotSchema = z
+    .object({
+    id: IdentifierSchema,
+    app: AppInfoSchema,
+    window: WindowInfoSchema,
+    treeText: z.string(),
+    elementCount: NonNegativeIntegerSchema,
+    focusedElementRef: z.string().nullable(),
+    desktopEpoch: NonNegativeIntegerSchema
+})
+    .strict();
+export const MutationOutcomeSchema = z.discriminatedUnion('state', [
+    z.object({ state: z.literal('verified'), evidence: z.unknown().optional() }).strict(),
+    z.object({ state: z.literal('indeterminate'), reason: z.string().optional() }).strict(),
+    z
+        .object({ state: z.literal('failed'), error: SerializedComputerErrorSchema.optional() })
+        .strict(),
+    z
+        .object({ state: z.literal('not_attempted'), error: SerializedComputerErrorSchema.optional() })
+        .strict()
+]);
+export const SnapshotResultSchema = z
+    .object({
+    context: InteractionContextSchema,
+    snapshot: SnapshotSchema,
+    screenshot: ScreenshotSchema.nullable(),
+    issues: z.array(SerializedComputerErrorSchema).default([])
+})
+    .strict();
+export const MutationResultSchema = z
+    .object({
+    outcome: MutationOutcomeSchema,
+    freshState: SnapshotResultSchema.optional()
+})
+    .strict();
+export const ProviderCapabilitiesSchema = z
+    .object({
+    platform: z.enum(['darwin', 'win32', 'linux']),
+    provider: IdentifierSchema,
+    providerVersion: z.string().min(1),
+    operations: z.record(z.string(), z.boolean()),
+    permissions: z.record(z.string(), z.enum(['granted', 'denied', 'unknown', 'not_required']))
+})
+    .strict();
+export const ProviderHandshakeSchema = z
+    .object({
+    provider: IdentifierSchema,
+    generation: IdentifierSchema,
+    graphicalSessionId: IdentifierSchema,
+    providerProtocol: PositiveIntegerSchema,
+    publicContract: z.string().min(1),
+    capabilities: ProviderCapabilitiesSchema
+})
+    .strict();
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/versions.d.ts

@@ -0,0 +1,31 @@
+import { createComputerError } from './errors.js';
+export declare const CONTRACT_VERSIONS: {
+    readonly product: "0.1.2";
+    readonly publicContract: "1.1.0";
+    readonly brokerControl: 1;
+    readonly providerProtocol: 1;
+    readonly mcpProtocol: "2025-11-25";
+};
+export type ContractVersions = {
+    product: string;
+    publicContract: string;
+    brokerControl: number;
+    providerProtocol: number;
+    mcpProtocol: string;
+};
+export declare const COMPATIBLE_VERSIONS: {
+    readonly product: readonly ["0.1.2"];
+    readonly publicContract: readonly ["1.1.0"];
+    readonly brokerControl: readonly [1];
+    readonly providerProtocol: readonly [1];
+    readonly mcpProtocol: readonly ["2025-11-25"];
+};
+export type VersionNegotiationResult = {
+    ok: true;
+    versions: typeof CONTRACT_VERSIONS;
+} | {
+    ok: false;
+    error: ReturnType<typeof createComputerError>;
+};
+export declare function negotiateVersionHandshake(remote: ContractVersions): VersionNegotiationResult;
+//# sourceMappingURL=versions.d.ts.map

package/dist/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,iBAAiB,CAAA;CAAE,GAChD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;CAAE,CAAA;AAEhE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,wBAAwB,CAe5F"}