{ "reviewedOn": "2026-09-30", "repository": "lomi-dev/lomi", "head": "93f47d818fe66ffada123cf49853e6bc00804433", "workingTreeChanges": [ "src-tauri/src/cli_integrations.rs", "src-tauri/src/cli_launch.rs", "src-tauri/src/cli_mcp.rs" ], "applicationVersion": "0.5.0", "serverInfo": { "name": "lomi-mcp", "version": "0.1.0" }, "protocolVersion": "2025-11-25", "controlApiVersion": "1.0", "ipcVersion": 1, "qualifiedHost": "macOS 14 or later, Apple Silicon", "toolCount": 74, "tools": [ { "name": "lomi_android_device_manage", "description": "Request create, modify, wipe, delete, recovery or owned-cache cleanup through Lomi's existing Android manager. Requires android.read/android.manage for devices, android.setup for global recovery/cleanup. Existing targets require an explicitly shared device, exact devices revision and generation; stop it first. Wipe/delete require its exact name. Every action needs protected Settings approval. Create grants only its creator the new device ID. Modify preserves image and data-partition size; changes apply on next start. Uses durable retry identity and native operation polling; an uncertain outcome never repeats a destructive action. Inventory provides exact recovery digests and available tool rollbacks. restore_metadata binds that digest; only preferences can reset with typed confirmation, while device metadata requires a valid backup; remove_package/rollback_package require the current manifest revision and refuse images referenced by a device.", "inputSchema": { "$defs": { "AndroidDeviceAction": { "oneOf": [ { "additionalProperties": false, "properties": { "expectedDevicesRevision": { "type": "string" }, "hardware": { "$ref": "#/$defs/AndroidHardware" }, "image": { "type": "string" }, "name": { "type": "string" }, "profile": { "type": "string" }, "type": { "const": "create", "type": "string" } }, "required": [ "type", "expectedDevicesRevision", "name", "image", "profile", "hardware" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "expectedDevicesRevision": { "type": "string" }, "generation": { "type": [ "string", "null" ] }, "hardware": { "$ref": "#/$defs/AndroidHardware" }, "name": { "type": "string" }, "profile": { "type": "string" }, "type": { "const": "modify", "type": "string" } }, "required": [ "type", "expectedDevicesRevision", "deviceId", "name", "profile", "hardware" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "type": "string" }, "deviceId": { "type": "string" }, "expectedDevicesRevision": { "type": "string" }, "generation": { "type": [ "string", "null" ] }, "type": { "const": "wipe", "type": "string" } }, "required": [ "type", "expectedDevicesRevision", "deviceId", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "confirmation": { "type": "string" }, "deviceId": { "type": "string" }, "expectedDevicesRevision": { "type": "string" }, "generation": { "type": [ "string", "null" ] }, "type": { "const": "delete", "type": "string" } }, "required": [ "type", "expectedDevicesRevision", "deviceId", "confirmation" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "recover", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "cleanup", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "digest": { "type": "string" }, "file": { "$ref": "#/$defs/AndroidMetadataFile" }, "reset": { "type": "boolean" }, "type": { "const": "restore_metadata", "type": "string" } }, "required": [ "type", "file", "digest", "reset" ], "type": "object" }, { "additionalProperties": false, "properties": { "expectedManifestRevision": { "type": "string" }, "packageId": { "type": "string" }, "type": { "const": "remove_package", "type": "string" } }, "required": [ "type", "packageId", "expectedManifestRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "expectedManifestRevision": { "type": "string" }, "packageId": { "type": "string" }, "type": { "const": "rollback_package", "type": "string" } }, "required": [ "type", "packageId", "expectedManifestRevision" ], "type": "object" } ] }, "AndroidGpu": { "enum": [ "auto", "host", "software" ], "type": "string" }, "AndroidHardware": { "additionalProperties": false, "properties": { "cpuCount": { "format": "uint32", "minimum": 0, "type": "integer" }, "dataGib": { "format": "uint32", "minimum": 0, "type": "integer" }, "gpu": { "$ref": "#/$defs/AndroidGpu" }, "quickBoot": { "type": "boolean" }, "ramMib": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "ramMib", "cpuCount", "dataGib", "gpu", "quickBoot" ], "type": "object" }, "AndroidMetadataFile": { "enum": [ "devices", "preferences" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "action": { "$ref": "#/$defs/AndroidDeviceAction" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "action", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "deviceId": { "type": [ "string", "null" ] }, "devicesRevision": { "type": [ "string", "null" ] }, "kind": { "const": "android_management", "type": "string" }, "manifestRevision": { "type": [ "string", "null" ] }, "nativeOperationId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "nativeOperationId" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_android_input", "description": "Send one ordered touch, key, navigation, quarter-turn rotation or committed Unicode text event through Lomi's existing Android router. Requires explicit android.interact, a device input lease from lomi_panel_control, and the selected panel in a focused visible Lomi window. Coordinates use hardware_display space. inputSequence is a decimal counter starting at 1; retry the same sequence and exact payload without dispatching twice. One operation at a time, 128 sequence receipts in RAM, text up to 16 KiB. Poll lomi_operation_get. Human takeover, blur and revoke release held input. No clipboard, arbitrary ADB shell or implicit Enter.", "inputSchema": { "$defs": { "AndroidCoordinateSpace": { "enum": [ "hardware_display" ], "type": "string" }, "AndroidInputEvent": { "oneOf": [ { "additionalProperties": false, "properties": { "quarterTurns": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "type": { "const": "rotate", "type": "string" } }, "required": [ "type", "quarterTurns" ], "type": "object" }, { "additionalProperties": false, "properties": { "text": { "type": "string" }, "type": { "const": "text", "type": "string" } }, "required": [ "type", "text" ], "type": "object" }, { "additionalProperties": false, "properties": { "down": { "type": "boolean" }, "key": { "type": "string" }, "type": { "const": "key", "type": "string" } }, "required": [ "type", "key", "down" ], "type": "object" }, { "additionalProperties": false, "properties": { "key": { "$ref": "#/$defs/AndroidNavigation" }, "type": { "const": "navigation", "type": "string" } }, "required": [ "type", "key" ], "type": "object" }, { "additionalProperties": false, "properties": { "identifier": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "phase": { "$ref": "#/$defs/AndroidTouchPhase" }, "space": { "$ref": "#/$defs/AndroidCoordinateSpace" }, "type": { "const": "touch", "type": "string" }, "x": { "format": "uint32", "minimum": 0, "type": "integer" }, "y": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "type", "space", "identifier", "x", "y", "phase" ], "type": "object" } ] }, "AndroidNavigation": { "enum": [ "back", "home", "overview", "power" ], "type": "string" }, "AndroidTouchPhase": { "enum": [ "down", "move", "up" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "event": { "$ref": "#/$defs/AndroidInputEvent" }, "generation": { "type": "string" }, "inputSequence": { "type": "string" }, "leaseId": { "type": "string" }, "panelId": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "leaseId", "inputSequence", "event", "retryEpoch" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "inputSequence": { "type": "string" }, "kind": { "const": "android_input", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "inputSequence" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_android_install_apk", "description": "Request installation of an imported APK on this connection's exact running managed Android generation. Requires android.install, android.control, android.read and source files.read. Supply artifactId and its exact sha256 plus durable retry key. Returns awaiting_user until native Settings approves this copy/device/generation within 120 seconds. Installation uses the same private read-only file, rechecks its hash, preserves app data and never uninstalls on failure. Poll lomi_operation_get; completion may take 180 seconds. Result reports package, observed numeric version codes when available and a bounded installer failure code. Transport uncertainty returns outcome_unknown, never automatic replay.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "sha256": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "artifactId", "sha256", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "installed": { "type": "boolean" }, "installerFailure": { "type": [ "string", "null" ] }, "kind": { "const": "android_install", "type": "string" }, "newVersion": { "type": [ "string", "null" ] }, "packageName": { "type": [ "string", "null" ] }, "previousVersion": { "type": [ "string", "null" ] }, "sha256": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "artifactId", "sha256", "installed" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_android_launch", "description": "Deliver a launch intent to an explicitly approved Android package on this connection’s running managed device. Requires android.launch and selected package permission in Settings. Optional activity is a Java class name; omission resolves MAIN/LAUNCHER. Supply exact device generation, panel, expectedRevision and durable retry key. Poll the operation. Success confirms intent delivery only; verify behavior with snapshot or logs. No deep links, arbitrary shell, force-stop or automatic retry after uncertain effects.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "activity": { "type": [ "string", "null" ] }, "deviceId": { "type": "string" }, "expectedRevision": { "type": "string" }, "generation": { "type": "string" }, "packageName": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "packageName", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "activity": { "type": "string" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "intentDelivered": { "type": "boolean" }, "kind": { "const": "android_launch", "type": "string" }, "packageName": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "packageName", "activity", "intentDelivered" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_android_list", "description": "Read names and runtime status only for managed Android devices explicitly selected in Settings for this connection and workspace. Requires android.read. Does not start the emulator, ADB or input. At most sixteen devices; excludes SDK paths, serials, logs and credentials.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidDevice": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "display": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": [ "array", "null" ] }, "generation": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "phase": { "$ref": "#/$defs/AndroidPhase" }, "processAlive": { "type": "boolean" } }, "required": [ "deviceId", "name", "phase", "processAlive" ], "type": "object" }, "AndroidDevices": { "additionalProperties": false, "properties": { "devicesRevision": { "type": "string" }, "hostQualified": { "type": "boolean" }, "items": { "items": { "$ref": "#/$defs/AndroidDevice" }, "type": "array" } }, "required": [ "devicesRevision", "hostQualified", "items" ], "type": "object" }, "AndroidPhase": { "enum": [ "stopped", "starting", "booting", "running", "stopping", "failed" ], "type": "string" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "devices": { "$ref": "#/$defs/AndroidDevices" }, "kind": { "const": "android_devices", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "devices" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_android_logcat", "description": "Read a bounded recent logcat snapshot from an explicitly approved Android package’s running main process. Requires android.logs and selected package permission. minPriority is V/D/I/W/E/F. At most 256 recent lines in main buffer, 64 KiB total; limit 1-64 lines per page, 2048 bytes per line. Cursor pages the same RAM snapshot for 60 seconds and binds all target/filter fields; omit it to take a new snapshot. Reports incomplete with unknown gaps: rotated logs, subprocesses, crashed/exited processes and other buffers are not covered. Shared-UID packages are refused. No global logs, arbitrary filters, clearing or live stream.", "inputSchema": { "$defs": { "AndroidLogPriority": { "enum": [ "V", "D", "I", "W", "E", "F" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "limit": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "minPriority": { "$ref": "#/$defs/AndroidLogPriority" }, "packageName": { "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "packageName", "minPriority", "limit" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "complete": { "type": "boolean" }, "deviceId": { "type": "string" }, "gap": { "type": "string" }, "generation": { "type": "string" }, "kind": { "const": "android_logcat", "type": "string" }, "lines": { "items": { "type": "string" }, "type": "array" }, "nextCursor": { "type": [ "string", "null" ] }, "packageName": { "type": "string" }, "processId": { "format": "uint32", "minimum": 0, "type": "integer" }, "scope": { "type": "string" }, "truncated": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "packageName", "processId", "lines", "truncated", "complete", "scope", "gap" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_android_open", "description": "Create and select a retained Android panel for a device explicitly selected in Settings. Requires panel.create and android.read. Opening never starts or restarts the emulator. Uses the expected domain revision and durable retry key; poll lomi_operation_get for the panel ID.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "expectedRevision": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "deviceId", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "kind": { "const": "android_panel", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "deviceId" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_android_screenshot", "description": "Capture one PNG from this connection's exact running managed Android generation. Requires explicit android.capture permission. Returns standard MCP image content and an immutable artifact with hardware/image dimensions, rotation, scale, full-display crop and an image-to-hardware touch transform. No desktop capture or continuous MCP streaming. maxEdge is 64..1600 (default 1280), maxBytes up to 3 MiB; total pixels are bounded to 2 million. Screenshot read does not grant input. Artifacts recheck original device generation and permissions on reread.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "maxBytes": { "default": 1048576, "format": "uint32", "minimum": 0, "type": "integer" }, "maxEdge": { "default": 1280, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidArtifactSource": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "requiredScope" ], "type": "object" }, "AndroidImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "crop": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "imageToHardware": { "description": "[a,b,c,d,tx,ty]: x=a*u+c*v+tx, y=b*u+d*v+ty; floor and clamp to hardware bounds.", "items": { "format": "double", "type": "number" }, "maxItems": 6, "minItems": 6, "type": "array" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "capturedAtMillis", "hardwareDisplay", "rotation", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "imageToHardware", "coordinateSpace", "crop" ], "type": "object" }, "Artifact": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" }, "ArtifactSource": { "anyOf": [ { "$ref": "#/$defs/BrowserArtifactSource" }, { "$ref": "#/$defs/AndroidArtifactSource" }, { "$ref": "#/$defs/ProjectArtifactSource" } ] }, "BrowserArtifactSource": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "navigationId": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "origin", "requiredScope" ], "type": "object" }, "BrowserImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "crop": { "type": "string" }, "cssHeight": { "format": "double", "type": "number" }, "cssWidth": { "format": "double", "type": "number" }, "deviceScaleFactor": { "format": "double", "type": "number" }, "pageZoom": { "format": "double", "type": "number" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "scrollX": { "format": "double", "type": "number" }, "scrollY": { "format": "double", "type": "number" } }, "required": [ "capturedAtMillis", "cssWidth", "cssHeight", "deviceScaleFactor", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "pageZoom", "scrollX", "scrollY", "crop" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "kind": { "const": "artifact", "type": "string" } }, "required": [ "kind", "artifact" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "ImageGeometry": { "anyOf": [ { "$ref": "#/$defs/BrowserImageGeometry" }, { "$ref": "#/$defs/AndroidImageGeometry" } ] }, "ProjectArtifactSource": { "additionalProperties": false, "properties": { "kind": { "$ref": "#/$defs/ArtifactImportKind", "default": "android_apk" }, "relativePath": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "requiredScope" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_android_setup_apply", "description": "Request application of an exact prepared Android SDK/Java plan. Requires android.read/android.setup and durable retry identity. Returns awaiting_user: Settings displays the unchanged download plan and full provider terms; only the human can accept each license and approve. The same operation continues through the existing private installer, with a two-hour runtime bound. Poll lomi_operation_get. Cancellation/revocation cancels only this native operation; an uncertain outcome never replays installation. Existing AVD images are immutable and shared ADB is untouched.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "planId": { "type": "string" }, "planRevision": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "planId", "planRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "deviceId": { "type": [ "string", "null" ] }, "devicesRevision": { "type": [ "string", "null" ] }, "kind": { "const": "android_management", "type": "string" }, "manifestRevision": { "type": [ "string", "null" ] }, "nativeOperationId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "nativeOperationId" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_android_setup_plan", "description": "Inspect Lomi's managed Android inventory or bounded provider catalog, or prepare an exact SDK/Java download plan. Requires android.read and android.setup; inventory also accepts android.manage. Inventory reveals only explicitly shared devices. Catalog pages use offset/limit 1..32 and require the previous catalog revision after page one; refresh=true is allowed only at offset zero. Prepare selects exact package IDs/revisions from that catalog and optionally private CLI/Java. It downloads no SDK archives and accepts no licenses. A prepared plan contains versions, verified sources/checksums, sizes and license digests; apply that exact plan/revision within 30 minutes.", "inputSchema": { "$defs": { "AndroidPackageSelection": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "revision": { "type": "string" } }, "required": [ "id", "revision" ], "type": "object" }, "AndroidSetupQuery": { "oneOf": [ { "additionalProperties": false, "properties": { "type": { "const": "inventory", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "expectedCatalogRevision": { "type": [ "string", "null" ] }, "limit": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "offset": { "format": "uint32", "minimum": 0, "type": "integer" }, "refresh": { "default": false, "type": "boolean" }, "type": { "const": "catalog", "type": "string" } }, "required": [ "type", "offset", "limit" ], "type": "object" }, { "additionalProperties": false, "properties": { "catalogRevision": { "type": "string" }, "packages": { "items": { "$ref": "#/$defs/AndroidPackageSelection" }, "type": "array" }, "prepareTools": { "type": "boolean" }, "type": { "const": "prepare", "type": "string" } }, "required": [ "type", "catalogRevision", "packages", "prepareTools" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "action": { "$ref": "#/$defs/AndroidSetupQuery" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "action" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidDownload": { "additionalProperties": false, "properties": { "bytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "checksum": { "type": "string" }, "dependencies": { "items": { "$ref": "#/$defs/AndroidPackageSelection" }, "type": "array" }, "id": { "type": "string" }, "licenseId": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "revision": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "revision", "name", "url", "bytes", "checksum", "dependencies" ], "type": "object" }, "AndroidGpu": { "enum": [ "auto", "host", "software" ], "type": "string" }, "AndroidHardware": { "additionalProperties": false, "properties": { "cpuCount": { "format": "uint32", "minimum": 0, "type": "integer" }, "dataGib": { "format": "uint32", "minimum": 0, "type": "integer" }, "gpu": { "$ref": "#/$defs/AndroidGpu" }, "quickBoot": { "type": "boolean" }, "ramMib": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "ramMib", "cpuCount", "dataGib", "gpu", "quickBoot" ], "type": "object" }, "AndroidLicenseSummary": { "additionalProperties": false, "properties": { "digest": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "digest" ], "type": "object" }, "AndroidManagedDevice": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": [ "string", "null" ] }, "hardware": { "$ref": "#/$defs/AndroidHardware" }, "image": { "type": "string" }, "imageRevision": { "type": "string" }, "name": { "type": "string" }, "processAlive": { "type": "boolean" }, "profile": { "type": "string" } }, "required": [ "deviceId", "name", "image", "imageRevision", "profile", "hardware", "processAlive" ], "type": "object" }, "AndroidMetadataFile": { "enum": [ "devices", "preferences" ], "type": "string" }, "AndroidMetadataRecovery": { "additionalProperties": false, "properties": { "backupRevision": { "type": [ "string", "null" ] }, "digest": { "type": "string" }, "file": { "$ref": "#/$defs/AndroidMetadataFile" } }, "required": [ "file", "digest" ], "type": "object" }, "AndroidPackageSelection": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "revision": { "type": "string" } }, "required": [ "id", "revision" ], "type": "object" }, "AndroidProfile": { "additionalProperties": false, "properties": { "height": { "format": "uint32", "minimum": 0, "type": "integer" }, "id": { "type": "string" }, "minApi": { "format": "uint32", "minimum": 0, "type": "integer" }, "minMinorApi": { "format": "uint32", "minimum": 0, "type": "integer" }, "name": { "type": "string" }, "width": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "id", "name", "width", "height", "minApi", "minMinorApi" ], "type": "object" }, "Data": { "oneOf": [ { "oneOf": [ { "properties": { "devices": { "items": { "$ref": "#/$defs/AndroidManagedDevice" }, "type": "array" }, "devicesRevision": { "type": [ "string", "null" ] }, "hostQualified": { "type": "boolean" }, "installed": { "items": { "$ref": "#/$defs/AndroidPackageSelection" }, "type": "array" }, "manifestRevision": { "type": [ "string", "null" ] }, "profiles": { "items": { "$ref": "#/$defs/AndroidProfile" }, "type": "array" }, "recovery": { "items": { "$ref": "#/$defs/AndroidMetadataRecovery" }, "type": "array" }, "recoveryRequired": { "type": "boolean" }, "rollbacks": { "items": { "$ref": "#/$defs/AndroidPackageSelection" }, "type": "array" }, "type": { "const": "inventory", "type": "string" } }, "required": [ "type", "hostQualified", "devices", "installed", "profiles", "recoveryRequired", "recovery", "rollbacks" ], "type": "object" }, { "properties": { "catalogRevision": { "type": "string" }, "nextOffset": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "packages": { "items": { "$ref": "#/$defs/AndroidDownload" }, "type": "array" }, "type": { "const": "catalog", "type": "string" } }, "required": [ "type", "catalogRevision", "packages" ], "type": "object" }, { "properties": { "downloadBytes": { "format": "uint64", "minimum": 0, "type": "integer" }, "downloads": { "items": { "$ref": "#/$defs/AndroidDownload" }, "type": "array" }, "expiresInSeconds": { "format": "uint32", "minimum": 0, "type": "integer" }, "licenses": { "items": { "$ref": "#/$defs/AndroidLicenseSummary" }, "type": "array" }, "planId": { "type": "string" }, "revision": { "type": "string" }, "target": { "type": "string" }, "type": { "const": "prepared", "type": "string" } }, "required": [ "type", "planId", "revision", "downloads", "licenses", "downloadBytes", "target", "expiresInSeconds" ], "type": "object" } ], "properties": { "kind": { "const": "android_setup", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_android_snapshot", "description": "Read a bounded UI Automator projection of this connection's running managed phone. Requires separate android.observe permission, workspace/panel/device and exact generation. At most 500 nodes, 48 KiB output and 256 KiB XML; 12-second deadline. Password and editable text values are omitted. Coordinates are rotated_display bounds with hardware dimensions and rotation metadata; node IDs belong only to this observation, not input targets. Canvas, WebView and secure screens may be incomplete; absence is not proof an element is absent. No arbitrary ADB shell or raw XML.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "maxBytes": { "default": 32768, "format": "uint32", "minimum": 0, "type": "integer" }, "maxNodes": { "default": 250, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidNode": { "additionalProperties": false, "properties": { "bounds": { "items": { "format": "int32", "type": "integer" }, "maxItems": 4, "minItems": 4, "type": [ "array", "null" ] }, "checked": { "type": "boolean" }, "class": { "type": "string" }, "clickable": { "type": "boolean" }, "description": { "type": "string" }, "enabled": { "type": "boolean" }, "focused": { "type": "boolean" }, "id": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "package": { "type": "string" }, "parent": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] }, "resourceId": { "type": "string" }, "scrollable": { "type": "boolean" }, "text": { "type": "string" }, "valueOmitted": { "type": "boolean" } }, "required": [ "id", "class", "resourceId", "package", "description", "text", "enabled", "clickable", "focused", "scrollable", "checked", "valueOmitted" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "kind": { "const": "android_snapshot", "type": "string" }, "limitations": { "items": { "type": "string" }, "type": "array" }, "nodes": { "items": { "$ref": "#/$defs/AndroidNode" }, "type": "array" }, "panelId": { "type": "string" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "snapshotId": { "type": "string" }, "truncated": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "deviceId", "generation", "snapshotId", "capturedAtMillis", "hardwareDisplay", "rotation", "coordinateSpace", "nodes", "truncated", "limitations" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_android_start", "description": "Start the explicitly approved managed Android device referenced by panelId. Requires android.control and android.read. Starts only a stopped device or reuses this connection's generation; never takes a running human device. Returns a durable operation. Poll for ready after Android, authenticated RPC, ADB and IME readiness; boot can take up to 180 seconds. Retry does not spawn a second emulator.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "expectedRevision": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "kind": { "const": "android_runtime", "type": "string" }, "ready": { "type": "boolean" }, "stopped": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "ready", "stopped" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_android_stop", "description": "Stop this connection's exact managed Android generation without deleting its apps or data. Requires android.control and android.read, an explicit panel/device/generation and durable retry key. Poll the operation for confirmed stopped. Human takeover revokes authority; an unconfirmed stop never reports success. Force stop is available only through the native user interface.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "expectedRevision": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "kind": { "const": "android_runtime", "type": "string" }, "ready": { "type": "boolean" }, "stopped": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "ready", "stopped" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_artifact_export", "description": "Create one new project-relative file from an owned artifact (at most 4 MiB). Requires artifact.export, files.read/files.mutate/files.create and the original source permissions. Supply artifactId, expectedSha256, relativePath, expectedParentRevision from files_list, expectedRevision and durable retry fields. Uses verified immutable bytes, shared native writer and atomic no-overwrite publication. No absolute path, directory creation, execution or cross-workspace export. Poll the receipt; retry never writes twice. Closed or human-taken browser/Android sources deny export. Uncertain effects require inspection, not blind replay.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "expectedParentRevision": { "type": "string" }, "expectedRevision": { "type": "string" }, "expectedSha256": { "type": "string" }, "relativePath": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "artifactId", "expectedSha256", "relativePath", "expectedParentRevision", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidArtifactSource": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "requiredScope" ], "type": "object" }, "AndroidImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "crop": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "imageToHardware": { "description": "[a,b,c,d,tx,ty]: x=a*u+c*v+tx, y=b*u+d*v+ty; floor and clamp to hardware bounds.", "items": { "format": "double", "type": "number" }, "maxItems": 6, "minItems": 6, "type": "array" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "capturedAtMillis", "hardwareDisplay", "rotation", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "imageToHardware", "coordinateSpace", "crop" ], "type": "object" }, "Artifact": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" }, "ArtifactSource": { "anyOf": [ { "$ref": "#/$defs/BrowserArtifactSource" }, { "$ref": "#/$defs/AndroidArtifactSource" }, { "$ref": "#/$defs/ProjectArtifactSource" } ] }, "BrowserArtifactSource": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "navigationId": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "origin", "requiredScope" ], "type": "object" }, "BrowserImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "crop": { "type": "string" }, "cssHeight": { "format": "double", "type": "number" }, "cssWidth": { "format": "double", "type": "number" }, "deviceScaleFactor": { "format": "double", "type": "number" }, "pageZoom": { "format": "double", "type": "number" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "scrollX": { "format": "double", "type": "number" }, "scrollY": { "format": "double", "type": "number" } }, "required": [ "capturedAtMillis", "cssWidth", "cssHeight", "deviceScaleFactor", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "pageZoom", "scrollX", "scrollY", "crop" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "ImageGeometry": { "anyOf": [ { "$ref": "#/$defs/BrowserImageGeometry" }, { "$ref": "#/$defs/AndroidImageGeometry" } ] }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "kind": { "const": "artifact_exported", "type": "string" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "relativePath", "artifact" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] }, "ProjectArtifactSource": { "additionalProperties": false, "properties": { "kind": { "$ref": "#/$defs/ArtifactImportKind", "default": "android_apk" }, "relativePath": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "requiredScope" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_artifact_import", "description": "Import one approved project file into a private immutable copy. Requires files.read plus artifact.import for kind=android_apk (4 bytes..512 MiB), or separate artifact.import_file for kind=file (0..4 MiB). Generic files are opaque application/octet-stream and do not receive APK validation. Provide exact expectedByteLength and expectedSha256 from the source file. expectedRevision is the decimal domainRevision returned by lomi_panel_list, not a file revision or content hash. Also provide the durable retry key. No links or known secret paths. Returns an operation; poll for artifactId and the hash of copied bytes. APK structure is bounded and checked; Android verifies its installability and signature separately. No installation, execution or source mutation. Copies expire after 24 hours; shared quota is 2 GiB total, 1 GiB per connection and project, 64 files and two producers. Cancel stops copying; retry never creates a duplicate.", "inputSchema": { "$defs": { "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedByteLength": { "format": "uint64", "minimum": 0, "type": "integer" }, "expectedRevision": { "description": "Decimal domainRevision returned by lomi_panel_list. Not a file revision or content hash.", "type": "string" }, "expectedSha256": { "type": "string" }, "kind": { "$ref": "#/$defs/ArtifactImportKind" }, "relativePath": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "kind", "expectedByteLength", "expectedSha256", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "artifact_imported", "type": "string" }, "sha256": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "artifactId", "sha256", "byteLength" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_artifact_read", "description": "Read a captured PNG or imported file/APK metadata in an approved workspace. Imports return metadata only and rechecks project file permission. Rechecks its original browser profile/origin or Android device, exact generation and capture scope; closed or human-taken targets are unavailable. Returns standard MCP image content and metadata, never a local file path. Artifacts expire after 24 hours.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "artifactId" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidArtifactSource": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "requiredScope" ], "type": "object" }, "AndroidImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "crop": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "imageToHardware": { "description": "[a,b,c,d,tx,ty]: x=a*u+c*v+tx, y=b*u+d*v+ty; floor and clamp to hardware bounds.", "items": { "format": "double", "type": "number" }, "maxItems": 6, "minItems": 6, "type": "array" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "capturedAtMillis", "hardwareDisplay", "rotation", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "imageToHardware", "coordinateSpace", "crop" ], "type": "object" }, "Artifact": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" }, "ArtifactSource": { "anyOf": [ { "$ref": "#/$defs/BrowserArtifactSource" }, { "$ref": "#/$defs/AndroidArtifactSource" }, { "$ref": "#/$defs/ProjectArtifactSource" } ] }, "BrowserArtifactSource": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "navigationId": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "origin", "requiredScope" ], "type": "object" }, "BrowserImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "crop": { "type": "string" }, "cssHeight": { "format": "double", "type": "number" }, "cssWidth": { "format": "double", "type": "number" }, "deviceScaleFactor": { "format": "double", "type": "number" }, "pageZoom": { "format": "double", "type": "number" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "scrollX": { "format": "double", "type": "number" }, "scrollY": { "format": "double", "type": "number" } }, "required": [ "capturedAtMillis", "cssWidth", "cssHeight", "deviceScaleFactor", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "pageZoom", "scrollX", "scrollY", "crop" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "kind": { "const": "artifact", "type": "string" } }, "required": [ "kind", "artifact" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "ImageGeometry": { "anyOf": [ { "$ref": "#/$defs/BrowserImageGeometry" }, { "$ref": "#/$defs/AndroidImageGeometry" } ] }, "ProjectArtifactSource": { "additionalProperties": false, "properties": { "kind": { "$ref": "#/$defs/ArtifactImportKind", "default": "android_apk" }, "relativePath": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "requiredScope" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_browser_click", "description": "Click a current snapshot element in an owned native browser. Requires browser.interact and its lease. Uses synthetic DOM input, not a trusted user gesture. Rechecks identity, visibility and hit target; cannot activate file inputs or downloads. Poll the durable operation; retry does not click again.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "elementRef": { "type": "string" }, "leaseId": { "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "snapshotId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "leaseId", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "BrowserScrollPosition": { "additionalProperties": false, "properties": { "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "x", "y" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "defaultAction": { "type": [ "boolean", "null" ] }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_interaction", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "scrollPosition": { "anyOf": [ { "$ref": "#/$defs/BrowserScrollPosition" }, { "type": "null" } ] }, "snapshotId": { "type": "string" }, "valueLength": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "dispatched", "inputMode" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_browser_download", "description": "GET one explicit same-origin HTTP(S) URL from an owned browser's current main document into a private opaque artifact (maxBytes 1..4 MiB). Requires separate browser.download and browser.read, exact panel/generation/navigation, expectedRevision and durable retry fields. Uses this isolated profile's same-origin credentials; returns only artifact metadata. No redirects, userinfo, fragments, custom methods/headers/body or file picker. Five-second bounded streaming attempt; failed or cancelled GET may have affected its server and reports uncertainty. Exact retry never repeats GET. The source origin/profile/generation still restrict read and export; page and service-worker bytes remain untrusted. Use lomi_artifact_export separately to create a project file.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "expectedRevision": { "type": "string" }, "maxBytes": { "default": 4194304, "format": "uint32", "minimum": 0, "type": "integer" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "url": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "navigationId", "url", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidArtifactSource": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "requiredScope" ], "type": "object" }, "AndroidImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "crop": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "imageToHardware": { "description": "[a,b,c,d,tx,ty]: x=a*u+c*v+tx, y=b*u+d*v+ty; floor and clamp to hardware bounds.", "items": { "format": "double", "type": "number" }, "maxItems": 6, "minItems": 6, "type": "array" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "capturedAtMillis", "hardwareDisplay", "rotation", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "imageToHardware", "coordinateSpace", "crop" ], "type": "object" }, "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" }, "ArtifactSource": { "anyOf": [ { "$ref": "#/$defs/BrowserArtifactSource" }, { "$ref": "#/$defs/AndroidArtifactSource" }, { "$ref": "#/$defs/ProjectArtifactSource" } ] }, "BrowserArtifactSource": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "navigationId": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "origin", "requiredScope" ], "type": "object" }, "BrowserImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "crop": { "type": "string" }, "cssHeight": { "format": "double", "type": "number" }, "cssWidth": { "format": "double", "type": "number" }, "deviceScaleFactor": { "format": "double", "type": "number" }, "pageZoom": { "format": "double", "type": "number" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "scrollX": { "format": "double", "type": "number" }, "scrollY": { "format": "double", "type": "number" } }, "required": [ "capturedAtMillis", "cssWidth", "cssHeight", "deviceScaleFactor", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "pageZoom", "scrollX", "scrollY", "crop" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "ImageGeometry": { "anyOf": [ { "$ref": "#/$defs/BrowserImageGeometry" }, { "$ref": "#/$defs/AndroidImageGeometry" } ] }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "kind": { "const": "browser_downloaded", "type": "string" }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "kind", "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] }, "ProjectArtifactSource": { "additionalProperties": false, "properties": { "kind": { "$ref": "#/$defs/ArtifactImportKind", "default": "android_apk" }, "relativePath": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "requiredScope" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_browser_fill", "description": "Fill a current snapshot text input, textarea, select, or contenteditable in an owned native browser. Requires browser.interact and its lease. Sends synthetic input/change events, validates the retained value and returns only its length. text is limited to 16 KiB. Poll the durable operation; retry does not fill again.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "elementRef": { "type": "string" }, "leaseId": { "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "snapshotId": { "type": "string" }, "text": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "leaseId", "retryEpoch", "requestKey", "text" ], "type": "object" }, "outputSchema": { "$defs": { "BrowserScrollPosition": { "additionalProperties": false, "properties": { "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "x", "y" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "defaultAction": { "type": [ "boolean", "null" ] }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_interaction", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "scrollPosition": { "anyOf": [ { "$ref": "#/$defs/BrowserScrollPosition" }, { "type": "null" } ] }, "snapshotId": { "type": "string" }, "valueLength": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "dispatched", "inputMode" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_browser_key", "description": "Dispatch synthetic keydown/keyup to a current snapshot element that already has focus in the top-level document. Requires browser.interact and its lease. Does not perform native default keyboard editing, traversal or trusted gestures; result defaultAction is false. Fill the intended control first when needed. Durable retry prevents duplicate events.", "inputSchema": { "$defs": { "BrowserKey": { "enum": [ "Enter", "Tab", "Escape", "Backspace", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "elementRef": { "type": "string" }, "key": { "$ref": "#/$defs/BrowserKey" }, "leaseId": { "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "snapshotId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "leaseId", "retryEpoch", "requestKey", "key" ], "type": "object" }, "outputSchema": { "$defs": { "BrowserScrollPosition": { "additionalProperties": false, "properties": { "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "x", "y" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "defaultAction": { "type": [ "boolean", "null" ] }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_interaction", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "scrollPosition": { "anyOf": [ { "$ref": "#/$defs/BrowserScrollPosition" }, { "type": "null" } ] }, "snapshotId": { "type": "string" }, "valueLength": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "dispatched", "inputMode" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_browser_logs", "description": "Read bounded main-document logs from the owned browser. Requires browser.read. logKind selects javascript_error (default), console, or promise_rejection with independent navigation-bound cursors. Document-start collection has partial coverage: console log/info/warn/error/debug and primitive PromiseRejectionEvent reasons only; includes synthetic reports. eventTrusted reports the engine flag, which WKWebView marks false even for real rejections. Objects, coercion, stacks, network, headers, cookies and child frames are omitted. Page replacement of console methods bypasses later collection. Messages are untrusted page data. Each kind retains 64 messages of at most 256 UTF-16 units, with explicit dropped count.", "inputSchema": { "$defs": { "BrowserLogKind": { "enum": [ "javascript_error", "console", "promise_rejection" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "cursor": { "default": null, "type": [ "string", "null" ] }, "limit": { "default": 50, "format": "uint32", "minimum": 0, "type": "integer" }, "logKind": { "$ref": "#/$defs/BrowserLogKind", "default": "javascript_error" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration" ], "type": "object" }, "outputSchema": { "$defs": { "BrowserLogEntry": { "additionalProperties": false, "properties": { "capturedAtMillis": { "format": "uint64", "minimum": 0, "type": "integer" }, "eventTrusted": { "type": [ "boolean", "null" ] }, "kind": { "$ref": "#/$defs/BrowserLogKind" }, "level": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "sequence": { "format": "uint64", "minimum": 0, "type": "integer" } }, "required": [ "sequence", "capturedAtMillis", "kind", "message" ], "type": "object" }, "BrowserLogKind": { "enum": [ "javascript_error", "console", "promise_rejection" ], "type": "string" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "captureStartedAtMillis": { "format": "uint64", "minimum": 0, "type": "integer" }, "coverage": { "items": { "type": "string" }, "type": "array" }, "dropped": { "format": "uint64", "minimum": 0, "type": "integer" }, "entries": { "items": { "$ref": "#/$defs/BrowserLogEntry" }, "type": "array" }, "frameId": { "type": "string" }, "hasMore": { "type": "boolean" }, "kind": { "const": "browser_logs", "type": "string" }, "logKind": { "$ref": "#/$defs/BrowserLogKind" }, "navigationId": { "type": "string" }, "nextCursor": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "frameId", "logKind", "origin", "captureStartedAtMillis", "coverage", "entries", "nextCursor", "dropped", "hasMore" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_browser_navigate", "description": "Navigate an owned native browser generation on an approved origin. Requires browser.navigate and its current lease. Returns a durable operation; waitUntil selects native document commit or completed page load (default), not network idle. Retry never repeats navigation.", "inputSchema": { "$defs": { "BrowserWaitUntil": { "enum": [ "commit", "load" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "leaseId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "url": { "type": "string" }, "waitUntil": { "$ref": "#/$defs/BrowserWaitUntil", "default": "load" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "leaseId", "url", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "committed": { "type": "boolean" }, "kind": { "const": "browser_navigation", "type": "string" }, "loaded": { "type": "boolean" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "url": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "url", "committed", "loaded" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_browser_open", "description": "Create an isolated native browser panel on an explicitly approved origin. Requires panel.create and browser.navigate, expectedRevision and a durable retry key. Poll the operation for the browser generation and session-only lease. Native navigation is origin-restricted; networkIsolation is none. Set visible=false to prepare a hidden page without changing selection. Hidden pages allow DOM observations; focus the exact generation before input or screenshots.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "url": { "type": "string" }, "visible": { "default": true, "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "url", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "engine": { "type": "string" }, "kind": { "const": "browser", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "navigationId": { "type": "string" }, "networkIsolation": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "ready": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "ready", "engine", "networkIsolation" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_browser_screenshot", "description": "Capture the viewport of an owned native child browser with explicit browser.capture_composite permission for its isolated profile, including any embedded frames. Requires the current navigationId. Returns a standard PNG image, bounded artifact ID and CSS/pixel/zoom metadata. Hidden or obscured panels are not renderable. No desktop or main-window capture.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "maxBytes": { "default": 1048576, "format": "uint32", "minimum": 0, "type": "integer" }, "maxWidth": { "default": 1280, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "navigationId" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidArtifactSource": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "requiredScope" ], "type": "object" }, "AndroidImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "crop": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "imageToHardware": { "description": "[a,b,c,d,tx,ty]: x=a*u+c*v+tx, y=b*u+d*v+ty; floor and clamp to hardware bounds.", "items": { "format": "double", "type": "number" }, "maxItems": 6, "minItems": 6, "type": "array" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "capturedAtMillis", "hardwareDisplay", "rotation", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "imageToHardware", "coordinateSpace", "crop" ], "type": "object" }, "Artifact": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" }, "ArtifactSource": { "anyOf": [ { "$ref": "#/$defs/BrowserArtifactSource" }, { "$ref": "#/$defs/AndroidArtifactSource" }, { "$ref": "#/$defs/ProjectArtifactSource" } ] }, "BrowserArtifactSource": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "navigationId": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "origin", "requiredScope" ], "type": "object" }, "BrowserImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "crop": { "type": "string" }, "cssHeight": { "format": "double", "type": "number" }, "cssWidth": { "format": "double", "type": "number" }, "deviceScaleFactor": { "format": "double", "type": "number" }, "pageZoom": { "format": "double", "type": "number" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "scrollX": { "format": "double", "type": "number" }, "scrollY": { "format": "double", "type": "number" } }, "required": [ "capturedAtMillis", "cssWidth", "cssHeight", "deviceScaleFactor", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "pageZoom", "scrollX", "scrollY", "crop" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "kind": { "const": "artifact", "type": "string" } }, "required": [ "kind", "artifact" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "ImageGeometry": { "anyOf": [ { "$ref": "#/$defs/BrowserImageGeometry" }, { "$ref": "#/$defs/AndroidImageGeometry" } ] }, "ProjectArtifactSource": { "additionalProperties": false, "properties": { "kind": { "$ref": "#/$defs/ArtifactImportKind", "default": "android_apk" }, "relativePath": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "requiredScope" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_browser_scroll", "description": "Scroll an owned browser snapshot frame viewportRef by bounded CSS pixel deltas, using a current snapshot and lease. Requires browser.interact. Rejects focus inside a further child frame. Returns observed viewport scroll position; hidden panels are not renderable. Durable retry prevents repeated scrolling.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "deltaX": { "format": "double", "type": "number" }, "deltaY": { "format": "double", "type": "number" }, "leaseId": { "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "snapshotId": { "type": "string" }, "viewportRef": { "default": "viewport", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "leaseId", "retryEpoch", "requestKey", "deltaX", "deltaY" ], "type": "object" }, "outputSchema": { "$defs": { "BrowserScrollPosition": { "additionalProperties": false, "properties": { "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "x", "y" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "defaultAction": { "type": [ "boolean", "null" ] }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_interaction", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "scrollPosition": { "anyOf": [ { "$ref": "#/$defs/BrowserScrollPosition" }, { "type": "null" } ] }, "snapshotId": { "type": "string" }, "valueLength": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "dispatched", "inputMode" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_browser_snapshot", "description": "Read a bounded semantic DOM projection of the owned native browser main document and same-origin HTTP(S) frames. Requires browser.read. Returns snapshot-scoped elements with frameId and frames with origin, URL and viewportRef. At most 16 frames and depth 4; cross-origin, opaque, hidden and over-budget frames and all form values are omitted. Frame navigation or replacement expires its references. References expire on document replacement, navigation, a new snapshot, or human takeover. This is not a complete accessibility tree.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "maxBytes": { "default": 16384, "format": "uint32", "minimum": 0, "type": "integer" }, "maxNodes": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration" ], "type": "object" }, "outputSchema": { "$defs": { "BrowserElement": { "additionalProperties": false, "properties": { "checked": { "type": [ "boolean", "null" ] }, "editable": { "type": "boolean" }, "elementRef": { "type": "string" }, "enabled": { "type": "boolean" }, "frameId": { "type": "string" }, "name": { "type": "string" }, "role": { "type": "string" }, "valueLength": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "frameId", "elementRef", "role", "name", "enabled", "editable" ], "type": "object" }, "BrowserFrame": { "additionalProperties": false, "properties": { "frameId": { "type": "string" }, "origin": { "type": "string" }, "parentFrameId": { "type": [ "string", "null" ] }, "url": { "type": "string" }, "viewport": { "$ref": "#/$defs/BrowserViewport" }, "viewportRef": { "type": "string" } }, "required": [ "frameId", "origin", "url", "viewportRef", "viewport" ], "type": "object" }, "BrowserViewport": { "additionalProperties": false, "properties": { "deviceScaleFactor": { "format": "double", "type": "number" }, "height": { "format": "double", "type": "number" }, "width": { "format": "double", "type": "number" } }, "required": [ "width", "height", "deviceScaleFactor" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "capturedAt": { "type": "string" }, "elements": { "items": { "$ref": "#/$defs/BrowserElement" }, "type": "array" }, "frameId": { "type": "string" }, "frames": { "items": { "$ref": "#/$defs/BrowserFrame" }, "type": "array" }, "kind": { "const": "browser_snapshot", "type": "string" }, "limitations": { "items": { "type": "string" }, "type": "array" }, "navigationId": { "type": "string" }, "omittedFrames": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "snapshotId": { "type": "string" }, "snapshotKind": { "type": "string" }, "truncated": { "type": "boolean" }, "url": { "type": "string" }, "viewport": { "$ref": "#/$defs/BrowserViewport" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "snapshotKind", "frameId", "origin", "url", "capturedAt", "viewport", "frames", "elements", "truncated", "omittedFrames", "limitations" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_browser_upload", "description": "Attach one immutable private artifact (at most 4 MiB) to an exact visible file_input reference from lomi_browser_snapshot, including its frameId. Requires browser.upload/read/interact, the current lease, generation/navigation/snapshot, artifact ID/hash, basename, revision and durable retry fields. Native Settings must approve the exact destination/filename/size/hash for every request; granting the scope alone never transfers bytes. Same-origin frames only. No host paths, file picker, caller bytes or arbitrary script. Native source access/hash/ref/visibility are rechecked after approval. Emits synthetic input/change; the page can immediately transmit the file, and success confirms attachment/event dispatch, not server acceptance. Exact retry never attaches again; uncertain outcomes require inspection.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "browserGeneration": { "type": "string" }, "elementRef": { "type": "string" }, "expectedRevision": { "type": "string" }, "expectedSha256": { "type": "string" }, "fileName": { "type": "string" }, "frameId": { "type": "string" }, "leaseId": { "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "snapshotId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "leaseId", "navigationId", "snapshotId", "elementRef", "frameId", "artifactId", "expectedSha256", "fileName", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidArtifactSource": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "requiredScope" ], "type": "object" }, "AndroidImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "crop": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "imageToHardware": { "description": "[a,b,c,d,tx,ty]: x=a*u+c*v+tx, y=b*u+d*v+ty; floor and clamp to hardware bounds.", "items": { "format": "double", "type": "number" }, "maxItems": 6, "minItems": 6, "type": "array" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "capturedAtMillis", "hardwareDisplay", "rotation", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "imageToHardware", "coordinateSpace", "crop" ], "type": "object" }, "Artifact": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" }, "ArtifactSource": { "anyOf": [ { "$ref": "#/$defs/BrowserArtifactSource" }, { "$ref": "#/$defs/AndroidArtifactSource" }, { "$ref": "#/$defs/ProjectArtifactSource" } ] }, "BrowserArtifactSource": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "navigationId": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "origin", "requiredScope" ], "type": "object" }, "BrowserImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "crop": { "type": "string" }, "cssHeight": { "format": "double", "type": "number" }, "cssWidth": { "format": "double", "type": "number" }, "deviceScaleFactor": { "format": "double", "type": "number" }, "pageZoom": { "format": "double", "type": "number" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "scrollX": { "format": "double", "type": "number" }, "scrollY": { "format": "double", "type": "number" } }, "required": [ "capturedAtMillis", "cssWidth", "cssHeight", "deviceScaleFactor", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "pageZoom", "scrollX", "scrollY", "crop" ], "type": "object" }, "BrowserUploadTarget": { "additionalProperties": false, "properties": { "documentUrl": { "type": "string" }, "frameId": { "type": "string" }, "label": { "type": "string" }, "origin": { "type": "string" } }, "required": [ "frameId", "origin", "documentUrl", "label" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "ImageGeometry": { "anyOf": [ { "$ref": "#/$defs/BrowserImageGeometry" }, { "$ref": "#/$defs/AndroidImageGeometry" } ] }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "browserGeneration": { "type": "string" }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "fileName": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_uploaded", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "snapshotId": { "type": "string" }, "target": { "$ref": "#/$defs/BrowserUploadTarget" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "target", "fileName", "artifact", "inputMode", "dispatched" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] }, "ProjectArtifactSource": { "additionalProperties": false, "properties": { "kind": { "$ref": "#/$defs/ArtifactImportKind", "default": "android_apk" }, "relativePath": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "requiredScope" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_browser_wait", "description": "Wait up to 10 seconds for top-level DOM text, an exact semantic role/name, an exact URL, or page load in an owned browser. Requires browser.read. Returns matched and the last bounded snapshot; creates new references and expires previous ones. A truncated snapshot may omit the target. No network-idle or private-field-value inference.", "inputSchema": { "$defs": { "BrowserWaitCondition": { "oneOf": [ { "additionalProperties": false, "properties": { "text": { "type": "string" }, "type": { "const": "text", "type": "string" } }, "required": [ "type", "text" ], "type": "object" }, { "additionalProperties": false, "properties": { "name": { "type": "string" }, "role": { "type": "string" }, "type": { "const": "element", "type": "string" } }, "required": [ "type", "role", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "url", "type": "string" }, "url": { "type": "string" } }, "required": [ "type", "url" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "load", "type": "string" } }, "required": [ "type" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "condition": { "$ref": "#/$defs/BrowserWaitCondition" }, "panelId": { "type": "string" }, "timeoutMs": { "default": 5000, "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "condition" ], "type": "object" }, "outputSchema": { "$defs": { "BrowserElement": { "additionalProperties": false, "properties": { "checked": { "type": [ "boolean", "null" ] }, "editable": { "type": "boolean" }, "elementRef": { "type": "string" }, "enabled": { "type": "boolean" }, "frameId": { "type": "string" }, "name": { "type": "string" }, "role": { "type": "string" }, "valueLength": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "frameId", "elementRef", "role", "name", "enabled", "editable" ], "type": "object" }, "BrowserFrame": { "additionalProperties": false, "properties": { "frameId": { "type": "string" }, "origin": { "type": "string" }, "parentFrameId": { "type": [ "string", "null" ] }, "url": { "type": "string" }, "viewport": { "$ref": "#/$defs/BrowserViewport" }, "viewportRef": { "type": "string" } }, "required": [ "frameId", "origin", "url", "viewportRef", "viewport" ], "type": "object" }, "BrowserSnapshot": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "capturedAt": { "type": "string" }, "elements": { "items": { "$ref": "#/$defs/BrowserElement" }, "type": "array" }, "frameId": { "type": "string" }, "frames": { "items": { "$ref": "#/$defs/BrowserFrame" }, "type": "array" }, "limitations": { "items": { "type": "string" }, "type": "array" }, "navigationId": { "type": "string" }, "omittedFrames": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "snapshotId": { "type": "string" }, "snapshotKind": { "type": "string" }, "truncated": { "type": "boolean" }, "url": { "type": "string" }, "viewport": { "$ref": "#/$defs/BrowserViewport" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "snapshotKind", "frameId", "origin", "url", "capturedAt", "viewport", "frames", "elements", "truncated", "omittedFrames", "limitations" ], "type": "object" }, "BrowserViewport": { "additionalProperties": false, "properties": { "deviceScaleFactor": { "format": "double", "type": "number" }, "height": { "format": "double", "type": "number" }, "width": { "format": "double", "type": "number" } }, "required": [ "width", "height", "deviceScaleFactor" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "elapsedMs": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "browser_wait", "type": "string" }, "matched": { "type": "boolean" }, "snapshot": { "$ref": "#/$defs/BrowserSnapshot" } }, "required": [ "kind", "matched", "elapsedMs", "snapshot" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_chat_draft", "description": "Replace the text of an explicitly shared, already open Chat AI draft, up to 32 KiB UTF-8. Requires chat.read and chat.draft, exact workspace/panel/conversation IDs, current domain, conversation and draft revisions, and durable retry identity. Reuses the retained runtime and native draft CAS, preserving attachments and concurrent human typing; refuses unsaved or recovery text. Saves only locally and never sends. The result describes the persisted write; subsequent human editing can advance the draft. Poll lomi_operation_get; reuse the same retry key after an uncertain response.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "expectedConversationRevision": { "type": "string" }, "expectedDraftRevision": { "type": "string" }, "expectedRevision": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "text": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "conversationId", "text", "expectedDraftRevision", "expectedConversationRevision", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "conversationRevision": { "type": "string" }, "draftRevision": { "type": "string" }, "kind": { "const": "chat_draft_updated", "type": "string" }, "panelId": { "type": "string" }, "textSha256": { "type": "string" }, "totalUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "draftRevision", "conversationRevision", "textSha256", "totalUtf16" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_chat_export", "description": "Export the saved text of every message variant and persisted draft in an explicitly shared conversation as a Markdown or JSON document. Requires chat.read/chat.export and the approved project. System instructions, provider metadata, reasoning/non-text parts and attachments are omitted. Limits: 512 messages and 4 MiB source/document; refuses oversized exports rather than truncating them. Read 2..8192 UTF-16 units per page, pass revision as expectedRevision for all later pages, and concatenate content in order. Revision is SHA-256 of the complete UTF-8 document. Changed history or a split surrogate returns an error. No files are written and no provider is called; choose any output file through the client separately.", "inputSchema": { "$defs": { "ChatExportFormat": { "enum": [ "markdown", "json" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "expectedRevision": { "type": [ "string", "null" ] }, "format": { "$ref": "#/$defs/ChatExportFormat" }, "maxChars": { "default": 8192, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "startUtf16": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "conversationId", "format" ], "type": "object" }, "outputSchema": { "$defs": { "ChatExportFormat": { "enum": [ "markdown", "json" ], "type": "string" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "attachmentsOmitted": { "type": "boolean" }, "content": { "type": "string" }, "conversationId": { "type": "string" }, "format": { "$ref": "#/$defs/ChatExportFormat" }, "kind": { "const": "chat_export", "type": "string" }, "messageCount": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "nextUtf16": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "nonTextPartsOmitted": { "type": "boolean" }, "revision": { "type": "string" }, "startUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "totalBytes": { "format": "uint32", "minimum": 0, "type": "integer" }, "totalUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "conversationId", "format", "revision", "totalBytes", "messageCount", "content", "startUtf16", "totalUtf16", "attachmentsOmitted", "nonTextPartsOmitted" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_chat_list", "description": "List only the exact Chat AI conversations explicitly shared with this connection in Settings and belonging to the approved workspace project. Requires chat.read. Project access alone never grants history access. Metadata only; at most 64 shared conversations, stable ID order, limit 1..64. Pass the returned revision at nonzero offsets. Does not start an AI model, initialize history, read credentials or expose system prompts.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": [ "string", "null" ] }, "limit": { "default": 20, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "offset": { "default": 0, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "ChatSummary": { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "conversationRevision": { "type": "string" }, "latestMessageId": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "updatedAtMillis": { "type": "string" } }, "required": [ "conversationId", "title", "conversationRevision", "updatedAtMillis" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/$defs/ChatSummary" }, "type": "array" }, "kind": { "const": "chat_list", "type": "string" }, "nextOffset": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] }, "offset": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "revision": { "type": "string" }, "total": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "revision", "items", "total", "offset" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_chat_open", "description": "Open an explicitly shared Chat AI conversation, or create a new standalone conversation with target.type=new. Requires chat.read, chat.open, panel.create and panel.focus; new additionally requires chat.create and grants the creator read access within the 64-conversation budget. Existing standalone or mixed-layout views and their draft/stream runtimes are reused. Revealing a mixed layout requires permission for every visible sibling and cannot start lazy terminal/browser/device runtimes. Uses the existing native SQLite store, configured defaults and retained Chat runtime; never sends a provider request. Requires expectedRevision and durable retry identity. Poll lomi_operation_get for the exact conversation/panel IDs. Uncertain completion never creates another conversation on retry.", "inputSchema": { "$defs": { "ChatOpenTarget": { "oneOf": [ { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "type": { "const": "existing", "type": "string" } }, "required": [ "type", "conversationId" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "new", "type": "string" } }, "required": [ "type" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "target": { "$ref": "#/$defs/ChatOpenTarget" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "target", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "created": { "type": "boolean" }, "kind": { "const": "chat_opened", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "created" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_chat_read", "description": "Read a bounded persisted checkpoint from one explicitly shared Chat AI conversation in the approved workspace project. Requires chat.read. Select draft or message; a null messageId selects the active leaf, and parentMessageId allows walking the current branch. Only text is returned, never credentials, system prompts, provider metadata, reasoning or attachment bytes. Reports omitted parts. This is saved history, not unsaved editor text or uncheckpointed streaming output. maxChars is 2..8192 UTF-16 units within 48 KiB; offsets must be scalar boundaries and subsequent pages require the returned revision. Concurrent changes return REVISION_CONFLICT. Does not initialize, alter, send or stop a conversation.", "inputSchema": { "$defs": { "ChatReadPart": { "oneOf": [ { "additionalProperties": false, "properties": { "type": { "const": "draft", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "messageId": { "type": [ "string", "null" ] }, "type": { "const": "message", "type": "string" } }, "required": [ "type" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "expectedRevision": { "type": [ "string", "null" ] }, "includeSendTarget": { "default": false, "type": "boolean" }, "maxChars": { "default": 8192, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "part": { "$ref": "#/$defs/ChatReadPart" }, "startUtf16": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "conversationId", "part" ], "type": "object" }, "outputSchema": { "$defs": { "ChatReadPart": { "oneOf": [ { "additionalProperties": false, "properties": { "type": { "const": "draft", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "messageId": { "type": [ "string", "null" ] }, "type": { "const": "message", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ChatReadSource": { "enum": [ "persisted_checkpoint" ], "type": "string" }, "ChatRequest": { "additionalProperties": false, "properties": { "assistantId": { "type": "string" }, "requestId": { "type": "string" }, "status": { "type": "string" } }, "required": [ "requestId", "assistantId", "status" ], "type": "object" }, "ChatSendTarget": { "additionalProperties": false, "properties": { "connectionId": { "type": "string" }, "maxOutputTokens": { "format": "uint32", "minimum": 0, "type": "integer" }, "model": { "type": "string" } }, "required": [ "connectionId", "model", "maxOutputTokens" ], "type": "object" }, "ChatSummary": { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "conversationRevision": { "type": "string" }, "latestMessageId": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "updatedAtMillis": { "type": "string" } }, "required": [ "conversationId", "title", "conversationRevision", "updatedAtMillis" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "attachmentsOmitted": { "type": "boolean" }, "content": { "type": "string" }, "conversation": { "$ref": "#/$defs/ChatSummary" }, "draftRevision": { "type": [ "string", "null" ] }, "kind": { "const": "chat_read", "type": "string" }, "nextUtf16": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "nonTextPartsOmitted": { "type": "boolean" }, "parentMessageId": { "type": [ "string", "null" ] }, "part": { "$ref": "#/$defs/ChatReadPart" }, "request": { "anyOf": [ { "$ref": "#/$defs/ChatRequest" }, { "type": "null" } ] }, "revision": { "type": "string" }, "role": { "type": "string" }, "sendTarget": { "anyOf": [ { "$ref": "#/$defs/ChatSendTarget" }, { "type": "null" } ] }, "source": { "$ref": "#/$defs/ChatReadSource" }, "startUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "status": { "type": "string" }, "totalUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "conversation", "source", "part", "revision", "role", "status", "content", "startUtf16", "totalUtf16", "attachmentsOmitted", "nonTextPartsOmitted" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_chat_send", "description": "Send the exact persisted draft in an already open, explicitly shared Chat AI conversation. Requires chat.read/chat.send and exact workspace/panel/conversation, connectionId/model, domain/conversation/draft revisions and durable retry identity. Use lomi_chat_read with includeSendTarget=true to inspect the configured target with chat.send permission. Each send requires explicit approval in Lomi of the actual context, attachments, system instructions, connection/model, response limit and possible provider charges. The current configured target is used; this tool cannot change it. Reuses the retained SDK/runtime. Reserved request/user/assistant IDs are durable before dispatch. Poll lomi_operation_get: draftRevision=null means only reserved, not accepted. Never retry with a new key after an uncertain response; resubscription never sends again.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "connectionId": { "type": "string" }, "conversationId": { "type": "string" }, "expectedConversationRevision": { "type": "string" }, "expectedDraftRevision": { "type": "string" }, "expectedRevision": { "type": "string" }, "model": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "conversationId", "connectionId", "model", "expectedDraftRevision", "expectedConversationRevision", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "assistantId": { "type": "string" }, "connectionId": { "type": "string" }, "conversationId": { "type": "string" }, "draftRevision": { "description": "None identifies a durable reservation, not provider acceptance.", "type": [ "string", "null" ] }, "kind": { "const": "chat_sent", "type": "string" }, "model": { "type": "string" }, "panelId": { "type": "string" }, "rejection": { "anyOf": [ { "$ref": "#/$defs/ErrorCode" }, { "type": "null" } ] }, "requestId": { "type": "string" }, "userId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "requestId", "userId", "assistantId", "connectionId", "model" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_chat_stop", "description": "Stop only the exact native request ID in an explicitly shared Chat AI conversation. Requires chat.read/chat.stop. Obtain request.requestId from lomi_chat_read or the send receipt. Uses durable retry identity; replay cannot stop a newer response. Waits up to five seconds for the native terminal checkpoint, retaining partial text and the next draft. Already finished requests return their saved terminal state; unknown or foreign IDs cannot register cancellation. Does not require a visible panel or renderer response.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "requestId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "conversationId", "requestId", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "ChatRequest": { "additionalProperties": false, "properties": { "assistantId": { "type": "string" }, "requestId": { "type": "string" }, "status": { "type": "string" } }, "required": [ "requestId", "assistantId", "status" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "alreadyFinished": { "type": "boolean" }, "conversationId": { "type": "string" }, "kind": { "const": "chat_stopped", "type": "string" }, "request": { "$ref": "#/$defs/ChatRequest" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "conversationId", "request", "alreadyFinished" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_connect", "description": "Select an explicitly approved workspace and obtain its session retry epoch.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "instanceId": { "type": "string" }, "kind": { "const": "connected", "type": "string" }, "projectId": { "type": "string" }, "retryEpoch": { "type": "string" }, "scopes": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "instanceId", "workspaceId", "projectId", "retryEpoch", "scopes" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_diagnostics", "description": "Connection diagnosis and next step. Does not disclose workspace data before approval.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "connection": { "type": "string" }, "kind": { "const": "diagnostics", "type": "string" }, "nextStep": { "type": "string" }, "uiReady": { "type": "boolean" } }, "required": [ "kind", "connection", "uiReady", "nextStep" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_editor_apply_edits", "description": "Apply 1-64 ordered, nonoverlapping edits to one loaded shared editor buffer in a single undo transaction. Requires editor.write, editor.read and files.read; does not save disk. Offsets are zero-based UTF-16 against the same expectedBufferRevision; include documentId, expectedDiskRevision, current domain expectedRevision and retryEpoch/requestKey. Insert valid LF-normalized Unicode, at most 64 KiB UTF-8 total. Surrogate splits, overlaps, ambiguous coincident edits, read-only/busy/conflicted documents or stale revisions fail before any change. Durable operation receipt prevents duplicate application; uncertain outcomes are never replayed. Reads of disk and unsaved buffer remain separate.", "inputSchema": { "$defs": { "EditorEdit": { "additionalProperties": false, "properties": { "fromUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "insert": { "type": "string" }, "toUtf16": { "format": "uint32", "minimum": 0, "type": "integer" } }, "required": [ "fromUtf16", "toUtf16", "insert" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "documentId": { "type": "string" }, "edits": { "items": { "$ref": "#/$defs/EditorEdit" }, "type": "array" }, "expectedBufferRevision": { "type": "string" }, "expectedDiskRevision": { "type": "string" }, "expectedRevision": { "type": "string" }, "panelId": { "type": "string" }, "relativePath": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "relativePath", "documentId", "expectedBufferRevision", "expectedDiskRevision", "edits", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "bufferRevision": { "type": "string" }, "dirty": { "type": "boolean" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "editCount": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "kind": { "const": "editor_edited", "type": "string" }, "panelId": { "type": "string" }, "previousBufferRevision": { "type": "string" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "previousBufferRevision", "bufferRevision", "diskRevision", "dirty", "editCount" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_editor_open", "description": "Open and reveal an approved file through the existing shared editor and workspace layout. Requires files.read, editor.read, panel.create and panel.focus. relativePath is project-relative; expectedRevision is the current domain revision, with retryEpoch/requestKey for a durable operation receipt. Reuses an existing matching panel and preserves dirty buffer/undo. New text is prepared from a pinned NOFOLLOW file and staged before UI creation; disk limit 4 MiB, editor UTF-8/BOM/UTF-16 encodings, internal transfer at most 8 MiB. Returns panel/document/revision/dirty metadata, not file content. Does not save or execute code. presentation defaults to editor; Markdown/SVG also accept preview or split with the same buffer/undo. Raster images require preview and return editor_previewed metadata with source/preview dimensions, no editable document. Raster derivatives use the first frame, preserve orientation/alpha and are bounded to 1280 pixels per edge / 3 MiB PNG from a 16 Mi pixel / 64 MiB decoded input. AVIF is unsupported. Embedded Markdown images use expiring, scoped pinned reads; external images remain links.", "inputSchema": { "$defs": { "EditorPresentation": { "enum": [ "editor", "preview", "split" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "presentation": { "$ref": "#/$defs/EditorPresentation", "default": "editor" }, "relativePath": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "EditorPresentation": { "enum": [ "editor", "preview", "split" ], "type": "string" }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "bufferRevision": { "type": "string" }, "dirty": { "type": "boolean" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "kind": { "const": "editor_opened", "type": "string" }, "panelId": { "type": "string" }, "presentation": { "$ref": "#/$defs/EditorPresentation" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "bufferRevision", "diskRevision", "dirty", "presentation" ], "type": "object" }, { "additionalProperties": false, "properties": { "diskRevision": { "type": "string" }, "height": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "editor_previewed", "type": "string" }, "originalHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "originalWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "panelId": { "type": "string" }, "relativePath": { "type": "string" }, "width": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "diskRevision", "width", "height", "originalWidth", "originalHeight" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_editor_read", "description": "Read an already loaded shared editor buffer in an approved file panel. Requires editor.read and files.read. Identify workspaceId, panelId and project-relative path explicitly; never defaults to focus or disk. Returns source=buffer, documentId, bufferRevision, diskRevision, dirty/conflict, encoding and disk line-ending policy. Text uses the editor normalized LF representation and UTF-16 offsets. maxChars 2-8192; subsequent pages require documentId and expectedBufferRevision to reject concurrent edits. Rejects secret/link paths, a different source alias, disposed/replaced documents and stale revisions. Does not open a panel, load a file, save or change the buffer.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "documentId": { "type": [ "string", "null" ] }, "expectedBufferRevision": { "type": [ "string", "null" ] }, "maxChars": { "default": 4096, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "panelId": { "type": "string" }, "relativePath": { "type": "string" }, "startUtf16": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "relativePath" ], "type": "object" }, "outputSchema": { "$defs": { "BufferSource": { "enum": [ "buffer" ], "type": "string" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "bufferRevision": { "type": "string" }, "conflict": { "type": "boolean" }, "content": { "description": "CodeMirror's normalized LF text. Offsets count UTF-16 code units.", "type": "string" }, "dirty": { "type": "boolean" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "encoding": { "$ref": "#/$defs/TextEncoding" }, "kind": { "const": "editor_text", "type": "string" }, "lineEndings": { "$ref": "#/$defs/TextLineEndings" }, "nextUtf16": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "panelId": { "type": "string" }, "relativePath": { "type": "string" }, "source": { "$ref": "#/$defs/BufferSource" }, "startUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "totalUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "bufferRevision", "diskRevision", "source", "dirty", "conflict", "encoding", "lineEndings", "content", "startUtf16", "totalUtf16", "truncated" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "TextEncoding": { "enum": [ "utf8", "utf8-bom", "utf16-le", "utf16-be" ], "type": "string" }, "TextLineEndings": { "enum": [ "none", "lf", "cr_lf", "cr", "mixed" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_editor_save", "description": "Atomically save the exact loaded editor buffer revision to its existing approved project file. Requires files.mutate, files.read, editor.read and editor.write. Supply explicit workspace/panel/path/document identity, expectedBufferRevision, expectedDiskRevision, current expectedRevision and retryEpoch/requestKey. Does not accept caller-supplied file contents. Native one-use commit checks the disk SHA-256 again and preserves encoding, exact line endings and ordinary permissions; refuses links, special files and external changes. Limit 4 MiB encoded/UTF-8 text. Later user edits remain dirty and undo history survives. Returns a durable operation with saved revision metadata, no file body. Cancel before rename prevents writes; uncertainty after replacement is reported without automatic replay.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "documentId": { "type": "string" }, "expectedBufferRevision": { "type": "string" }, "expectedDiskRevision": { "type": "string" }, "expectedRevision": { "type": "string" }, "panelId": { "type": "string" }, "relativePath": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "relativePath", "documentId", "expectedBufferRevision", "expectedDiskRevision", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "kind": { "const": "editor_saved", "type": "string" }, "panelId": { "type": "string" }, "previousDiskRevision": { "type": "string" }, "relativePath": { "type": "string" }, "savedBufferRevision": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "savedBufferRevision", "previousDiskRevision", "diskRevision", "byteLength" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_events_read", "description": "Read bounded durable operation-state events owned by this connection in an approved workspace. Returns a cursor for subsequent reads, including when no events are ready. This feed contains operation metadata, not terminal text or general UI events.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "limit": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "ControlEvent": { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "type": "string" }, "operationId": { "type": "string" }, "sequence": { "type": "string" }, "state": { "type": "string" }, "timestampSeconds": { "type": "string" }, "tool": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "sequence", "kind", "operationId", "workspaceId", "tool", "state", "effectState", "timestampSeconds" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "gap": { "type": "boolean" }, "hasMore": { "type": "boolean" }, "items": { "items": { "$ref": "#/$defs/ControlEvent" }, "type": "array" }, "kind": { "const": "events", "type": "string" }, "nextCursor": { "type": "string" } }, "required": [ "kind", "items", "nextCursor", "hasMore", "gap" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_files_list", "description": "List one approved project directory with files.read permission. relativeDirectory defaults to the project root (empty string). Returns relative file/directory names, types and decimal byte sizes; omits known secret paths, symlinks, hard links, special files and non-UTF-8 names. limit 1-200, with a 48 KiB page budget; opaque cursors bind this connection, workspace, directory and observed directory revision. Changes expire the cursor. Enumeration is bounded to 10,000 entries and 1 MiB of metadata, with a five-second cooperative deadline and two shared file producers. Not recursive and does not read contents or execute code.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "limit": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "relativeDirectory": { "default": "", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "directoryRevision": { "type": "string" }, "entries": { "items": { "$ref": "#/$defs/FileEntry" }, "type": "array" }, "filtered": { "type": "boolean" }, "kind": { "const": "files_list", "type": "string" }, "nextCursor": { "type": [ "string", "null" ] }, "relativeDirectory": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "relativeDirectory", "directoryRevision", "entries", "filtered" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "FileEntry": { "additionalProperties": false, "properties": { "byteLength": { "description": "Decimal bytes avoid loss of precision for large host files.", "type": [ "string", "null" ] }, "kind": { "$ref": "#/$defs/FileEntryKind" }, "name": { "type": "string" }, "relativePath": { "type": "string" } }, "required": [ "name", "relativePath", "kind" ], "type": "object" }, "FileEntryKind": { "enum": [ "directory", "file" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_files_mutate", "description": "Create an empty file/directory or rename/move files and directories within an approved project. Requires files.read and files.mutate, plus files.create for create or files.rename for rename/move. Every operation includes relativePath and expectedParentRevision from lomi_files_list for the destination parent; rename adds newName and expectedDiskRevision, move adds targetRelativePath and expectedDiskRevision, create adds kind:file|directory. Supply workspaceId, expectedRevision using the decimal domainRevision from a fresh lomi_workspace_list or lomi_panel_list, and retryEpoch/requestKey. Directory/disk hashes only belong to the separate operation revision fields. Native pinned NOFOLLOW parents and exclusive syscalls never overwrite an existing destination. Rename/move checks exact disk SHA-256, allows regular single-link files up to 4 MiB, and preserves inode/permissions; cross-device moves have no copy/delete fallback. Open editors retain dirty text and undo. New entries are private 0600 files/0700 directories. Poll the durable receipt. Uncertainty never replays or rolls back published effects. For directories use type=rename_directory or move_directory and expectedDirectoryRevision from source files_list instead of expectedDiskRevision. Directory revisions describe immediate entries, not recursive content; descendants are preserved without reading or copying bytes. Source must not contain the destination. Trash uses type=trash, kind, expectedEntryRevision (file SHA-256 or source directory revision) and expectedParentRevision for the source parent, with separate files.trash scope. Dirty buffers enter awaiting_user for the existing main-window save/discard/cancel decision. Save cancels this removal so the agent must read the saved version and request again. Trash uses private durable recovery staging on the same volume; interrupted effects are never replayed. Only the qualified macOS adapter is available.", "inputSchema": { "$defs": { "FileEntryKind": { "enum": [ "directory", "file" ], "type": "string" }, "FileMutation": { "oneOf": [ { "additionalProperties": false, "properties": { "expectedEntryRevision": { "type": "string" }, "expectedParentRevision": { "type": "string" }, "kind": { "$ref": "#/$defs/FileEntryKind" }, "relativePath": { "type": "string" }, "type": { "const": "trash", "type": "string" } }, "required": [ "type", "relativePath", "kind", "expectedEntryRevision", "expectedParentRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "expectedParentRevision": { "type": "string" }, "kind": { "$ref": "#/$defs/FileEntryKind" }, "relativePath": { "type": "string" }, "type": { "const": "create", "type": "string" } }, "required": [ "type", "relativePath", "kind", "expectedParentRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "expectedDiskRevision": { "type": "string" }, "expectedParentRevision": { "type": "string" }, "newName": { "type": "string" }, "relativePath": { "type": "string" }, "type": { "const": "rename", "type": "string" } }, "required": [ "type", "relativePath", "newName", "expectedDiskRevision", "expectedParentRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "expectedDiskRevision": { "type": "string" }, "expectedParentRevision": { "type": "string" }, "relativePath": { "type": "string" }, "targetRelativePath": { "type": "string" }, "type": { "const": "move", "type": "string" } }, "required": [ "type", "relativePath", "targetRelativePath", "expectedDiskRevision", "expectedParentRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "expectedDirectoryRevision": { "type": "string" }, "expectedParentRevision": { "type": "string" }, "newName": { "type": "string" }, "relativePath": { "type": "string" }, "type": { "const": "rename_directory", "type": "string" } }, "required": [ "type", "relativePath", "newName", "expectedDirectoryRevision", "expectedParentRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "expectedDirectoryRevision": { "type": "string" }, "expectedParentRevision": { "type": "string" }, "relativePath": { "type": "string" }, "targetRelativePath": { "type": "string" }, "type": { "const": "move_directory", "type": "string" } }, "required": [ "type", "relativePath", "targetRelativePath", "expectedDirectoryRevision", "expectedParentRevision" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "description": "Decimal domainRevision from lomi_workspace_list or lomi_panel_list.\nFile and directory hashes belong to the operation's separate revision fields.", "type": "string" }, "operation": { "$ref": "#/$defs/FileMutation" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "operation", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "FileEntryKind": { "enum": [ "directory", "file" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "entryKind": { "$ref": "#/$defs/FileEntryKind" }, "kind": { "const": "files_mutated", "type": "string" }, "newPath": { "type": [ "string", "null" ] }, "oldPath": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "entryKind" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_files_read", "description": "Read a bounded text slice from disk in an explicitly approved project. Requires files.read. UTF-16 offsets preserve original line endings; supported encodings are UTF-8/BOM and UTF-16 with BOM. maxChars 2-8192 (default 4096); disk file up to 4 MiB. Beyond the first page expectedDiskRevision is mandatory and must match the exact SHA-256 revision. Does not read unsaved editor buffers. Known secret paths, symlinks, hard links and paths outside the pinned project are denied. At most two producers and a five-second cooperative deadline. No execution or mutation.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedDiskRevision": { "type": [ "string", "null" ] }, "maxChars": { "default": 4096, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "relativePath": { "type": "string" }, "startUtf16": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "content": { "type": "string" }, "diskRevision": { "type": "string" }, "encoding": { "$ref": "#/$defs/TextEncoding" }, "kind": { "const": "file_text", "type": "string" }, "lineEndings": { "$ref": "#/$defs/TextLineEndings" }, "nextUtf16": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "relativePath": { "type": "string" }, "source": { "$ref": "#/$defs/DiskSource" }, "startUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "totalUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "relativePath", "source", "diskRevision", "encoding", "lineEndings", "content", "startUtf16", "totalUtf16", "truncated" ], "type": "object" } ] }, "DiskSource": { "enum": [ "disk" ], "type": "string" }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "TextEncoding": { "enum": [ "utf8", "utf8-bom", "utf16-le", "utf16-be" ], "type": "string" }, "TextLineEndings": { "enum": [ "none", "lf", "cr_lf", "cr", "mixed" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_files_search", "description": "Search approved project disk text with files.read. Query supports literal/regex, case, whole-word and comma-separated include/exclude globs. Uses explicit patterns and secret-path exclusions, not Git/global ignore files. No symlinks, hard links or special files. Results identify each disk SHA-256 and one-based line/UTF-16 column; previews never read editor buffers. Bounded to 4 MiB/file, 32 MiB total, 10,000 entries, 256 matches/128 KiB and 15 seconds, with limited/skipped counters. Paginated immutable per-file observations are not an atomic project snapshot; cursor is bound to this session/workspace/query for 60 seconds. limit 1-200 with a 48 KiB page ceiling. Revocation cancels scans and denies cached results.", "inputSchema": { "$defs": { "FileSearchQuery": { "additionalProperties": false, "properties": { "caseSensitive": { "default": false, "type": "boolean" }, "exclude": { "default": "", "type": "string" }, "include": { "default": "", "type": "string" }, "regex": { "default": false, "type": "boolean" }, "text": { "default": "", "type": "string" }, "wholeWord": { "default": false, "type": "boolean" } }, "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "limit": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "query": { "$ref": "#/$defs/FileSearchQuery" }, "relativeDirectory": { "default": "", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "query" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "consistency": { "$ref": "#/$defs/SearchConsistency" }, "filesScanned": { "format": "uint32", "minimum": 0, "type": "integer" }, "filterPolicy": { "$ref": "#/$defs/SearchFilterPolicy" }, "filtered": { "type": "boolean" }, "kind": { "const": "files_search", "type": "string" }, "limited": { "type": "boolean" }, "matches": { "items": { "$ref": "#/$defs/FileSearchMatch" }, "type": "array" }, "nextCursor": { "type": [ "string", "null" ] }, "relativeDirectory": { "type": "string" }, "skipped": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "relativeDirectory", "matches", "limited", "skipped", "filesScanned", "filtered", "consistency", "filterPolicy" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "FileSearchMatch": { "additionalProperties": false, "properties": { "column": { "format": "uint32", "minimum": 0, "type": "integer" }, "diskRevision": { "type": "string" }, "length": { "format": "uint32", "minimum": 0, "type": "integer" }, "line": { "description": "One-based line/column; column and length count UTF-16 code units.", "format": "uint32", "minimum": 0, "type": "integer" }, "preview": { "type": "string" }, "previewStartUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "relativePath": { "type": "string" } }, "required": [ "relativePath", "diskRevision", "line", "column", "length", "preview", "previewStartUtf16" ], "type": "object" }, "SearchConsistency": { "enum": [ "per_file_snapshot" ], "type": "string" }, "SearchFilterPolicy": { "enum": [ "explicit_patterns_and_secret_paths" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_git_commit", "description": "Read exact commit metadata and message in the approved repository. Requires files.read and git.read and a full 40/64 hexadecimal commit SHA. Rejects blobs and arbitrary revision syntax. Exact message at most64KiB; complete metadata and bounded changed-file list compared with first parent (initial commit vs empty tree). filesSkip/default0 and filesLimit/default100 (1..200) page immutable commit paths; nextFilesSkip and omittedEntries are explicit. No symlink/submodule/secret entries, signatures, mailmap helpers or notes. Serialized response at most64KiB. Qualified guarded Git denies helpers, writes and network. Does not open a view.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "commit": { "type": "string" }, "filesLimit": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "filesSkip": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "repositoryRelative": { "default": "", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "commit" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "author": { "type": "string" }, "authorEmail": { "type": "string" }, "authoredAt": { "type": "string" }, "commit": { "type": "string" }, "committedAt": { "type": "string" }, "committer": { "type": "string" }, "committerEmail": { "type": "string" }, "files": { "items": { "$ref": "#/$defs/GitCommitFile" }, "type": "array" }, "filesSkip": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "git_commit", "type": "string" }, "message": { "type": "string" }, "nextFilesSkip": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "omittedEntries": { "format": "uint32", "minimum": 0, "type": "integer" }, "parents": { "items": { "type": "string" }, "type": "array" }, "repositoryRelative": { "type": "string" }, "source": { "$ref": "#/$defs/GitSource" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "committer", "committerEmail", "committedAt", "files", "filesSkip", "omittedEntries", "workspaceId", "repositoryRelative", "source", "commit", "parents", "author", "authorEmail", "authoredAt", "message" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "GitCommitFile": { "additionalProperties": false, "properties": { "newMode": { "type": "string" }, "oldMode": { "type": "string" }, "relativePath": { "type": "string" }, "status": { "type": "string" } }, "required": [ "relativePath", "status", "oldMode", "newMode" ], "type": "object" }, "GitSource": { "enum": [ "git" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_git_diff", "description": "Read a literal, bounded Git patch for one approved repository-relative path. Requires files.read and git.read. comparison=worktree, staged, or commit (requires full commit SHA in commit; absent otherwise); no external helpers, writes or network. Read-only guarded Git on qualified macOS ARM64. startUtf16/default0, maxChars/default4096 (2..8192). Continue using nextUtf16 and exact expectedObservationRevision; changed patch returns revision_conflict. Explicit binary/untracked notice, no secret/link/special/directory path reads. No arbitrary revision, executable, config or pathspec. Does not open a view.", "inputSchema": { "$defs": { "GitComparison": { "enum": [ "worktree", "staged", "commit" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "commit": { "type": [ "string", "null" ] }, "comparison": { "$ref": "#/$defs/GitComparison" }, "expectedObservationRevision": { "type": [ "string", "null" ] }, "maxChars": { "default": 4096, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "relativePath": { "type": "string" }, "repositoryRelative": { "default": "", "type": "string" }, "startUtf16": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "comparison" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "commit": { "type": [ "string", "null" ] }, "comparison": { "$ref": "#/$defs/GitComparison" }, "consistency": { "$ref": "#/$defs/GitConsistency" }, "kind": { "const": "git_diff", "type": "string" }, "nextUtf16": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "notice": { "anyOf": [ { "$ref": "#/$defs/GitDiffNotice" }, { "type": "null" } ] }, "observationRevision": { "type": "string" }, "patch": { "type": "string" }, "relativePath": { "type": "string" }, "repositoryRelative": { "type": "string" }, "source": { "$ref": "#/$defs/GitSource" }, "startUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "totalUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "repositoryRelative", "relativePath", "comparison", "source", "consistency", "observationRevision", "patch", "startUtf16", "totalUtf16" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "GitComparison": { "enum": [ "worktree", "staged", "commit" ], "type": "string" }, "GitConsistency": { "enum": [ "per_command_snapshot" ], "type": "string" }, "GitDiffNotice": { "enum": [ "binary", "untracked" ], "type": "string" }, "GitSource": { "enum": [ "git" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_git_history", "description": "Read bounded commit history in the exact approved repository. Requires files.read and git.read. Optional commit is a full SHA naming a commit. Start without commit at HEAD; continue with returned startCommit and nextSkip to avoid following a moving HEAD. limit1..100/default20, skip0..10000, 48KiB pages. Unborn HEAD and unsupported metadata fail explicitly. Qualified guarded Git denies helpers, writes and network.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "commit": { "type": [ "string", "null" ] }, "limit": { "default": 20, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "repositoryRelative": { "default": "", "type": "string" }, "skip": { "default": 0, "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "commits": { "items": { "$ref": "#/$defs/GitCommitSummary" }, "type": "array" }, "consistency": { "$ref": "#/$defs/GitConsistency" }, "kind": { "const": "git_history", "type": "string" }, "nextSkip": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "repositoryRelative": { "type": "string" }, "skip": { "format": "uint32", "minimum": 0, "type": "integer" }, "source": { "$ref": "#/$defs/GitSource" }, "startCommit": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "repositoryRelative", "source", "consistency", "startCommit", "commits", "skip" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "GitCommitSummary": { "additionalProperties": false, "properties": { "author": { "type": "string" }, "authoredAt": { "type": "string" }, "commit": { "type": "string" }, "parents": { "items": { "type": "string" }, "type": "array" }, "subject": { "type": "string" } }, "required": [ "commit", "parents", "author", "authoredAt", "subject" ], "type": "object" }, "GitConsistency": { "enum": [ "per_command_snapshot" ], "type": "string" }, "GitSource": { "enum": [ "git" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_git_mutate", "description": "Request stage, unstage, commit, fetch, push, discard or pull in an approved repository. Stage/unstage/commit require 1..64 exact relative file paths. Fetch requires git.network, remote (configured name), reference (full refs/heads branch), empty paths and no message; it updates only that remote tracking branch after native UI approval. Credentials and full remote URLs are not returned. Commit requires message (up to 16KiB) and paths naming the complete staged change set; it never stages implicitly. Omit message for stage/unstage. Requires files.read, git.read, git.write and git.execute, expectedRevision and a durable retry key. Every request requires a separate main-window decision for an immutable native plan bound to file bytes, index, HEAD, refs, configuration and environment. Does not accept approval in tool arguments. Configured Git code runs with the user account after approval; this is not a sandbox. Rechecking a changed plan fails before dispatch. Poll the operation; cancelled or uncertain execution is never replayed. At most 4MiB/file, 32MiB selected bytes, 120s overall request and 30s process budget. Commit approval shows the exact stored message, native author/committer and staged objects. Git adds a final LF if missing; the preview states this. Hooks are preserved and the resulting commit is verified; divergent or uncertain outcomes are never rolled back or replayed. Fetch does not merge, prune, fetch tags or submodules. Push requires separate git.push and git.network scopes, remote, reference (full target refs/heads branch), sourceCommit equal to current HEAD, expectedRemoteCommit (null means create only if absent), empty paths and no message. Native approval binds the push URL and exact commits. An independent fast-forward proof plus exact expected-value lease prevents history rewrite or overwriting concurrent remote work. The receipt reports server acknowledgement, not permanent remote state. Discard requires separate git.discard permission and exact tracked paths, restoring the current index versions while preserving staged changes. Its main-window approval shows current disk hashes and bounded working diffs; dirty editor buffers or stale plans block dispatch. Discarded worktree bytes are not saved in Git or Trash. For untracked files use the approved lomi_files_mutate trash operation; Git discard never removes them. Pull requires separate git.pull and git.network, remote, full refs/heads reference, sourceCommit equal to HEAD, expectedRemoteCommit already present locally (fetch first), pullMode ff_only or rebase, empty paths and no message. Native approval shows exact commits, affected file versions and commits to rebase. Requires a clean tracked worktree and no busy/dirty affected editor buffers, an attached branch and no active Git operation. A changed fetched remote returns failed/partial with pull.outcome=remote_changed, without integration. A real rebase conflict returns failed/partial with pull.outcome=conflicted and preserves the conflict; never automatically abort, reset, stash or retry. Applied results verify current ancestry and clean index/worktree. Linear rebase only, at most64 local commits/64 paths/256 inspected blob objects and32MiB total inspected bytes; merge/root/unrelated/shallow histories, secret/link/submodule/sparse paths and untracked/ignored collisions fail before approval.", "inputSchema": { "$defs": { "GitMutation": { "enum": [ "stage", "unstage", "commit", "fetch", "push", "discard", "pull" ], "type": "string" }, "GitPullMode": { "enum": [ "ff_only", "rebase" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRemoteCommit": { "type": [ "string", "null" ] }, "expectedRevision": { "type": "string" }, "message": { "type": [ "string", "null" ] }, "operation": { "$ref": "#/$defs/GitMutation" }, "paths": { "items": { "type": "string" }, "type": "array" }, "pullMode": { "anyOf": [ { "$ref": "#/$defs/GitPullMode" }, { "type": "null" } ] }, "reference": { "type": [ "string", "null" ] }, "remote": { "type": [ "string", "null" ] }, "repositoryRelative": { "default": "", "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "sourceCommit": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "operation", "paths", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "GitCommitCreated": { "additionalProperties": false, "properties": { "author": { "$ref": "#/$defs/GitCommitIdentity" }, "committer": { "$ref": "#/$defs/GitCommitIdentity" }, "messageSha256": { "type": "string" } }, "required": [ "messageSha256", "author", "committer" ], "type": "object" }, "GitCommitIdentity": { "additionalProperties": false, "properties": { "email": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "email" ], "type": "object" }, "GitFetched": { "additionalProperties": false, "properties": { "commit": { "type": "string" }, "destination": { "type": "string" }, "reference": { "type": "string" }, "remote": { "type": "string" } }, "required": [ "remote", "reference", "destination", "commit" ], "type": "object" }, "GitMutation": { "enum": [ "stage", "unstage", "commit", "fetch", "push", "discard", "pull" ], "type": "string" }, "GitMutationFile": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint64", "minimum": 0, "type": "integer" }, "relativePath": { "type": "string" }, "sha256": { "type": [ "string", "null" ] } }, "required": [ "relativePath", "byteLength" ], "type": "object" }, "GitPullMode": { "enum": [ "ff_only", "rebase" ], "type": "string" }, "GitPullOutcome": { "enum": [ "applied", "remote_changed", "conflicted" ], "type": "string" }, "GitPullTarget": { "additionalProperties": false, "properties": { "expectedRemoteCommit": { "type": "string" }, "mode": { "$ref": "#/$defs/GitPullMode" }, "reference": { "type": "string" }, "remote": { "type": "string" }, "sourceCommit": { "type": "string" } }, "required": [ "remote", "reference", "sourceCommit", "expectedRemoteCommit", "mode" ], "type": "object" }, "GitPulled": { "additionalProperties": false, "properties": { "fetchedCommit": { "type": "string" }, "outcome": { "$ref": "#/$defs/GitPullOutcome" }, "target": { "$ref": "#/$defs/GitPullTarget" } }, "required": [ "target", "fetchedCommit", "outcome" ], "type": "object" }, "GitPushTarget": { "additionalProperties": false, "properties": { "expectedRemoteCommit": { "type": [ "string", "null" ] }, "reference": { "type": "string" }, "remote": { "type": "string" }, "sourceCommit": { "type": "string" } }, "required": [ "remote", "reference", "sourceCommit" ], "type": "object" }, "GitPushVerification": { "enum": [ "server_acknowledgement" ], "type": "string" }, "GitPushed": { "additionalProperties": false, "properties": { "changed": { "type": "boolean" }, "target": { "$ref": "#/$defs/GitPushTarget" }, "verification": { "$ref": "#/$defs/GitPushVerification" } }, "required": [ "target", "changed", "verification" ], "type": "object" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "afterRevision": { "type": "string" }, "beforeRevision": { "type": "string" }, "commit": { "anyOf": [ { "$ref": "#/$defs/GitCommitCreated" }, { "type": "null" } ] }, "fetch": { "anyOf": [ { "$ref": "#/$defs/GitFetched" }, { "type": "null" } ] }, "files": { "items": { "$ref": "#/$defs/GitMutationFile" }, "type": "array" }, "head": { "type": [ "string", "null" ] }, "indexRevision": { "type": "string" }, "kind": { "const": "git_mutated", "type": "string" }, "operation": { "$ref": "#/$defs/GitMutation" }, "planHash": { "type": "string" }, "pull": { "anyOf": [ { "$ref": "#/$defs/GitPulled" }, { "type": "null" } ] }, "push": { "anyOf": [ { "$ref": "#/$defs/GitPushed" }, { "type": "null" } ] }, "repositoryRelative": { "type": "string" }, "selectedFilesChanged": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "repositoryRelative", "operation", "planHash", "beforeRevision", "afterRevision", "indexRevision", "files", "selectedFilesChanged" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_git_open", "description": "Open a read-only Git diff or commit view in the approved workspace. Requires files.read, git.read, panel.create and panel.focus; expectedRevision and durable retry key. view is diff with relativePath/staged or commit with a full commit SHA. Native guarded reads prepare bounded data before the panel is published. Poll the operation; retry never creates another panel. Restored views without live permits cannot read ordinary Git commands. Does not mutate Git.", "inputSchema": { "$defs": { "GitView": { "oneOf": [ { "additionalProperties": false, "properties": { "relativePath": { "type": "string" }, "staged": { "type": "boolean" }, "type": { "const": "diff", "type": "string" } }, "required": [ "type", "relativePath", "staged" ], "type": "object" }, { "additionalProperties": false, "properties": { "commit": { "type": "string" }, "type": { "const": "commit", "type": "string" } }, "required": [ "type", "commit" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "repositoryRelative": { "default": "", "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "view": { "$ref": "#/$defs/GitView" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "view", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "GitView": { "oneOf": [ { "additionalProperties": false, "properties": { "relativePath": { "type": "string" }, "staged": { "type": "boolean" }, "type": { "const": "diff", "type": "string" } }, "required": [ "type", "relativePath", "staged" ], "type": "object" }, { "additionalProperties": false, "properties": { "commit": { "type": "string" }, "type": { "const": "commit", "type": "string" } }, "required": [ "type", "commit" ], "type": "object" } ] }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "git_opened", "type": "string" }, "observationRevision": { "type": "string" }, "panelId": { "type": "string" }, "repositoryRelative": { "type": "string" }, "view": { "$ref": "#/$defs/GitView" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "repositoryRelative", "view", "observationRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_git_remotes", "description": "Read redacted remote metadata in the approved repository. Requires files.read and git.read. At most64 entries; name, fetch/push role, known transport, hostname and port. Userinfo, repository path, query, fragment and unknown transports are redacted. No credential helpers, network or URL rewriting. This observation cannot authorize a mutation. Qualified guarded Git only.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "repositoryRelative": { "default": "", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "git_remotes", "type": "string" }, "remotes": { "items": { "$ref": "#/$defs/GitRemote" }, "type": "array" }, "repositoryRelative": { "type": "string" }, "source": { "$ref": "#/$defs/GitSource" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "repositoryRelative", "source", "remotes" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "GitRemote": { "additionalProperties": false, "properties": { "host": { "type": [ "string", "null" ] }, "locationRedacted": { "type": "boolean" }, "name": { "type": "string" }, "port": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] }, "role": { "$ref": "#/$defs/GitRemoteRole" }, "transport": { "type": "string" } }, "required": [ "name", "role", "transport", "locationRedacted" ], "type": "object" }, "GitRemoteRole": { "enum": [ "fetch", "push" ], "type": "string" }, "GitSource": { "enum": [ "git" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_git_status", "description": "Read bounded Git status in an approved workspace/project or exact repositoryRelative subdirectory. Requires files.read and separate git.read. Qualified macOS ARM64 reader uses a fixed system Git executable, a private environment, a pinned working directory and an OS guard denying subprocess helpers, writes and network. Rejects any stderr, including an exit0 failed filter. Real .git directories only; linked worktrees/external metadata are unsupported. No ancestor discovery or arbitrary Git args. Omits secret, link and unsupported paths. Returns immutable per_command_snapshot metadata, observationRevision, Git version and explicit index/worktree states. limit 1..200, 48 KiB/page; up to4096 changes/1MiB, four caches/60s. Cursor binds session/workspace/repository/root/policy; it pages the same observation despite later working-tree edits. Does not mutate Git or open a view.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "limit": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "repositoryRelative": { "default": "", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "changes": { "items": { "$ref": "#/$defs/GitChange" }, "type": "array" }, "consistency": { "$ref": "#/$defs/GitConsistency" }, "gitVersion": { "type": "string" }, "kind": { "const": "git_status", "type": "string" }, "nextCursor": { "type": [ "string", "null" ] }, "observationRevision": { "type": "string" }, "omittedEntries": { "format": "uint32", "minimum": 0, "type": "integer" }, "repositoryRelative": { "type": "string" }, "source": { "$ref": "#/$defs/GitSource" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "repositoryRelative", "source", "consistency", "gitVersion", "observationRevision", "changes", "omittedEntries" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "GitChange": { "additionalProperties": false, "properties": { "directory": { "type": "boolean" }, "index": { "type": "string" }, "originalPath": { "type": [ "string", "null" ] }, "relativePath": { "type": "string" }, "worktree": { "type": "string" } }, "required": [ "relativePath", "index", "worktree", "directory" ], "type": "object" }, "GitConsistency": { "enum": [ "per_command_snapshot" ], "type": "string" }, "GitSource": { "enum": [ "git" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_operation_cancel", "description": "Cancel queued work or request cancellation of a running operation. Cancellation does not undo completed effects.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "operationId": { "type": "string" } }, "required": [ "operationId" ], "type": "object" }, "outputSchema": { "$defs": { "AndroidArtifactSource": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "requiredScope" ], "type": "object" }, "AndroidImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "crop": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "imageToHardware": { "description": "[a,b,c,d,tx,ty]: x=a*u+c*v+tx, y=b*u+d*v+ty; floor and clamp to hardware bounds.", "items": { "format": "double", "type": "number" }, "maxItems": 6, "minItems": 6, "type": "array" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "capturedAtMillis", "hardwareDisplay", "rotation", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "imageToHardware", "coordinateSpace", "crop" ], "type": "object" }, "Artifact": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" }, "ArtifactSource": { "anyOf": [ { "$ref": "#/$defs/BrowserArtifactSource" }, { "$ref": "#/$defs/AndroidArtifactSource" }, { "$ref": "#/$defs/ProjectArtifactSource" } ] }, "BrowserArtifactSource": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "navigationId": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "origin", "requiredScope" ], "type": "object" }, "BrowserImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "crop": { "type": "string" }, "cssHeight": { "format": "double", "type": "number" }, "cssWidth": { "format": "double", "type": "number" }, "deviceScaleFactor": { "format": "double", "type": "number" }, "pageZoom": { "format": "double", "type": "number" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "scrollX": { "format": "double", "type": "number" }, "scrollY": { "format": "double", "type": "number" } }, "required": [ "capturedAtMillis", "cssWidth", "cssHeight", "deviceScaleFactor", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "pageZoom", "scrollX", "scrollY", "crop" ], "type": "object" }, "BrowserScrollPosition": { "additionalProperties": false, "properties": { "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "x", "y" ], "type": "object" }, "BrowserUploadTarget": { "additionalProperties": false, "properties": { "documentUrl": { "type": "string" }, "frameId": { "type": "string" }, "label": { "type": "string" }, "origin": { "type": "string" } }, "required": [ "frameId", "origin", "documentUrl", "label" ], "type": "object" }, "ChatRequest": { "additionalProperties": false, "properties": { "assistantId": { "type": "string" }, "requestId": { "type": "string" }, "status": { "type": "string" } }, "required": [ "requestId", "assistantId", "status" ], "type": "object" }, "CommandObservation": { "additionalProperties": false, "properties": { "completed": { "type": "boolean" }, "endCursor": { "type": [ "string", "null" ] }, "exitCode": { "format": "int32", "type": [ "integer", "null" ] }, "operationId": { "type": "string" }, "source": { "type": "string" }, "startCursor": { "type": "string" }, "startedObserved": { "type": "boolean" } }, "required": [ "operationId", "startedObserved", "completed", "source", "startCursor" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "DockSide": { "enum": [ "left", "right", "top", "bottom" ], "type": "string" }, "EditorPresentation": { "enum": [ "editor", "preview", "split" ], "type": "string" }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "FileEntryKind": { "enum": [ "directory", "file" ], "type": "string" }, "GitCommitCreated": { "additionalProperties": false, "properties": { "author": { "$ref": "#/$defs/GitCommitIdentity" }, "committer": { "$ref": "#/$defs/GitCommitIdentity" }, "messageSha256": { "type": "string" } }, "required": [ "messageSha256", "author", "committer" ], "type": "object" }, "GitCommitIdentity": { "additionalProperties": false, "properties": { "email": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "email" ], "type": "object" }, "GitFetched": { "additionalProperties": false, "properties": { "commit": { "type": "string" }, "destination": { "type": "string" }, "reference": { "type": "string" }, "remote": { "type": "string" } }, "required": [ "remote", "reference", "destination", "commit" ], "type": "object" }, "GitMutation": { "enum": [ "stage", "unstage", "commit", "fetch", "push", "discard", "pull" ], "type": "string" }, "GitMutationFile": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint64", "minimum": 0, "type": "integer" }, "relativePath": { "type": "string" }, "sha256": { "type": [ "string", "null" ] } }, "required": [ "relativePath", "byteLength" ], "type": "object" }, "GitPullMode": { "enum": [ "ff_only", "rebase" ], "type": "string" }, "GitPullOutcome": { "enum": [ "applied", "remote_changed", "conflicted" ], "type": "string" }, "GitPullTarget": { "additionalProperties": false, "properties": { "expectedRemoteCommit": { "type": "string" }, "mode": { "$ref": "#/$defs/GitPullMode" }, "reference": { "type": "string" }, "remote": { "type": "string" }, "sourceCommit": { "type": "string" } }, "required": [ "remote", "reference", "sourceCommit", "expectedRemoteCommit", "mode" ], "type": "object" }, "GitPulled": { "additionalProperties": false, "properties": { "fetchedCommit": { "type": "string" }, "outcome": { "$ref": "#/$defs/GitPullOutcome" }, "target": { "$ref": "#/$defs/GitPullTarget" } }, "required": [ "target", "fetchedCommit", "outcome" ], "type": "object" }, "GitPushTarget": { "additionalProperties": false, "properties": { "expectedRemoteCommit": { "type": [ "string", "null" ] }, "reference": { "type": "string" }, "remote": { "type": "string" }, "sourceCommit": { "type": "string" } }, "required": [ "remote", "reference", "sourceCommit" ], "type": "object" }, "GitPushVerification": { "enum": [ "server_acknowledgement" ], "type": "string" }, "GitPushed": { "additionalProperties": false, "properties": { "changed": { "type": "boolean" }, "target": { "$ref": "#/$defs/GitPushTarget" }, "verification": { "$ref": "#/$defs/GitPushVerification" } }, "required": [ "target", "changed", "verification" ], "type": "object" }, "GitView": { "oneOf": [ { "additionalProperties": false, "properties": { "relativePath": { "type": "string" }, "staged": { "type": "boolean" }, "type": { "const": "diff", "type": "string" } }, "required": [ "type", "relativePath", "staged" ], "type": "object" }, { "additionalProperties": false, "properties": { "commit": { "type": "string" }, "type": { "const": "commit", "type": "string" } }, "required": [ "type", "commit" ], "type": "object" } ] }, "ImageGeometry": { "anyOf": [ { "$ref": "#/$defs/BrowserImageGeometry" }, { "$ref": "#/$defs/AndroidImageGeometry" } ] }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "created": { "type": "boolean" }, "kind": { "const": "chat_opened", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "created" ], "type": "object" }, { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "conversationRevision": { "type": "string" }, "draftRevision": { "type": "string" }, "kind": { "const": "chat_draft_updated", "type": "string" }, "panelId": { "type": "string" }, "textSha256": { "type": "string" }, "totalUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "draftRevision", "conversationRevision", "textSha256", "totalUtf16" ], "type": "object" }, { "additionalProperties": false, "properties": { "assistantId": { "type": "string" }, "connectionId": { "type": "string" }, "conversationId": { "type": "string" }, "draftRevision": { "description": "None identifies a durable reservation, not provider acceptance.", "type": [ "string", "null" ] }, "kind": { "const": "chat_sent", "type": "string" }, "model": { "type": "string" }, "panelId": { "type": "string" }, "rejection": { "anyOf": [ { "$ref": "#/$defs/ErrorCode" }, { "type": "null" } ] }, "requestId": { "type": "string" }, "userId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "requestId", "userId", "assistantId", "connectionId", "model" ], "type": "object" }, { "additionalProperties": false, "properties": { "alreadyFinished": { "type": "boolean" }, "conversationId": { "type": "string" }, "kind": { "const": "chat_stopped", "type": "string" }, "request": { "$ref": "#/$defs/ChatRequest" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "conversationId", "request", "alreadyFinished" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "settings_opened", "type": "string" }, "page": { "$ref": "#/$defs/SettingsPage" }, "requested": { "description": "The native window accepted this request; no preference was changed.", "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "page", "requested" ], "type": "object" }, { "additionalProperties": false, "properties": { "applied": { "type": "boolean" }, "kind": { "const": "settings_updated", "type": "string" }, "previousStoredRevision": { "type": [ "string", "null" ] }, "section": { "$ref": "#/$defs/SettingsSection" }, "storedRevision": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "section", "storedRevision", "applied" ], "type": "object" }, { "additionalProperties": false, "properties": { "closed": { "type": [ "boolean", "null" ] }, "kind": { "const": "workspace_closure", "type": "string" }, "panelIds": { "items": { "type": "string" }, "type": "array" }, "projectClosed": { "type": [ "boolean", "null" ] }, "projectId": { "type": "string" }, "terminalSessionIds": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "projectId", "panelIds", "terminalSessionIds" ], "type": "object" }, { "additionalProperties": false, "properties": { "closed": { "type": [ "boolean", "null" ] }, "kind": { "const": "project_closure", "type": "string" }, "panelIds": { "items": { "type": "string" }, "type": "array" }, "projectId": { "type": "string" }, "terminalSessionIds": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" }, "workspaceIds": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "workspaceId", "projectId", "workspaceIds", "panelIds", "terminalSessionIds" ], "type": "object" }, { "additionalProperties": false, "properties": { "anchorWorkspaceId": { "type": "string" }, "kind": { "const": "project_opened", "type": "string" }, "name": { "type": "string" }, "opened": { "type": [ "boolean", "null" ] }, "panelId": { "type": "string" }, "projectId": { "type": "string" }, "projectPath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "anchorWorkspaceId", "projectId", "projectPath", "workspaceId", "panelId", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "destination": { "anyOf": [ { "$ref": "#/$defs/PanelMoveDestination" }, { "type": "null" } ] }, "kind": { "const": "panel_moved", "type": "string" }, "movement": { "$ref": "#/$defs/PanelMove" }, "panels": { "items": { "$ref": "#/$defs/PanelMoveIdentity" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "movement", "panels" ], "type": "object" }, { "additionalProperties": false, "properties": { "afterRevision": { "type": "string" }, "beforeRevision": { "type": "string" }, "commit": { "anyOf": [ { "$ref": "#/$defs/GitCommitCreated" }, { "type": "null" } ] }, "fetch": { "anyOf": [ { "$ref": "#/$defs/GitFetched" }, { "type": "null" } ] }, "files": { "items": { "$ref": "#/$defs/GitMutationFile" }, "type": "array" }, "head": { "type": [ "string", "null" ] }, "indexRevision": { "type": "string" }, "kind": { "const": "git_mutated", "type": "string" }, "operation": { "$ref": "#/$defs/GitMutation" }, "planHash": { "type": "string" }, "pull": { "anyOf": [ { "$ref": "#/$defs/GitPulled" }, { "type": "null" } ] }, "push": { "anyOf": [ { "$ref": "#/$defs/GitPushed" }, { "type": "null" } ] }, "repositoryRelative": { "type": "string" }, "selectedFilesChanged": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "repositoryRelative", "operation", "planHash", "beforeRevision", "afterRevision", "indexRevision", "files", "selectedFilesChanged" ], "type": "object" }, { "additionalProperties": false, "properties": { "entryKind": { "$ref": "#/$defs/FileEntryKind" }, "kind": { "const": "files_mutated", "type": "string" }, "newPath": { "type": [ "string", "null" ] }, "oldPath": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "entryKind" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "kind": { "const": "artifact_exported", "type": "string" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "relativePath", "artifact" ], "type": "object" }, { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "kind": { "const": "browser_downloaded", "type": "string" }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "kind", "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "browserGeneration": { "type": "string" }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "fileName": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_uploaded", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "snapshotId": { "type": "string" }, "target": { "$ref": "#/$defs/BrowserUploadTarget" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "target", "fileName", "artifact", "inputMode", "dispatched" ], "type": "object" }, { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "kind": { "const": "editor_saved", "type": "string" }, "panelId": { "type": "string" }, "previousDiskRevision": { "type": "string" }, "relativePath": { "type": "string" }, "savedBufferRevision": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "savedBufferRevision", "previousDiskRevision", "diskRevision", "byteLength" ], "type": "object" }, { "additionalProperties": false, "properties": { "bufferRevision": { "type": "string" }, "dirty": { "type": "boolean" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "kind": { "const": "editor_opened", "type": "string" }, "panelId": { "type": "string" }, "presentation": { "$ref": "#/$defs/EditorPresentation" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "bufferRevision", "diskRevision", "dirty", "presentation" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "git_opened", "type": "string" }, "observationRevision": { "type": "string" }, "panelId": { "type": "string" }, "repositoryRelative": { "type": "string" }, "view": { "$ref": "#/$defs/GitView" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "repositoryRelative", "view", "observationRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "diskRevision": { "type": "string" }, "height": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "editor_previewed", "type": "string" }, "originalHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "originalWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "panelId": { "type": "string" }, "relativePath": { "type": "string" }, "width": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "diskRevision", "width", "height", "originalWidth", "originalHeight" ], "type": "object" }, { "additionalProperties": false, "properties": { "bufferRevision": { "type": "string" }, "dirty": { "type": "boolean" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "editCount": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "kind": { "const": "editor_edited", "type": "string" }, "panelId": { "type": "string" }, "previousBufferRevision": { "type": "string" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "previousBufferRevision", "bufferRevision", "diskRevision", "dirty", "editCount" ], "type": "object" }, { "additionalProperties": false, "properties": { "activity": { "type": "string" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "intentDelivered": { "type": "boolean" }, "kind": { "const": "android_launch", "type": "string" }, "packageName": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "packageName", "activity", "intentDelivered" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "installed": { "type": "boolean" }, "installerFailure": { "type": [ "string", "null" ] }, "kind": { "const": "android_install", "type": "string" }, "newVersion": { "type": [ "string", "null" ] }, "packageName": { "type": [ "string", "null" ] }, "previousVersion": { "type": [ "string", "null" ] }, "sha256": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "artifactId", "sha256", "installed" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": [ "string", "null" ] }, "devicesRevision": { "type": [ "string", "null" ] }, "kind": { "const": "android_management", "type": "string" }, "manifestRevision": { "type": [ "string", "null" ] }, "nativeOperationId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "nativeOperationId" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "artifact_imported", "type": "string" }, "sha256": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "artifactId", "sha256", "byteLength" ], "type": "object" }, { "additionalProperties": false, "properties": { "controlled": { "type": "boolean" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "kind": { "const": "android_control", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "controlled" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "inputSequence": { "type": "string" }, "kind": { "const": "android_input", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "inputSequence" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "kind": { "const": "android_runtime", "type": "string" }, "ready": { "type": "boolean" }, "stopped": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "ready", "stopped" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "kind": { "const": "android_panel", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "deviceId" ], "type": "object" }, { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "defaultAction": { "type": [ "boolean", "null" ] }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_interaction", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "scrollPosition": { "anyOf": [ { "$ref": "#/$defs/BrowserScrollPosition" }, { "type": "null" } ] }, "snapshotId": { "type": "string" }, "valueLength": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "dispatched", "inputMode" ], "type": "object" }, { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "engine": { "type": "string" }, "kind": { "const": "browser", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "navigationId": { "type": "string" }, "networkIsolation": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "ready": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "ready", "engine", "networkIsolation" ], "type": "object" }, { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "committed": { "type": "boolean" }, "kind": { "const": "browser_navigation", "type": "string" }, "loaded": { "type": "boolean" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "url": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "url", "committed", "loaded" ], "type": "object" }, { "additionalProperties": false, "properties": { "controlled": { "type": "boolean" }, "kind": { "const": "terminal_control", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "controlled" ], "type": "object" }, { "additionalProperties": false, "properties": { "closed": { "type": "boolean" }, "focused": { "type": "boolean" }, "kind": { "const": "panel", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "focused", "closed" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "workspace", "type": "string" }, "name": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" }, { "additionalProperties": false, "properties": { "dispatched": { "type": "boolean" }, "kind": { "const": "terminal_interrupt", "type": "string" }, "panelId": { "type": "string" }, "targetOperationId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "targetOperationId", "dispatched" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "terminal_command", "type": "string" }, "observation": { "$ref": "#/$defs/CommandObservation" }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "observation" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "terminal", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "panelId": { "type": "string" }, "ready": { "type": "boolean" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "ready" ], "type": "object" } ] }, "PanelMove": { "oneOf": [ { "additionalProperties": false, "properties": { "beforeTabId": { "type": [ "string", "null" ] }, "tabId": { "type": "string" }, "type": { "const": "reorder_tab", "type": "string" } }, "required": [ "type", "tabId" ], "type": "object" }, { "additionalProperties": false, "properties": { "side": { "$ref": "#/$defs/DockSide" }, "tabId": { "type": "string" }, "targetTabId": { "type": "string" }, "type": { "const": "dock_tab", "type": "string" } }, "required": [ "type", "tabId", "targetTabId", "side" ], "type": "object" }, { "additionalProperties": false, "properties": { "panelId": { "type": "string" }, "side": { "$ref": "#/$defs/DockSide" }, "targetPanelId": { "type": "string" }, "type": { "const": "move_pane", "type": "string" } }, "required": [ "type", "panelId", "targetPanelId", "side" ], "type": "object" }, { "additionalProperties": false, "properties": { "beforeTabId": { "type": [ "string", "null" ] }, "tabId": { "type": "string" }, "targetWorkspaceId": { "type": "string" }, "type": { "const": "transfer_tab", "type": "string" } }, "required": [ "type", "tabId", "targetWorkspaceId" ], "type": "object" } ] }, "PanelMoveDestination": { "additionalProperties": false, "properties": { "panels": { "items": { "$ref": "#/$defs/PanelMoveIdentity" }, "type": "array" }, "tabOrder": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "tabOrder", "panels" ], "type": "object" }, "PanelMoveIdentity": { "additionalProperties": false, "properties": { "androidDeviceId": { "type": [ "string", "null" ] }, "browserGeneration": { "type": [ "string", "null" ] }, "kind": { "type": "string" }, "panelId": { "type": "string" }, "tabId": { "type": "string" }, "terminalSessionId": { "type": [ "string", "null" ] } }, "required": [ "panelId", "tabId", "kind" ], "type": "object" }, "ProjectArtifactSource": { "additionalProperties": false, "properties": { "kind": { "$ref": "#/$defs/ArtifactImportKind", "default": "android_apk" }, "relativePath": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "requiredScope" ], "type": "object" }, "SettingsPage": { "enum": [ "keybinds", "themes", "plugins", "terminal", "about", "chat-ai", "android", "agent-control" ], "type": "string" }, "SettingsSection": { "enum": [ "editor", "terminal", "keybinds", "themes" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_operation_get", "description": "Read a durable operation receipt owned by this connection and project.", "inputSchema": { "$defs": { "OperationInput": { "additionalProperties": false, "properties": { "operationId": { "type": "string" } }, "required": [ "operationId" ], "type": "object" }, "OperationKeyInput": { "additionalProperties": false, "properties": { "projectId": { "description": "Required when this connection has more than one approved project.", "type": [ "string", "null" ] }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "tool": { "type": "string" } }, "required": [ "retryEpoch", "requestKey", "tool" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "$ref": "#/$defs/OperationInput" }, { "$ref": "#/$defs/OperationKeyInput" } ], "type": "object" }, "outputSchema": { "$defs": { "AndroidArtifactSource": { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "requiredScope" ], "type": "object" }, "AndroidImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "coordinateSpace": { "type": "string" }, "crop": { "type": "string" }, "hardwareDisplay": { "items": { "format": "uint32", "minimum": 0, "type": "integer" }, "maxItems": 2, "minItems": 2, "type": "array" }, "imageToHardware": { "description": "[a,b,c,d,tx,ty]: x=a*u+c*v+tx, y=b*u+d*v+ty; floor and clamp to hardware bounds.", "items": { "format": "double", "type": "number" }, "maxItems": 6, "minItems": 6, "type": "array" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "rotation": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "capturedAtMillis", "hardwareDisplay", "rotation", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "imageToHardware", "coordinateSpace", "crop" ], "type": "object" }, "Artifact": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, "ArtifactImportKind": { "enum": [ "android_apk", "file" ], "type": "string" }, "ArtifactSource": { "anyOf": [ { "$ref": "#/$defs/BrowserArtifactSource" }, { "$ref": "#/$defs/AndroidArtifactSource" }, { "$ref": "#/$defs/ProjectArtifactSource" } ] }, "BrowserArtifactSource": { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "navigationId": { "type": "string" }, "origin": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "origin", "requiredScope" ], "type": "object" }, "BrowserImageGeometry": { "additionalProperties": false, "properties": { "captureScaleX": { "format": "double", "type": "number" }, "captureScaleY": { "format": "double", "type": "number" }, "capturedAtMillis": { "type": "string" }, "crop": { "type": "string" }, "cssHeight": { "format": "double", "type": "number" }, "cssWidth": { "format": "double", "type": "number" }, "deviceScaleFactor": { "format": "double", "type": "number" }, "pageZoom": { "format": "double", "type": "number" }, "pixelHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "pixelWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "scrollX": { "format": "double", "type": "number" }, "scrollY": { "format": "double", "type": "number" } }, "required": [ "capturedAtMillis", "cssWidth", "cssHeight", "deviceScaleFactor", "pixelWidth", "pixelHeight", "captureScaleX", "captureScaleY", "pageZoom", "scrollX", "scrollY", "crop" ], "type": "object" }, "BrowserScrollPosition": { "additionalProperties": false, "properties": { "x": { "format": "double", "type": "number" }, "y": { "format": "double", "type": "number" } }, "required": [ "x", "y" ], "type": "object" }, "BrowserUploadTarget": { "additionalProperties": false, "properties": { "documentUrl": { "type": "string" }, "frameId": { "type": "string" }, "label": { "type": "string" }, "origin": { "type": "string" } }, "required": [ "frameId", "origin", "documentUrl", "label" ], "type": "object" }, "ChatRequest": { "additionalProperties": false, "properties": { "assistantId": { "type": "string" }, "requestId": { "type": "string" }, "status": { "type": "string" } }, "required": [ "requestId", "assistantId", "status" ], "type": "object" }, "CommandObservation": { "additionalProperties": false, "properties": { "completed": { "type": "boolean" }, "endCursor": { "type": [ "string", "null" ] }, "exitCode": { "format": "int32", "type": [ "integer", "null" ] }, "operationId": { "type": "string" }, "source": { "type": "string" }, "startCursor": { "type": "string" }, "startedObserved": { "type": "boolean" } }, "required": [ "operationId", "startedObserved", "completed", "source", "startCursor" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "DockSide": { "enum": [ "left", "right", "top", "bottom" ], "type": "string" }, "EditorPresentation": { "enum": [ "editor", "preview", "split" ], "type": "string" }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "FileEntryKind": { "enum": [ "directory", "file" ], "type": "string" }, "GitCommitCreated": { "additionalProperties": false, "properties": { "author": { "$ref": "#/$defs/GitCommitIdentity" }, "committer": { "$ref": "#/$defs/GitCommitIdentity" }, "messageSha256": { "type": "string" } }, "required": [ "messageSha256", "author", "committer" ], "type": "object" }, "GitCommitIdentity": { "additionalProperties": false, "properties": { "email": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "email" ], "type": "object" }, "GitFetched": { "additionalProperties": false, "properties": { "commit": { "type": "string" }, "destination": { "type": "string" }, "reference": { "type": "string" }, "remote": { "type": "string" } }, "required": [ "remote", "reference", "destination", "commit" ], "type": "object" }, "GitMutation": { "enum": [ "stage", "unstage", "commit", "fetch", "push", "discard", "pull" ], "type": "string" }, "GitMutationFile": { "additionalProperties": false, "properties": { "byteLength": { "format": "uint64", "minimum": 0, "type": "integer" }, "relativePath": { "type": "string" }, "sha256": { "type": [ "string", "null" ] } }, "required": [ "relativePath", "byteLength" ], "type": "object" }, "GitPullMode": { "enum": [ "ff_only", "rebase" ], "type": "string" }, "GitPullOutcome": { "enum": [ "applied", "remote_changed", "conflicted" ], "type": "string" }, "GitPullTarget": { "additionalProperties": false, "properties": { "expectedRemoteCommit": { "type": "string" }, "mode": { "$ref": "#/$defs/GitPullMode" }, "reference": { "type": "string" }, "remote": { "type": "string" }, "sourceCommit": { "type": "string" } }, "required": [ "remote", "reference", "sourceCommit", "expectedRemoteCommit", "mode" ], "type": "object" }, "GitPulled": { "additionalProperties": false, "properties": { "fetchedCommit": { "type": "string" }, "outcome": { "$ref": "#/$defs/GitPullOutcome" }, "target": { "$ref": "#/$defs/GitPullTarget" } }, "required": [ "target", "fetchedCommit", "outcome" ], "type": "object" }, "GitPushTarget": { "additionalProperties": false, "properties": { "expectedRemoteCommit": { "type": [ "string", "null" ] }, "reference": { "type": "string" }, "remote": { "type": "string" }, "sourceCommit": { "type": "string" } }, "required": [ "remote", "reference", "sourceCommit" ], "type": "object" }, "GitPushVerification": { "enum": [ "server_acknowledgement" ], "type": "string" }, "GitPushed": { "additionalProperties": false, "properties": { "changed": { "type": "boolean" }, "target": { "$ref": "#/$defs/GitPushTarget" }, "verification": { "$ref": "#/$defs/GitPushVerification" } }, "required": [ "target", "changed", "verification" ], "type": "object" }, "GitView": { "oneOf": [ { "additionalProperties": false, "properties": { "relativePath": { "type": "string" }, "staged": { "type": "boolean" }, "type": { "const": "diff", "type": "string" } }, "required": [ "type", "relativePath", "staged" ], "type": "object" }, { "additionalProperties": false, "properties": { "commit": { "type": "string" }, "type": { "const": "commit", "type": "string" } }, "required": [ "type", "commit" ], "type": "object" } ] }, "ImageGeometry": { "anyOf": [ { "$ref": "#/$defs/BrowserImageGeometry" }, { "$ref": "#/$defs/AndroidImageGeometry" } ] }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "created": { "type": "boolean" }, "kind": { "const": "chat_opened", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "created" ], "type": "object" }, { "additionalProperties": false, "properties": { "conversationId": { "type": "string" }, "conversationRevision": { "type": "string" }, "draftRevision": { "type": "string" }, "kind": { "const": "chat_draft_updated", "type": "string" }, "panelId": { "type": "string" }, "textSha256": { "type": "string" }, "totalUtf16": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "draftRevision", "conversationRevision", "textSha256", "totalUtf16" ], "type": "object" }, { "additionalProperties": false, "properties": { "assistantId": { "type": "string" }, "connectionId": { "type": "string" }, "conversationId": { "type": "string" }, "draftRevision": { "description": "None identifies a durable reservation, not provider acceptance.", "type": [ "string", "null" ] }, "kind": { "const": "chat_sent", "type": "string" }, "model": { "type": "string" }, "panelId": { "type": "string" }, "rejection": { "anyOf": [ { "$ref": "#/$defs/ErrorCode" }, { "type": "null" } ] }, "requestId": { "type": "string" }, "userId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "conversationId", "requestId", "userId", "assistantId", "connectionId", "model" ], "type": "object" }, { "additionalProperties": false, "properties": { "alreadyFinished": { "type": "boolean" }, "conversationId": { "type": "string" }, "kind": { "const": "chat_stopped", "type": "string" }, "request": { "$ref": "#/$defs/ChatRequest" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "conversationId", "request", "alreadyFinished" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "settings_opened", "type": "string" }, "page": { "$ref": "#/$defs/SettingsPage" }, "requested": { "description": "The native window accepted this request; no preference was changed.", "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "page", "requested" ], "type": "object" }, { "additionalProperties": false, "properties": { "applied": { "type": "boolean" }, "kind": { "const": "settings_updated", "type": "string" }, "previousStoredRevision": { "type": [ "string", "null" ] }, "section": { "$ref": "#/$defs/SettingsSection" }, "storedRevision": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "section", "storedRevision", "applied" ], "type": "object" }, { "additionalProperties": false, "properties": { "closed": { "type": [ "boolean", "null" ] }, "kind": { "const": "workspace_closure", "type": "string" }, "panelIds": { "items": { "type": "string" }, "type": "array" }, "projectClosed": { "type": [ "boolean", "null" ] }, "projectId": { "type": "string" }, "terminalSessionIds": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "projectId", "panelIds", "terminalSessionIds" ], "type": "object" }, { "additionalProperties": false, "properties": { "closed": { "type": [ "boolean", "null" ] }, "kind": { "const": "project_closure", "type": "string" }, "panelIds": { "items": { "type": "string" }, "type": "array" }, "projectId": { "type": "string" }, "terminalSessionIds": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" }, "workspaceIds": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "workspaceId", "projectId", "workspaceIds", "panelIds", "terminalSessionIds" ], "type": "object" }, { "additionalProperties": false, "properties": { "anchorWorkspaceId": { "type": "string" }, "kind": { "const": "project_opened", "type": "string" }, "name": { "type": "string" }, "opened": { "type": [ "boolean", "null" ] }, "panelId": { "type": "string" }, "projectId": { "type": "string" }, "projectPath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "anchorWorkspaceId", "projectId", "projectPath", "workspaceId", "panelId", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "destination": { "anyOf": [ { "$ref": "#/$defs/PanelMoveDestination" }, { "type": "null" } ] }, "kind": { "const": "panel_moved", "type": "string" }, "movement": { "$ref": "#/$defs/PanelMove" }, "panels": { "items": { "$ref": "#/$defs/PanelMoveIdentity" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "movement", "panels" ], "type": "object" }, { "additionalProperties": false, "properties": { "afterRevision": { "type": "string" }, "beforeRevision": { "type": "string" }, "commit": { "anyOf": [ { "$ref": "#/$defs/GitCommitCreated" }, { "type": "null" } ] }, "fetch": { "anyOf": [ { "$ref": "#/$defs/GitFetched" }, { "type": "null" } ] }, "files": { "items": { "$ref": "#/$defs/GitMutationFile" }, "type": "array" }, "head": { "type": [ "string", "null" ] }, "indexRevision": { "type": "string" }, "kind": { "const": "git_mutated", "type": "string" }, "operation": { "$ref": "#/$defs/GitMutation" }, "planHash": { "type": "string" }, "pull": { "anyOf": [ { "$ref": "#/$defs/GitPulled" }, { "type": "null" } ] }, "push": { "anyOf": [ { "$ref": "#/$defs/GitPushed" }, { "type": "null" } ] }, "repositoryRelative": { "type": "string" }, "selectedFilesChanged": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "repositoryRelative", "operation", "planHash", "beforeRevision", "afterRevision", "indexRevision", "files", "selectedFilesChanged" ], "type": "object" }, { "additionalProperties": false, "properties": { "entryKind": { "$ref": "#/$defs/FileEntryKind" }, "kind": { "const": "files_mutated", "type": "string" }, "newPath": { "type": [ "string", "null" ] }, "oldPath": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "entryKind" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "kind": { "const": "artifact_exported", "type": "string" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "relativePath", "artifact" ], "type": "object" }, { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "createdAtSeconds": { "type": "string" }, "expiresAtSeconds": { "type": "string" }, "id": { "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ImageGeometry" }, { "type": "null" } ] }, "kind": { "const": "browser_downloaded", "type": "string" }, "mediaType": { "type": "string" }, "sha256": { "type": "string" }, "source": { "$ref": "#/$defs/ArtifactSource" } }, "required": [ "kind", "id", "mediaType", "byteLength", "sha256", "createdAtSeconds", "expiresAtSeconds", "source" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifact": { "$ref": "#/$defs/Artifact" }, "browserGeneration": { "type": "string" }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "fileName": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_uploaded", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "snapshotId": { "type": "string" }, "target": { "$ref": "#/$defs/BrowserUploadTarget" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "target", "fileName", "artifact", "inputMode", "dispatched" ], "type": "object" }, { "additionalProperties": false, "properties": { "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "kind": { "const": "editor_saved", "type": "string" }, "panelId": { "type": "string" }, "previousDiskRevision": { "type": "string" }, "relativePath": { "type": "string" }, "savedBufferRevision": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "savedBufferRevision", "previousDiskRevision", "diskRevision", "byteLength" ], "type": "object" }, { "additionalProperties": false, "properties": { "bufferRevision": { "type": "string" }, "dirty": { "type": "boolean" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "kind": { "const": "editor_opened", "type": "string" }, "panelId": { "type": "string" }, "presentation": { "$ref": "#/$defs/EditorPresentation" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "bufferRevision", "diskRevision", "dirty", "presentation" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "git_opened", "type": "string" }, "observationRevision": { "type": "string" }, "panelId": { "type": "string" }, "repositoryRelative": { "type": "string" }, "view": { "$ref": "#/$defs/GitView" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "repositoryRelative", "view", "observationRevision" ], "type": "object" }, { "additionalProperties": false, "properties": { "diskRevision": { "type": "string" }, "height": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "editor_previewed", "type": "string" }, "originalHeight": { "format": "uint32", "minimum": 0, "type": "integer" }, "originalWidth": { "format": "uint32", "minimum": 0, "type": "integer" }, "panelId": { "type": "string" }, "relativePath": { "type": "string" }, "width": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "diskRevision", "width", "height", "originalWidth", "originalHeight" ], "type": "object" }, { "additionalProperties": false, "properties": { "bufferRevision": { "type": "string" }, "dirty": { "type": "boolean" }, "diskRevision": { "type": "string" }, "documentId": { "type": "string" }, "editCount": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "kind": { "const": "editor_edited", "type": "string" }, "panelId": { "type": "string" }, "previousBufferRevision": { "type": "string" }, "relativePath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "relativePath", "documentId", "previousBufferRevision", "bufferRevision", "diskRevision", "dirty", "editCount" ], "type": "object" }, { "additionalProperties": false, "properties": { "activity": { "type": "string" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "intentDelivered": { "type": "boolean" }, "kind": { "const": "android_launch", "type": "string" }, "packageName": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "packageName", "activity", "intentDelivered" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "installed": { "type": "boolean" }, "installerFailure": { "type": [ "string", "null" ] }, "kind": { "const": "android_install", "type": "string" }, "newVersion": { "type": [ "string", "null" ] }, "packageName": { "type": [ "string", "null" ] }, "previousVersion": { "type": [ "string", "null" ] }, "sha256": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "artifactId", "sha256", "installed" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": [ "string", "null" ] }, "devicesRevision": { "type": [ "string", "null" ] }, "kind": { "const": "android_management", "type": "string" }, "manifestRevision": { "type": [ "string", "null" ] }, "nativeOperationId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "nativeOperationId" ], "type": "object" }, { "additionalProperties": false, "properties": { "artifactId": { "type": "string" }, "byteLength": { "format": "uint32", "minimum": 0, "type": "integer" }, "kind": { "const": "artifact_imported", "type": "string" }, "sha256": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "artifactId", "sha256", "byteLength" ], "type": "object" }, { "additionalProperties": false, "properties": { "controlled": { "type": "boolean" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "kind": { "const": "android_control", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "controlled" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "inputSequence": { "type": "string" }, "kind": { "const": "android_input", "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "inputSequence" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "generation": { "type": "string" }, "kind": { "const": "android_runtime", "type": "string" }, "ready": { "type": "boolean" }, "stopped": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "ready", "stopped" ], "type": "object" }, { "additionalProperties": false, "properties": { "deviceId": { "type": "string" }, "kind": { "const": "android_panel", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "deviceId" ], "type": "object" }, { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "defaultAction": { "type": [ "boolean", "null" ] }, "dispatched": { "type": "boolean" }, "elementRef": { "type": "string" }, "inputMode": { "type": "string" }, "kind": { "const": "browser_interaction", "type": "string" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "scrollPosition": { "anyOf": [ { "$ref": "#/$defs/BrowserScrollPosition" }, { "type": "null" } ] }, "snapshotId": { "type": "string" }, "valueLength": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "snapshotId", "elementRef", "dispatched", "inputMode" ], "type": "object" }, { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "engine": { "type": "string" }, "kind": { "const": "browser", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "navigationId": { "type": "string" }, "networkIsolation": { "type": "string" }, "panelId": { "type": "string" }, "profileId": { "type": "string" }, "ready": { "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "profileId", "navigationId", "ready", "engine", "networkIsolation" ], "type": "object" }, { "additionalProperties": false, "properties": { "browserGeneration": { "type": "string" }, "committed": { "type": "boolean" }, "kind": { "const": "browser_navigation", "type": "string" }, "loaded": { "type": "boolean" }, "navigationId": { "type": "string" }, "panelId": { "type": "string" }, "url": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "browserGeneration", "navigationId", "url", "committed", "loaded" ], "type": "object" }, { "additionalProperties": false, "properties": { "controlled": { "type": "boolean" }, "kind": { "const": "terminal_control", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "controlled" ], "type": "object" }, { "additionalProperties": false, "properties": { "closed": { "type": "boolean" }, "focused": { "type": "boolean" }, "kind": { "const": "panel", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "focused", "closed" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "workspace", "type": "string" }, "name": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" }, { "additionalProperties": false, "properties": { "dispatched": { "type": "boolean" }, "kind": { "const": "terminal_interrupt", "type": "string" }, "panelId": { "type": "string" }, "targetOperationId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "targetOperationId", "dispatched" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "terminal_command", "type": "string" }, "observation": { "$ref": "#/$defs/CommandObservation" }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "observation" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "terminal", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "panelId": { "type": "string" }, "ready": { "type": "boolean" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "ready" ], "type": "object" } ] }, "PanelMove": { "oneOf": [ { "additionalProperties": false, "properties": { "beforeTabId": { "type": [ "string", "null" ] }, "tabId": { "type": "string" }, "type": { "const": "reorder_tab", "type": "string" } }, "required": [ "type", "tabId" ], "type": "object" }, { "additionalProperties": false, "properties": { "side": { "$ref": "#/$defs/DockSide" }, "tabId": { "type": "string" }, "targetTabId": { "type": "string" }, "type": { "const": "dock_tab", "type": "string" } }, "required": [ "type", "tabId", "targetTabId", "side" ], "type": "object" }, { "additionalProperties": false, "properties": { "panelId": { "type": "string" }, "side": { "$ref": "#/$defs/DockSide" }, "targetPanelId": { "type": "string" }, "type": { "const": "move_pane", "type": "string" } }, "required": [ "type", "panelId", "targetPanelId", "side" ], "type": "object" }, { "additionalProperties": false, "properties": { "beforeTabId": { "type": [ "string", "null" ] }, "tabId": { "type": "string" }, "targetWorkspaceId": { "type": "string" }, "type": { "const": "transfer_tab", "type": "string" } }, "required": [ "type", "tabId", "targetWorkspaceId" ], "type": "object" } ] }, "PanelMoveDestination": { "additionalProperties": false, "properties": { "panels": { "items": { "$ref": "#/$defs/PanelMoveIdentity" }, "type": "array" }, "tabOrder": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "tabOrder", "panels" ], "type": "object" }, "PanelMoveIdentity": { "additionalProperties": false, "properties": { "androidDeviceId": { "type": [ "string", "null" ] }, "browserGeneration": { "type": [ "string", "null" ] }, "kind": { "type": "string" }, "panelId": { "type": "string" }, "tabId": { "type": "string" }, "terminalSessionId": { "type": [ "string", "null" ] } }, "required": [ "panelId", "tabId", "kind" ], "type": "object" }, "ProjectArtifactSource": { "additionalProperties": false, "properties": { "kind": { "$ref": "#/$defs/ArtifactImportKind", "default": "android_apk" }, "relativePath": { "type": "string" }, "requiredScope": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "relativePath", "requiredScope" ], "type": "object" }, "SettingsPage": { "enum": [ "keybinds", "themes", "plugins", "terminal", "about", "chat-ai", "android", "agent-control" ], "type": "string" }, "SettingsSection": { "enum": [ "editor", "terminal", "keybinds", "themes" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_panel_close", "description": "Close a clean file panel, an explicitly shared Chat AI view, an owned read-only Git view, an idle agent-owned terminal, an authorized Android view, or an owned native browser generation using the current domain revision. Requires panel.close and panel.create; terminal close also requires terminal.execute. Browser targets require browserGeneration. Chat views require chat.read and exact conversation grants; the last view additionally requires chat.stop, saved drafts and a native terminal checkpoint. A failed draft flush preserves views and reports an uncertain outcome. Android views require android.read and an exact selected-device grant; the last view additionally requires android.control and confirmed native Stop after editor guards. Shared views retain the same device generation. Dirty buffers, running terminal processes and human-taken terminals or browsers are preserved. Closing the active whole tab opens an empty scratch file without starting a shell.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": [ "string", "null" ] }, "expectedRevision": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "terminalSessionId": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "closed": { "type": "boolean" }, "focused": { "type": "boolean" }, "kind": { "const": "panel", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "focused", "closed" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_panel_control", "description": "Claim or release input for an explicit terminal or Android generation. Terminals require terminal.execute; a new claim waits for native Settings approval and never restarts the shell. Android requires android.control, android.read and explicit android.interact permission, deviceId/generation/expectedRevision, and the selected panel in a focused visible Lomi window. Android uses one device lease across its panels; release discharges held input. Poll the durable operation for its RAM-only lease.", "inputSchema": { "$defs": { "AndroidControlInput": { "additionalProperties": false, "properties": { "action": { "$ref": "#/$defs/PanelControlAction" }, "deviceId": { "type": "string" }, "expectedRevision": { "type": "string" }, "generation": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "deviceId", "generation", "action", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "PanelControlAction": { "enum": [ "claim", "release" ], "type": "string" }, "PanelControlInput": { "additionalProperties": false, "properties": { "action": { "$ref": "#/$defs/PanelControlAction" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "terminalSessionId", "action", "retryEpoch", "requestKey" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "$ref": "#/$defs/PanelControlInput" }, { "$ref": "#/$defs/AndroidControlInput" } ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "controlled": { "type": "boolean" }, "deviceId": { "type": "string" }, "generation": { "type": "string" }, "kind": { "const": "android_control", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "deviceId", "generation", "controlled" ], "type": "object" }, { "additionalProperties": false, "properties": { "controlled": { "type": "boolean" }, "kind": { "const": "terminal_control", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "controlled" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_panel_focus", "description": "Select an existing file, an owned read-only Git view, an already-started terminal, an explicitly shared Chat AI view, a granted Android view with this connection's controlled live generation, or an owned running isolated browser panel in an approved workspace. Chat views and revealed chat siblings additionally require chat.read/chat.open for their exact conversations. Browser targets require browserGeneration. Android targets and revealed Android siblings require android.read, an exact selected-device grant and an already running controlled generation; focus never boots a device. Requires panel.focus and expectedRevision. Rejects any tab whose selection would start a lazy shell or unqualified device/browser runtime.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "browserGeneration": { "type": [ "string", "null" ] }, "expectedRevision": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "terminalSessionId": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "closed": { "type": "boolean" }, "focused": { "type": "boolean" }, "kind": { "const": "panel", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "focused", "closed" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_panel_list", "description": "List panels in an explicitly approved workspace, including stable IDs, runtime generation and ownership. Unobserved human runtimes are not claimed to be running. Cursors are bound to this workspace and domain revision.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "limit": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "domainRevision": { "type": "string" }, "items": { "items": { "$ref": "#/$defs/PanelView" }, "type": "array" }, "kind": { "const": "panels", "type": "string" }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "kind", "items", "domainRevision" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "PanelView": { "additionalProperties": false, "properties": { "androidDeviceId": { "type": [ "string", "null" ] }, "browserGeneration": { "type": [ "string", "null" ] }, "id": { "type": "string" }, "inputControlled": { "type": "boolean" }, "kind": { "type": "string" }, "ownership": { "type": "string" }, "runtimeState": { "type": "string" }, "tabId": { "type": "string" }, "terminalSessionId": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "id", "workspaceId", "tabId", "kind", "title", "ownership", "runtimeState", "inputControlled" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_panel_move", "description": "Move existing panels: reorder_tab (beforeTabId null means end), dock_tab into the visible terminal layout, move_pane within that layout, or transfer_tab to another explicitly approved workspace in the same project. Transfer binds both workspace snapshots, preserves live owned PTYs/browsers and file/Git views, and leaves selection neutral when moving the selected tab. It does not implicitly start a replacement runtime. Chat views require chat.read/chat.open and exact shared-conversation access; their streams and drafts remain retained. Android views require android.read and an exact selected-device grant; docking, transfer and reveal also require this connection's controlled live generation, which is retained. Plugin transfers remain unqualified. Requires panel.move and workspace.write; docking and transfer also require panel.focus. Uses expectedRevision and a durable retry key. Preserves dirty editor buffers, live PTYs and browser generations; does not start or close resources. Docking requires all source/target runtimes already live and qualified. Rejects modal UI, hidden targets and insufficient space. Bounded to 128 panels and 48 KiB identity metadata.", "inputSchema": { "$defs": { "DockSide": { "enum": [ "left", "right", "top", "bottom" ], "type": "string" }, "PanelMove": { "oneOf": [ { "additionalProperties": false, "properties": { "beforeTabId": { "type": [ "string", "null" ] }, "tabId": { "type": "string" }, "type": { "const": "reorder_tab", "type": "string" } }, "required": [ "type", "tabId" ], "type": "object" }, { "additionalProperties": false, "properties": { "side": { "$ref": "#/$defs/DockSide" }, "tabId": { "type": "string" }, "targetTabId": { "type": "string" }, "type": { "const": "dock_tab", "type": "string" } }, "required": [ "type", "tabId", "targetTabId", "side" ], "type": "object" }, { "additionalProperties": false, "properties": { "panelId": { "type": "string" }, "side": { "$ref": "#/$defs/DockSide" }, "targetPanelId": { "type": "string" }, "type": { "const": "move_pane", "type": "string" } }, "required": [ "type", "panelId", "targetPanelId", "side" ], "type": "object" }, { "additionalProperties": false, "properties": { "beforeTabId": { "type": [ "string", "null" ] }, "tabId": { "type": "string" }, "targetWorkspaceId": { "type": "string" }, "type": { "const": "transfer_tab", "type": "string" } }, "required": [ "type", "tabId", "targetWorkspaceId" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "movement": { "$ref": "#/$defs/PanelMove" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "movement", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "DockSide": { "enum": [ "left", "right", "top", "bottom" ], "type": "string" }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "destination": { "anyOf": [ { "$ref": "#/$defs/PanelMoveDestination" }, { "type": "null" } ] }, "kind": { "const": "panel_moved", "type": "string" }, "movement": { "$ref": "#/$defs/PanelMove" }, "panels": { "items": { "$ref": "#/$defs/PanelMoveIdentity" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "movement", "panels" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] }, "PanelMove": { "oneOf": [ { "additionalProperties": false, "properties": { "beforeTabId": { "type": [ "string", "null" ] }, "tabId": { "type": "string" }, "type": { "const": "reorder_tab", "type": "string" } }, "required": [ "type", "tabId" ], "type": "object" }, { "additionalProperties": false, "properties": { "side": { "$ref": "#/$defs/DockSide" }, "tabId": { "type": "string" }, "targetTabId": { "type": "string" }, "type": { "const": "dock_tab", "type": "string" } }, "required": [ "type", "tabId", "targetTabId", "side" ], "type": "object" }, { "additionalProperties": false, "properties": { "panelId": { "type": "string" }, "side": { "$ref": "#/$defs/DockSide" }, "targetPanelId": { "type": "string" }, "type": { "const": "move_pane", "type": "string" } }, "required": [ "type", "panelId", "targetPanelId", "side" ], "type": "object" }, { "additionalProperties": false, "properties": { "beforeTabId": { "type": [ "string", "null" ] }, "tabId": { "type": "string" }, "targetWorkspaceId": { "type": "string" }, "type": { "const": "transfer_tab", "type": "string" } }, "required": [ "type", "tabId", "targetWorkspaceId" ], "type": "object" } ] }, "PanelMoveDestination": { "additionalProperties": false, "properties": { "panels": { "items": { "$ref": "#/$defs/PanelMoveIdentity" }, "type": "array" }, "tabOrder": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "tabOrder", "panels" ], "type": "object" }, "PanelMoveIdentity": { "additionalProperties": false, "properties": { "androidDeviceId": { "type": [ "string", "null" ] }, "browserGeneration": { "type": [ "string", "null" ] }, "kind": { "type": "string" }, "panelId": { "type": "string" }, "tabId": { "type": "string" }, "terminalSessionId": { "type": [ "string", "null" ] } }, "required": [ "panelId", "tabId", "kind" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_project_close", "description": "Request closure of an exact project and all its workspaces without deleting its folder. Requires project.close, workspace.close, workspace.write and panel.close, plus explicit grants for EVERY current project workspace. Live terminal descendants additionally require terminal.execute and idle agent ownership; protected origins and human resources are preserved. Supply projectId, an approved anchor workspaceId, expectedRevision and retryEpoch/requestKey. Shared dirty-file Save/Discard/Cancel guards apply; Save retains the project and reports partial effects. Only confirmed native closure and complete domain removal produce succeeded. No replacement runtime starts. Exact retries remain readable after removal. Bounded to 128 workspaces/panels and 48 KiB. Chat descendants require exact conversation grants and chat.read; final views additionally require chat.stop and saved native checkpoints. Android descendants require android.read and exact selected-device grants; closing a device's final view also requires android.control and confirmed native Stop after editor guards. Shared remaining views retain the device. Plugin descendants remain unqualified.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "projectId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "projectId", "workspaceId", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "closed": { "type": [ "boolean", "null" ] }, "kind": { "const": "project_closure", "type": "string" }, "panelIds": { "items": { "type": "string" }, "type": "array" }, "projectId": { "type": "string" }, "terminalSessionIds": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" }, "workspaceIds": { "items": { "type": "string" }, "type": "array" } }, "required": [ "kind", "workspaceId", "projectId", "workspaceIds", "panelIds", "terminalSessionIds" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_project_open", "description": "Request opening a new canonical project folder with one named workspace and a blank scratch editor; no shell starts. Requires project.open, workspace.write and panel.create. workspaceId is an explicitly approved anchor for the durable receipt and may refer to a closed workspace. Every new root needs a separate expiring Settings approval for the exact folder, initial workspace and inherited connection permissions. Pending requests grant no new reads or execution. The directory identity is pinned and rechecked; at most sixteen approved projects per connection. Poll the operation and preserve exact retry arguments. After success, use its new workspaceId for tools; operation lookup by retry key requires the anchor projectId when multiple projects are approved.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "name": { "type": "string" }, "projectPath": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "description": "An approved workspace binds the receipt, even after that workspace closes.", "type": "string" } }, "required": [ "workspaceId", "projectPath", "name", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "anchorWorkspaceId": { "type": "string" }, "kind": { "const": "project_opened", "type": "string" }, "name": { "type": "string" }, "opened": { "type": [ "boolean", "null" ] }, "panelId": { "type": "string" }, "projectId": { "type": "string" }, "projectPath": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "anchorWorkspaceId", "projectId", "projectPath", "workspaceId", "panelId", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_settings_open", "description": "Request a named section in the existing Lomi Settings window. Requires explicit settings.open and an approved live workspace anchor. Supply the expected domain revision and durable retry identity. No preference is written, and this permission grants no settings reads or changes. The result confirms the native window request; use the specific settings tools for changes. Exact retry returns the original receipt without opening again.", "inputSchema": { "$defs": { "SettingsPage": { "enum": [ "keybinds", "themes", "plugins", "terminal", "about", "chat-ai", "android", "agent-control" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "page": { "$ref": "#/$defs/SettingsPage" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "page", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "settings_opened", "type": "string" }, "page": { "$ref": "#/$defs/SettingsPage" }, "requested": { "description": "The native window accepted this request; no preference was changed.", "type": "boolean" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "page", "requested" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] }, "SettingsPage": { "enum": [ "keybinds", "themes", "plugins", "terminal", "about", "chat-ai", "android", "agent-control" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_settings_read", "description": "Read current nonsecret application preferences from the same retained providers as the main workbench. Requires explicit global settings.read and a live approved workspace anchor. Closed sections: editor defaults, terminal preferences (appearance overrides), keybindings, theme selections/safe mode. Excludes credentials, conversations, plugin source and CSS. Does not reload or write files. Recovery-required reports retained effective values without replacing malformed settings. Keybindings have at most 200 entries per page; pass the returned revision for subsequent offsets. Revision describes the effective snapshot, not a stored-file write token.", "inputSchema": { "$defs": { "SettingsSection": { "enum": [ "editor", "terminal", "keybinds", "themes" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": [ "string", "null" ] }, "limit": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "offset": { "default": 0, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "section": { "$ref": "#/$defs/SettingsSection" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "section" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "settings_snapshot", "type": "string" }, "readiness": { "$ref": "#/$defs/SettingsReadiness" }, "revision": { "type": "string" }, "section": { "$ref": "#/$defs/SettingsSection" }, "values": { "$ref": "#/$defs/SettingsValues" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "section", "revision", "readiness", "values" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "SettingsAppearance": { "enum": [ "system", "light", "dark" ], "type": "string" }, "SettingsBinding": { "additionalProperties": false, "properties": { "action": { "type": "string" }, "defaultShortcut": { "type": [ "string", "null" ] }, "shortcut": { "type": [ "string", "null" ] } }, "required": [ "action" ], "type": "object" }, "SettingsCursor": { "enum": [ "bar", "block", "underline" ], "type": "string" }, "SettingsEffectiveAppearance": { "enum": [ "light", "dark" ], "type": "string" }, "SettingsInactiveCursor": { "enum": [ "outline", "bar", "block", "underline", "none" ], "type": "string" }, "SettingsReadiness": { "enum": [ "ready", "recovery_required" ], "type": "string" }, "SettingsSection": { "enum": [ "editor", "terminal", "keybinds", "themes" ], "type": "string" }, "SettingsTerminalAppearance": { "additionalProperties": false, "properties": { "colors": { "anyOf": [ { "$ref": "#/$defs/SettingsTerminalColors" }, { "type": "null" } ] }, "cursorBlink": { "type": [ "boolean", "null" ] }, "cursorInactiveStyle": { "anyOf": [ { "$ref": "#/$defs/SettingsInactiveCursor" }, { "type": "null" } ] }, "cursorStyle": { "anyOf": [ { "$ref": "#/$defs/SettingsCursor" }, { "type": "null" } ] }, "cursorWidth": { "format": "uint8", "maximum": 255, "minimum": 0, "type": [ "integer", "null" ] }, "drawBoldTextInBrightColors": { "type": [ "boolean", "null" ] }, "fontFamily": { "type": [ "string", "null" ] }, "fontSize": { "format": "double", "type": [ "number", "null" ] }, "fontWeight": { "anyOf": [ { "$ref": "#/$defs/SettingsWeight" }, { "type": "null" } ] }, "fontWeightBold": { "anyOf": [ { "$ref": "#/$defs/SettingsWeight" }, { "type": "null" } ] }, "letterSpacing": { "format": "double", "type": [ "number", "null" ] }, "lineHeight": { "format": "double", "type": [ "number", "null" ] }, "minimumContrastRatio": { "format": "double", "type": [ "number", "null" ] } }, "type": "object" }, "SettingsTerminalBehavior": { "additionalProperties": false, "properties": { "altClickMovesCursor": { "type": "boolean" }, "customGlyphs": { "type": "boolean" }, "fastScrollSensitivity": { "format": "double", "type": "number" }, "macOptionClickForcesSelection": { "type": "boolean" }, "macOptionIsMeta": { "type": "boolean" }, "rescaleOverlappingGlyphs": { "type": "boolean" }, "rightClickSelectsWord": { "type": "boolean" }, "screenReaderMode": { "type": "boolean" }, "scrollOnEraseInDisplay": { "type": "boolean" }, "scrollOnUserInput": { "type": "boolean" }, "scrollSensitivity": { "format": "double", "type": "number" }, "scrollback": { "format": "uint32", "minimum": 0, "type": "integer" }, "smoothScrollDuration": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "tabStopWidth": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" }, "wordSeparator": { "type": "string" } }, "required": [ "scrollback", "scrollSensitivity", "fastScrollSensitivity", "smoothScrollDuration", "tabStopWidth", "scrollOnUserInput", "scrollOnEraseInDisplay", "altClickMovesCursor", "rightClickSelectsWord", "macOptionIsMeta", "macOptionClickForcesSelection", "screenReaderMode", "customGlyphs", "rescaleOverlappingGlyphs", "wordSeparator" ], "type": "object" }, "SettingsTerminalColors": { "additionalProperties": false, "properties": { "background": { "type": [ "string", "null" ] }, "black": { "type": [ "string", "null" ] }, "blue": { "type": [ "string", "null" ] }, "brightBlack": { "type": [ "string", "null" ] }, "brightBlue": { "type": [ "string", "null" ] }, "brightCyan": { "type": [ "string", "null" ] }, "brightGreen": { "type": [ "string", "null" ] }, "brightMagenta": { "type": [ "string", "null" ] }, "brightRed": { "type": [ "string", "null" ] }, "brightWhite": { "type": [ "string", "null" ] }, "brightYellow": { "type": [ "string", "null" ] }, "cursor": { "type": [ "string", "null" ] }, "cursorAccent": { "type": [ "string", "null" ] }, "cyan": { "type": [ "string", "null" ] }, "foreground": { "type": [ "string", "null" ] }, "green": { "type": [ "string", "null" ] }, "magenta": { "type": [ "string", "null" ] }, "red": { "type": [ "string", "null" ] }, "searchActiveMatchBackground": { "type": [ "string", "null" ] }, "searchActiveMatchBorder": { "type": [ "string", "null" ] }, "searchMatchBackground": { "type": [ "string", "null" ] }, "searchMatchBorder": { "type": [ "string", "null" ] }, "selectionBackground": { "type": [ "string", "null" ] }, "selectionForeground": { "type": [ "string", "null" ] }, "selectionInactiveBackground": { "type": [ "string", "null" ] }, "white": { "type": [ "string", "null" ] }, "yellow": { "type": [ "string", "null" ] } }, "type": "object" }, "SettingsValues": { "oneOf": [ { "additionalProperties": false, "properties": { "insertSpaces": { "type": "boolean" }, "section": { "const": "editor", "type": "string" }, "tabSize": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "section", "tabSize", "insertSpaces" ], "type": "object" }, { "additionalProperties": false, "properties": { "agentNotifications": { "type": "boolean" }, "alwaysShowTitles": { "type": "boolean" }, "appearanceOverrides": { "$ref": "#/$defs/SettingsTerminalAppearance" }, "behavior": { "$ref": "#/$defs/SettingsTerminalBehavior" }, "section": { "const": "terminal", "type": "string" }, "windowsShell": { "$ref": "#/$defs/SettingsWindowsShell" } }, "required": [ "section", "appearanceOverrides", "behavior", "windowsShell", "agentNotifications", "alwaysShowTitles" ], "type": "object" }, { "additionalProperties": false, "properties": { "focusFollowsPointer": { "type": "boolean" }, "items": { "items": { "$ref": "#/$defs/SettingsBinding" }, "type": "array" }, "nextOffset": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": [ "integer", "null" ] }, "offset": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "section": { "const": "keybinds", "type": "string" }, "total": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "required": [ "section", "focusFollowsPointer", "items", "total", "offset" ], "type": "object" }, { "additionalProperties": false, "properties": { "active": { "type": [ "string", "null" ] }, "appearance": { "$ref": "#/$defs/SettingsAppearance" }, "effectiveAppearance": { "$ref": "#/$defs/SettingsEffectiveAppearance" }, "fileIcons": { "type": [ "string", "null" ] }, "productIcons": { "type": [ "string", "null" ] }, "safeMode": { "type": "boolean" }, "section": { "const": "themes", "type": "string" } }, "required": [ "section", "appearance", "effectiveAppearance", "safeMode" ], "type": "object" } ] }, "SettingsWeight": { "anyOf": [ { "$ref": "#/$defs/SettingsWeightName" }, { "format": "double", "type": "number" } ] }, "SettingsWeightName": { "enum": [ "normal", "bold" ], "type": "string" }, "SettingsWindowsShell": { "enum": [ "powershell", "cmd" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_settings_update", "description": "Request one application editor-default, terminal-preference, keyboard-shortcut or builtin-theme change. Editor tab size is 1..16. terminal_field uses only its closed field enum and existing native validator ranges; null restores theme inheritance for appearance fields only. Fixed Windows shell selection does not execute or edit shell profiles. Requires settings.read/write, a live approved workspace, current domain revision, current lomi_settings_read revision for the matching section and durable retry identity. Settings shows exact before/after values for an expiring human decision. Poll lomi_operation_get. Concurrent stored changes and malformed preferences are preserved without overwrite. Running buffers, Undo and PTYs remain; reducing terminal scrollback can trim old displayed output. Exact retry never applies twice. keybinding_set assigns a canonical shortcut (for example Ctrl+Alt+F20); an explicit null disables it. keybinding_reset removes the stored override and restores its platform/plugin default. Only available builtin/installed action IDs are writable; conflicts and changes to other effective shortcuts are rejected. keybinds_focus_follows_pointer changes the boolean focus preference. Plugin shortcut definitions must remain unchanged until approval. theme_builtin selects lomi or deepmono; theme_appearance selects system/light/dark only while the current color theme is builtin. These patches preserve icon selections and cannot introduce third-party CSS. Safe mode and recovery block writes. Installed/custom theme selection, import and recovery are not implemented yet.", "inputSchema": { "$defs": { "RequiredSettingsScalar": { "anyOf": [ { "$ref": "#/$defs/SettingsScalar" }, { "type": "null" } ] }, "RequiredShortcut": { "type": [ "string", "null" ] }, "SettingsAppearance": { "enum": [ "system", "light", "dark" ], "type": "string" }, "SettingsBuiltinTheme": { "enum": [ "lomi", "deepmono" ], "type": "string" }, "SettingsPatch": { "oneOf": [ { "additionalProperties": false, "properties": { "type": { "const": "editor_tab_size", "type": "string" }, "value": { "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "required": [ "type", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "editor_insert_spaces", "type": "string" }, "value": { "type": "boolean" } }, "required": [ "type", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "field": { "$ref": "#/$defs/SettingsTerminalField" }, "type": { "const": "terminal_field", "type": "string" }, "value": { "$ref": "#/$defs/RequiredSettingsScalar" } }, "required": [ "type", "field", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "type": "string" }, "shortcut": { "$ref": "#/$defs/RequiredShortcut" }, "type": { "const": "keybinding_set", "type": "string" } }, "required": [ "type", "action", "shortcut" ], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "type": "string" }, "type": { "const": "keybinding_reset", "type": "string" } }, "required": [ "type", "action" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "keybinds_focus_follows_pointer", "type": "string" }, "value": { "type": "boolean" } }, "required": [ "type", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "theme_builtin", "type": "string" }, "value": { "$ref": "#/$defs/SettingsBuiltinTheme" } }, "required": [ "type", "value" ], "type": "object" }, { "additionalProperties": false, "properties": { "type": { "const": "theme_appearance", "type": "string" }, "value": { "$ref": "#/$defs/SettingsAppearance" } }, "required": [ "type", "value" ], "type": "object" } ] }, "SettingsScalar": { "anyOf": [ { "type": "boolean" }, { "format": "double", "type": "number" }, { "type": "string" } ] }, "SettingsTerminalField": { "enum": [ "appearance.fontFamily", "appearance.fontSize", "appearance.fontWeight", "appearance.fontWeightBold", "appearance.lineHeight", "appearance.letterSpacing", "appearance.cursorWidth", "appearance.cursorStyle", "appearance.cursorInactiveStyle", "appearance.cursorBlink", "appearance.minimumContrastRatio", "appearance.drawBoldTextInBrightColors", "appearance.colors.background", "appearance.colors.foreground", "appearance.colors.cursor", "appearance.colors.cursorAccent", "appearance.colors.selectionBackground", "appearance.colors.selectionForeground", "appearance.colors.selectionInactiveBackground", "appearance.colors.black", "appearance.colors.red", "appearance.colors.green", "appearance.colors.yellow", "appearance.colors.blue", "appearance.colors.magenta", "appearance.colors.cyan", "appearance.colors.white", "appearance.colors.brightBlack", "appearance.colors.brightRed", "appearance.colors.brightGreen", "appearance.colors.brightYellow", "appearance.colors.brightBlue", "appearance.colors.brightMagenta", "appearance.colors.brightCyan", "appearance.colors.brightWhite", "appearance.colors.searchMatchBackground", "appearance.colors.searchActiveMatchBackground", "appearance.colors.searchMatchBorder", "appearance.colors.searchActiveMatchBorder", "behavior.scrollback", "behavior.scrollSensitivity", "behavior.fastScrollSensitivity", "behavior.smoothScrollDuration", "behavior.tabStopWidth", "behavior.scrollOnUserInput", "behavior.scrollOnEraseInDisplay", "behavior.altClickMovesCursor", "behavior.rightClickSelectsWord", "behavior.macOptionIsMeta", "behavior.macOptionClickForcesSelection", "behavior.screenReaderMode", "behavior.customGlyphs", "behavior.rescaleOverlappingGlyphs", "behavior.wordSeparator", "windowsShell", "agentNotifications", "alwaysShowTitles" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "expectedSettingsRevision": { "type": "string" }, "patch": { "$ref": "#/$defs/SettingsPatch" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "patch", "expectedSettingsRevision", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "applied": { "type": "boolean" }, "kind": { "const": "settings_updated", "type": "string" }, "previousStoredRevision": { "type": [ "string", "null" ] }, "section": { "$ref": "#/$defs/SettingsSection" }, "storedRevision": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "section", "storedRevision", "applied" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] }, "SettingsSection": { "enum": [ "editor", "terminal", "keybinds", "themes" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_status", "description": "Connection status and implemented capabilities. Available without pairing.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "type": "object" }, "outputSchema": { "$defs": { "Capability": { "additionalProperties": false, "properties": { "authorized": { "type": "boolean" }, "available": { "type": "boolean" }, "name": { "type": "string" }, "qualified": { "type": "boolean" } }, "required": [ "name", "available", "authorized", "qualified" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "capabilities": { "items": { "$ref": "#/$defs/Capability" }, "type": "array" }, "connection": { "type": "string" }, "instanceId": { "type": [ "string", "null" ] }, "kind": { "const": "status", "type": "string" }, "limitations": { "items": { "type": "string" }, "type": "array" }, "pairingRequestId": { "type": [ "string", "null" ] }, "platform": { "type": "string" }, "uiReady": { "type": "boolean" } }, "required": [ "kind", "connection", "uiReady", "platform", "capabilities", "limitations" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_terminal_create", "description": "Create and show a terminal in an approved workspace using the Bash or Zsh profile selected at pairing. An explicit profileId must match that approval. Requires panel.create and terminal.execute; starts real shell initialization with host account permissions. Returns a durable operation; poll lomi_operation_get for readiness and a session-only lease.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cwdRelative": { "type": "string" }, "expectedRevision": { "type": "string" }, "profileId": { "type": [ "string", "null" ] }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "title": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "cwdRelative", "title", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "terminal", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "panelId": { "type": "string" }, "ready": { "type": "boolean" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "ready" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_terminal_input", "description": "Send exact text or an explicit key to an owned terminal using its current lease and monotonically increasing inputSequence. Requires terminal.execute. A repeated sequence and identical payload returns its ACK without sending again; text does not append Enter.", "inputSchema": { "$defs": { "TerminalKey": { "enum": [ "enter", "tab", "escape", "backspace", "ctrl_c", "ctrl_d" ], "type": "string" }, "TerminalPayload": { "oneOf": [ { "additionalProperties": false, "properties": { "text": { "type": "string" }, "type": { "const": "text", "type": "string" } }, "required": [ "type", "text" ], "type": "object" }, { "additionalProperties": false, "properties": { "key": { "$ref": "#/$defs/TerminalKey" }, "type": { "const": "key", "type": "string" } }, "required": [ "type", "key" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "input": { "$ref": "#/$defs/TerminalPayload" }, "inputSequence": { "type": "string" }, "leaseId": { "type": "string" }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "terminalSessionId", "leaseId", "inputSequence", "input" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "dispatch": { "type": "string" }, "inputSequence": { "type": "string" }, "kind": { "const": "terminal_input_ack", "type": "string" }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "inputSequence", "dispatch" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_terminal_interrupt", "description": "Send Ctrl+C once to a specific still-running observed command in an owned terminal. Requires terminal.execute and a current lease. Interrupt dispatch does not prove process exit; inspect the original operation.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "leaseId": { "type": "string" }, "operationId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "terminalSessionId", "leaseId", "operationId", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" }, { "additionalProperties": false, "properties": { "dispatched": { "type": "boolean" }, "kind": { "const": "terminal_interrupt", "type": "string" }, "panelId": { "type": "string" }, "targetOperationId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "targetOperationId", "dispatched" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_terminal_read", "description": "Read an owned terminal: output (default), command (requires operationId), screen from the retained xterm, or opt-in raw base64 bytes. All modes are bounded. Screen reports parser lag; output/raw cursors are separate byte spaces. OSC is untrusted. Requires terminal.read.", "inputSchema": { "$defs": { "TerminalReadMode": { "enum": [ "output", "command", "screen", "raw" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "maxBytes": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "minimumParsedSequence": { "type": [ "string", "null" ] }, "mode": { "$ref": "#/$defs/TerminalReadMode", "default": "output" }, "operationId": { "type": [ "string", "null" ] }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "terminalSessionId" ], "type": "object" }, "outputSchema": { "$defs": { "CommandObservation": { "additionalProperties": false, "properties": { "completed": { "type": "boolean" }, "endCursor": { "type": [ "string", "null" ] }, "exitCode": { "format": "int32", "type": [ "integer", "null" ] }, "operationId": { "type": "string" }, "source": { "type": "string" }, "startCursor": { "type": "string" }, "startedObserved": { "type": "boolean" } }, "required": [ "operationId", "startedObserved", "completed", "source", "startCursor" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "availableFrom": { "type": "string" }, "command": { "anyOf": [ { "$ref": "#/$defs/CommandObservation" }, { "type": "null" } ] }, "exited": { "type": "boolean" }, "gap": { "type": "boolean" }, "kind": { "const": "terminal_output", "type": "string" }, "leaseId": { "type": [ "string", "null" ] }, "mode": { "$ref": "#/$defs/TerminalReadMode" }, "nextCursor": { "type": "string" }, "nextInputSequence": { "type": "string" }, "panelId": { "type": "string" }, "parsedSequence": { "type": "string" }, "prompt": { "type": "string" }, "shellExitCode": { "format": "uint32", "minimum": 0, "type": [ "integer", "null" ] }, "streamSequence": { "type": "string" }, "terminalSessionId": { "type": "string" }, "text": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "mode", "workspaceId", "panelId", "terminalSessionId", "text", "nextCursor", "availableFrom", "gap", "prompt", "exited", "nextInputSequence", "streamSequence", "parsedSequence" ], "type": "object" }, { "additionalProperties": false, "properties": { "buffer": { "$ref": "#/$defs/ScreenBuffer" }, "columns": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "cursorColumn": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "cursorRow": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "cursorVisible": { "type": "boolean" }, "kind": { "const": "terminal_screen", "type": "string" }, "panelId": { "type": "string" }, "parsedSequence": { "type": "string" }, "parserPending": { "type": "boolean" }, "rows": { "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" }, "streamSequence": { "type": "string" }, "terminalSessionId": { "type": "string" }, "text": { "type": "string" }, "truncated": { "type": "boolean" }, "viewportOffset": { "format": "uint32", "minimum": 0, "type": "integer" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "columns", "rows", "cursorColumn", "cursorRow", "cursorVisible", "viewportOffset", "buffer", "text", "truncated", "parsedSequence", "streamSequence", "parserPending" ], "type": "object" }, { "additionalProperties": false, "properties": { "availableFrom": { "type": "string" }, "base64": { "type": "string" }, "gap": { "type": "boolean" }, "kind": { "const": "terminal_raw", "type": "string" }, "nextCursor": { "type": "string" }, "panelId": { "type": "string" }, "streamSequence": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "base64", "nextCursor", "availableFrom", "gap", "streamSequence" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "ScreenBuffer": { "enum": [ "normal", "alternate" ], "type": "string" }, "TerminalReadMode": { "enum": [ "output", "command", "screen", "raw" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_terminal_run", "description": "Run one single-line shell command at an observed idle prompt in a terminal owned by this connection. Requires terminal.execute and its current lease. Returns a durable operation; completion and exit code come from untrusted shell integration, never silence.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "command": { "type": "string" }, "leaseId": { "type": "string" }, "panelId": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "panelId", "terminalSessionId", "leaseId", "command", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "CommandObservation": { "additionalProperties": false, "properties": { "completed": { "type": "boolean" }, "endCursor": { "type": [ "string", "null" ] }, "exitCode": { "format": "int32", "type": [ "integer", "null" ] }, "operationId": { "type": "string" }, "source": { "type": "string" }, "startCursor": { "type": "string" }, "startedObserved": { "type": "boolean" } }, "required": [ "operationId", "startedObserved", "completed", "source", "startCursor" ], "type": "object" }, "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "terminal_command", "type": "string" }, "observation": { "$ref": "#/$defs/CommandObservation" }, "panelId": { "type": "string" }, "terminalSessionId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "terminalSessionId", "observation" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true } }, { "name": "lomi_workspace_create", "description": "Create a workspace in the same approved project as workspaceId. Starts with an empty scratch file and does not execute a shell. Requires workspace.write and panel.create; the creator receives access to the new workspace. Uses expectedRevision and a durable retry key.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "name": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "name", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "workspace", "type": "string" }, "name": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_workspace_list", "description": "List workspaces approved for this connection. Cursors expire when the workspace domain changes.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "cursor": { "type": [ "string", "null" ] }, "limit": { "default": 100, "format": "uint16", "maximum": 65535, "minimum": 0, "type": "integer" } }, "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "domainRevision": { "type": "string" }, "items": { "items": { "$ref": "#/$defs/Workspace" }, "type": "array" }, "kind": { "const": "workspaces", "type": "string" }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "kind", "items", "domainRevision" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "Workspace": { "additionalProperties": false, "properties": { "activePanelId": { "default": null, "type": [ "string", "null" ] }, "id": { "type": "string" }, "name": { "type": "string" }, "projectId": { "type": "string" }, "projectName": { "type": "string" }, "projectPath": { "type": "string" } }, "required": [ "id", "projectId", "name", "projectName", "projectPath" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "lomi_workspace_update", "description": "Rename an approved workspace, select its saved active panel with action=select, or request action=close using its expected domain revision. Close requires workspace.close, workspace.write and panel.close; live terminal descendants also require terminal.execute and must be idle and agent-owned. Chat descendants require exact conversation grants and chat.read; final views additionally require chat.stop and saved native checkpoints. Android descendants require android.read and exact selected-device grants; closing the final device view additionally requires android.control and confirmed native Stop after editor guards. Human-controlled browsers/terminals and unqualified plugin descendants are preserved. Dirty file guards offer save/discard/cancel; Save leaves the workspace open with partial effects and requires a fresh request. Closing never deletes the folder and does not select another workspace. Polling and exact retry still work after the workspace is removed. Selection preserves live resources and rejects lazy or unqualified runtimes. Requires workspace.write and, for selection, panel.focus. Reuse the retry epoch and request key to retrieve the same operation without repeating it.", "inputSchema": { "$defs": { "WorkspaceCloseAction": { "enum": [ "close" ], "type": "string" }, "WorkspaceCloseInput": { "additionalProperties": false, "properties": { "action": { "$ref": "#/$defs/WorkspaceCloseAction" }, "expectedRevision": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "action", "workspaceId", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "WorkspaceRenameInput": { "additionalProperties": false, "properties": { "expectedRevision": { "type": "string" }, "name": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "workspaceId", "name", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" }, "WorkspaceSelectAction": { "enum": [ "select" ], "type": "string" }, "WorkspaceSelectInput": { "additionalProperties": false, "properties": { "action": { "$ref": "#/$defs/WorkspaceSelectAction" }, "expectedRevision": { "type": "string" }, "requestKey": { "type": "string" }, "retryEpoch": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "action", "workspaceId", "expectedRevision", "retryEpoch", "requestKey" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "$ref": "#/$defs/WorkspaceRenameInput" }, { "$ref": "#/$defs/WorkspaceSelectInput" }, { "$ref": "#/$defs/WorkspaceCloseInput" } ], "type": "object" }, "outputSchema": { "$defs": { "Data": { "oneOf": [ { "additionalProperties": false, "properties": { "effectState": { "type": "string" }, "kind": { "const": "operation", "type": "string" }, "operationId": { "type": "string" }, "result": { "anyOf": [ { "$ref": "#/$defs/OperationResult" }, { "type": "null" } ] }, "state": { "type": "string" }, "workspaceId": { "type": [ "string", "null" ] } }, "required": [ "kind", "operationId", "state", "effectState" ], "type": "object" } ] }, "ErrorCode": { "enum": [ "APP_UNAVAILABLE", "PAIRING_REQUIRED", "SCOPE_DENIED", "UI_NOT_READY", "APP_CLOSING", "TARGET_NOT_FOUND", "STALE_GENERATION", "REVISION_CONFLICT", "STALE_SNAPSHOT", "TARGET_BUSY", "CONTROL_REVOKED", "PROMPT_STATE_UNKNOWN", "PANEL_NOT_RENDERABLE", "PROTECTED_ORIGIN_TERMINAL", "UNSUPPORTED_CAPABILITY", "HOST_UNQUALIFIED", "DEADLINE_EXCEEDED", "CURSOR_EXPIRED", "ARTIFACT_TOO_LARGE", "ARTIFACT_INVALID", "OUTCOME_UNKNOWN", "IDEMPOTENCY_CONFLICT", "RETRY_WINDOW_EXPIRED", "RESOURCE_EXHAUSTED", "STORAGE_UNAVAILABLE" ], "type": "string" }, "OperationResult": { "oneOf": [ { "additionalProperties": false, "properties": { "closed": { "type": [ "boolean", "null" ] }, "kind": { "const": "workspace_closure", "type": "string" }, "panelIds": { "items": { "type": "string" }, "type": "array" }, "projectClosed": { "type": [ "boolean", "null" ] }, "projectId": { "type": "string" }, "terminalSessionIds": { "items": { "type": "string" }, "type": "array" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "projectId", "panelIds", "terminalSessionIds" ], "type": "object" }, { "additionalProperties": false, "properties": { "closed": { "type": "boolean" }, "focused": { "type": "boolean" }, "kind": { "const": "panel", "type": "string" }, "panelId": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "panelId", "focused", "closed" ], "type": "object" }, { "additionalProperties": false, "properties": { "kind": { "const": "workspace", "type": "string" }, "name": { "type": "string" }, "workspaceId": { "type": "string" } }, "required": [ "kind", "workspaceId", "name" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "kind": { "const": "failure", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "controlApiVersion": { "type": "string" }, "data": { "$ref": "#/$defs/Data" }, "status": { "const": "ok", "type": "string" } }, "required": [ "status", "controlApiVersion", "data" ], "type": "object" }, { "additionalProperties": false, "properties": { "code": { "$ref": "#/$defs/ErrorCode" }, "controlApiVersion": { "type": "string" }, "message": { "type": "string" }, "status": { "const": "error", "type": "string" } }, "required": [ "status", "controlApiVersion", "code", "message" ], "type": "object" } ], "title": "Reply" }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": false } } ] }