Peekaboo MCP

import Commander import CoreGraphics import Foundation import PeekabooCore import PeekabooFoundation /// Shared targeting options for interaction commands. /// /// These options are always optional. When you provide a window selector, an app selector must be present. struct InteractionTargetOptions: CommanderParsable, ApplicationResolvable { @Option(name: .long, help: "Target application name, bundle ID, or 'PID:12345'") var app: String? @Option(name: .long, help: "Target application by process ID") var pid: Int32? @Option(name: .long, help: "Target window by title (partial match supported)") var windowTitle: String? @Option(name: .long, help: "Target window by index (0-based, frontmost is 0)") var windowIndex: Int? @Option( name: .long, help: "Target window by CoreGraphics window id (window_id from `peekaboo window list --json`)" ) var windowId: Int? init() {} var hasAnyTarget: Bool { self.app != nil || self.pid != nil || self.windowTitle != nil || self.windowIndex != nil || self.windowId != nil } mutating func validate() throws { if let windowIndex = self.windowIndex, windowIndex < 0 { throw ValidationError("--window-index must be 0 or greater") } if let windowId = self.windowId, windowId <= 0 { throw ValidationError("--window-id must be greater than 0") } if self.windowTitle != nil || self.windowIndex != nil, self.app == nil, self.pid == nil, self.windowId == nil { throw ValidationError("When using --window-title/--window-index, also provide --app or --pid.") } } func resolveApplicationIdentifierOptional() throws -> String? { guard self.app != nil || self.pid != nil else { return nil } return try self.resolveApplicationIdentifier() } func resolveWindowID(services: any PeekabooServiceProviding) async throws -> CGWindowID? { if let windowId = self.windowId { return CGWindowID(windowId) } guard let windowIndex = self.windowIndex else { return nil } guard let appIdentifier = try self.resolveApplicationIdentifierOptional() else { throw ValidationError("Missing --app/--pid for --window-index") } let windows = try await services.windows.listWindows(target: .index(app: appIdentifier, index: windowIndex)) guard let window = windows.first else { return nil } return CGWindowID(window.windowID) } func resolveWindowTitleOptional(services: any PeekabooServiceProviding) async throws -> String? { if let windowTitle { return windowTitle } if let windowId = self.windowId { let windows = try await services.windows.listWindows(target: .windowId(windowId)) return windows.first?.title } guard let windowIndex = self.windowIndex else { return nil } guard let appIdentifier = try self.resolveApplicationIdentifierOptional() else { throw ValidationError("Missing --app/--pid for --window-index") } let windows = try await services.windows.listWindows(target: .index(app: appIdentifier, index: windowIndex)) return windows.first?.title } }