@johpaz/hive-agents 0.0.38 → 0.0.40

package/packages/core/src/gateway/llm-local/downloader.ts

@@ -18,22 +18,116 @@ export const MODELS_DIR = join(LLM_ROOT, "models")
 if (!existsSync(BIN_DIR)) mkdirSync(BIN_DIR, { recursive: true })
 if (!existsSync(MODELS_DIR)) mkdirSync(MODELS_DIR, { recursive: true })
 
-/** URLs de modelos en HuggingFace (Gemma 4 según GUIA-SERVIDOR.md) */
+/** URLs de modelos en HuggingFace (Gemma 4 y Qwen 3.5 según Unsloth) */
 export const HF_MODEL_URLS = {
+  // mmproj legacy (E4B)
   mmproj: "https://huggingface.co/unsloth/gemma-4-E4B-it-GGUF/resolve/main/mmproj-BF16.gguf",
+  // mmproj Gemma 4
+  mmproj_gemma4_12b: "https://huggingface.co/unsloth/gemma-4-12b-it-GGUF/resolve/main/mmproj-BF16.gguf",
+  mmproj_gemma4_26b: "https://huggingface.co/unsloth/gemma-4-26B-A4B-it-GGUF/resolve/main/mmproj-BF16.gguf",
+  mmproj_gemma4_31b: "https://huggingface.co/unsloth/gemma-4-31B-it-GGUF/resolve/main/mmproj-BF16.gguf",
+  // mmproj Qwen 3.5
+  mmproj_qwen3_5_2b: "https://huggingface.co/unsloth/Qwen3.5-2B-GGUF/resolve/main/mmproj-F16.gguf",
+  mmproj_qwen3_5_4b: "https://huggingface.co/unsloth/Qwen3.5-4B-GGUF/resolve/main/mmproj-F16.gguf",
+  mmproj_qwen3_5_9b: "https://huggingface.co/unsloth/Qwen3.5-9B-GGUF/resolve/main/mmproj-F16.gguf",
+  mmproj_qwen3_5_27b: "https://huggingface.co/unsloth/Qwen3.5-27B-GGUF/resolve/main/mmproj-F16.gguf",
+  mmproj_qwen3_5_35b: "https://huggingface.co/unsloth/Qwen3.5-35B-A3B-GGUF/resolve/main/mmproj-F16.gguf",
+  // modelos Gemma 4
   e2b_Q4_K_XL: "https://huggingface.co/unsloth/gemma-4-E2B-it-GGUF/resolve/main/gemma-4-E2B-it-UD-Q4_K_XL.gguf",
-  e4b_Q4_K_XL: "https://huggingface.co/unsloth/gemma-4-E4B-it-GGUF/resolve/main/gemma-4-E4B-it-UD-Q4_K_XL.gguf"
+  e4b_Q4_K_XL: "https://huggingface.co/unsloth/gemma-4-E4B-it-GGUF/resolve/main/gemma-4-E4B-it-UD-Q4_K_XL.gguf",
+  gemma4_12b_Q4_K_XL: "https://huggingface.co/unsloth/gemma-4-12b-it-GGUF/resolve/main/gemma-4-12b-it-UD-Q4_K_XL.gguf",
+  gemma4_26b_Q4_K_M: "https://huggingface.co/unsloth/gemma-4-26B-A4B-it-GGUF/resolve/main/gemma-4-26B-A4B-it-UD-Q4_K_M.gguf",
+  gemma4_31b_Q4_K_XL: "https://huggingface.co/unsloth/gemma-4-31B-it-GGUF/resolve/main/gemma-4-31B-it-UD-Q4_K_XL.gguf",
+  // modelos Qwen 3.5
+  qwen3_5_2b_Q4_K_XL: "https://huggingface.co/unsloth/Qwen3.5-2B-GGUF/resolve/main/Qwen3.5-2B-UD-Q4_K_XL.gguf",
+  qwen3_5_4b_Q4_K_XL: "https://huggingface.co/unsloth/Qwen3.5-4B-GGUF/resolve/main/Qwen3.5-4B-UD-Q4_K_XL.gguf",
+  qwen3_5_9b_Q4_K_XL: "https://huggingface.co/unsloth/Qwen3.5-9B-GGUF/resolve/main/Qwen3.5-9B-UD-Q4_K_XL.gguf",
+  qwen3_5_27b_Q4_K_XL: "https://huggingface.co/unsloth/Qwen3.5-27B-GGUF/resolve/main/Qwen3.5-27B-UD-Q4_K_XL.gguf",
+  qwen3_5_35b_Q4_K_XL: "https://huggingface.co/unsloth/Qwen3.5-35B-A3B-GGUF/resolve/main/Qwen3.5-35B-A3B-UD-Q4_K_XL.gguf",
 }
 
