anypick 1.0.0

package/dist/tray/native/TrayControls.swift

@@ -0,0 +1,475 @@
+import AppKit
+import Foundation
+import SwiftUI
+
+// Module: TrayControls.swift — hover, buttons, switches, menus
+
+// MARK: - Interaction helpers
+//
+// MenuBarExtra often drops SwiftUI `.onHover` and ignores default button cursors.
+// Hover + pointing-hand are driven by a non-hit-testing NSTrackingArea probe.
+// Hover chrome is always drawn as an *overlay* so it sits above opaque row fills.
+
+/// Transparent NSView that reports mouse enter/exit and sets the hand cursor.
+struct TrayHoverProbe: NSViewRepresentable {
+  @Binding var isHovering: Bool
+  var showsPointer: Bool
+
+  func makeNSView(context: Context) -> TrayHoverNSView {
+    let view = TrayHoverNSView()
+    view.showsPointer = showsPointer
+    view.onHoverChange = { hovering in
+      DispatchQueue.main.async {
+        if isHovering != hovering { isHovering = hovering }
+      }
+    }
+    return view
+  }
+
+  func updateNSView(_ nsView: TrayHoverNSView, context: Context) {
+    nsView.showsPointer = showsPointer
+    nsView.onHoverChange = { hovering in
+      DispatchQueue.main.async {
+        if isHovering != hovering { isHovering = hovering }
+      }
+    }
+    // Leaving a disabled surface must drop the hand immediately.
+    if !showsPointer, nsView.isHovering {
+      nsView.forceExit()
+    }
+  }
+}
+final class TrayHoverNSView: NSView {
+  var onHoverChange: ((Bool) -> Void)?
+  var showsPointer = true
+  private(set) var isHovering = false
+  private var tracking: NSTrackingArea?
+
+  override init(frame frameRect: NSRect) {
+    super.init(frame: frameRect)
+    wantsLayer = true
+  }
+
+  @available(*, unavailable)
+  required init?(coder: NSCoder) { fatalError("init(coder:) has not been implemented") }
+
+  /// Probe must not steal clicks from the SwiftUI button underneath.
+  override func hitTest(_ point: NSPoint) -> NSView? { nil }
+
+  override func updateTrackingAreas() {
+    super.updateTrackingAreas()
+    if let tracking { removeTrackingArea(tracking) }
+    // mouseMoved keeps the hand cursor alive: hitTest-nil probes lose
+    // cursorUpdate races against the real hit-tested AppKit view.
+    let area = NSTrackingArea(
+      rect: bounds,
+      options: [
+        .mouseEnteredAndExited,
+        .mouseMoved,
+        .activeAlways,
+        .inVisibleRect,
+      ],
+      owner: self,
+      userInfo: nil
+    )
+    addTrackingArea(area)
+    tracking = area
+  }
+
+  override func mouseEntered(with event: NSEvent) {
+    isHovering = true
+    onHoverChange?(true)
+    applyCursor()
+  }
+
+  override func mouseExited(with event: NSEvent) {
+    forceExit()
+  }
+
+  override func mouseMoved(with event: NSEvent) {
+    if isHovering { applyCursor() }
+  }
+
+  func forceExit() {
+    guard isHovering else { return }
+    isHovering = false
+    onHoverChange?(false)
+    // `.set()` (not push/pop) — nested probes must not corrupt a cursor stack.
+    NSCursor.arrow.set()
+  }
+
+  private func applyCursor() {
+    guard showsPointer else { return }
+    NSCursor.pointingHand.set()
+  }
+
+  deinit {
+    if isHovering { NSCursor.arrow.set() }
+  }
+}
+
+extension View {
+  /// AppKit-backed hover (MenuBarExtra-safe). Prefer over bare `.onHover`.
+  func trayHovering(_ isHovering: Binding<Bool>, showsPointer: Bool = true) -> some View {
+    background(TrayHoverProbe(isHovering: isHovering, showsPointer: showsPointer))
+  }
+
+  /// Hide system Menu pull-down chevron so custom labels don't double-glyph.
+  @ViewBuilder
+  func trayMenuIndicatorHidden() -> some View {
+    if #available(macOS 14.0, *) {
+      self.menuIndicator(.hidden)
+    } else {
+      self
+    }
+  }
+
+  /// Shared Menu chrome: no system indicator, no bordered chrome.
+  func trayMenuLabel() -> some View {
+    self
+      .menuStyle(.borderlessButton)
+      .trayMenuIndicatorHidden()
+      .fixedSize()
+  }
+
+  /// Soft hover overlay + pointing hand for non-Button interactive surfaces.
+  func anypickInteractive(
+    highlight: Bool = true,
+    cornerRadius: CGFloat = 8,
+    showsPointer: Bool = true
+  ) -> some View {
+    modifier(
+      AnyPickHoverModifier(
+        cornerRadius: cornerRadius,
+        enabled: highlight,
+        showsPointer: showsPointer
+      )
+    )
+    .contentShape(RoundedRectangle(cornerRadius: cornerRadius, style: .continuous))
+  }
+
+  /// Tinted callout row (amber/accent) — press opacity only, no second hover wash.
+  func trayCalloutButton(cornerRadius: CGFloat = 8) -> some View {
+    self
+      .buttonStyle(
+        AnyPickPlainButtonStyle(
+          cornerRadius: cornerRadius,
+          drawsFill: false
+        )
+      )
+      .contentShape(RoundedRectangle(cornerRadius: cornerRadius, style: .continuous))
+  }
+
+  /// Pointing-hand only — for system controls (Toggle/switch) that already draw their own chrome.
+  func anypickHandCursor(enabled: Bool = true) -> some View {
+    modifier(AnyPickHandCursorModifier(enabled: enabled))
+  }
+}
+
+/// Cursor-only probe; no hover fill.
+private struct AnyPickHandCursorModifier: ViewModifier {
+  var enabled: Bool
+  @State private var hovering = false
+
+  func body(content: Content) -> some View {
+    content.trayHovering($hovering, showsPointer: enabled)
+  }
+}
+
+/// System switch with a pointing-hand cursor in MenuBarExtra / custom panels.
+struct AnyPickSwitch: View {
+  let title: String
+  @Binding var isOn: Bool
+  var isEnabled: Bool = true
+
+  var body: some View {
+    Toggle(title, isOn: $isOn)
+      .labelsHidden()
+      .toggleStyle(.switch)
+      .controlSize(.small)
+      .disabled(!isEnabled)
+      .anypickHandCursor(enabled: isEnabled)
+      .accessibilityLabel(title)
+  }
+}
+
+/// Segmented tabs with real hover + pointing-hand (system `Picker`/`NSSegmentedControl` won't).
+/// Visually mirrors `NSSegmentedControl` on a vibrancy surface (HIG: selected pill on track).
+struct TraySegmentedControl<Value: Hashable>: View {
+  @Binding var selection: Value
+  let options: [Value]
+  var title: (Value) -> String
+
+  var body: some View {
+    HStack(spacing: 1) {
+      ForEach(Array(options.enumerated()), id: \.offset) { _, option in
+        let selected = selection == option
+        Button {
+          selection = option
+        } label: {
+          Text(title(option))
+            .font(.callout.weight(selected ? .semibold : .regular))
+            .foregroundStyle(selected ? Color.primary : Color.secondary)
+            .frame(maxWidth: .infinity)
+            .padding(.vertical, 5)
+            .background {
+              if selected {
+                RoundedRectangle(cornerRadius: 5, style: .continuous)
+                  .fill(.background.opacity(0.9))
+                  .shadow(color: .black.opacity(0.06), radius: 0.5, y: 0.5)
+              }
+            }
+            .contentShape(RoundedRectangle(cornerRadius: 5, style: .continuous))
+        }
+        .buttonStyle(.plain)
+        .accessibilityAddTraits(selected ? .isSelected : [])
+        .accessibilityLabel(title(option))
+        .accessibilityAddTraits(.isButton)
+      }
+    }
+    .padding(2)
+    .background(
+      RoundedRectangle(cornerRadius: 7, style: .continuous)
+        .fill(Color.primary.opacity(0.06))
+    )
+    .accessibilityElement(children: .contain)
+  }
+}
+
+/// Hover overlay for non-Button rows (Menus, tappable stacks).
+struct AnyPickHoverModifier: ViewModifier {
+  var cornerRadius: CGFloat
+  var enabled: Bool
+  var showsPointer: Bool
+  @State private var hovering = false
+
+  func body(content: Content) -> some View {
+    content
+      // Overlay (not background): sits above opaque fills already on the row.
+      // Hit-testing off so the fill never steals clicks from the control.
+      .overlay(
+        RoundedRectangle(cornerRadius: cornerRadius, style: .continuous)
+          .fill(enabled && hovering ? nativeHoverFill : .clear)
+          .allowsHitTesting(false)
+      )
+      .trayHovering($hovering, showsPointer: enabled && showsPointer)
+      .animation(TrayMotion.snappy, value: hovering)
+  }
+}
+
+/// Plain button style with visible hover/press overlay and pointing-hand cursor.
+/// Use instead of `.buttonStyle(.plain)` / `.borderless` on custom chrome.
+struct AnyPickPlainButtonStyle: ButtonStyle {
+  enum Chrome {
+    case rounded(CGFloat)
+    case capsule
+  }
+
+  var chrome: Chrome = .rounded(8)
+  var showsPointer: Bool = true
+  /// When false, only press opacity + cursor (caller owns the fill, e.g. chips).
+  var drawsFill: Bool = true
+
+  init(
+    cornerRadius: CGFloat = 8,
+    showsPointer: Bool = true,
+    drawsFill: Bool = true
+  ) {
+    self.chrome = .rounded(cornerRadius)
+    self.showsPointer = showsPointer
+    self.drawsFill = drawsFill
+  }
+
+  init(
+    chrome: Chrome,
+    showsPointer: Bool = true,
+    drawsFill: Bool = true
+  ) {
+    self.chrome = chrome
+    self.showsPointer = showsPointer
+    self.drawsFill = drawsFill
+  }
+
+  func makeBody(configuration: Configuration) -> some View {
+    AnyPickPlainButtonBody(
+      configuration: configuration,
+      chrome: chrome,
+      showsPointer: showsPointer,
+      drawsFill: drawsFill
+    )
+  }
+}
+
+private struct AnyPickPlainButtonBody: View {
+  let configuration: ButtonStyle.Configuration
+  var chrome: AnyPickPlainButtonStyle.Chrome
+  var showsPointer: Bool
+  var drawsFill: Bool
+  @Environment(\.isEnabled) private var isEnabled
+  @State private var hovering = false
+
+  var body: some View {
+    configuration.label
+      .contentShape(shape)
+      // Overlay so hover wins over label backgrounds (chips, tinted rows, etc.).
+      .overlay(fillOverlay)
+      .opacity(pressOpacity)
+      .trayHovering(
+        $hovering,
+        showsPointer: isEnabled && showsPointer
+      )
+      .animation(TrayMotion.snappy, value: hovering)
+      .animation(TrayMotion.snappy, value: configuration.isPressed)
+  }
+
+  @ViewBuilder
+  private var fillOverlay: some View {
+    if drawsFill {
+      shape
+        .fill(fillColor)
+        .allowsHitTesting(false)
+    }
+  }
+
+  private var shape: AnyShape {
+    switch chrome {
+    case .rounded(let radius):
+      AnyShape(RoundedRectangle(cornerRadius: radius, style: .continuous))
+    case .capsule:
+      AnyShape(Capsule(style: .continuous))
+    }
+  }
+
+  private var fillColor: Color {
+    guard isEnabled else { return .clear }
+    if configuration.isPressed { return nativePressFill }
+    if hovering { return nativeHoverFill }
+    return .clear
+  }
+
+  private var pressOpacity: Double {
+    guard isEnabled else { return 1 }
+    if configuration.isPressed { return drawsFill ? 0.96 : 0.84 }
+    return 1
+  }
+}
+
+/// Type-erased Shape for contentShape / overlay switching.
+private struct AnyShape: Shape, @unchecked Sendable {
+  private let pathBuilder: @Sendable (CGRect) -> Path
+
+  init<S: Shape>(_ shape: S) {
+    pathBuilder = { rect in shape.path(in: rect) }
+  }
+
+  func path(in rect: CGRect) -> Path { pathBuilder(rect) }
+}
+
+// MARK: - Shared menu affordances (macOS Settings vocabulary)
+//
+// Three glyphs only — never mix them:
+//   • overflow of secondary actions  →  ellipsis.circle  (⋯)
+//   • choose one value / open menu   →  chevron.down
+//   • navigate into a child screen   →  chevron.right
+// System Menu pull-down indicators are always hidden via `.trayMenuLabel()`.
+
+/// Overflow control for secondary actions (⋯). No text, no system chevron.
+struct TrayOverflowMenuLabel: View {
+  var body: some View {
+    Image(systemName: "ellipsis.circle")
+      .font(.body.weight(.medium))
+      .foregroundStyle(.secondary)
+      .frame(width: 28, height: 28)
+      .contentShape(Rectangle())
+  }
+}
+
+/// HIG pop-up button face: **current value** + chevron.down (no capsule chrome).
+/// Title must be the selected value (or "Choose" when empty) — never a verb like "Change".
+struct TrayPopupMenuLabel: View {
+  var title: String
+  var compact: Bool = false
+
+  var body: some View {
+    HStack(spacing: 3) {
+      Text(title)
+        .font((compact ? Font.caption : Font.callout).weight(.medium))
+        .foregroundStyle(.primary)
+        .lineLimit(1)
+      Image(systemName: "chevron.up.chevron.down")
+        .font(.system(size: 8, weight: .semibold))
+        .foregroundStyle(.secondary)
+    }
+    .contentShape(Rectangle())
+  }
+}
+
+/// Route/account switcher. `bordered` matches the product mock (small push-button face).
+struct TraySwitchMenu<Content: View>: View {
+  var title: String = "Switch"
+  var help: String? = nil
+  var isEnabled: Bool = true
+  var compact: Bool = true
+  /// Bordered control for tray rows; borderless for dense pop-up value faces.
+  var bordered: Bool = false
+  @ViewBuilder var content: () -> Content
+
+  var body: some View {
+    Menu(content: content) {
+      if bordered {
+        HStack(spacing: 3) {
+          Text(title)
+            .font(.caption.weight(.semibold))
+          Image(systemName: "chevron.up.chevron.down")
+            .font(.system(size: 8, weight: .semibold))
+            .foregroundStyle(.secondary)
+        }
+        .padding(.horizontal, 2)
+      } else {
+        TrayPopupMenuLabel(title: title, compact: compact)
+      }
+    }
+    .trayMenuIndicatorHidden()
+    .disabled(!isEnabled)
+    .help(help ?? title)
+    .accessibilityLabel(help ?? title)
+    .modifier(TraySwitchMenuChrome(bordered: bordered))
+  }
+}
+
+private struct TraySwitchMenuChrome: ViewModifier {
+  var bordered: Bool
+
+  func body(content: Content) -> some View {
+    if bordered {
+      content
+        .menuStyle(.borderlessButton)
+        .buttonStyle(.bordered)
+        .controlSize(.small)
+        .fixedSize()
+    } else {
+      content
+        .menuStyle(.borderlessButton)
+        .fixedSize()
+    }
+  }
+}
+
+/// Navigation disclosure — chevron.right only (HIG: navigate into child).
+struct TrayNavigateLabel: View {
+  var title: String
+  var compact: Bool = false
+
+  var body: some View {
+    HStack(spacing: 3) {
+      Text(title)
+        .font((compact ? Font.caption : Font.callout).weight(.medium))
+        .foregroundStyle(.secondary)
+        .lineLimit(1)
+      Image(systemName: "chevron.right")
+        .font(.caption2.weight(.semibold))
+        .foregroundStyle(.tertiary)
+    }
+    .contentShape(Rectangle())
+  }
+}

