aigetwey 1.0.1

package/src/adapters/index.ts

@@ -0,0 +1,17 @@
+import type { CanonicalRequest, CanonicalResponse, WireFormat } from "../core/canonical.js";
+import * as openai from "./openai.js";
+import * as anthropic from "./anthropic.js";
+import * as gemini from "./gemini.js";
+
+export interface Adapter {
+  requestToCanonical(body: unknown): CanonicalRequest;
+  requestFromCanonical(req: CanonicalRequest): unknown;
+  responseToCanonical(resp: unknown): CanonicalResponse;
+  responseFromCanonical(resp: CanonicalResponse): unknown;
+}
+
+const ADAPTERS: Record<WireFormat, Adapter> = { openai, anthropic, gemini };
+
+export function adapterFor(format: WireFormat): Adapter {
+  return ADAPTERS[format];
+}

package/src/adapters/openai.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenAI adapter. The canonical format IS the OpenAI Chat Completions shape, so
+ * these are near-identity passes — they exist so every format flows through the
+ * same adapter interface.
+ */
+import type { CanonicalRequest, CanonicalResponse } from "../core/canonical.js";
+
+export function requestToCanonical(body: unknown): CanonicalRequest {
+  return body as CanonicalRequest;
+}
+
+export function requestFromCanonical(req: CanonicalRequest): unknown {
+  return req;
+}
+
+export function responseToCanonical(resp: unknown): CanonicalResponse {
+  return resp as CanonicalResponse;
+}
+
+export function responseFromCanonical(resp: CanonicalResponse): unknown {
+  return resp;
+}

package/src/cli/tray/autostart.ts

