# Argus Local AI Pane — Implementation Handoff

## Context

Argus is a native Kotlin Android app (no Capacitor/React) that provides a multi-pane terminal/browser interface to a remote Claude Code server. It lives at `/home/claude/argus`. The active development branch is `dev`.

The previous session implemented a **Local AI pane** feature in v0.41.3. This doc explains what was done, how it works, and what's left to do.

---

## What Was Built (v0.41.3, commit `b13fb92` on `dev`)

### Overview

The AI tab in the "Add Pane" dialog already had a UI stub with GEMINI / ANTHROPIC / OPENAI / LOCAL provider buttons and a model list. The model list was stale (wrong models). The confirm button didn't actually work for AI panes. And `PaneView.kt` had no handling for `PaneType.AI`.

v0.41.3 wires all of this up for the LOCAL provider — pointing at Ollama on JONATHAN-PC at `10.0.0.199:11436`.

---

## Files Changed

### 1. NEW: `android/app/src/main/assets/local_ai.html`

A self-contained streaming chat UI bundled as an Android asset. Loaded into the pane's WebView via `loadDataWithBaseURL`.

**Features:**
- Dark theme with Argus orange `#C15F3C`
- 6 model picker buttons at top (tap to switch model, no reload)
- Scrolling message area above, `<textarea>` input pinned at bottom
- Streams from Ollama `/v1/chat/completions` SSE
- Multi-turn history maintained in JS `history[]` array
- Enter to send, Shift+Enter for newline
- Status bar shows current model

**Config injection:** Kotlin injects a `<script>` tag before `</head>` that sets:
```js
window.ARGUS_AI_ENDPOINT = "http://10.0.0.199:11436";
window.ARGUS_AI_MODEL    = "qwen3-coder:30b";
```
The HTML falls back to those same defaults if the vars are missing.