package/dist/tray/native/TrayPreferences.swift

@@ -0,0 +1,46 @@
+import AppKit
+import Foundation
+import SwiftUI
+
+// Module: TrayPreferences.swift — local UI prefs (UserDefaults, not supervisor state)
+
+/// Menu-bar / main-window chrome preferences only.
+/// Activation, accounts, and proxies stay with the Node supervisor (ADR 0006/0009).
+enum TrayPreferences {
+  private static let defaults = UserDefaults.standard
+  private static let prefix = "dev.anypick.tray."
+
+  /// Keys for `@AppStorage` (SwiftUI invalidation) and `UserDefaults`.
+  enum Key {
+    static let onboardingDismissed = prefix + "onboardingDismissed"
+    static let quickSection = prefix + "quickSection"
+    static let mainTab = prefix + "mainTab"
+  }
+
+  /// User chose “Not Now” / “Got It” on the setup checklist.
+  static var onboardingDismissed: Bool {
+    get { defaults.bool(forKey: Key.onboardingDismissed) }
+    set { defaults.set(newValue, forKey: Key.onboardingDismissed) }
+  }
+
+  /// Last Apps / Proxies / Logs segment in the menu-bar panel.
+  static var quickSectionRaw: String? {
+    get { defaults.string(forKey: Key.quickSection) }
+    set { defaults.set(newValue, forKey: Key.quickSection) }
+  }
+
+  /// Last primary sidebar destination in the main window.
+  static var mainTabRaw: String? {
+    get { defaults.string(forKey: Key.mainTab) }
+    set { defaults.set(newValue, forKey: Key.mainTab) }
+  }
+
+  static func resetOnboarding() {
+    onboardingDismissed = false
+  }
+
+  /// Call when the machine is back to zero config so tips reappear.
+  static func resetOnboardingIfEmpty(isFirstRun: Bool) {
+    if isFirstRun { onboardingDismissed = false }
+  }
+}