@@ -0,0 +1,133 @@
+/**
+ * Run-on-OS-startup, toggled from the tray menu — registers the aigetwey CLI to
+ * launch with `--tray` at login.
+ *
+ *   macOS  → ~/Library/LaunchAgents/com.aigetwey.autostart.plist (launchd)
+ *   Windows→ %APPDATA%/.../Startup/aigetwey.vbs
+ *   Linux  → ~/.config/autostart/aigetwey.desktop
+ */
+import { existsSync, mkdirSync, writeFileSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname, basename, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+
+const APP_NAME = "aigetwey";
+const APP_LABEL = "com.aigetwey.autostart";
+const here = dirname(fileURLToPath(import.meta.url));
+
+/** Absolute path to the launcher script (dist/cli.js). */
+function getCliPath(explicit?: string): string | null {
+  if (explicit && existsSync(resolve(explicit))) return resolve(explicit);
+  if (process.argv[1]) {
+    const r = resolve(process.argv[1]);
+    if (/cli\.(js|ts)$/.test(basename(r)) && existsSync(r)) return r;
+  }
+  // dist/cli/tray/autostart.js → up two → dist/cli.js
+  const computed = resolve(here, "..", "..", "cli.js");
+  return existsSync(computed) ? computed : null;
+}
+
+export function isAutoStartEnabled(): boolean {
+  try {
+    if (process.platform === "darwin") {
+      const plist = join(homedir(), "Library", "LaunchAgents", `${APP_LABEL}.plist`);
+      return existsSync(plist);
+    }
+    if (process.platform === "win32") {
+      return existsSync(join(process.env.APPDATA || "", "Microsoft", "Windows", "Start Menu", "Programs", "Startup", `${APP_NAME}.vbs`));
+    }
+    return existsSync(join(homedir(), ".config", "autostart", `${APP_NAME}.desktop`));
+  } catch {
+    return false;
+  }
+}
+
+export function enableAutoStart(cliPath?: string): boolean {
+  if (process.platform === "linux" && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY) return false;
+  const script = getCliPath(cliPath);
+  if (!script) return false;
+  const node = process.execPath;
+  try {
+    if (process.platform === "darwin") return enableMac(node, script);
+    if (process.platform === "win32") return enableWin(node, script);
+    return enableLinux(node, script);
+  } catch {
+    return false;
+  }
+}
+
+export function disableAutoStart(): boolean {
+  try {
+    if (process.platform === "darwin") return disableMac();
+    if (process.platform === "win32") return disableWin();
+    return disableLinux();
+  } catch {
+    return false;
+  }
+}
+
+// ── macOS ──
+function enableMac(node: string, script: string): boolean {
+  const dir = join(homedir(), "Library", "LaunchAgents");
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  const plistPath = join(dir, `${APP_LABEL}.plist`);
+  const path = `${dirname(node)}:/usr/local/bin:/usr/bin:/bin`;
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>${APP_LABEL}</string>
+  <key>ProgramArguments</key><array>
+    <string>${node}</string><string>${script}</string><string>--tray</string>
+  </array>
+  <key>EnvironmentVariables</key><dict><key>PATH</key><string>${path}</string></dict>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><false/>
+</dict></plist>`;
+  writeFileSync(plistPath, plist);
+  try { execSync(`launchctl unload "${plistPath}"`, { stdio: "ignore" }); } catch { /* not loaded */ }
+  try { execSync(`launchctl load -w "${plistPath}"`, { stdio: "ignore" }); } catch { /* picked up next login */ }
+  return true;
+}
+function disableMac(): boolean {
+  const plistPath = join(homedir(), "Library", "LaunchAgents", `${APP_LABEL}.plist`);
+  try { execSync(`launchctl unload "${plistPath}"`, { stdio: "ignore" }); } catch { /* not loaded */ }
+  if (existsSync(plistPath)) unlinkSync(plistPath);
+  return true;
+}
+
+// ── Windows ──
+function enableWin(node: string, script: string): boolean {
+  const dir = join(process.env.APPDATA || "", "Microsoft", "Windows", "Start Menu", "Programs", "Startup");
+  if (!existsSync(dir)) return false;
+  const vbs = `Set WshShell = CreateObject("WScript.Shell")\nWshShell.Run """${node}"" ""${script}"" --tray", 0, False\n`;
+  writeFileSync(join(dir, `${APP_NAME}.vbs`), vbs);
+  return true;
+}
+function disableWin(): boolean {
+  const vbs = join(process.env.APPDATA || "", "Microsoft", "Windows", "Start Menu", "Programs", "Startup", `${APP_NAME}.vbs`);
+  if (existsSync(vbs)) unlinkSync(vbs);
+  return true;
+}
+
+// ── Linux ──
+function enableLinux(node: string, script: string): boolean {
+  const dir = join(homedir(), ".config", "autostart");
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  const desktop = `[Desktop Entry]
+Type=Application
+Name=aigetwey
+Comment=Personal AI gateway
+Exec=${node} ${script} --tray
+Hidden=false
+NoDisplay=false
+X-GNOME-Autostart-enabled=true
+`;
+  writeFileSync(join(dir, `${APP_NAME}.desktop`), desktop);
+  return true;
+}
+function disableLinux(): boolean {
+  const desktop = join(homedir(), ".config", "autostart", `${APP_NAME}.desktop`);
+  if (existsSync(desktop)) unlinkSync(desktop);
+  return true;
+}

package/src/cli/tray/icon.ts

@@ -0,0 +1,4 @@
+/** The aigetwey tray icon ("a»" mark), embedded so it ships without an asset
+ *  copy step. 64×64 RGBA PNG, base64. */
+export const TRAY_ICON_PNG_BASE64 =
+  "iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAABmJLR0QA/wD/AP+gvaeTAAAEZklEQVR4nO2ZX2hbVRzHv79zb1qnjq46TVItOrc6xAlBmzqGD6s6BkJxIqXmtk5QEARfnG7OP+geHNiVCr6U+eS2mtR1LyqIuAfdg4zWpNvErSI+adfmD+KmDatdkvOTEzNIk3uTZs3WZD2fp5vf79d7z/fbc3N+5wTQaDQajUaj0Wg0Go1Go9GsLGi5BxCO9m0lyEcZYtzv/eyEXc3Jqe7bGhpcPer68uXU0S2tx/66IQyIxAO7mGnwymcGfdjhCb5VKN7lcp0CcE8uNJUReGLznaHfqjEGgWWEmfbmfybw3nA80J8fM03zuTzxilZT8vdjCaut7g2whWlPoQlFJaC7qmWCwHLCPFDOhHQ6/bma9tfKBKqk+Ny57oa55sZNkjIbSNCa7EAkXyQyJ9vd6yeJ9slKBxCO9X4A8Du2ScZHfm/odSVSiVWibSTEhEw//kjL0V8qffaiDRiPPb9OIP0uQM8CaHIoixIw1DR7YaCt7Zt51IkJVK4gErW6mXAYwKpF3vMMSd7W3jLyZz2YIEolI4nAY0wIOYi/BCBjE/exwDFUiN8TVDNsv22SsCsctQbV0pcW1Eng6eIi9khhfjcx0/NA1Qxgpo/VSrRwLPxThulBvyd0S3Ku4VYm9AFIFYx4azhqPYU6MEE4JX5MWD4wHrb5i1c3e4OT6rJz3aF/O9yhIAGjxQNm9X2BWjdBOCYkZYjwHgj9AH0CxjCBRnHH6vGiRxKOFw+WfLhKrqcJhCoQjge2ganQhN/9ntC9S7xvv+oJbJPMe/zekYHSX4yYSqVSvlJ7B7OSAZ2c6l5FpuE2DLHGSMPIBgU3SaZNNuUuLBG/e+TNcDyQbYyKkkS7AQyomTCWsDodTGjNtdJDV23A2Pneuw2TXyFgBwMbARiQgBQ1s6FcEmapZCTWazH4IIDVjOtPmVcg20aXewVyrXTlBkzEre2S+Uj2P76QFECnQPwHGBdyMS+ALlSRcMzaD4ateGYe7Cj7/mcbo+3lzg5Mp4RkDBSJJ0ykDPPpLWuPTBceaoBkV1XFA2+XEP9GtbpCYRecSPRtAPBQUXFGvFYoPvs44hbUoXhHA5j5Pru4KyXP2taDn0Qdinc0QLJstIvP34TmwlhuP66WmkJuRo2Ld54BkqN2cZL0QuE22ZD4ymGz1DR+fuftqGHxjot4hF92cTyZAJA99MhDrYZfMuNnItwPYAcANVtmwTgOwoL+n4kPGywOSoik3zN8ttbEl+xiwlFrHwjvYzEQdoLxD4Av7NM02u4J9hQ/I7AbRAfs78kHVCeYOxU+o7q64vvytNoPLOWEWDglkp4ZdUChpncp5pn5Rb87NJx0z3wNxumKnv5/O+soXl3mWtlrIr6kAZ10It3u3vgMQC+p3bE6n8xLzxDREEn2dXhHPr1Sn3KZXUQ4BMKvAC4CiIPxAwPfYrHkiXcsqZL4ihp5dSA6u9ZsnrvU+Lc6B8AN8sMIYYX/NKbRaDQajUaj0Wg0Go1Go8EK4z+xLpJ3fRAUmgAAAABJRU5ErkJggg==";

package/src/cli/tray/tray.ts

@@ -0,0 +1,156 @@
+/**
+ * System tray icon. macOS/Linux use the lazy-installed `systray2` Go binary;
+ * Windows uses a PowerShell NotifyIcon (see trayWin). Menu: status · Open
+ * Dashboard · Auto-start toggle · Quit. The launcher owns the gateway +
+ * dashboard child processes, so Quit tears those down too.
+ */
+import { exec } from "node:child_process";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { getRuntimeNodeModules } from "./trayRuntime.js";
+import { TRAY_ICON_PNG_BASE64 } from "./icon.js";
+import { isAutoStartEnabled, enableAutoStart, disableAutoStart } from "./autostart.js";
+
+export interface TrayOptions {
+  /** dashboard URL opened by "Open Dashboard". */
+  dashboardUrl: string;
+  port: number;
+  onQuit: () => void;
+}
+
+interface SysTrayInstance {
+  onClick(cb: (action: { seq_id: number }) => void): void;
+  sendAction(action: unknown): void;
+  ready?: () => Promise<void>;
+  onReady?: (cb: () => void) => void;
+  onError?: (cb: () => void) => void;
+  kill(graceful?: boolean): void;
+}
+
+const MENU = { STATUS: 0, DASHBOARD: 1, AUTOSTART: 2, QUIT: 3 };
+let tray: SysTrayInstance | null = null;
+let winTray: { kill(): void; updateItem(i: number, t: string, e: boolean): void } | null = null;
+
+function openBrowser(url: string): void {
+  const cmd =
+    process.platform === "darwin" ? `open "${url}"` : process.platform === "win32" ? `start "" "${url}"` : `xdg-open "${url}"`;
+  exec(cmd);
+}
+
+function isTraySupported(): boolean {
+  if (!["darwin", "win32", "linux"].includes(process.platform)) return false;
+  if (process.platform === "linux" && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY) return false;
+  return true;
+}
+
+function menuItems(autostart: boolean): Array<{ title: string; tooltip: string; enabled: boolean }> {
+  return [
+    { title: `aigetwey (port ${0})`, tooltip: "gateway + dashboard running", enabled: false },
+    { title: "Open Dashboard", tooltip: "open the console in your browser", enabled: true },
+    { title: autostart ? "✓ Auto-start enabled" : "Enable auto-start", tooltip: "run on OS startup", enabled: true },
+    { title: "Quit", tooltip: "stop the gateway + dashboard and exit", enabled: true },
+  ];
+}
+
+function handleClick(index: number, opts: TrayOptions, onToggle: (enabled: boolean) => void): void {
+  if (index === MENU.DASHBOARD) {
+    openBrowser(opts.dashboardUrl);
+  } else if (index === MENU.AUTOSTART) {
+    const enabled = isAutoStartEnabled();
+    if (enabled) disableAutoStart();
+    else enableAutoStart();
+    onToggle(!enabled);
+  } else if (index === MENU.QUIT) {
+    opts.onQuit();
+    void killTray();
+    setTimeout(() => process.exit(0), 400);
+  }
+}
+
+/** Show the tray icon. Returns true if it started, false if unsupported/failed. */
+export function initTray(opts: TrayOptions): boolean {
+  if (!isTraySupported()) return false;
+  if (process.platform === "win32") return initWindowsTray(opts);
+  return initUnixTray(opts);
+}
+
+function initUnixTray(opts: TrayOptions): boolean {
+  try {
+    const require = createRequire(import.meta.url);
+    let SysTray: new (cfg: unknown) => SysTrayInstance;
+    try {
+      SysTray = require(join(getRuntimeNodeModules(), "systray2")).default;
+    } catch {
+      SysTray = require("systray2").default; // fallback to a local install
+    }
+    const autostart = isAutoStartEnabled();
+    const items = menuItems(autostart).map((it, i) =>
+      i === MENU.STATUS ? { ...it, title: `aigetwey (port ${opts.port})` } : it,
+    );
+    tray = new SysTray({
+      menu: {
+        icon: TRAY_ICON_PNG_BASE64,
+        isTemplateIcon: false,
+        title: "",
+        tooltip: `aigetwey — port ${opts.port}`,
+        items,
+      },
+      debug: false,
+      copyDir: true,
+    });
+    tray.onClick((action) => {
+      handleClick(action.seq_id, opts, (enabled) => {
+        tray?.sendAction({
+          type: "update-item",
+          item: { title: enabled ? "✓ Auto-start enabled" : "Enable auto-start", tooltip: "run on OS startup", enabled: true },
+          seq_id: MENU.AUTOSTART,
+        });
+      });
+    });
+    tray.ready?.().catch((e: unknown) =>
+      process.stderr.write(`  tray failed to start: ${(e as Error)?.message ?? e}\n`),
+    );
+    return true;
+  } catch (e) {
+    process.stderr.write(`  tray init error: ${(e as Error).message}\n`);
+    return false;
+  }
+}
+
+function initWindowsTray(opts: TrayOptions): boolean {
+  try {
+    const require = createRequire(import.meta.url);
+    const { initWinTray } = require("./trayWin.js") as {
+      initWinTray: (cfg: unknown) => { kill(): void; updateItem(i: number, t: string, e: boolean): void };
+    };
+    const autostart = isAutoStartEnabled();
+    winTray = initWinTray({
+      tooltip: `aigetwey - port ${opts.port}`,
+      items: menuItems(autostart).map((it, i) =>
+        i === MENU.STATUS ? { ...it, title: `aigetwey (port ${opts.port})` } : it,
+      ),
+      onClick: (index: number) =>
+        handleClick(index, opts, (enabled) =>
+          winTray?.updateItem(MENU.AUTOSTART, enabled ? "✓ Auto-start enabled" : "Enable auto-start", true),
+        ),
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/** Tear down the tray icon (graceful so macOS releases the menubar item). */
+export function killTray(): Promise<void> {
+  if (winTray) {
+    try { winTray.kill(); } catch { /* gone */ }
+    winTray = null;
+    return Promise.resolve();
+  }
+  const inst = tray;
+  tray = null;
+  if (!inst) return Promise.resolve();
+  try { inst.kill(true); } catch { /* gone */ }
+  try { inst.kill(false); } catch { /* gone */ }
+  return Promise.resolve();
+}

package/src/cli/tray/trayRuntime.ts

@@ -0,0 +1,90 @@
+/**
+ * Lazy-install the system-tray runtime (`systray2`) into a user data dir rather
+ * than the published npm tarball. systray2 ships a small Go binary; keeping it
+ * out of the tarball avoids antivirus false positives (e.g. Kaspersky) and
+ * per-arch packaging in the published package.
+ *
+ * macOS/Linux: install systray2 into ~/.aigetwey/runtime/node_modules.
+ * Windows: no binary — a PowerShell NotifyIcon is used instead (see trayWin).
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync, chmodSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const SYSTRAY_PKG = "systray2";
+const SYSTRAY_VERSION = "2.1.4";
+
+/** ~/.aigetwey (or %APPDATA%/aigetwey on Windows) — holds the tray runtime. */
+export function getRuntimeDir(): string {
+  const base =
+    process.platform === "win32"
+      ? process.env.APPDATA || homedir()
+      : homedir();
+  return join(base, process.platform === "win32" ? "aigetwey" : ".aigetwey", "runtime");
+}
+
+export function getRuntimeNodeModules(): string {
+  return join(getRuntimeDir(), "node_modules");
+}
+
+function trayBinName(): string | null {
+  if (process.platform === "darwin") return "tray_darwin_release";
+  if (process.platform === "linux") return "tray_linux_release";
+  return null; // windows uses powershell, no binary
+}
+
+/** systray2's tarball sometimes drops the +x bit on the Go binary → EACCES. */
+function chmodTrayBin(): void {
+  const bin = trayBinName();
+  if (!bin) return;
+  const p = join(getRuntimeNodeModules(), SYSTRAY_PKG, "traybin", bin);
+  try {
+    if (existsSync(p)) chmodSync(p, 0o755);
+  } catch {
+    /* best-effort */
+  }
+}
+
+export function hasSystray(): boolean {
+  return existsSync(join(getRuntimeNodeModules(), SYSTRAY_PKG, "package.json"));
+}
+
+function ensureRuntimeDir(): string {
+  const dir = getRuntimeDir();
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  const pkg = join(dir, "package.json");
+  if (!existsSync(pkg)) {
+    writeFileSync(pkg, JSON.stringify({ name: "aigetwey-runtime", version: "1.0.0", private: true }, null, 2));
+  }
+  return dir;
+}
+
+/**
+ * Make sure systray2 is installed (Windows skips — PowerShell needs no binary).
+ * Returns true if the tray runtime is ready. Best-effort: install failure just
+ * disables the tray, never crashes the launcher.
+ */
+export function ensureTrayRuntime({ silent = false } = {}): boolean {
+  if (process.platform === "win32") return true;
+  if (process.platform === "linux" && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY) {
+    return false; // no GUI session — a tray icon has nowhere to live
+  }
+  if (hasSystray()) {
+    chmodTrayBin();
+    return true;
+  }
+  const cwd = ensureRuntimeDir();
+  if (!silent) console.log("  installing system tray (first run)…");
+  const res = spawnSync("npm", ["install", `${SYSTRAY_PKG}@${SYSTRAY_VERSION}`, "--no-save", "--no-audit", "--no-fund"], {
+    cwd,
+    stdio: silent ? "ignore" : "inherit",
+    timeout: 120_000,
+  });
+  if (res.status !== 0) {
+    if (!silent) console.warn("  system tray install failed — tray disabled (everything else works).");
+    return false;
+  }
+  chmodTrayBin();
+  return hasSystray();
+}