@zenalexa/unicli 0.223.4 → 0.224.1

package/dist/compute/macos-overlay.js

@@ -0,0 +1,590 @@
+/**
+ * @owner   src/compute/macos-overlay.ts
+ * @does    Render compute visual_action evidence through a macOS AppKit full-screen HUD.
+ * @needs   Swift runtime, AppKit, src/compute/overlay.ts
+ * @feeds   future computer-use native overlay orchestration
+ * @breaks  Non-click-through or key windows can steal focus from the real action transport.
+ * @invariants The overlay is visual-only, click-through, non-key, and spans every visible screen.
+ * @side-effects launches a Swift/AppKit helper on macOS and may keep a daemon process per provider.
+ * @perf    one persistent Swift process per daemon provider; one-shot provider spawns per render.
+ * @concurrency daemon provider serializes render requests; native AppKit state is process-local
+ * @test    tests/unit/compute-macos-overlay-swift.test.ts
+ * @stability experimental
+ * @since   0.224.0
+ */
+import { spawn } from "node:child_process";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { computeOverlayRequestFromAction, } from "./overlay.js";
+import { StdioComputeOverlayDaemonSession, } from "./overlay-daemon.js";
+export class MacosAppKitOverlayProvider {
+    provider = "macos-appkit";
+    platform;
+    shell;
+    scriptPath;
+    lastPoint;
+    constructor(opts = {}) {
+        this.platform = opts.platform ?? process.platform;
+        this.shell = opts.shell ?? defaultShell;
+        this.scriptPath = opts.scriptPath;
+    }
+    currentPoint() {
+        return this.lastPoint;
+    }
+    async render(action) {
+        const request = computeOverlayRequestFromAction(action);
+        if (!request) {
+            return { provider: "macos-appkit", status: "not_requested" };
+        }
+        if (this.platform !== "darwin") {
+            return { provider: "macos-appkit", status: "unavailable" };
+        }
+        let tmpRoot;
+        const scriptPath = this.scriptPath ??
+            join((tmpRoot = await mkdtemp(join(tmpdir(), "unicli-overlay-"))), "main.swift");
+        try {
+            if (!this.scriptPath) {
+                await writeFile(scriptPath, buildMacosOverlaySwiftScript(), "utf8");
+            }
+            const result = await this.shell.run("swift", [scriptPath], {
+                input: JSON.stringify(request),
+                timeoutMs: Math.max(1_000, request.duration_ms + 1_500),
+            });
+            const status = parseOverlayStatus(result.stdout);
+            if (status.status === "arrived") {
+                this.lastPoint = pointFromOverlayTarget(request);
+            }
+            return status;
+        }
+        catch (error) {
+            return {
+                provider: "macos-appkit",
+                status: "failed",
+                error: errorMessage(error),
+            };
+        }
+        finally {
+            if (tmpRoot)
+                await rm(tmpRoot, { recursive: true, force: true });
+        }
+    }
+}
+export class MacosAppKitOverlayDaemonProvider {
+    provider = "macos-appkit";
+    platform;
+    scriptPath;
+    sessionFactory;
+    session;
+    tmpRoot;
+    lastPoint;
+    constructor(opts = {}) {
+        this.platform = opts.platform ?? process.platform;
+        this.scriptPath = opts.scriptPath;
+        this.sessionFactory = opts.sessionFactory;
+    }
+    currentPoint() {
+        return this.lastPoint;
+    }
+    async render(action) {
+        const request = computeOverlayRequestFromAction(action);
+        if (!request) {
+            return { provider: "macos-appkit", status: "not_requested" };
+        }
+        if (this.platform !== "darwin") {
+            return { provider: "macos-appkit", status: "unavailable" };
+        }
+        try {
+            const session = await this.ensureSession();
+            const status = await session.render(request, Math.max(1_000, request.duration_ms + 1_500));
+            if (status.status === "arrived") {
+                this.lastPoint = pointFromOverlayTarget(request);
+            }
+            return status;
+        }
+        catch (error) {
+            return {
+                provider: "macos-appkit",
+                status: "failed",
+                error: errorMessage(error),
+            };
+        }
+    }
+    async close() {
+        await this.session?.close();
+        this.session = undefined;
+        if (this.tmpRoot) {
+            await rm(this.tmpRoot, { recursive: true, force: true });
+            this.tmpRoot = undefined;
+        }
+    }
+    async ensureSession() {
+        if (this.session)
+            return this.session;
+        if (this.sessionFactory) {
+            this.session = await this.sessionFactory();
+            return this.session;
+        }
+        const scriptPath = this.scriptPath ??
+            join((this.tmpRoot = await mkdtemp(join(tmpdir(), "unicli-overlayd-"))), "main.swift");
+        if (!this.scriptPath) {
+            await writeFile(scriptPath, buildMacosOverlayDaemonSwiftScript(), "utf8");
+        }
+        this.session = new StdioComputeOverlayDaemonSession("swift", [scriptPath]);
+        return this.session;
+    }
+}
+export function buildMacosOverlaySwiftScript() {
+    return String.raw `
+import AppKit
+import Foundation
+import QuartzCore
+
+let cursorVisualStyle = "mac-glass-pointer-v1"
+let cursorSkin = "mac-pointer"
+
+struct OverlaySample: Decodable {
+  let at_ms: Double
+  let x: Double
+  let y: Double
+  let screenIndex: Int?
+}
+
+struct OverlayAffordance: Decodable {
+  let cursor: String?
+  let halo: String?
+  let trail: Bool?
+  let click_ripple: Bool?
+}
+
+struct OverlayRequest: Decodable {
+  let action_id: String
+  let action: String
+  let visual_style: String?
+  let state: String?
+  let affordance: OverlayAffordance?
+  let target: OverlaySample
+  let duration_ms: Double
+  let samples: [OverlaySample]
+}
+
+final class ComputeOverlayWindow: NSWindow {
+  override var canBecomeKey: Bool { false }
+  override var canBecomeMain: Bool { false }
+}
+
+final class ComputeOverlayView: NSView {
+  private let haloLayer = CAShapeLayer()
+  private let stateLayer = CAShapeLayer()
+  private let coreLayer = CAShapeLayer()
+  private let trailLayer = CAShapeLayer()
+  private let screenFrame: NSRect
+
+  init(frame: NSRect, screenFrame: NSRect) {
+    self.screenFrame = screenFrame
+    super.init(frame: frame)
+    wantsLayer = true
+    layer?.backgroundColor = NSColor.clear.cgColor
+    trailLayer.fillColor = NSColor.clear.cgColor
+    trailLayer.strokeColor = NSColor(calibratedRed: 0.76, green: 0.60, blue: 0.32, alpha: 0.52).cgColor
+    trailLayer.lineWidth = 2
+    trailLayer.lineCap = .round
+    haloLayer.fillColor = NSColor(calibratedRed: 0.98, green: 0.96, blue: 0.90, alpha: 0.98).cgColor
+    haloLayer.strokeColor = NSColor(calibratedRed: 0.09, green: 0.07, blue: 0.05, alpha: 0.96).cgColor
+    haloLayer.lineWidth = 2.25
+    haloLayer.shadowColor = NSColor(calibratedWhite: 0.0, alpha: 0.45).cgColor
+    haloLayer.shadowRadius = 10
+    haloLayer.shadowOpacity = 0.72
+    haloLayer.shadowOffset = .zero
+    stateLayer.fillColor = NSColor.clear.cgColor
+    stateLayer.strokeColor = NSColor(calibratedRed: 0.76, green: 0.60, blue: 0.32, alpha: 0.78).cgColor
+    stateLayer.lineWidth = 1.5
+    stateLayer.opacity = 0
+    coreLayer.fillColor = NSColor.clear.cgColor
+    coreLayer.strokeColor = NSColor(calibratedWhite: 1.0, alpha: 0.72).cgColor
+    coreLayer.lineWidth = 1
+    layer?.addSublayer(trailLayer)
+    layer?.addSublayer(haloLayer)
+    layer?.addSublayer(stateLayer)
+    layer?.addSublayer(coreLayer)
+  }
+
+  required init?(coder: NSCoder) { nil }
+
+  func update(point: CGPoint, trail: [CGPoint], request: OverlayRequest, elapsedMs: Double, durationMs: Double) {
+    CATransaction.begin()
+    CATransaction.setDisableActions(true)
+    let local = CGPoint(x: point.x - screenFrame.minX, y: point.y - screenFrame.minY)
+    let hotspot = local
+    let pointerPath = CGMutablePath()
+    pointerPath.move(to: local)
+    pointerPath.addLine(to: CGPoint(x: local.x, y: local.y + 45))
+    pointerPath.addLine(to: CGPoint(x: local.x + 13, y: local.y + 32))
+    pointerPath.addLine(to: CGPoint(x: local.x + 21, y: local.y + 55))
+    pointerPath.addLine(to: CGPoint(x: local.x + 31, y: local.y + 51))
+    pointerPath.addLine(to: CGPoint(x: local.x + 23, y: local.y + 29))
+    pointerPath.addLine(to: CGPoint(x: local.x + 43, y: local.y + 29))
+    pointerPath.closeSubpath()
+    let highlightPath = CGMutablePath()
+    highlightPath.move(to: CGPoint(x: local.x + 6, y: local.y + 8))
+    highlightPath.addLine(to: CGPoint(x: local.x + 6, y: local.y + 34))
+    let trailPath = CGMutablePath()
+    for (index, global) in trail.enumerated() {
+      let p = CGPoint(x: global.x - screenFrame.minX, y: global.y - screenFrame.minY)
+      if index == 0 { trailPath.move(to: p) } else { trailPath.addLine(to: p) }
+    }
+    let state = request.state ?? ""
+    let halo = request.affordance?.halo ?? ""
+    let clickRipple = request.affordance?.click_ripple ?? false
+    let pressProgress = durationMs > 0 ? elapsedMs / durationMs : 1
+    let isPressure = (state == "press" || halo == "pressure-bloom" || clickRipple) && pressProgress >= 0.78
+    let isOrbit = state == "wait" || halo == "busy-orbit"
+    let statePath = CGMutablePath()
+    statePath.addEllipse(in: CGRect(x: local.x - 14, y: local.y - 14, width: 30, height: 30))
+    haloLayer.path = pointerPath
+    coreLayer.path = highlightPath
+    trailLayer.path = trailPath
+    stateLayer.path = statePath
+    stateLayer.opacity = isPressure || isOrbit ? 1 : 0
+    stateLayer.lineDashPattern = isOrbit ? [4 as NSNumber, 5 as NSNumber] : nil
+    CATransaction.commit()
+  }
+}
+
+let data = FileHandle.standardInput.readDataToEndOfFile()
+let request = try JSONDecoder().decode(OverlayRequest.self, from: data)
+let displayHeight = NSScreen.screens.map { $0.frame.maxY }.max() ?? 0
+
+func appKitPoint(_ sample: OverlaySample) -> CGPoint {
+  CGPoint(x: sample.x, y: displayHeight - sample.y)
+}
+
+func sampleAt(elapsedMs: Double) -> OverlaySample {
+  guard let first = request.samples.first else { return request.target }
+  var previous = first
+  for sample in request.samples.dropFirst() {
+    if sample.at_ms >= elapsedMs {
+      let span = max(1, sample.at_ms - previous.at_ms)
+      let t = min(1, max(0, (elapsedMs - previous.at_ms) / span))
+      return OverlaySample(
+        at_ms: elapsedMs,
+        x: previous.x + (sample.x - previous.x) * t,
+        y: previous.y + (sample.y - previous.y) * t,
+        screenIndex: sample.screenIndex ?? previous.screenIndex
+      )
+    }
+    previous = sample
+  }
+  return request.target
+}
+
+let app = NSApplication.shared
+app.setActivationPolicy(.accessory)
+var views: [ComputeOverlayView] = []
+for screen in NSScreen.screens {
+  let window = ComputeOverlayWindow(
+    contentRect: screen.frame,
+    styleMask: [.borderless],
+    backing: .buffered,
+    defer: false,
+    screen: screen
+  )
+  window.level = .screenSaver
+  window.backgroundColor = .clear
+  window.isOpaque = false
+  window.hasShadow = false
+  window.ignoresMouseEvents = true
+  window.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .stationary]
+  let view = ComputeOverlayView(frame: NSRect(origin: .zero, size: screen.frame.size), screenFrame: screen.frame)
+  window.contentView = view
+  window.orderFrontRegardless()
+  views.append(view)
+}
+
+let start = ProcessInfo.processInfo.systemUptime
+let duration = max(120, request.duration_ms)
+Timer.scheduledTimer(withTimeInterval: 1.0 / 60.0, repeats: true) { timer in
+  let elapsed = (ProcessInfo.processInfo.systemUptime - start) * 1000
+  let sample = sampleAt(elapsedMs: elapsed)
+  let point = appKitPoint(sample)
+  let trail = request.samples.filter { $0.at_ms <= elapsed }.suffix(10).map(appKitPoint)
+  for view in views { view.update(point: point, trail: trail, request: request, elapsedMs: elapsed, durationMs: duration) }
+  if elapsed >= duration {
+    print("{\"provider\":\"macos-appkit\",\"status\":\"arrived\",\"acknowledged_at_ms\":\(Int(duration))}")
+    fflush(stdout)
+    timer.invalidate()
+    app.terminate(nil)
+  }
+}
+
+app.run()
+`;
+}
+export function buildMacosOverlayDaemonSwiftScript() {
+    return String.raw `
+import AppKit
+import Foundation
+import QuartzCore
+
+let cursorVisualStyle = "mac-glass-pointer-v1"
+let cursorSkin = "mac-pointer"
+
+struct OverlaySample: Decodable {
+  let at_ms: Double
+  let x: Double
+  let y: Double
+  let screenIndex: Int?
+}
+
+struct OverlayAffordance: Decodable {
+  let cursor: String?
+  let halo: String?
+  let trail: Bool?
+  let click_ripple: Bool?
+}
+
+struct OverlayRequest: Decodable {
+  let action_id: String
+  let action: String
+  let visual_style: String?
+  let state: String?
+  let affordance: OverlayAffordance?
+  let target: OverlaySample
+  let duration_ms: Double
+  let samples: [OverlaySample]
+}
+
+final class ComputeOverlayWindow: NSWindow {
+  override var canBecomeKey: Bool { false }
+  override var canBecomeMain: Bool { false }
+}
+
+final class ComputeOverlayView: NSView {
+  private let haloLayer = CAShapeLayer()
+  private let stateLayer = CAShapeLayer()
+  private let coreLayer = CAShapeLayer()
+  private let trailLayer = CAShapeLayer()
+  private let screenFrame: NSRect
+
+  init(frame: NSRect, screenFrame: NSRect) {
+    self.screenFrame = screenFrame
+    super.init(frame: frame)
+    wantsLayer = true
+    layer?.backgroundColor = NSColor.clear.cgColor
+    trailLayer.fillColor = NSColor.clear.cgColor
+    trailLayer.strokeColor = NSColor(calibratedRed: 0.76, green: 0.60, blue: 0.32, alpha: 0.52).cgColor
+    trailLayer.lineWidth = 2
+    trailLayer.lineCap = .round
+    haloLayer.fillColor = NSColor(calibratedRed: 0.98, green: 0.96, blue: 0.90, alpha: 0.98).cgColor
+    haloLayer.strokeColor = NSColor(calibratedRed: 0.09, green: 0.07, blue: 0.05, alpha: 0.96).cgColor
+    haloLayer.lineWidth = 2.25
+    haloLayer.shadowColor = NSColor(calibratedWhite: 0.0, alpha: 0.45).cgColor
+    haloLayer.shadowRadius = 10
+    haloLayer.shadowOpacity = 0.72
+    haloLayer.shadowOffset = .zero
+    stateLayer.fillColor = NSColor.clear.cgColor
+    stateLayer.strokeColor = NSColor(calibratedRed: 0.76, green: 0.60, blue: 0.32, alpha: 0.78).cgColor
+    stateLayer.lineWidth = 1.5
+    stateLayer.opacity = 0
+    coreLayer.fillColor = NSColor.clear.cgColor
+    coreLayer.strokeColor = NSColor(calibratedWhite: 1.0, alpha: 0.72).cgColor
+    coreLayer.lineWidth = 1
+    layer?.addSublayer(trailLayer)
+    layer?.addSublayer(haloLayer)
+    layer?.addSublayer(stateLayer)
+    layer?.addSublayer(coreLayer)
+  }
+
+  required init?(coder: NSCoder) { nil }
+
+  func update(point: CGPoint, trail: [CGPoint], request: OverlayRequest, elapsedMs: Double, durationMs: Double) {
+    CATransaction.begin()
+    CATransaction.setDisableActions(true)
+    let local = CGPoint(x: point.x - screenFrame.minX, y: point.y - screenFrame.minY)
+    let hotspot = local
+    let pointerPath = CGMutablePath()
+    pointerPath.move(to: local)
+    pointerPath.addLine(to: CGPoint(x: local.x, y: local.y + 45))
+    pointerPath.addLine(to: CGPoint(x: local.x + 13, y: local.y + 32))
+    pointerPath.addLine(to: CGPoint(x: local.x + 21, y: local.y + 55))
+    pointerPath.addLine(to: CGPoint(x: local.x + 31, y: local.y + 51))
+    pointerPath.addLine(to: CGPoint(x: local.x + 23, y: local.y + 29))
+    pointerPath.addLine(to: CGPoint(x: local.x + 43, y: local.y + 29))
+    pointerPath.closeSubpath()
+    let highlightPath = CGMutablePath()
+    highlightPath.move(to: CGPoint(x: local.x + 6, y: local.y + 8))
+    highlightPath.addLine(to: CGPoint(x: local.x + 6, y: local.y + 34))
+    let trailPath = CGMutablePath()
+    for (index, global) in trail.enumerated() {
+      let p = CGPoint(x: global.x - screenFrame.minX, y: global.y - screenFrame.minY)
+      if index == 0 { trailPath.move(to: p) } else { trailPath.addLine(to: p) }
+    }
+    let state = request.state ?? ""
+    let halo = request.affordance?.halo ?? ""
+    let clickRipple = request.affordance?.click_ripple ?? false
+    let pressProgress = durationMs > 0 ? elapsedMs / durationMs : 1
+    let isPressure = (state == "press" || halo == "pressure-bloom" || clickRipple) && pressProgress >= 0.78
+    let isOrbit = state == "wait" || halo == "busy-orbit"
+    let statePath = CGMutablePath()
+    statePath.addEllipse(in: CGRect(x: local.x - 14, y: local.y - 14, width: 30, height: 30))
+    haloLayer.path = pointerPath
+    coreLayer.path = highlightPath
+    trailLayer.path = trailPath
+    stateLayer.path = statePath
+    stateLayer.opacity = isPressure || isOrbit ? 1 : 0
+    stateLayer.lineDashPattern = isOrbit ? [4 as NSNumber, 5 as NSNumber] : nil
+    CATransaction.commit()
+  }
+}
+
+let app = NSApplication.shared
+app.setActivationPolicy(.accessory)
+let displayHeight = NSScreen.screens.map { $0.frame.maxY }.max() ?? 0
+var views: [ComputeOverlayView] = []
+var activeTimer: Timer?
+
+for screen in NSScreen.screens {
+  let window = ComputeOverlayWindow(
+    contentRect: screen.frame,
+    styleMask: [.borderless],
+    backing: .buffered,
+    defer: false,
+    screen: screen
+  )
+  window.level = .screenSaver
+  window.backgroundColor = .clear
+  window.isOpaque = false
+  window.hasShadow = false
+  window.ignoresMouseEvents = true
+  window.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .stationary]
+  let view = ComputeOverlayView(frame: NSRect(origin: .zero, size: screen.frame.size), screenFrame: screen.frame)
+  window.contentView = view
+  window.orderFrontRegardless()
+  views.append(view)
+}
+
+print("{\"provider\":\"macos-appkit\",\"status\":\"ready\"}")
+fflush(stdout)
+
+func appKitPoint(_ sample: OverlaySample) -> CGPoint {
+  CGPoint(x: sample.x, y: displayHeight - sample.y)
+}
+
+func sampleAt(_ request: OverlayRequest, elapsedMs: Double) -> OverlaySample {
+  guard let first = request.samples.first else { return request.target }
+  var previous = first
+  for sample in request.samples.dropFirst() {
+    if sample.at_ms >= elapsedMs {
+      let span = max(1, sample.at_ms - previous.at_ms)
+      let t = min(1, max(0, (elapsedMs - previous.at_ms) / span))
+      return OverlaySample(
+        at_ms: elapsedMs,
+        x: previous.x + (sample.x - previous.x) * t,
+        y: previous.y + (sample.y - previous.y) * t,
+        screenIndex: sample.screenIndex ?? previous.screenIndex
+      )
+    }
+    previous = sample
+  }
+  return request.target
+}
+
+func render(request: OverlayRequest) {
+  activeTimer?.invalidate()
+  let start = ProcessInfo.processInfo.systemUptime
+  let duration = max(120, request.duration_ms)
+  activeTimer = Timer.scheduledTimer(withTimeInterval: 1.0 / 60.0, repeats: true) { timer in
+    let elapsed = (ProcessInfo.processInfo.systemUptime - start) * 1000
+    let sample = sampleAt(request, elapsedMs: elapsed)
+    let point = appKitPoint(sample)
+    let trail = request.samples.filter { $0.at_ms <= elapsed }.suffix(10).map(appKitPoint)
+    for view in views { view.update(point: point, trail: trail, request: request, elapsedMs: elapsed, durationMs: duration) }
+    if elapsed >= duration {
+      print("{\"provider\":\"macos-appkit\",\"status\":\"arrived\",\"acknowledged_at_ms\":\(Int(duration))}")
+      fflush(stdout)
+      timer.invalidate()
+      activeTimer = nil
+    }
+  }
+}
+
+DispatchQueue.global(qos: .userInitiated).async {
+  while let line = readLine() {
+    guard let data = line.data(using: .utf8) else { continue }
+    do {
+      let request = try JSONDecoder().decode(OverlayRequest.self, from: data)
+      DispatchQueue.main.async {
+        render(request: request)
+      }
+    } catch {
+      print("{\"provider\":\"macos-appkit\",\"status\":\"failed\",\"error\":\"invalid request\"}")
+      fflush(stdout)
+    }
+  }
+  DispatchQueue.main.async { app.terminate(nil) }
+}
+
+app.run()
+`;
+}
+function parseOverlayStatus(stdout) {
+    try {
+        const value = JSON.parse(stdout.trim());
+        if (value.provider === "macos-appkit" && typeof value.status === "string") {
+            return value;
+        }
+    }
+    catch {
+        // handled below
+    }
+    return {
+        provider: "macos-appkit",
+        status: "failed",
+        error: "overlay sidecar returned invalid JSON",
+    };
+}
+function pointFromOverlayTarget(request) {
+    return {
+        x: request.target.x,
+        y: request.target.y,
+        coordinate_space: {
+            kind: "screen-pixels",
+            origin: "top-left",
+            ...(request.target.screenIndex !== undefined
+                ? { screenIndex: request.target.screenIndex }
+                : {}),
+        },
+    };
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+const defaultShell = {
+    run(command, args, opts) {
+        return new Promise((resolve, reject) => {
+            const child = spawn(command, [...args], {
+                stdio: ["pipe", "pipe", "pipe"],
+                timeout: opts?.timeoutMs ?? 2_000,
+            });
+            const stdoutChunks = [];
+            const stderrChunks = [];
+            child.stdout.on("data", (chunk) => stdoutChunks.push(chunk));
+            child.stderr.on("data", (chunk) => stderrChunks.push(chunk));
+            child.on("error", reject);
+            child.on("close", (code) => {
+                const stdout = Buffer.concat(stdoutChunks).toString("utf8");
+                const stderr = Buffer.concat(stderrChunks).toString("utf8");
+                if (code !== 0) {
+                    reject(new Error(stderr || `${command} exited with code ${code}`));
+                    return;
+                }
+                resolve({ stdout, stderr });
+            });
+            if (opts?.input !== undefined) {
+                child.stdin.write(opts.input);
+            }
+            child.stdin.end();
+        });
+    },
+};
+//# sourceMappingURL=macos-overlay.js.map

package/dist/compute/macos-overlay.js.map

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

package/dist/compute/overlay-daemon.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @owner   src/compute/overlay-daemon.ts
+ * @does    Manage JSONL stdio sessions for native compute overlay HUD daemons.
+ * @needs   child_process spawn, readline, visual overlay status protocol
+ * @feeds   macOS AppKit, Windows Win32, and Linux GTK overlay providers
+ * @breaks  Missing ready separation causes cold-start time to consume render animation timeouts.
+ * @invariants A daemon must emit provider/status=ready before render requests are written.
+ * @side-effects Starts and kills native helper processes.
+ * @perf    One persistent process per overlay provider instance.
+ * @concurrency Render calls are serialized through one active JSONL request.
+ * @test    tests/unit/compute-macos-overlay-swift.test.ts
+ * @stability experimental
+ * @since   0.224.0
+ */
+import type { ComputeOverlayRequest } from "./overlay.js";
+import type { ComputeVisualOverlayStatus } from "./visual-timeline.js";
+export interface ComputeOverlayDaemonSession {
+    render(request: ComputeOverlayRequest, timeoutMs: number): Promise<ComputeVisualOverlayStatus>;
+    close(): Promise<void>;
+}
+export declare class StdioComputeOverlayDaemonSession implements ComputeOverlayDaemonSession {
+    private readonly command;
+    private readonly args;
+    private child;
+    private lines;
+    private active;
+    private readiness;
+    private readonly queue;
+    private closed;
+    private readonly readyTimeoutMs;
+    constructor(command: string, args: readonly string[], opts?: {
+        readyTimeoutMs?: number;
+    });
+    render(request: ComputeOverlayRequest, timeoutMs: number): Promise<ComputeVisualOverlayStatus>;
+    close(): Promise<void>;
+    private processNext;
+    private writeActiveCall;
+    private ensureReadyChild;
+    private ensureChild;
+    private handleLine;
+    private createReadiness;
+    private resolveReadinessIfReady;
+    private rejectActive;
+    private rejectQueue;
+    private rejectReadiness;
+}
+//# sourceMappingURL=overlay-daemon.d.ts.map

package/dist/compute/overlay-daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-daemon.d.ts","sourceRoot":"","sources":["../../src/compute/overlay-daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CACJ,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,gCAAiC,YAAW,2BAA2B;IAUhF,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVvB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAGrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACxC,IAAI,GAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO;IAKxC,MAAM,CACJ,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,0BAA0B,CAAC;IAOhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,eAAe;YAcT,gBAAgB;IAO9B,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;CAMxB"}