package/dist/tray/native/sources.txt

@@ -0,0 +1,26 @@
+Theme.swift
+TrayPreferences.swift
+TrayControls.swift
+TrayChrome.swift
+Models.swift
+Store.swift
+SharedUI.swift
+QuickNav.swift
+QuickRouteRow.swift
+QuickServiceRows.swift
+QuickActivityRow.swift
+QuickPanel.swift
+MainWindow.swift
+AccountsPanel.swift
+RoutingIssues.swift
+ModelsOverview.swift
+ModelsEditor.swift
+ModelsPickers.swift
+ModelsRoutePickers.swift
+ProxyPanel.swift
+MonitorPanel.swift
+SettingsPanel.swift
+ManageFormChrome.swift
+ManageForms.swift
+ManagePanel.swift
+AppEntry.swift

package/dist/tray/native-sources.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Ordered Swift sources for the macOS menu-bar helper.
+ * Prefer sources.txt so compile order stays stable across machines.
+ */
+export declare function nativeTraySwiftFiles(nativeDir: string): Promise<string[]>;
+/** Concatenated sources — useful for string-scanning tests and fingerprints. */
+export declare function readNativeTraySwiftBundle(nativeDir: string): Promise<string>;
+//# sourceMappingURL=native-sources.d.ts.map

