HSA Companion

IDE-deep companion extension for DOMYH HSA — real-time AI agent monitoring, Telegram remote control, auto-accept for agent steps, and session completion tracking.
Part of the DOMYH Awesome Code Agent framework.

✨ Features

Feature	Description
📡 Telegram Remote Control	Full IDE control via Telegram bot — send prompts, observe AI progress, receive completion notifications
🤖 AI Agent Monitoring	Real-time tracking of AI agent steps via Antigravity SDK — file edits, terminal commands, diagnostics
✅ Auto-Accept	Automatic acceptance of AI agent steps, terminal commands, and code changes with safety filters
🔔 Session Completion	Event-driven agent completion detection with instant Telegram notifications and full response preview
🩺 Diagnostics Bridge	Real-time VS Code diagnostics streaming to HSA daemon
💻 Terminal Bridge	Command capture + multi-pattern error detection
📝 Editor Bridge	Active file context (cursor, selection, language)
📂 FileSystem Bridge	Workspace file change notifications
🔀 Git Bridge	Repository status, branch, and diff tracking (with polling fallback)
📊 Dashboard	Webview panel showing system status, auto-accept controls, and bridge health
🔌 WebSocket	Real-time bidirectional daemon communication with authentication
💉 Context Injection	Language-aware HSA guide injection (vi/en) with dedup and IPC toggle sync

📱 Telegram Commands

Command	Description
`/a <prompt>`	Send prompt to AI agent and stream live progress
`/do select <n>`	Observe AI agent session — live step tracking
`/do status`	Show current agent status and session info
`/do response`	Get last AI response
`/do accept`	Toggle auto-accept on/off
`/help`	Show all available commands

When agent is processing, new messages show an inline menu:

Button	Action
🕐 Queue	Send after current task finishes
⏹ Cancel + Send	Interrupt current task and send immediately
❌ Cancel	Dismiss without sending

🔧 Configuration

Setting	Default	Description
`hsa.daemon.port`	`13100`	HSA daemon HTTP port
`hsa.telegram.botToken`	—	Telegram Bot API token (encrypted in SecretStorage)
`hsa.telegram.allowedUsers`	`[]`	Authorized Telegram user IDs
`hsa.telegram.contextInjection.enabled`	`true`	Append HSA context to AI messages
`hsa.autoAccept.enabled`	`false`	Enable auto-accept feature
`hsa.dashboard.locale`	`"en"`	Dashboard language (en/vi)

⌨️ Commands

Command	Shortcut	Description
HSA: Show Dashboard	`Ctrl+Shift+H`	Open dashboard panel
HSA: Show Status	—	Show connection status
HSA: Restart Companion	—	Restart companion server

🏗 Architecture

┌─────────────────────────────────────────────────┐
│              HSA Companion Extension             │
│                                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────────┐   │
│  │ Bridges  │  │Auto-Accept│  │   Telegram   │   │
│  │ (7 total)│  │ Observer  │  │ Remote Ctrl  │   │
│  └────┬─────┘  └─────┬────┘  └──────┬───────┘   │
│       │              │              │            │
│  ┌────┴──────────────┴──────────────┴────┐       │
│  │         Companion IPC Server          │       │
│  └───────────────────┬───────────────────┘       │
│                      │ HTTP + WebSocket           │
└──────────────────────┼───────────────────────────┘
                       │
              ┌────────▼────────┐
              │   HSA Daemon    │
              │  (MCP Server)   │
              └─────────────────┘

🔒 Security

Token storage — Bot token stored in VS Code SecretStorage (encrypted)
WS authentication — Shared-secret auth with 5s timeout
Command validation — Blocks shell chaining, dangerous flags, and inline scripts
File access — Restricted to workspace root
Auto-accept safety — Skips buttons with dangerous words (delete, remove, drop, destroy)

📋 Requirements

VS Code 1.93+ / Antigravity IDE
HSA daemon running (default port: 13100)
Node.js ≥ 18.0.0

nockasdd