@crosshands/runtime 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/broker/broker.d.ts

@@ -0,0 +1,53 @@
+import { type ComputerOperationName, type ContractVersions, type InteractionContext, type ReferenceBindings } from '@crosshands/contract';
+import { type StableAppIdentity } from '../policy/policy.js';
+import { ProviderSupervisor } from '../providers/supervisor.js';
+export type BrokerPeer = {
+    osIdentity: string;
+    graphicalSessionId: string;
+    verified: boolean;
+    local: boolean;
+};
+export type TargetInspection = {
+    bindings: ReferenceBindings;
+    appIdentity: StableAppIdentity;
+};
+export type BrokerRequest = {
+    operation: ComputerOperationName;
+    input: unknown;
+    deadlineMs?: number;
+};
+export type BrokerResponse = {
+    requestId: string;
+    result: unknown;
+    desktopEpoch: number;
+    providerGeneration: string;
+    context?: InteractionContext;
+};
+export type LocalBrokerOptions = {
+    identity: BrokerPeer;
+    generation?: string;
+    providerFactory: ConstructorParameters<typeof ProviderSupervisor>[0]['providerFactory'];
+    inspectTarget?: (operation: ComputerOperationName, input: unknown) => Promise<TargetInspection | null>;
+    publish?: (response: BrokerResponse) => Promise<void>;
+    contextTtlMs?: number;
+    now?: () => number;
+};
+export declare class BrokerClient {
+    private readonly broker;
+    constructor(broker: LocalBroker);
+    request(request: BrokerRequest): Promise<BrokerResponse>;
+}
+export declare class LocalBroker {
+    #private;
+    readonly generation: string;
+    constructor(options: LocalBrokerOptions);
+    get desktopEpoch(): number;
+    connect(handshake: {
+        peer: BrokerPeer;
+        versions: ContractVersions;
+    }): Promise<BrokerClient>;
+    issueContext(bindings: ReferenceBindings): InteractionContext;
+    resolveContext(token: string): InteractionContext;
+    request(request: BrokerRequest): Promise<BrokerResponse>;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/broker/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/broker/broker.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EAEvB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAE/D,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,qBAAqB,CAAA;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,UAAU,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,qBAAqB,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAA;IACvF,aAAa,CAAC,EAAE,CACd,SAAS,EAAE,qBAAqB,EAChC,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB,CAAA;AAiKD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEhD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAGzD;AAED,qBAAa,WAAW;;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;gBAWf,OAAO,EAAE,kBAAkB;IAgBvC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAEK,OAAO,CAAC,SAAS,EAAE;QACvB,IAAI,EAAE,UAAU,CAAA;QAChB,QAAQ,EAAE,gBAAgB,CAAA;KAC3B,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBzB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,kBAAkB;IAU7D,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB;IAIjD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAiJzD"}

package/dist/broker/broker.js

@@ -0,0 +1,346 @@
+import { randomUUID } from 'node:crypto';
+import { COMPUTER_OPERATIONS, InteractionContextStore, createComputerError, negotiateVersionHandshake, parseOperationOutput } from '@crosshands/contract';
+import { assertAppAllowed } from '../policy/policy.js';
+import { ProviderSupervisor } from '../providers/supervisor.js';
+class SerialQueue {
+    #tail = Promise.resolve();
+    async run(work) {
+        const previous = this.#tail;
+        let release;
+        this.#tail = new Promise((resolve) => {
+            release = resolve;
+        });
+        await previous;
+        try {
+            return await work();
+        }
+        finally {
+            release();
+        }
+    }
+}
+function isMutation(operation) {
+    return COMPUTER_OPERATIONS[operation].mutation;
+}
+function assertedInputApp(input) {
+    if (input === null || typeof input !== 'object')
+        return;
+    const app = input.app;
+    if (typeof app === 'string' && app.length > 0) {
+        assertAppAllowed({ appId: app, executableId: app });
+    }
+}
+function targetReference(input) {
+    if (input === null || typeof input !== 'object')
+        return undefined;
+    const record = input;
+    const candidate = record.target ?? record.from;
+    if (candidate === null || typeof candidate !== 'object')
+        return undefined;
+    const target = candidate;
+    if (target.kind === 'element')
+        return target.ref;
+    if (target.kind === 'coordinate' && target.window !== undefined)
+        return target.window;
+    if ('contextToken' in target)
+        return target;
+    return undefined;
+}
+function bindReference(context, current, kind, ref) {
+    return {
+        ...current,
+        kind,
+        ref,
+        contextToken: context.token,
+        expiresAt: context.expiresAt
+    };
+}
+function normalizeTarget(candidate, context, current) {
+    if (candidate === null || typeof candidate !== 'object')
+        return candidate;
+    const target = candidate;
+    if (target.kind === 'element' && typeof target.elementIndex === 'number') {
+        return {
+            kind: 'element',
+            ref: bindReference(context, current, 'element', `element:${target.elementIndex}`)
+        };
+    }
+    if (target.kind === 'coordinate' && target.window === undefined) {
+        return {
+            ...target,
+            window: bindReference(context, current, 'window', current.window.id)
+        };
+    }
+    if (target.kind === 'context-window') {
+        return bindReference(context, current, 'window', current.window.id);
+    }
+    return candidate;
+}
+function normalizeMutationInput(input, context, current) {
+    if (input === null || typeof input !== 'object')
+        return input;
+    const record = input;
+    return {
+        ...record,
+        ...(record.target === undefined
+            ? {}
+            : { target: normalizeTarget(record.target, context, current) }),
+        ...(record.from === undefined ? {} : { from: normalizeTarget(record.from, context, current) }),
+        ...(record.to === undefined ? {} : { to: normalizeTarget(record.to, context, current) })
+    };
+}
+function mutationReferences(input) {
+    if (input === null || typeof input !== 'object')
+        return [];
+    const record = input;
+    return [record.target, record.from, record.to]
+        .map((candidate) => targetReference({ target: candidate }))
+        .filter((candidate) => candidate !== undefined);
+}
+function contextToken(input) {
+    if (input === null || typeof input !== 'object')
+        return undefined;
+    const token = input.contextToken;
+    return typeof token === 'string' ? token : undefined;
+}
+function computerError(cause) {
+    if (cause instanceof Error)
+        return cause;
+    return { message: 'Unknown provider failure' };
+}
+function assertFreshReference(reference, context, current, now) {
+    const mismatches = [
+        [reference.contextToken !== context.token, 'context token'],
+        [reference.brokerGeneration !== context.brokerGeneration, 'context broker generation'],
+        [reference.providerGeneration !== context.providerGeneration, 'context provider generation'],
+        [reference.graphicalSessionId !== context.graphicalSessionId, 'context session'],
+        [reference.brokerGeneration !== current.brokerGeneration, 'current broker generation'],
+        [reference.providerGeneration !== current.providerGeneration, 'current provider generation'],
+        [reference.graphicalSessionId !== current.graphicalSessionId, 'current session'],
+        [reference.process.pid !== context.process.pid, 'context pid'],
+        [reference.process.startedAt !== context.process.startedAt, 'context process start'],
+        [reference.process.executableId !== context.process.executableId, 'context executable'],
+        [reference.process.pid !== current.process.pid, 'current pid'],
+        [reference.process.startedAt !== current.process.startedAt, 'current process start'],
+        [reference.process.executableId !== current.process.executableId, 'current executable'],
+        [reference.appId !== context.appId, 'context app'],
+        [reference.appId !== current.appId, 'current app'],
+        [reference.window.id !== context.window.id, 'context window'],
+        [reference.window.ownerPid !== context.window.ownerPid, 'context window owner'],
+        [reference.window.id !== current.window.id, 'current window'],
+        [reference.window.ownerPid !== current.window.ownerPid, 'current window owner'],
+        [reference.snapshotId !== context.snapshotId, 'context snapshot'],
+        [reference.snapshotId !== current.snapshotId, 'current snapshot'],
+        [reference.desktopEpoch !== context.desktopEpoch, 'context desktop epoch'],
+        [reference.desktopEpoch !== current.desktopEpoch, 'current desktop epoch'],
+        [Date.parse(reference.expiresAt) < now, 'reference expiration'],
+        [Date.parse(context.expiresAt) < now, 'context expiration']
+    ]
+        .filter(([failed]) => failed)
+        .map(([, label]) => label);
+    if (mismatches.length > 0) {
+        throw createComputerError('stale_target', 'Target reference is no longer fresh', { mismatches });
+    }
+}
+export class BrokerClient {
+    broker;
+    constructor(broker) {
+        this.broker = broker;
+    }
+    request(request) {
+        return this.broker.request(request);
+    }
+}
+export class LocalBroker {
+    generation;
+    #identity;
+    #supervisor;
+    #contexts;
+    #inspectTarget;
+    #publish;
+    #now;
+    #queue = new SerialQueue();
+    #desktopEpoch = 0;
+    #requestSequence = 0;
+    constructor(options) {
+        this.generation = options.generation ?? `broker-${randomUUID()}`;
+        this.#identity = options.identity;
+        this.#inspectTarget = options.inspectTarget;
+        this.#publish = options.publish;
+        this.#now = options.now ?? Date.now;
+        this.#contexts = new InteractionContextStore({
+            ...(options.contextTtlMs === undefined ? {} : { ttlMs: options.contextTtlMs }),
+            now: this.#now
+        });
+        this.#supervisor = new ProviderSupervisor({
+            providerFactory: options.providerFactory,
+            graphicalSessionId: options.identity.graphicalSessionId
+        });
+    }
+    get desktopEpoch() {
+        return this.#desktopEpoch;
+    }
+    async connect(handshake) {
+        const { peer } = handshake;
+        if (!peer.verified || !peer.local) {
+            throw createComputerError('session_unavailable', 'Broker peer could not be verified locally');
+        }
+        if (peer.osIdentity !== this.#identity.osIdentity ||
+            peer.graphicalSessionId !== this.#identity.graphicalSessionId) {
+            throw createComputerError('session_unavailable', 'Broker peer belongs to a different OS identity or graphical session');
+        }
+        const versions = negotiateVersionHandshake(handshake.versions);
+        if (!versions.ok)
+            throw versions.error;
+        await this.#supervisor.start();
+        return new BrokerClient(this);
+    }
+    issueContext(bindings) {
+        return this.#contexts.issue({
+            ...bindings,
+            brokerGeneration: this.generation,
+            providerGeneration: this.#supervisor.generation ?? bindings.providerGeneration,
+            graphicalSessionId: this.#identity.graphicalSessionId,
+            desktopEpoch: this.#desktopEpoch
+        });
+    }
+    resolveContext(token) {
+        return this.#contexts.resolve(token);
+    }
+    request(request) {
+        return this.#queue.run(() => this.#requestLocked(request));
+    }
+    async #requestLocked(request) {
+        const requestId = `broker-${++this.#requestSequence}`;
+        const deadlineAt = this.#now() + (request.deadlineMs ?? 30_000);
+        const mutation = isMutation(request.operation);
+        assertedInputApp(request.input);
+        let context;
+        let inspectionInput = request.input;
+        if (mutation) {
+            const token = contextToken(request.input);
+            if (token === undefined) {
+                throw createComputerError('invalid_argument', 'Mutation requires a context token and target');
+            }
+            context = this.#contexts.resolve(token);
+            // Context-window and index shorthand do not carry an identity until the
+            // broker binds them. Inspect the bound form so native providers can
+            // re-resolve the exact process/window before dispatch.
+            inspectionInput = normalizeMutationInput(request.input, context, context);
+        }
+        const inspection = await this.#inspectTarget?.(request.operation, inspectionInput);
+        if (inspection !== undefined && inspection !== null)
+            assertAppAllowed(inspection.appIdentity);
+        let providerInput = request.input;
+        if (mutation) {
+            if (inspection === undefined || inspection === null) {
+                throw createComputerError('stale_target', 'Target identity could not be re-resolved');
+            }
+            providerInput = normalizeMutationInput(request.input, context, inspection.bindings);
+            const references = mutationReferences(providerInput);
+            if (references.length === 0) {
+                throw createComputerError('invalid_argument', 'Mutation requires a target selector');
+            }
+            for (const reference of references) {
+                assertFreshReference(reference, context, inspection.bindings, this.#now());
+            }
+        }
+        try {
+            const providerResponse = await this.#supervisor.dispatch({
+                requestId,
+                operation: request.operation,
+                input: providerInput,
+                deadlineAt
+            });
+            if (mutation) {
+                const dispatched = providerResponse.dispatched;
+                if (dispatched)
+                    this.#desktopEpoch += 1;
+                const result = 'error' in providerResponse
+                    ? {
+                        outcome: dispatched
+                            ? { state: 'indeterminate', reason: providerResponse.error.message }
+                            : { state: 'not_attempted', error: providerResponse.error }
+                    }
+                    : providerResponse.result;
+                const response = {
+                    requestId,
+                    result: this.#publicResult(request.operation, result),
+                    desktopEpoch: this.#desktopEpoch,
+                    providerGeneration: this.#supervisor.generation ?? 'unknown'
+                };
+                await this.#publish?.(response);
+                return response;
+            }
+            return this.#observationResponse(requestId, request.operation, providerResponse.result);
+        }
+        catch (cause) {
+            const error = computerError(cause);
+            if (!mutation && error.code === 'provider_crashed') {
+                await this.#supervisor.restart();
+                this.#contexts.invalidateAll();
+                const retry = await this.#supervisor.dispatch({
+                    requestId: `${requestId}-retry`,
+                    operation: request.operation,
+                    input: request.input,
+                    deadlineAt
+                });
+                if ('error' in retry)
+                    throw Object.assign(new Error(retry.error.message), retry.error);
+                return this.#observationResponse(requestId, request.operation, retry.result);
+            }
+            if (mutation && (error.code === 'provider_crashed' || error.code === 'timeout')) {
+                this.#desktopEpoch += 1;
+                this.#contexts.invalidateAll();
+                const response = {
+                    requestId,
+                    result: this.#publicResult(request.operation, {
+                        outcome: { state: 'indeterminate', reason: error.message }
+                    }),
+                    desktopEpoch: this.#desktopEpoch,
+                    providerGeneration: this.#supervisor.generation ?? 'unknown'
+                };
+                await this.#publish?.(response);
+                return response;
+            }
+            throw cause;
+        }
+    }
+    #observationResponse(requestId, operation, result) {
+        let context;
+        const publicResult = this.#publicResult(operation, result);
+        if (publicResult !== null && typeof publicResult === 'object' && 'context' in publicResult)
+            context = publicResult.context;
+        return {
+            requestId,
+            result: publicResult,
+            desktopEpoch: this.#desktopEpoch,
+            providerGeneration: this.#supervisor.generation ?? 'unknown',
+            ...(context === undefined ? {} : { context })
+        };
+    }
+    #publicResult(operation, result) {
+        if (result === null || typeof result !== 'object')
+            return parseOperationOutput(operation, result);
+        const value = result;
+        let publicResult = value;
+        if ('bindings' in value) {
+            const { bindings, ...snapshot } = value;
+            publicResult = { ...snapshot, context: this.issueContext(bindings) };
+        }
+        else if (value.freshState !== null &&
+            typeof value.freshState === 'object' &&
+            'bindings' in value.freshState) {
+            const { bindings, ...freshState } = value.freshState;
+            publicResult = {
+                ...value,
+                freshState: {
+                    ...freshState,
+                    context: this.issueContext(bindings)
+                }
+            };
+        }
+        return parseOperationOutput(operation, publicResult);
+    }
+}
+//# sourceMappingURL=broker.js.map