package/dist/tray/native-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-sources.d.ts","sourceRoot":"","sources":["../../src/tray/native-sources.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmB/E;AAED,gFAAgF;AAChF,wBAAsB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlF"}

package/dist/tray/native-sources.js

@@ -0,0 +1,19 @@
+import { join } from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+//#region src/tray/native-sources.ts
+/**
+* Ordered Swift sources for the macOS menu-bar helper.
+* Prefer sources.txt so compile order stays stable across machines.
+*/
+async function nativeTraySwiftFiles(nativeDir) {
+	const manifest = join(nativeDir, "sources.txt");
+	try {
+		const names = (await readFile(manifest, "utf8")).split(/\r?\n/).map((line) => line.trim()).filter((line) => line && !line.startsWith("#") && line.endsWith(".swift"));
+		if (names.length > 0) return names.map((name) => join(nativeDir, name));
+	} catch {}
+	return (await readdir(nativeDir)).filter((name) => name.endsWith(".swift")).sort().map((name) => join(nativeDir, name));
+}
+//#endregion
+export { nativeTraySwiftFiles };
+
+//# sourceMappingURL=native-sources.js.map

package/dist/tray/native-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-sources.js","names":[],"sources":["../../src/tray/native-sources.ts"],"sourcesContent":["import { readFile, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\n/**\n * Ordered Swift sources for the macOS menu-bar helper.\n * Prefer sources.txt so compile order stays stable across machines.\n */\nexport async function nativeTraySwiftFiles(nativeDir: string): Promise<string[]> {\n  const manifest = join(nativeDir, 'sources.txt');\n  try {\n    const text = await readFile(manifest, 'utf8');\n    const names = text\n      .split(/\\r?\\n/)\n      .map((line) => line.trim())\n      .filter((line) => line && !line.startsWith('#') && line.endsWith('.swift'));\n    if (names.length > 0) {\n      return names.map((name) => join(nativeDir, name));\n    }\n  } catch {\n    // fall through\n  }\n  const entries = await readdir(nativeDir);\n  return entries\n    .filter((name) => name.endsWith('.swift'))\n    .sort()\n    .map((name) => join(nativeDir, name));\n}\n\n/** Concatenated sources — useful for string-scanning tests and fingerprints. */\nexport async function readNativeTraySwiftBundle(nativeDir: string): Promise<string> {\n  const files = await nativeTraySwiftFiles(nativeDir);\n  const chunks = await Promise.all(files.map((file) => readFile(file, 'utf8')));\n  return chunks.join('\\n\\n');\n}\n"],"mappings":";;;;;;;AAOA,eAAsB,qBAAqB,WAAsC;CAC/E,MAAM,WAAW,KAAK,WAAW,aAAa;CAC9C,IAAI;EAEF,MAAM,SAAQ,MADK,SAAS,UAAU,MAAM,EAAA,CAEzC,MAAM,OAAO,CAAC,CACd,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAC1B,QAAQ,SAAS,QAAQ,CAAC,KAAK,WAAW,GAAG,KAAK,KAAK,SAAS,QAAQ,CAAC;EAC5E,IAAI,MAAM,SAAS,GACjB,OAAO,MAAM,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;CAEpD,QAAQ,CAER;CAEA,QAAO,MADe,QAAQ,SAAS,EAAA,CAEpC,QAAQ,SAAS,KAAK,SAAS,QAAQ,CAAC,CAAC,CACzC,KAAK,CAAC,CACN,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;AACxC"}

package/dist/tray/protocol.d.ts

@@ -0,0 +1,79 @@
+/** Commands emitted by the native tray helper over its stdout pipe. */
+export declare const TRAY_PROTOCOL_VERSION = 1;
+export declare const MAX_TRAY_COMMAND_BYTES: number;
+export interface TrayInvokeCommand {
+    version: 1;
+    requestId: string;
+    revision: number;
+    actionId: string;
+}
+export interface TrayApplyModelRolesCommand {
+    version: 1;
+    requestId: string;
+    revision: number;
+    clientId: string;
+    /** Role id -> opaque model action id from this exact snapshot revision. */
+    roleActionIds: Record<string, string>;
+}
+export interface TrayLogsCommand {
+    version: 1;
+    requestId: string;
+    providerId: string;
+    name: string;
+    lines: number;
+}
+export type TrayProxyLogsState = 'ready' | 'empty' | 'not-running' | 'error';
+export interface TrayProxyLogsResult {
+    version: 1;
+    requestId: string;
+    proxyId: string;
+    state: TrayProxyLogsState;
+    text: string;
+}
+/** Stable identity shared by snapshot rows, log requests, and log responses. */
+export declare function trayLogSourceId(providerId: string, name: string): string;
+export type TrayMutationOperation = 'account-detect' | 'account-save' | 'account-edit' | 'account-refresh' | 'account-remove'
+/** Clear the live app login (stash: optional backup + local wipe, no remote logout). */
+ | 'account-clear' | 'gateway-create' | 'gateway-edit' | 'gateway-refresh' | 'gateway-remove' | 'client-reset' | 'hub-source-toggle' | 'proxy-restart-all' | 'proxy-stop-all' | 'setting-launch-at-login' | 'setting-auto-start-proxies' | 'setting-show-quota' | 'setting-quota-guard';
+export interface TrayMutationCommand {
+    version: 1;
+    requestId: string;
+    operation: TrayMutationOperation;
+    providerId?: string;
+    sourceId?: string;
+    name: string;
+    label?: string;
+    endpoint?: string;
+    apiKey?: string;
+    /** Non-secret credential qualifier (e.g. Kiro API region) for account-save. */
+    region?: string;
+    defaultModel?: string;
+    overwrite?: boolean;
+    enabled?: boolean;
+}
+export type TrayCommand = {
+    kind: 'open' | 'refresh' | 'restart' | 'stop' | 'quit';
+} | {
+    kind: 'navigate';
+    screen: 'accounts' | 'gateways' | 'proxy' | 'proxy-hub' | 'add-account' | 'add-gateway';
+} | {
+    kind: 'apply-model-roles';
+    payload: TrayApplyModelRolesCommand;
+} | {
+    kind: 'logs';
+    payload: TrayLogsCommand;
+} | {
+    kind: 'mutate';
+    payload: TrayMutationCommand;
+} | {
+    kind: 'invoke';
+    payload: TrayInvokeCommand;
+};
+/**
+ * Decodes one complete command line from the native tray helper.
+ *
+ * The helper is a separate process, so malformed input is ignored rather than
+ * allowed to disrupt proxy supervision.
+ */
+export declare function decodeTrayCommand(line: string): TrayCommand | undefined;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/tray/protocol.d.ts.map

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