@devicerail/protocol 0.1.0

package/dist/generated/v1/find-element-result.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type UiContextKind = "native" | "web";
+export interface FindElementResult {
+    element: UiNodeRef;
+}
+/**
+ * Durable reference to one node in one observed UI Tree.
+ */
+export interface UiNodeRef {
+    context: UiContextRef;
+    observationId: string;
+    stableNodeId: string;
+}
+/**
+ * Full identity of one native accessibility or web-document context.
+ * `documentEpoch` is required for both channels and changes after reconnect,
+ * navigation, or any replacement that invalidates prior node references.
+ */
+export interface UiContextRef {
+    contextId: string;
+    contextKind: UiContextKind;
+    documentEpoch: string;
+}

package/dist/generated/v1/hello-params.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export interface HelloParams {
+    client: PeerInfo;
+    features?: FeatureOffer;
+    protocol: ProtocolOffer;
+}
+export interface PeerInfo {
+    name: string;
+    version: string;
+}
+export interface FeatureOffer {
+    optional?: string[];
+    required?: string[];
+}
+/**
+ * An explicit set of supported ranges. Multiple entries avoid implying support
+ * for major versions that a peer intentionally skipped.
+ */
+export interface ProtocolOffer {
+    /**
+     * @minItems 1
+     */
+    ranges: [ProtocolRange, ...ProtocolRange[]];
+}
+/**
+ * A contiguous minor-version range within one protocol major version.
+ */
+export interface ProtocolRange {
+    major: number;
+    maxMinor: number;
+    minMinor: number;
+}

package/dist/generated/v1/hello-result.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export interface HelloResult {
+    connectionId: string;
+    features: FeatureSelection;
+    protocol: ProtocolSelection;
+    server: PeerInfo;
+    transport: TransportInfo;
+}
+export interface FeatureSelection {
+    enabled: string[];
+}
+export interface ProtocolSelection {
+    selected: ProtocolVersion;
+}
+export interface ProtocolVersion {
+    major: number;
+    minor: number;
+}
+export interface PeerInfo {
+    name: string;
+    version: string;
+}
+export interface TransportInfo {
+    framing: string;
+    kind: string;
+}