-export type ModelId = "mmproj" | "e2b_Q4_K_XL" | "e4b_Q4_K_XL"
+export type ModelId =
+  | "mmproj"
+  | "mmproj_gemma4_12b"
+  | "mmproj_gemma4_26b"
+  | "mmproj_gemma4_31b"
+  | "mmproj_qwen3_5_2b"
+  | "mmproj_qwen3_5_4b"
+  | "mmproj_qwen3_5_9b"
+  | "mmproj_qwen3_5_27b"
+  | "mmproj_qwen3_5_35b"
+  | "e2b_Q4_K_XL"
+  | "e4b_Q4_K_XL"
+  | "gemma4_12b_Q4_K_XL"
+  | "gemma4_26b_Q4_K_M"
+  | "gemma4_31b_Q4_K_XL"
+  | "qwen3_5_2b_Q4_K_XL"
+  | "qwen3_5_4b_Q4_K_XL"
+  | "qwen3_5_9b_Q4_K_XL"
+  | "qwen3_5_27b_Q4_K_XL"
+  | "qwen3_5_35b_Q4_K_XL"
 
 /** Modelos que requieren proyector de visión (mmproj) */
-export const VISION_MODELS: ModelId[] = ["e4b_Q4_K_XL"]
+export const VISION_MODELS: ModelId[] = [
+  "e4b_Q4_K_XL",
+  "gemma4_12b_Q4_K_XL",
+  "gemma4_26b_Q4_K_M",
+  "gemma4_31b_Q4_K_XL",
+  "qwen3_5_2b_Q4_K_XL",
+  "qwen3_5_4b_Q4_K_XL",
+  "qwen3_5_9b_Q4_K_XL",
+  "qwen3_5_27b_Q4_K_XL",
+  "qwen3_5_35b_Q4_K_XL",
+]
+
+/** Mapeo de cada modelo a su mmproj correspondiente */
+export const MODEL_MMPROJ_MAP: Record<ModelId, ModelId | undefined> = {
+  mmproj: undefined,
+  mmproj_gemma4_12b: undefined,
+  mmproj_gemma4_26b: undefined,
+  mmproj_gemma4_31b: undefined,
+  mmproj_qwen3_5_2b: undefined,
+  mmproj_qwen3_5_4b: undefined,
+  mmproj_qwen3_5_9b: undefined,
+  mmproj_qwen3_5_27b: undefined,
+  mmproj_qwen3_5_35b: undefined,
+  e2b_Q4_K_XL: undefined,
+  e4b_Q4_K_XL: "mmproj",
+  gemma4_12b_Q4_K_XL: "mmproj_gemma4_12b",
+  gemma4_26b_Q4_K_M: "mmproj_gemma4_26b",
+  gemma4_31b_Q4_K_XL: "mmproj_gemma4_31b",
+  qwen3_5_2b_Q4_K_XL: "mmproj_qwen3_5_2b",
+  qwen3_5_4b_Q4_K_XL: "mmproj_qwen3_5_4b",
+  qwen3_5_9b_Q4_K_XL: "mmproj_qwen3_5_9b",
+  qwen3_5_27b_Q4_K_XL: "mmproj_qwen3_5_27b",
+  qwen3_5_35b_Q4_K_XL: "mmproj_qwen3_5_35b",
+}
+
+/** Devuelve el ID del mmproj asociado a un modelo, o undefined si no requiere visión */
+export function getModelMMProjId(modelId: ModelId): ModelId | undefined {
+  return MODEL_MMPROJ_MAP[modelId]
+}
 
 export const MODEL_FILES: Record<ModelId, string> = {
   mmproj: "mmproj-BF16.gguf",
+  mmproj_gemma4_12b: "mmproj-gemma4-12b-BF16.gguf",
+  mmproj_gemma4_26b: "mmproj-gemma4-26b-BF16.gguf",
+  mmproj_gemma4_31b: "mmproj-gemma4-31b-BF16.gguf",
+  mmproj_qwen3_5_2b: "mmproj-qwen3.5-2b-F16.gguf",
+  mmproj_qwen3_5_4b: "mmproj-qwen3.5-4b-F16.gguf",
+  mmproj_qwen3_5_9b: "mmproj-qwen3.5-9b-F16.gguf",
+  mmproj_qwen3_5_27b: "mmproj-qwen3.5-27b-F16.gguf",
+  mmproj_qwen3_5_35b: "mmproj-qwen3.5-35b-F16.gguf",
   e2b_Q4_K_XL: "gemma-4-E2B-it-UD-Q4_K_XL.gguf",
   e4b_Q4_K_XL: "gemma-4-E4B-it-UD-Q4_K_XL.gguf",
+  gemma4_12b_Q4_K_XL: "gemma-4-12b-it-UD-Q4_K_XL.gguf",
+  gemma4_26b_Q4_K_M: "gemma-4-26B-A4B-it-UD-Q4_K_M.gguf",
+  gemma4_31b_Q4_K_XL: "gemma-4-31B-it-UD-Q4_K_XL.gguf",
+  qwen3_5_2b_Q4_K_XL: "Qwen3.5-2B-UD-Q4_K_XL.gguf",
+  qwen3_5_4b_Q4_K_XL: "Qwen3.5-4B-UD-Q4_K_XL.gguf",
+  qwen3_5_9b_Q4_K_XL: "Qwen3.5-9B-UD-Q4_K_XL.gguf",
+  qwen3_5_27b_Q4_K_XL: "Qwen3.5-27B-UD-Q4_K_XL.gguf",
+  qwen3_5_35b_Q4_K_XL: "Qwen3.5-35B-A3B-UD-Q4_K_XL.gguf",
 }
 
 export function getModelPath(modelId: ModelId): string {
@@ -65,13 +159,14 @@ export async function downloadFile(
       const { done, value } = await reader.read()
       if (done) break
 
-      writer.write(value)
+      await writer.write(value)
       downloaded += value.byteLength
       if (onProgress) onProgress(downloaded, total)
     }
+    await writer.flush()
     await writer.end()
   } catch (err) {
-    await writer.end()
+    try { await writer.end() } catch { /* ignore */ }
     throw err
   }
 }
