@archastro/movie-harness 0.1.0

package/native/macos/WindowTools.swift

@@ -0,0 +1,150 @@
+/**
+ * Window inventory + Screen Recording TCC helpers for desktop.window.
+ *
+ * Usage:
+ *   swift WindowTools.swift list
+ *   swift WindowTools.swift screen-access          # preflight only (JSON)
+ *   swift WindowTools.swift screen-access --request  # may show system prompt
+ */
+import AppKit
+import CoreGraphics
+import Foundation
+
+struct WindowRow: Encodable {
+  let id: Int
+  let pid: Int
+  let owner: String
+  let title: String
+  let bundleId: String?
+  let width: Int
+  let height: Int
+  let x: Int
+  let y: Int
+  let onScreen: Bool
+}
+
+struct ScreenAccessReport: Encodable {
+  let granted: Bool
+  /// True when we invoked CGRequestScreenCaptureAccess (may have shown a prompt).
+  let requested: Bool
+  let hostApp: String
+  let hostBundleId: String?
+  let settingsHint: String
+}
+
+func listWindows() -> [WindowRow] {
+  // Include off-screen windows so agents can still target them.
+  let opts = CGWindowListOption(arrayLiteral: .excludeDesktopElements)
+  guard let info = CGWindowListCopyWindowInfo(opts, kCGNullWindowID) as? [[String: Any]]
+  else {
+    return []
+  }
+
+  var bundleByPid: [Int32: String] = [:]
+  for app in NSWorkspace.shared.runningApplications {
+    if let bid = app.bundleIdentifier {
+      bundleByPid[app.processIdentifier] = bid
+    }
+  }
+
+  var rows: [WindowRow] = []
+  for w in info {
+    let layer = w[kCGWindowLayer as String] as? Int ?? -1
+    guard layer == 0 else { continue }
+
+    let id = w[kCGWindowNumber as String] as? Int ?? 0
+    let pid = w[kCGWindowOwnerPID as String] as? Int ?? 0
+    let owner = w[kCGWindowOwnerName as String] as? String ?? ""
+    let title = w[kCGWindowName as String] as? String ?? ""
+    let onScreen = w[kCGWindowIsOnscreen as String] as? Bool ?? false
+    let bounds = w[kCGWindowBounds as String] as? [String: Any]
+    let width = (bounds?["Width"] as? NSNumber)?.intValue ?? 0
+    let height = (bounds?["Height"] as? NSNumber)?.intValue ?? 0
+    let x = (bounds?["X"] as? NSNumber)?.intValue ?? 0
+    let y = (bounds?["Y"] as? NSNumber)?.intValue ?? 0
+    if width < 2 || height < 2 { continue }
+
+    rows.append(
+      WindowRow(
+        id: id,
+        pid: pid,
+        owner: owner,
+        title: title,
+        bundleId: bundleByPid[Int32(pid)],
+        width: width,
+        height: height,
+        x: x,
+        y: y,
+        onScreen: onScreen
+      )
+    )
+  }
+
+  // Largest first — better default when multiple windows share a bundle id.
+  return rows.sorted { ($0.width * $0.height) > ($1.width * $1.height) }
+}
+
+func hostIdentity() -> (name: String, bundleId: String?) {
+  let app = NSRunningApplication.current
+  let name =
+    app.localizedName
+    ?? ProcessInfo.processInfo.processName
+  return (name, app.bundleIdentifier)
+}
+
+func screenAccess(request: Bool) -> ScreenAccessReport {
+  let host = hostIdentity()
+  var granted = CGPreflightScreenCaptureAccess()
+  var didRequest = false
+  if request && !granted {
+    // May show the system consent dialog (not always; Settings may still be required).
+    granted = CGRequestScreenCaptureAccess()
+    didRequest = true
+  }
+  return ScreenAccessReport(
+    granted: granted,
+    requested: didRequest,
+    hostApp: host.name,
+    hostBundleId: host.bundleId,
+    settingsHint:
+      "System Settings → Privacy & Security → Screen Recording → enable \(host.name), then quit & reopen it"
+  )
+}
+
+func emitJSON<T: Encodable>(_ value: T) {
+  let encoder = JSONEncoder()
+  encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
+  let data = try! encoder.encode(value)
+  FileHandle.standardOutput.write(data)
+  fputs("\n", stdout)
+}
+
+let args = Array(CommandLine.arguments.dropFirst())
+let command = args.first ?? "list"
+
+if command == "list" || command == "--json" {
+  emitJSON(listWindows())
+  exit(0)
+}
+
+if command == "screen-access" {
+  let request = args.contains("--request") || args.contains("-r")
+  let report = screenAccess(request: request)
+  emitJSON(report)
+  // Exit 0 when granted, 2 when denied (easy for shells).
+  exit(report.granted ? 0 : 2)
+}
+
+fputs(
+  """
+  usage:
+    WindowTools.swift list
+    WindowTools.swift screen-access [--request]
+
+  list          JSON windows for desktop.window matching
+  screen-access Screen Recording TCC preflight (optional --request prompt)
+
+  """,
+  stderr
+)
+exit(2)

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@archastro/movie-harness",
+  "version": "0.1.0",
+  "description": "Universal movie capture harness for browser, PTY, desktop, and raw frames into .astroshot/",
+  "keywords": [
+    "astroshots",
+    "movie",
+    "screencast",
+    "playwright",
+    "pty",
+    "harness"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArchAstro/astroshots.git",
+    "directory": "packages/movie-harness"
+  },
+  "homepage": "https://github.com/ArchAstro/astroshots#readme",
+  "bugs": "https://github.com/ArchAstro/astroshots/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "astroshot-movie": "bin/astroshot-movie.mjs"
+  },
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "bin",
+    "dist",
+    "native",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "test": "npm run build && vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run clean && npm run build"
+  },
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@xterm/headless": "^5.5.0",
+    "playwright": "1.61.1",
+    "yaml": "^2.8.0"
+  },
+  "optionalDependencies": {
+    "node-pty": "1.2.0-beta.14"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.1.0"
+  }
+}