package/dist/generated/v1/index.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type { ActionCall } from "./action-call.js";
+export type { ActionDefinition } from "./action-definition.js";
+export type { ActionExecution } from "./action-execution.js";
+export type { ActionOutcome } from "./action-outcome.js";
+export type { ActionProtection } from "./action-protection.js";
+export type { ActionResult } from "./action-result.js";
+export type { AssetRef } from "./asset-ref.js";
+export type { ClearElementArguments } from "./clear-element-arguments.js";
+export type { ClearElementResult } from "./clear-element-result.js";
+export type { CoordinateFallbackReason } from "./coordinate-fallback-reason.js";
+export type { DeviceCapabilitiesRequest } from "./device-capabilities-request.js";
+export type { DeviceCapabilitiesResponse } from "./device-capabilities-response.js";
+export type { DeviceCapabilitiesResult } from "./device-capabilities-result.js";
+export type { DeviceConnectRequest } from "./device-connect-request.js";
+export type { DeviceConnectResponse } from "./device-connect-response.js";
+export type { DeviceConnectResult } from "./device-connect-result.js";
+export type { DeviceDisconnectRequest } from "./device-disconnect-request.js";
+export type { DeviceDisconnectResponse } from "./device-disconnect-response.js";
+export type { DeviceDisconnectResult } from "./device-disconnect-result.js";
+export type { DeviceExecuteParams } from "./device-execute-params.js";
+export type { DeviceExecuteRequest } from "./device-execute-request.js";
+export type { DeviceExecuteResponse } from "./device-execute-response.js";
+export type { DeviceExecuteResult } from "./device-execute-result.js";
+export type { DeviceId } from "./device-id.js";
+export type { DeviceInfo } from "./device-info.js";
+export type { DeviceObserveRequest } from "./device-observe-request.js";
+export type { DeviceObserveResponse } from "./device-observe-response.js";
+export type { DeviceObserveResult } from "./device-observe-result.js";
+export type { DeviceSelectParams } from "./device-select-params.js";
+export type { DeviceSelectRequest } from "./device-select-request.js";
+export type { DeviceSelectResponse } from "./device-select-response.js";
+export type { DeviceSelectResult } from "./device-select-result.js";
+export type { DevicesListRequest } from "./devices-list-request.js";
+export type { DevicesListResponse } from "./devices-list-response.js";
+export type { DevicesListResult } from "./devices-list-result.js";
+export type { ElementSelector } from "./element-selector.js";
+export type { ElementTarget } from "./element-target.js";
+export type { ErrorInfo } from "./error-info.js";
+export type { EventId } from "./event-id.js";
+export type { EventSequence } from "./event-sequence.js";
+export type { EventStreamCursor } from "./event-stream-cursor.js";
+export type { EventStreamEndpoint } from "./event-stream-endpoint.js";
+export type { EventStreamEpoch } from "./event-stream-epoch.js";
+export type { EventStreamOriginPolicy } from "./event-stream-origin-policy.js";
+export type { EventSubscriptionId } from "./event-subscription-id.js";
+export type { EventsClearRequest } from "./events-clear-request.js";
+export type { EventsClearResponse } from "./events-clear-response.js";
+export type { EventsClearResult } from "./events-clear-result.js";
+export type { EventsListParams } from "./events-list-params.js";
+export type { EventsListRequest } from "./events-list-request.js";
+export type { EventsListResponse } from "./events-list-response.js";
+export type { EventsListResult } from "./events-list-result.js";
+export type { EventsStreamEventNotification } from "./events-stream-event-notification.js";
+export type { EventsStreamEventParams } from "./events-stream-event-params.js";
+export type { EventsStreamOpenParams } from "./events-stream-open-params.js";
+export type { EventsStreamOpenRequest } from "./events-stream-open-request.js";
+export type { EventsStreamOpenResponse } from "./events-stream-open-response.js";
+export type { EventsStreamOpenResult } from "./events-stream-open-result.js";
+export type { EventsStreamTerminalNotification } from "./events-stream-terminal-notification.js";
+export type { EventsStreamTerminalParams } from "./events-stream-terminal-params.js";
+export type { EventsStreamTermination } from "./events-stream-termination.js";
+export type { EventsSubscribeParams } from "./events-subscribe-params.js";
+export type { EventsSubscribeRequest } from "./events-subscribe-request.js";
+export type { EventsSubscribeResponse } from "./events-subscribe-response.js";
+export type { EventsSubscribeResult } from "./events-subscribe-result.js";
+export type { FeatureOffer } from "./feature-offer.js";
+export type { FeatureSelection } from "./feature-selection.js";
+export type { FindElementArguments } from "./find-element-arguments.js";
+export type { FindElementResult } from "./find-element-result.js";
+export type { HelloParams } from "./hello-params.js";
+export type { HelloResult } from "./hello-result.js";
+export type { JsonRpcVersion } from "./json-rpc-version.js";
+export type { ManualActionArguments } from "./manual-action-arguments.js";
+export type { ManualActionStep } from "./manual-action-step.js";
+export type { ManualRecording } from "./manual-recording.js";
+export type { MediaFrame } from "./media-frame.js";
+export type { MediaStreamCaptureParams } from "./media-stream-capture-params.js";
+export type { MediaStreamCaptureRequest } from "./media-stream-capture-request.js";
+export type { MediaStreamCaptureResponse } from "./media-stream-capture-response.js";
+export type { MediaStreamCaptureResult } from "./media-stream-capture-result.js";
+export type { MediaStreamEndParams } from "./media-stream-end-params.js";
+export type { MediaStreamEndRequest } from "./media-stream-end-request.js";
+export type { MediaStreamEndResponse } from "./media-stream-end-response.js";
+export type { MediaStreamEndResult } from "./media-stream-end-result.js";
+export type { MediaStreamId } from "./media-stream-id.js";
+export type { MediaStreamInfo } from "./media-stream-info.js";
+export type { MediaStreamKind } from "./media-stream-kind.js";
+export type { MediaStreamStartParams } from "./media-stream-start-params.js";
+export type { MediaStreamStartRequest } from "./media-stream-start-request.js";
+export type { MediaStreamStartResponse } from "./media-stream-start-response.js";
+export type { MediaStreamStartResult } from "./media-stream-start-result.js";
+export type { Observation } from "./observation.js";
+export type { PeerInfo } from "./peer-info.js";
+export type { Platform } from "./platform.js";
+export type { ProtocolIncompatibilityReason } from "./protocol-incompatibility-reason.js";
+export type { ProtocolOffer } from "./protocol-offer.js";
+export type { ProtocolRange } from "./protocol-range.js";
+export type { ProtocolSelection } from "./protocol-selection.js";
+export type { ProtocolVersion } from "./protocol-version.js";
+export type { RecordedActionCall } from "./recorded-action-call.js";
+export type { RequestCancelParams } from "./request-cancel-params.js";
+export type { RequestCancelRequest } from "./request-cancel-request.js";
+export type { RequestCancelResponse } from "./request-cancel-response.js";
+export type { RequestCancelResult } from "./request-cancel-result.js";
+export type { RequestCancelStatus } from "./request-cancel-status.js";
+export type { RequestTimeoutMs } from "./request-timeout-ms.js";
+export type { RpcError } from "./rpc-error.js";
+export type { RpcId } from "./rpc-id.js";
+export type { RpcParams } from "./rpc-params.js";
+export type { RpcRequest } from "./rpc-request.js";
+export type { RpcResponse } from "./rpc-response.js";
+export type { RpcServerMessage } from "./rpc-server-message.js";
+export type { RpcServerNotification } from "./rpc-server-notification.js";
+export type { ScreenshotOmissionReason } from "./screenshot-omission-reason.js";
+export type { SessionCurrentRequest } from "./session-current-request.js";
+export type { SessionCurrentResponse } from "./session-current-response.js";
+export type { SessionCurrentResult } from "./session-current-result.js";
+export type { SessionEndParams } from "./session-end-params.js";
+export type { SessionEndRequest } from "./session-end-request.js";
+export type { SessionEndResponse } from "./session-end-response.js";
+export type { SessionEndResult } from "./session-end-result.js";
+export type { SessionExportParams } from "./session-export-params.js";
+export type { SessionExportRequest } from "./session-export-request.js";
+export type { SessionExportResponse } from "./session-export-response.js";
+export type { SessionExportResult } from "./session-export-result.js";
+export type { SessionExport } from "./session-export.js";
+export type { SessionId } from "./session-id.js";
+export type { SessionInfo } from "./session-info.js";
+export type { SessionOutcome } from "./session-outcome.js";
+export type { SessionStartRequest } from "./session-start-request.js";
+export type { SessionStartResponse } from "./session-start-response.js";
+export type { SessionStartResult } from "./session-start-result.js";
+export type { SessionState } from "./session-state.js";
+export type { SessionTargetParams } from "./session-target-params.js";
+export type { SessionsListRequest } from "./sessions-list-request.js";
+export type { SessionsListResponse } from "./sessions-list-response.js";
+export type { SessionsListResult } from "./sessions-list-result.js";
+export type { SetElementValueArguments } from "./set-element-value-arguments.js";
+export type { SetElementValueResult } from "./set-element-value-result.js";
+export type { SystemDescribeRequest } from "./system-describe-request.js";
+export type { SystemDescribeResponse } from "./system-describe-response.js";
+export type { SystemDescribeResult } from "./system-describe-result.js";
+export type { SystemHelloRequest } from "./system-hello-request.js";
+export type { SystemHelloResponse } from "./system-hello-response.js";
+export type { TapElementArguments } from "./tap-element-arguments.js";
+export type { TapElementResult } from "./tap-element-result.js";
+export type { TestEventPayload } from "./test-event-payload.js";
+export type { TestEvent } from "./test-event.js";
+export type { TextMatchMode } from "./text-match-mode.js";
+export type { TextMatch } from "./text-match.js";
+export type { TransportInfo } from "./transport-info.js";
+export type { UiContextKind } from "./ui-context-kind.js";
+export type { UiContextRef } from "./ui-context-ref.js";
+export type { UiContextSelector } from "./ui-context-selector.js";
+export type { UiNodeRef } from "./ui-node-ref.js";
+export type { UiNode } from "./ui-node.js";
+export type { UiRect } from "./ui-rect.js";
+export type { UiSnapshotGetParams } from "./ui-snapshot-get-params.js";
+export type { UiSnapshotGetRequest } from "./ui-snapshot-get-request.js";
+export type { UiSnapshotGetResponse } from "./ui-snapshot-get-response.js";
+export type { UiSnapshotGetResult } from "./ui-snapshot-get-result.js";
+export type { UiSnapshotOmissionReason } from "./ui-snapshot-omission-reason.js";
+export type { UiSnapshotRef } from "./ui-snapshot-ref.js";
+export type { UiSnapshot } from "./ui-snapshot.js";
+export type { VerdictRecordParams } from "./verdict-record-params.js";
+export type { VerdictRecordRequest } from "./verdict-record-request.js";
+export type { VerdictRecordResponse } from "./verdict-record-response.js";
+export type { VerdictRecordResult } from "./verdict-record-result.js";
+export type { VerdictStatus } from "./verdict-status.js";
+export type { Verdict } from "./verdict.js";
+export type { Viewport } from "./viewport.js";
+export type { WaitForElementArguments } from "./wait-for-element-arguments.js";
+export type { WaitForElementCondition } from "./wait-for-element-condition.js";
+export type { WaitForElementResult } from "./wait-for-element-result.js";
+export type { RpcMethod, RpcMethodMap, RpcParamsFor, RpcRequestFor, RpcResponseFor, RpcResultFor, RpcSupportsTimeout, } from "./method-map.js";