@@ -191,9 +286,10 @@ export async function downloadModel(
   await downloadFile(url, dest, onProgress)
   console.log(`[hive-local] ✓ Modelo ${modelId} descargado`)
 
-  // Advertir si el modelo requiere visión y no tenemos mmproj (NO descargar automáticamente)
-  if (VISION_MODELS.includes(modelId) && !isModelDownloaded("mmproj")) {
-    console.warn(`[hive-local] ⚠️ El modelo ${modelId} requiere el proyector de visión (mmproj). Descárgalo manualmente desde la UI.`)
+  // Advertir si el modelo requiere visión y no tenemos su mmproj (NO descargar automáticamente)
+  const mmprojId = getModelMMProjId(modelId)
+  if (mmprojId && !isModelDownloaded(mmprojId)) {
+    console.warn(`[hive-local] ⚠️ El modelo ${modelId} requiere el proyector de visión (${mmprojId}). Descárgalo manualmente desde la UI.`)
   }
 
   return dest
@@ -206,11 +302,34 @@ export async function installMMProj(): Promise<string> {
 
 /** Lista modelos disponibles localmente (solo modelos de texto/visión finales) */
 export function listLocalModels(): { id: ModelId; name: string; size: string; downloaded: boolean }[] {
-  const models: ModelId[] = ["e2b_Q4_K_XL", "e4b_Q4_K_XL"]
+  const models: ModelId[] = [
+    "e2b_Q4_K_XL",
+    "e4b_Q4_K_XL",
+    "gemma4_12b_Q4_K_XL",
+    "gemma4_26b_Q4_K_M",
+    "gemma4_31b_Q4_K_XL",
+    "qwen3_5_2b_Q4_K_XL",
+    "qwen3_5_4b_Q4_K_XL",
+    "qwen3_5_9b_Q4_K_XL",
+    "qwen3_5_27b_Q4_K_XL",
+    "qwen3_5_35b_Q4_K_XL",
+  ]
+  const sizeMap: Record<string, string> = {
+    e2b_Q4_K_XL: "~3 GB",
+    e4b_Q4_K_XL: "~5 GB",
+    gemma4_12b_Q4_K_XL: "~7 GB",
+    gemma4_26b_Q4_K_M: "~10 GB",
+    gemma4_31b_Q4_K_XL: "~14 GB",
+    qwen3_5_2b_Q4_K_XL: "~1.2 GB",
+    qwen3_5_4b_Q4_K_XL: "~2.5 GB",
+    qwen3_5_9b_Q4_K_XL: "~5.4 GB",
+    qwen3_5_27b_Q4_K_XL: "~16 GB",
+    qwen3_5_35b_Q4_K_XL: "~21 GB",
+  }
   return models.map((id) => ({
     id,
     name: MODEL_FILES[id],
-    size: id.includes("Q4_K_XL") ? "~5-8 GB" : "~2-3 GB",
+    size: sizeMap[id] || "~?",
     downloaded: isModelDownloaded(id),
   }))
 }

package/packages/core/src/gateway/llm-local/index.ts

@@ -15,9 +15,11 @@ export {
   listLocalModels,
   isModelDownloaded,
   getModelPath,
+  getModelMMProjId,
   BIN_DIR,
   MODELS_DIR,
   HF_MODEL_URLS,
+  MODEL_MMPROJ_MAP,
 } from "./downloader"
 export type { ModelId } from "./downloader"
 

package/packages/core/src/gateway/llm-local/models.ts

@@ -5,7 +5,7 @@
 
 
 import { existsSync } from "fs"
-import { MODELS_DIR, getModelPath, type ModelId } from "./downloader"
+import { MODELS_DIR, getModelPath, getModelMMProjId, type ModelId } from "./downloader"
 
 export interface ModelConfig {
   modelPath: string
@@ -43,8 +43,9 @@ export function getModelConfig(modelId: ModelId, port: number = 8081): ModelConf
     throw new Error(`Modelo no descargado: ${modelId}. Ejecuta downloadModel("${modelId}") primero.`)
   }
 
-  const mmprojPath = getModelPath("mmproj")
-  const hasMMProj = existsSync(mmprojPath)
+  const mmprojId = getModelMMProjId(modelId)
+  const mmprojPath = mmprojId ? getModelPath(mmprojId) : undefined
+  const hasMMProj = mmprojPath ? existsSync(mmprojPath) : false
 
   return {
     modelPath,

package/packages/core/src/gateway/router.ts

@@ -1,4 +1,6 @@
 import type { Config, Binding } from "../config/loader.ts";
+import { homedir } from "node:os";
+import * as path from "node:path";
 
 export interface RoutingContext {
   channel: string;
@@ -113,12 +115,12 @@ export class Router {
     const agent = agents.find((a) => a.id === agentId);
     
     if (agent?.workspace) {
-      return agent.workspace.replace(/^~/, process.env.HOME ?? "");
+      return agent.workspace.replace(/^~/, homedir());
     }
 
-    const baseDir = this.config.agent?.baseDir?.replace(/^~/, process.env.HOME ?? "") 
-      ?? `${process.env.HOME}/.hive/agents`;
-    
-    return `${baseDir}/${agentId}/workspace`;
+    const baseDir = this.config.agent?.baseDir?.replace(/^~/, homedir())
+      ?? path.join(homedir(), ".hive", "agents");
+
+    return path.join(baseDir, agentId, "workspace");
   }
 }

package/packages/core/src/gateway/routes/http-client.ts

@@ -0,0 +1,16 @@
+import { apiRequestTool } from "../../tools/api/api-request.ts";
+
+export async function handleHttpRequest(req: Request, addCorsHeaders: (r: Response, req: Request) => Response): Promise<Response> {
+  try {
+    const body = await req.json().catch(() => ({}));
+
+    const result = await apiRequestTool.execute(body, { configurable: {} });
+
+    return addCorsHeaders(Response.json(result), req);
+  } catch (error) {
+    return addCorsHeaders(Response.json({
+      ok: false,
+      error: `Request failed: ${(error as Error).message}`,
+    }), req);
+  }
+}

package/packages/core/src/gateway/routes/llm-local.ts

@@ -19,6 +19,15 @@ let installing = false
 let installLogs: string[] = []
 let downloadingModelId: string | null = null
 
+interface DownloadProgress {
+  modelId: string
+  downloaded: number
+  total: number
+  percent: number
+}
+
+let currentDownloadProgress: DownloadProgress | null = null
+
 async function getInstalledStatus() {
   const { LLAMA_CPP_DEFAULT_VER } = await import("../llm-local/detector")
   const gpu = await detectGPU()
@@ -183,7 +192,12 @@ export async function handleDownloadLLMModel(
   ;(async () => {
     try {
       await downloadModel(modelId, (d, t) => {
-        // Opcional: Podríamos emitir eventos por WS si quisiéramos progreso real en UI
+        currentDownloadProgress = {
+          modelId,
+          downloaded: d,
+          total: t,
+          percent: t > 0 ? Math.round((d / t) * 100) : 0,
+        }
       })
       installLogs.push(`✓ Modelo ${modelId} descargado exitosamente`)
     } catch (err) {
@@ -191,6 +205,7 @@ export async function handleDownloadLLMModel(
       installLogs.push(`[error] Error descargando ${modelId}: ${msg}`)
     } finally {
       downloadingModelId = null
+      currentDownloadProgress = null
     }
   })()
 
@@ -207,7 +222,15 @@ export async function handleStartLocalLLM(
   } catch { /* ignore if no body */ }
 
   const mode = body.mode || "TEXT"
-  const modelId = body.modelId || getRecommendedModel(mode.toLowerCase() as any)
+  // If no modelId specified, prefer the recommended model; fall back to the
+  // first downloaded model so the user doesn't get an error when they only
+  // downloaded a non-default model.
+  const recommended = getRecommendedModel(mode.toLowerCase() as any)
+  const allModels = listLocalModels()
+  const downloadedModels = allModels.filter(m => m.downloaded)
+  const resolvedModelId: string =
+    body.modelId ||
+    (downloadedModels.find(m => m.id === recommended) ? recommended : (downloadedModels[0]?.id ?? recommended))
 
   const status = await getInstalledStatus()
   if (!status.installed && !status.binaryExists) {
@@ -217,11 +240,18 @@ export async function handleStartLocalLLM(
     )
   }
 
+  if (downloadedModels.length === 0) {
+    return addCors(
+      Response.json({ started: false, reason: "No hay modelos descargados. Descarga un modelo primero desde la sección de modelos." }, { status: 400 }),
+      req
+    )
+  }
+
   try {
-    installLogs.push(`[llm-server] Iniciando servidor en modo ${mode} con modelo ${modelId}...`)
-    await llamaManager.start(mode, modelId as any)
+    installLogs.push(`[llm-server] Iniciando servidor en modo ${mode} con modelo ${resolvedModelId}...`)
+    await llamaManager.start(mode, resolvedModelId as any)
     installLogs.push(`[llm-server] Servidor ${mode} iniciado correctamente.`)
-    return addCors(Response.json({ started: true, mode }), req)
+    return addCors(Response.json({ started: true, mode, modelId: resolvedModelId }), req)
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err)
     installLogs.push(`[error] Servidor LLM falló al iniciar: ${msg}`)
@@ -251,6 +281,22 @@ export async function handleStopLocalLLM(
  * Verifica el estado del LLM local al iniciar el gateway.
  * NO auto-inicia el servidor ni descarga nada — el usuario debe hacerlo manualmente.
  */
+export async function handleGetDownloadProgress(
+  req: Request,
+  addCors: (r: Response, req: Request) => Response
+): Promise<Response> {
+  if (!currentDownloadProgress) {
+    return addCors(Response.json({ active: false }), req)
+  }
+  return addCors(
+    Response.json({
+      active: true,
+      ...currentDownloadProgress,
+    }),
+    req
+  )
+}
+
 export async function initializeLocalLLM() {
   try {
     const status = await getInstalledStatus()

package/packages/core/src/gateway/routes/providers.ts

@@ -4,6 +4,11 @@ import {
   loadProviderApiKey, storeProviderApiKey,
   loadProviderHeaders, storeProviderHeaders,
 } from "../../storage/crypto"
+import { listLocalModels } from "../llm-local/downloader"
+import { loadHiveAgentsModel, getHiveAgentsModelStatus } from "../../agent/llm-providers/hiveagents"
+import { logger } from "../../utils/logger"
+
+const log = logger.child("gateway")
 
 export async function handleGetProviders(req: Request, addCorsHeaders: (r: Response, req: Request) => Response): Promise<Response> {
   const rawProviders = getDb().query(`
@@ -24,20 +29,60 @@ export async function handleGetProviders(req: Request, addCorsHeaders: (r: Respo
     })
   }
 
+  // Inyectar modelos locales descargados dinámicamente para local-llama
+  try {
+    const localModels = listLocalModels()
+    const downloadedLocalModels = localModels.filter(m => m.downloaded)
+    if (downloadedLocalModels.length > 0) {
+      const existingLocalModels = modelsByProvider["local-llama"] || []
+      for (const localModel of downloadedLocalModels) {
+        const existingIdx = existingLocalModels.findIndex((m: any) => m.id === localModel.id)
+        if (existingIdx === -1) {
+          existingLocalModels.push({
+            id: localModel.id,
+            name: localModel.name,
+            provider_id: "local-llama",
+            model_type: "llm",
+            context_window: 16000,
+            capabilities: JSON.stringify(["chat", "local"]),
+            enabled: true,
+            active: true,
+          })
+        } else {
+          // Modelo del seed ya existe pero está descargado: forzar activo
+          existingLocalModels[existingIdx] = {
+            ...existingLocalModels[existingIdx],
+            enabled: true,
+            active: true,
+          }
+        }
+      }
+      modelsByProvider["local-llama"] = existingLocalModels
+    }
+  } catch {
+    // Ignorar si no se pueden obtener modelos locales
+  }
+
   const providers = await Promise.all(rawProviders.map(async (p) => {
     const apiKey = await loadProviderApiKey(p.id as string)
     const headers = await loadProviderHeaders(p.id as string)
+    const providerModels = modelsByProvider[p.id as string] || []
+    // Auto-activar local-llama si tiene modelos descargados dinámicamente
+    let active = p.active
+    if (p.id === "local-llama" && providerModels.some((m: any) => m.active || m.enabled)) {
+      active = true
+    }
     return {
       id: p.id,
       name: p.name,
       base_url: p.base_url,
       enabled: p.enabled,
-      active: p.active,
+      active,
       num_ctx: p.num_ctx ?? null,
       has_api_key: apiKey ? 1 : 0,
       has_headers: Object.keys(headers).length > 0 ? 1 : 0,
       masked_api_key: apiKey ? maskApiKey(apiKey) : null,
-      models: modelsByProvider[p.id as string] || [],
+      models: providerModels,
     }
   }))
 
@@ -218,3 +263,55 @@ export async function handleSyncProviderModels(
     }, { status: 502 }), req)
   }
 }
+
+export async function handleLoadHiveAgentsModel(
+  req: Request,
+  addCorsHeaders: (r: Response, req: Request) => Response
+): Promise<Response> {
+  const body = await req.json().catch(() => ({}))
+  const modelId = body.model_id || body.modelId
+  const ctx = typeof body.ctx === "number" && body.ctx > 0 ? body.ctx : 50000
+  if (!modelId) {
+    return addCorsHeaders(Response.json({ error: "model_id is required" }, { status: 400 }), req)
+  }
+
+  const providerRow = getDb().query("SELECT * FROM providers WHERE id = ?").get("hiveagents") as Record<string, unknown> | undefined
+  if (!providerRow) {
+    return addCorsHeaders(Response.json({ error: "Provider not found" }, { status: 404 }), req)
+  }
+
+  const apiKey = await loadProviderApiKey("hiveagents")
+  if (!apiKey) {
+    return addCorsHeaders(Response.json({ error: "API key not configured for hiveagents" }, { status: 400 }), req)
+  }
+
+  const baseUrl = providerRow.base_url as string | undefined
+  log.info(`[gateway] Loading hiveagents model ${modelId} with ctx=${ctx} via ${baseUrl || "https://llm.hiveagents.io"}`)
+
+  const result = await loadHiveAgentsModel(modelId as string, apiKey, baseUrl, ctx)
+  if (!result.success) {
+    log.error(`[gateway] Failed to load hiveagents model ${modelId}: ${result.error}`)
+    return addCorsHeaders(Response.json({ error: result.error }, { status: 502 }), req)
+  }
+  const isLoading = (result as any).loading === true
+  log.info(`[gateway] hiveagents load request accepted for ${modelId} with ctx=${ctx}${isLoading ? " (timeout/backend still loading)" : ""}`)
+  return addCorsHeaders(Response.json({ success: true, loading: isLoading, model_id: modelId, ctx }), req)
+}
+
+export async function handleGetHiveAgentsModelStatus(
+  req: Request,
+  addCorsHeaders: (r: Response, req: Request) => Response
+): Promise<Response> {
+  const providerRow = getDb().query("SELECT * FROM providers WHERE id = ?").get("hiveagents") as Record<string, unknown> | undefined
+  if (!providerRow) {
+    return addCorsHeaders(Response.json({ error: "Provider not found" }, { status: 404 }), req)
+  }
+
+  const apiKey = await loadProviderApiKey("hiveagents")
+  if (!apiKey) {
+    return addCorsHeaders(Response.json({ error: "API key not configured for hiveagents" }, { status: 400 }), req)
+  }
+
+  const status = await getHiveAgentsModelStatus(apiKey, providerRow.base_url as string | undefined)
+  return addCorsHeaders(Response.json({ success: true, ...status }), req)
+}