package/dist/broker/broker.js.map

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

package/dist/bundle-lifecycle.d.ts

@@ -0,0 +1,75 @@
+export type BundleArtifact = {
+    name: string;
+    version: string;
+    expectedDigest: string;
+    actualDigest: string;
+    trustVerified: boolean;
+};
+export type BundleCandidate = {
+    version: string;
+    release: number;
+    manifestDigest: string;
+    requiredArtifacts: readonly string[];
+    artifacts: readonly BundleArtifact[];
+};
+export type LifecyclePhase = 'idle' | 'running' | 'draining' | 'activating' | 'uninstalling' | 'uninstalled';
+export type LifecycleErrorCode = 'bundle_incomplete' | 'bundle_integrity' | 'bundle_version_mismatch' | 'lifecycle_busy' | 'mutation_rejected' | 'version_incompatible';
+export declare class BundleLifecycleError extends Error {
+    readonly code: LifecycleErrorCode;
+    constructor(code: LifecycleErrorCode, message: string);
+}
+export type ActivationHooks = {
+    /** Runs before the atomic active-version pointer changes. */
+    beforeCommit?: () => void | Promise<void>;
+    /** Runs after the pointer changes, to model restart/interruption after commit. */
+    afterCommit?: () => void | Promise<void>;
+};
+export type ClientState = {
+    id: string;
+    version: string;
+    reconnectRequired: boolean;
+};
+export type DispatchVersions = {
+    client: string;
+    broker: string;
+    provider: string;
+    payload: string;
+};
+export type InteractionContextGeneration = {
+    generation: number;
+};
+export type InstalledResourceKind = 'broker-registration' | 'ipc' | 'cache' | 'log' | 'temporary-capture' | 'export' | 'configuration' | 'permission';
+export type InstalledResource = {
+    id: string;
+    kind: InstalledResourceKind;
+    owner: 'crosshands' | 'user' | 'os';
+};
+export type UninstallPlan = {
+    remove: readonly InstalledResource[];
+    preserve: readonly InstalledResource[];
+    manual: readonly InstalledResource[];
+};
+export declare function planUninstall(resources: readonly InstalledResource[]): UninstallPlan;
+/**
+ * Coordinates installed bundle state. Filesystem/package-manager work is deliberately
+ * supplied by callers; this class owns only verification gates and atomic state changes.
+ */
+export declare class BundleLifecycle {
+    #private;
+    get phase(): LifecyclePhase;
+    get activeVersion(): string | undefined;
+    get inFlightMutations(): number;
+    stage(candidate: BundleCandidate): void;
+    bundle(version: string): BundleCandidate | undefined;
+    beginMutation(): () => void;
+    activate(version: string, hooks?: ActivationHooks): Promise<void>;
+    rollback(version: string, hooks?: ActivationHooks): Promise<void>;
+    connectClient(id: string, version: string): ClientState;
+    reconnectClient(id: string, version: string): ClientState;
+    client(id: string): ClientState | undefined;
+    assertDispatchCompatible(versions: DispatchVersions): void;
+    issueContext(): InteractionContextGeneration;
+    isContextCurrent(context: InteractionContextGeneration): boolean;
+    uninstall(resources: readonly InstalledResource[], remove: (resource: InstalledResource) => void | Promise<void>): Promise<UninstallPlan>;
+}
+//# sourceMappingURL=bundle-lifecycle.d.ts.map

package/dist/bundle-lifecycle.d.ts.map

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