package/dist/generated/v1/json-rpc-version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type JsonRpcVersion = "2.0";

package/dist/generated/v1/manual-action-arguments.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type ManualActionArguments = {
+    kind: "captured";
+    value: unknown;
+} | {
+    kind: "protected";
+    secretRef: string;
+};

package/dist/generated/v1/manual-action-step.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type ManualActionArguments = {
+    kind: "captured";
+    value: unknown;
+} | {
+    kind: "protected";
+    secretRef: string;
+};
+/**
+ * A one-based sequence number within one session.
+ *
+ * The wire value is capped at JavaScript's maximum safe integer so generated
+ * clients can sort and resume event streams without losing precision.
+ */
+export type EventSequence = number;
+export interface ManualActionStep {
+    arguments: ManualActionArguments;
+    callId: string;
+    capturedAtMs: number;
+    name: string;
+    sequence: EventSequence;
+}

package/dist/generated/v1/manual-recording.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type ManualActionArguments = {
+    kind: "captured";
+    value: unknown;
+} | {
+    kind: "protected";
+    secretRef: string;
+};
+/**
+ * A one-based sequence number within one session.
+ *
+ * The wire value is capped at JavaScript's maximum safe integer so generated
+ * clients can sort and resume event streams without losing precision.
+ */
+export type EventSequence = number;
+/**
+ * A bounded, Driver-neutral record of human-selected Actions.
+ *
+ * Protected Action arguments are represented only by an opaque host-owned
+ * secret reference. The secret value is never part of this durable DTO.
+ */
+export interface ManualRecording {
+    actionSpaceSha256: string;
+    endedAtMs: number;
+    formatVersion: number;
+    recordingId: string;
+    sourceDeviceId: string;
+    startedAtMs: number;
+    /**
+     * @maxItems 10000
+     */
+    steps: ManualActionStep[];
+}
+export interface ManualActionStep {
+    arguments: ManualActionArguments;
+    callId: string;
+    capturedAtMs: number;
+    name: string;
+    sequence: EventSequence;
+}