**Models hardcoded in the HTML** (match what's on JONATHAN-PC):
```
qwen3-coder:30b   → "Coder 30B"
qwen3:32b         → "General 32B"
qwen3.6:27b       → "Qwen3.6 27B"
qwen3.6:35b       → "Qwen3.6 35B"
deepseek-r1:32b   → "DeepSeek R1"
gemma4:31b        → "Gemma4 31B"
```

---

### 2. `android/app/src/main/java/network/domian/argus/PaneView.kt`

#### New private method: `loadAiPane(url: String)`

```kotlin
private fun loadAiPane(url: String) {
    try {
        val uri = android.net.Uri.parse(url)
        val endpoint = "${uri.scheme ?: "http"}://${uri.authority ?: "10.0.0.199:11436"}"
        val model = uri.getQueryParameter("argus_ai_model") ?: "qwen3-coder:30b"
        val html = context.assets.open("local_ai.html").bufferedReader().use { it.readText() }
        val safeModel = model.replace("\\", "\\\\").replace("\"", "\\\"")
        val script = "<script>window.ARGUS_AI_ENDPOINT=\"$endpoint\";window.ARGUS_AI_MODEL=\"$safeModel\";</script>"
        val injected = html.replace("</head>", "$script</head>")
        webView.loadDataWithBaseURL("$endpoint/", injected, "text/html", "UTF-8", null)
    } catch (e: Exception) {
        webView.loadUrl(url)
    }
}
```

**Why `loadDataWithBaseURL`?** Sets WebView's origin to the Ollama host so same-origin `fetch()` calls work without CORS errors. The fourth arg `null` for `historyUrl` means the back stack isn't affected.

#### `init` block — patched URL loading

Before:
```kotlin
if (!currentUrl.isBlank()) webView.loadUrl(currentUrl)
```

After:
```kotlin
if (!currentUrl.isBlank()) {
    if (paneType == PaneType.AI) loadAiPane(currentUrl)
    else webView.loadUrl(currentUrl)
}
```

#### `loadUrl()` function — patched

Before:
```kotlin
webView.loadUrl(url)
```

After:
```kotlin
if (paneType == PaneType.AI) loadAiPane(url) else webView.loadUrl(url)
```

---

### 3. `android/app/src/main/java/network/domian/argus/AddPaneDialog.kt`

#### a) LOCAL model list (was stale, replaced)

Old:
```kotlin
AiProvider.LOCAL to listOf(
    AiModel("llama32",   "llama3.2:latest",       ...),
    AiModel("mistral",   "mistral:latest",         ...),
    AiModel("codellama", "codellama:latest",       ...),
    AiModel("deepseek",  "deepseek-coder:latest",  ...),
)
```

New:
```kotlin
AiProvider.LOCAL to listOf(
    AiModel("qwen3coder", "qwen3-coder:30b",  "Qwen3 Coder — code & reasoning",    "local", "128K", "Local", "Coder",   "free"),
    AiModel("qwen3",      "qwen3:32b",        "Qwen3 32B — general purpose",        "local", "128K", "Local", "General", "free"),
    AiModel("qwen36_27b", "qwen3.6:27b",      "Qwen3.6 27B — multimodal",           "local", "64K",  "Local", "Qwen3.6", "free"),
    AiModel("qwen36_35b", "qwen3.6:35b",      "Qwen3.6 35B — multimodal, larger",   "local", "64K",  "Local", "Qwen3.6", "free"),
    AiModel("deepseek",   "deepseek-r1:32b",  "DeepSeek R1 — deep reasoning",       "local", "128K", "Local", "DeepSeek","free"),
    AiModel("gemma4",     "gemma4:31b",       "Gemma4 31B — Google open source",    "local", "128K", "Local", "Gemma",   "free"),
)
```

#### b) Default endpoint auto-fill

Added in `renderModels()`, just before the `aiLocalEndpoint.visibility` line:
```kotlin
if (provider == "local" && aiLocalEndpointUrl.text.isNullOrBlank()) {
    aiLocalEndpointUrl.setText("http://10.0.0.199:11436")
}
```

#### c) Confirm logic for AI panes

Added a new block at the top of the confirm button's `setOnClickListener`, BEFORE the existing `if (currentType == PaneType.TERMINAL)` block:

```kotlin
if (currentType == PaneType.AI) {
    if (currentAiProvider != AiProvider.LOCAL) {
        Toast.makeText(context, "Only Local AI is supported in this release", Toast.LENGTH_SHORT).show()
        return@setOnClickListener
    }
    val endpoint = aiLocalEndpointUrl.text?.toString()?.trim()
        ?.let { if (it.startsWith("http")) it else "http://$it" }
        ?: "http://10.0.0.199:11436"
    val modelName = AI_MODELS[AiProvider.LOCAL]?.find { it.id == currentAiModel }?.name
        ?: "qwen3-coder:30b"
    val paneUrl = "$endpoint?argus_ai_model=${android.net.Uri.encode(modelName)}"
    onConfirmResolved(paneUrl, PaneType.AI)
    dialog.dismiss()
    return@setOnClickListener
}
```

**URL format stored in `PaneState`:**
```
http://10.0.0.199:11436?argus_ai_model=qwen3-coder%3A30b
```

`PaneView.loadAiPane()` parses this: `authority` → endpoint, `argus_ai_model` query param → model name.

---

### 4. `android/app/build.gradle.kts`

```
versionCode = 162   (was 161)
versionName = "0.41.3"   (was "0.41.2")
```

---

## How to Build

```bash
# On Claude Server, sync to build server and build:
rsync -az --delete --exclude='.git' --exclude='app/build' --exclude='.gradle' \
  /home/claude/argus/android/ jonathan-domian@10.0.0.164:~/android-builds/argus/

ssh jonathan-domian@10.0.0.164 "bash -lc '
  export ANDROID_HOME=\$HOME/android-sdk
  cd ~/android-builds/argus
  ./gradlew assembleDebug
'"

# Pull APK and copy to downloads:
scp jonathan-domian@10.0.0.164:~/android-builds/argus/app/build/outputs/apk/debug/app-debug.apk \
  /tmp/argus-v0.41.3-debug.apk
scp /tmp/argus-v0.41.3-debug.apk root@10.0.0.102:/var/www/downloads/argus/argus-v0.41.3-debug.apk
```

APK URL: `https://downloads.domian.network/argus/argus-v0.41.3-debug.apk`

---

## Known Gaps / Next Steps

### 1. Pane header label is the raw URL
The pane header's `tvUrl` / `nhSubtitle` shows the raw URL (`10.0.0.199:11436`) for AI panes. It should show something like `Local AI · Coder 30B`. Fix is in `refreshNonTerminalHeader()` in `PaneView.kt` — add a `PaneType.AI` branch that parses `argus_ai_model` from the URL and formats it nicely.

### 2. GEMINI / ANTHROPIC / OPENAI tabs do nothing
The confirm button shows a "not supported" toast for non-LOCAL providers. These could be wired up later with their respective APIs.

### 3. No history persistence across reloads
The JS `history[]` array is in-memory. If the pane reloads (e.g., after a background kill), the conversation is lost. Could serialize to `localStorage` or pass state through the URL.

### 4. Model switcher in HTML vs dialog model picker
There are two places to pick a model: the dialog (which sets `ARGUS_AI_MODEL` at load time) and the in-pane button bar (which switches model mid-conversation in JS). They're independent — the dialog sets the initial model, the buttons override it at runtime without a reload. This is intentional but could be confusing.

### 5. `feature/local-ai-pane` branch is stale
The branch was created earlier but the commit landed on `dev` directly. The branch is at `595b36f` (v0.41.2). Either fast-forward it or delete it — it's not blocking anything.

---

## Relevant Infrastructure

| Thing | Detail |
|---|---|
| Ollama host | `http://10.0.0.199:11436` (JONATHAN-PC, Windows native) |
| Ollama API | OpenAI-compatible `/v1/chat/completions` |
| Available models | `qwen3-coder:30b`, `qwen3:32b`, `qwen3.6:27b`, `qwen3.6:35b`, `deepseek-r1:32b`, `gemma4:31b` |
| Android build server | `jonathan-domian@10.0.0.164`, Android SDK at `~/android-sdk` |
| Build dir on server | `~/android-builds/argus/` |
| Downloads server | `root@10.0.0.102:/var/www/downloads/argus/` |
| Downloads URL | `https://downloads.domian.network/argus/` |
| Argus repo | `/home/claude/argus`, remote: `https://github.com/jdomian/argus.git` |
| Active branch | `dev` |