jim800121chen 3f0175f1a9 feat(local-agent): Phase 0.5 visionA Agent — Wails 桌面 + tunnel client + 配對 UI
從 local-tool 複製出獨立的「visionA Agent」桌面應用(A3 純橋樑:
tunnel client + 配對 UI + 設定,不開 HTTP port、不做本機裝置/推論 UI)。
Bundle ID 與 local-tool 不同(com.innovedus.visiona-agent vs visiona-local),
雙 app 可共存。fork 後不主動 sync,需要時手動 cherry-pick。

Backend / Wails Go(AB1-AB13):
- internal/tunnel:6 狀態機(Idle/Connecting/Connected/Reconnecting/Failed/Stopped)
  + Pair/Unpair/Reconnect/Disconnect binding + ClientHooks event
- internal/auth:encrypted file token store(AES-GCM + scrypt + machineID
  fallback salt + 13 tests)
- internal/config:YAML validation + atomic write + 11 tests
- internal/log:ring buffer + ExportLog 升級 zip
- visionA-backend /api/pairing/exchange:SessionTokenStore + 17 new tests
- 三平台 build 驗證(macOS DMG 160 MB / Windows EXE / Linux AppImage)
- end-to-end 5 milestone 全綠(pairing → tunnel → forward → reuse 防護
  → tunnel drop failover)

Frontend / Next.js(AF1-AF7,沿用 visionA-frontend 基礎):
- AppShell + Header + TabNav(StatusView / PairView / SettingsView 三 tab)
- ConnectionStatusBadge 5 種狀態
- TokenInput regex 驗證 + 7 種錯誤 + 0.5s auto-switch 到狀態頁
- 設定頁 4 區塊(含重新配對 AlertDialog)
- agent-api.ts 封裝 Wails bindings(mock/real 雙實作)+ 90 tests

Phase 0.7 review-driven fix(Round 2):
- A1 Session fixation 防護(RotateSessionID)
- A3 mock pairing 預設改 false(必須明確 opt-in)+ startup log
- A4 Pair 失敗後 state 清理矩陣(exchange/Save/Start fail 各自終態)
- A5 Pair/Unpair/Reconnect lifecycleMu + 50 goroutine race test
- F1 重新配對次按鈕 / F2 PairView Esc cancel / F3 Wails BrowserOpenURL
  / F4 Settings draft 持久 + 未儲存 badge

驗證:agent backend go test -race -count=3 ./... 4 packages 全綠 /
agent frontend pnpm test 119 tests 全綠

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 11:22:01 +08:00

170 lines
4.7 KiB
TypeScript
Executable File

export namespace main {
export class AgentSettings {
relayUrl: string;
autoStart: boolean;
reconnectStrategy: string;
logLevel: string;
static createFrom(source: any = {}) {
return new AgentSettings(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.relayUrl = source["relayUrl"];
this.autoStart = source["autoStart"];
this.reconnectStrategy = source["reconnectStrategy"];
this.logLevel = source["logLevel"];
}
}
export class ConnectionStatus {
state: string;
error?: string;
attemptNo?: number;
relayUrl: string;
account?: string;
connectedSince?: number;
lastSeenAt?: number;
sessionTokenPreview?: string;
static createFrom(source: any = {}) {
return new ConnectionStatus(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.state = source["state"];
this.error = source["error"];
this.attemptNo = source["attemptNo"];
this.relayUrl = source["relayUrl"];
this.account = source["account"];
this.connectedSince = source["connectedSince"];
this.lastSeenAt = source["lastSeenAt"];
this.sessionTokenPreview = source["sessionTokenPreview"];
}
}
export class LogLine {
ts: number;
stream: string;
line: string;
level?: string;
static createFrom(source: any = {}) {
return new LogLine(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.ts = source["ts"];
this.stream = source["stream"];
this.line = source["line"];
this.level = source["level"];
}
}
export class Preferences {
autoOpenBrowser: boolean;
locale?: string;
logRingSize?: number;
static createFrom(source: any = {}) {
return new Preferences(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.autoOpenBrowser = source["autoOpenBrowser"];
this.locale = source["locale"];
this.logRingSize = source["logRingSize"];
}
}
export class ServerStatus {
running: boolean;
port: number;
url: string;
pid: number;
pythonBin: string;
pythonMode: string;
lastError?: string;
static createFrom(source: any = {}) {
return new ServerStatus(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.running = source["running"];
this.port = source["port"];
this.url = source["url"];
this.pid = source["pid"];
this.pythonBin = source["pythonBin"];
this.pythonMode = source["pythonMode"];
this.lastError = source["lastError"];
}
}
export class ServerStatusV2 {
state: string;
port?: number;
url?: string;
pid?: number;
pythonBin?: string;
pythonMode?: string;
startedAt?: number;
lastError?: string;
static createFrom(source: any = {}) {
return new ServerStatusV2(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.state = source["state"];
this.port = source["port"];
this.url = source["url"];
this.pid = source["pid"];
this.pythonBin = source["pythonBin"];
this.pythonMode = source["pythonMode"];
this.startedAt = source["startedAt"];
this.lastError = source["lastError"];
}
}
export class SystemInfo {
appVersion: string;
buildTime: string;
dataDir: string;
logsDir: string;
platform: string;
static createFrom(source: any = {}) {
return new SystemInfo(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.appVersion = source["appVersion"];
this.buildTime = source["buildTime"];
this.dataDir = source["dataDir"];
this.logsDir = source["logsDir"];
this.platform = source["platform"];
}
}
export class TestResult {
ok: boolean;
latencyMs?: number;
reason?: string;
static createFrom(source: any = {}) {
return new TestResult(source);
}
constructor(source: any = {}) {
if ('string' === typeof source) source = JSON.parse(source);
this.ok = source["ok"];
this.latencyMs = source["latencyMs"];
this.reason = source["reason"];
}
}
}