package/dist/generated/v1/media-frame.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+/**
+ * A one-based sequence number within one session.
+ *
+ * The wire value is capped at JavaScript's maximum safe integer so generated
+ * clients can sort and resume event streams without losing precision.
+ */
+export type EventSequence = number;
+export interface MediaFrame {
+    durationMs?: number | null;
+    evidence: AssetRef;
+    frameIndex: EventSequence;
+    keyFrame?: boolean;
+    streamId: string;
+}
+export interface AssetRef {
+    id: string;
+    mediaType: string;
+    sha256?: string | null;
+    uri: string;
+    [k: string]: unknown;
+}

package/dist/generated/v1/media-stream-capture-params.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+/**
+ * Parameters accepted by `media.stream.capture`.
+ */
+export interface MediaStreamCaptureParams {
+    durationMs?: number | null;
+    /**
+     * Caller-declared one-based frame index. Retrying the same accepted index
+     * is idempotent; advancing it is the caller's acknowledgement boundary.
+     */
+    frameIndex: number;
+    streamId: string;
+}

package/dist/generated/v1/media-stream-capture-request.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type RpcIdSchema = string | number;
+export type JsonRpcVersion = "2.0";
+export type MediaStreamCaptureMethodSchema = "media.stream.capture";
+/**
+ * A positive timeout in milliseconds that is safe to represent as a JSON
+ * number in every supported client language.
+ */
+export type RequestTimeoutMs = number;
+export interface MediaStreamCaptureRequest {
+    id: RpcIdSchema;
+    jsonrpc: JsonRpcVersion;
+    method: MediaStreamCaptureMethodSchema;
+    params: MediaStreamCaptureParams;
+    timeoutMs?: RequestTimeoutMs;
+}
+/**
+ * Parameters accepted by `media.stream.capture`.
+ */
+export interface MediaStreamCaptureParams {
+    durationMs?: number | null;
+    /**
+     * Caller-declared one-based frame index. Retrying the same accepted index
+     * is idempotent; advancing it is the caller's acknowledgement boundary.
+     */
+    frameIndex: number;
+    streamId: string;
+}

package/dist/generated/v1/media-stream-capture-response.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type MediaStreamCaptureResponse = MediaStreamCaptureSuccessSchema | SystemHelloFailureSchema;
+export type RpcIdSchema = string | number;
+export type JsonRpcVersion = "2.0";
+/**
+ * A one-based sequence number within one session.
+ *
+ * The wire value is capped at JavaScript's maximum safe integer so generated
+ * clients can sort and resume event streams without losing precision.
+ */
+export type EventSequence = number;
+export type NullableRpcIdSchema = RpcIdSchema | null;
+export interface MediaStreamCaptureSuccessSchema {
+    id: RpcIdSchema;
+    jsonrpc: JsonRpcVersion;
+    result: MediaStreamCaptureResult;
+}
+/**
+ * Result returned by `media.stream.capture`.
+ */
+export interface MediaStreamCaptureResult {
+    frame: MediaFrame;
+}
+export interface MediaFrame {
+    durationMs?: number | null;
+    evidence: AssetRef;
+    frameIndex: EventSequence;
+    keyFrame?: boolean;
+    streamId: string;
+}
+export interface AssetRef {
+    id: string;
+    mediaType: string;
+    sha256?: string | null;
+    uri: string;
+    [k: string]: unknown;
+}
+export interface SystemHelloFailureSchema {
+    error: RpcError;
+    id: NullableRpcIdSchema;
+    jsonrpc: JsonRpcVersion;
+}
+export interface RpcError {
+    code: number;
+    data: ErrorInfo;
+    message: string;
+}
+export interface ErrorInfo {
+    code: string;
+    details?: unknown;
+    message: string;
+    retryable: boolean;
+}

package/dist/generated/v1/media-stream-capture-result.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+/**
+ * A one-based sequence number within one session.
+ *
+ * The wire value is capped at JavaScript's maximum safe integer so generated
+ * clients can sort and resume event streams without losing precision.
+ */
+export type EventSequence = number;
+/**
+ * Result returned by `media.stream.capture`.
+ */
+export interface MediaStreamCaptureResult {
+    frame: MediaFrame;
+}
+export interface MediaFrame {
+    durationMs?: number | null;
+    evidence: AssetRef;
+    frameIndex: EventSequence;
+    keyFrame?: boolean;
+    streamId: string;
+}
+export interface AssetRef {
+    id: string;
+    mediaType: string;
+    sha256?: string | null;
+    uri: string;
+    [k: string]: unknown;
+}

package/dist/generated/v1/media-stream-end-params.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+/**
+ * Parameters accepted by `media.stream.end`.
+ */
+export interface MediaStreamEndParams {
+    streamId: string;
+}

package/dist/generated/v1/media-stream-end-request.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type RpcIdSchema = string | number;
+export type JsonRpcVersion = "2.0";
+export type MediaStreamEndMethodSchema = "media.stream.end";
+export interface MediaStreamEndRequest {
+    id: RpcIdSchema;
+    jsonrpc: JsonRpcVersion;
+    method: MediaStreamEndMethodSchema;
+    params: MediaStreamEndParams;
+}
+/**
+ * Parameters accepted by `media.stream.end`.
+ */
+export interface MediaStreamEndParams {
+    streamId: string;
+}

package/dist/generated/v1/media-stream-end-response.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type MediaStreamEndResponse = MediaStreamEndSuccessSchema | SystemHelloFailureSchema;
+export type RpcIdSchema = string | number;
+export type JsonRpcVersion = "2.0";
+export type NullableRpcIdSchema = RpcIdSchema | null;
+export interface MediaStreamEndSuccessSchema {
+    id: RpcIdSchema;
+    jsonrpc: JsonRpcVersion;
+    result: MediaStreamEndResult;
+}
+/**
+ * Result returned by `media.stream.end`.
+ */
+export interface MediaStreamEndResult {
+    frameCount: number;
+    streamId: string;
+}
+export interface SystemHelloFailureSchema {
+    error: RpcError;
+    id: NullableRpcIdSchema;
+    jsonrpc: JsonRpcVersion;
+}
+export interface RpcError {
+    code: number;
+    data: ErrorInfo;
+    message: string;
+}
+export interface ErrorInfo {
+    code: string;
+    details?: unknown;
+    message: string;
+    retryable: boolean;
+}

package/dist/generated/v1/media-stream-end-result.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+/**
+ * Result returned by `media.stream.end`.
+ */
+export interface MediaStreamEndResult {
+    frameCount: number;
+    streamId: string;
+}

package/dist/generated/v1/media-stream-id.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type MediaStreamId = string;

package/dist/generated/v1/media-stream-info.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type MediaStreamKind = "screenshot" | "video";
+export interface MediaStreamInfo {
+    id: string;
+    kind: MediaStreamKind;
+    mediaType: string;
+    viewport?: Viewport | null;
+}
+export interface Viewport {
+    height: number;
+    scaleFactor: number;
+    width: number;
+    [k: string]: unknown;
+}

package/dist/generated/v1/media-stream-kind.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type MediaStreamKind = "screenshot" | "video";

package/dist/generated/v1/media-stream-start-params.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Generated from the checked-in DeviceRail JSON Schema. DO NOT EDIT.
+ * Run `pnpm protocol:types:generate` from the repository root.
+ */
+export type MediaStreamKind = "screenshot" | "video";
+/**
+ * Parameters accepted by `media.stream.start`.
+ *
+ * The caller chooses only a lifetime-unique stream identifier and the logical
+ * stream kind. The daemon assigns the media type from its selected, leased
+ * device producer; viewport metadata may be absent. This control method never
+ * accepts frame bytes, Evidence references, or filesystem paths.
+ */
+export interface MediaStreamStartParams {
+    kind: MediaStreamKind;
+    streamId: string;
+}