@hilbras/omnihilbras 2.9.11 → 2.9.13

package/cli/app/package.json

@@ -1,16 +1,17 @@
 {
-  "name": "omnihilbras-app",
-  "version": "2.9.8",
+  "name": "@hilbras/omnihilbras",
+  "version": "2.9.12",
   "description": "OmniHilbras web dashboard",
-  "private": true,
   "scripts": {
     "dev": "next dev --port 20127",
     "dev:webpack": "next dev --webpack --port 20127",
+    "prebuild": "node scripts/build-skills-index.mjs",
     "build": "next build --webpack",
     "postbuild": "node scripts/copy-standalone-assets.mjs",
     "postbuild:bun": "node scripts/copy-standalone-assets.mjs",
     "start": "node custom-server.js --port 20127",
     "dev:bun": "bun --bun next dev --webpack --port 20127",
+    "prebuild:bun": "node scripts/build-skills-index.mjs",
     "build:bun": "bun --bun next build --webpack",
     "start:bun": "bun ./.next/standalone/custom-server.js",
     "cli:pack": "npm --prefix cli run pack:cli",

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hilbras/omnihilbras",
-  "version": "2.9.8",
+  "version": "2.9.13",
   "description": "OmniHilbras CLI - Start and manage OmniHilbras server",
   "bin": {
     "omnihilbras": "./cli.js"

package/open-sse/executors/webcookie-agent.js

@@ -176,13 +176,30 @@ export class WebCookieAgentExecutor extends BaseExecutor {
     const created = Math.floor(Date.now() / 1000);
     const finishReason = agentResult.finished === "cap" ? "length" : "stop";
 
+    // Collect the actual tool-call objects from the conversation so the UI
+    // can render what the agent did (name, args, result snippets).
+    const agentToolCalls = [];
+    for (const msg of agentResult.messages || []) {
+      if (msg.role === "assistant" && Array.isArray(msg.tool_calls)) {
+        for (const tc of msg.tool_calls) {
+          agentToolCalls.push({
+            id: tc.id || `call_${agentToolCalls.length + 1}`,
+            type: "function",
+            function: {
+              name: tc.function?.name || tc.name || "tool",
+              arguments: typeof tc.function?.arguments === "string"
+                ? tc.function.arguments
+                : JSON.stringify(tc.function?.arguments || {}),
+            },
+          });
+        }
+      }
+    }
+
     const finalMessage = {
       role: "assistant",
       content,
-      // Expose the tools the agent used so a client can render intermediate steps.
-      ...(agentResult.toolCalls > 0
-        ? { _agent: { toolCalls: agentResult.toolCalls, rounds: agentResult.rounds, finished: agentResult.finished } }
-        : {}),
+      ...(agentToolCalls.length > 0 ? { tool_calls: agentToolCalls } : {}),
     };
 
     const baseModel = model || "webcookie-agent";
@@ -195,10 +212,24 @@ export class WebCookieAgentExecutor extends BaseExecutor {
             id: cid, object: "chat.completion.chunk", created, model: baseModel,
             choices: [{ index: 0, delta: { role: "assistant" }, finish_reason: null, logprobs: null }],
           })));
+
+          // Emit the final content + tool_calls in one chunk. The agent loop
+          // runs to completion before streaming starts, so all tool calls are
+          // known at this point.
+          const delta = { content };
+          if (finalMessage.tool_calls?.length) {
+            delta.tool_calls = finalMessage.tool_calls.map((tc, i) => ({
+              index: i,
+              id: tc.id,
+              type: tc.type,
+              function: tc.function,
+            }));
+          }
           controller.enqueue(encoder.encode(sseChunk({
             id: cid, object: "chat.completion.chunk", created, model: baseModel,
-            choices: [{ index: 0, delta: { content }, finish_reason: null, logprobs: null }],
+            choices: [{ index: 0, delta, finish_reason: null, logprobs: null }],
           })));
+
           controller.enqueue(encoder.encode(sseChunk({
             id: cid, object: "chat.completion.chunk", created, model: baseModel,
             choices: [{ index: 0, delta: {}, finish_reason: finishReason, logprobs: null }],

package/open-sse/providers/registry/ollama-local.js

@@ -16,4 +16,5 @@ export default {
     format: "ollama",
   },
   serviceKinds: ["llm"],
+  modelsFetcher: { url: "http://localhost:11434/api/tags", type: "ollama-local" },
 };

package/open-sse/providers/registry/ollama.js

@@ -32,6 +32,7 @@ export default {
     { id: "minimax-m3", name: "MiniMax M3" },
     { id: "deepseek-v4.1-flash:cloud", name: "DeepSeek V4.1 Flash" },
   ],
+  modelsFetcher: { url: "https://ollama.com/api/tags", type: "openai" },
   serviceKinds: ["llm", "webFetch"],
   fetchConfig: {
     baseUrl: "https://ollama.com/api/web_fetch",

package/open-sse/services/agent/runAgentTools.js

@@ -37,7 +37,7 @@ function agentApiBaseUrl() {
 // at import) so this module stays importable in tests without the local DB.
 async function agentApiToken() {
   try {
-    const { getCliToken } = await import("../../../../src/lib/auth/cliToken.js");
+    const { getCliToken } = await import("../../../src/lib/auth/cliToken.js");
     return await getCliToken();
   } catch {
     return process.env.OMNIHILBRAS_AGENT_API_KEY?.trim() || "dummy";

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@hilbras/omnihilbras",
-  "version": "2.9.11",
+  "version": "2.9.13",
   "description": "OmniHilbras web dashboard",
   "scripts": {
     "dev": "next dev --port 20127",
     "dev:webpack": "next dev --webpack --port 20127",
+    "prebuild": "node scripts/build-skills-index.mjs",
     "build": "next build --webpack",
     "postbuild": "node scripts/copy-standalone-assets.mjs",
     "postbuild:bun": "node scripts/copy-standalone-assets.mjs",
     "start": "node custom-server.js --port 20127",
     "dev:bun": "bun --bun next dev --webpack --port 20127",
+    "prebuild:bun": "node scripts/build-skills-index.mjs",
     "build:bun": "bun --bun next build --webpack",
     "start:bun": "bun ./.next/standalone/custom-server.js",
     "cli:pack": "npm --prefix cli run pack:cli",

package/skills/SKILLS_INDEX.json

@@ -0,0 +1,67 @@
+{
+  "skills": [
+    {
+      "id": "omnihilbras",
+      "name": "omnihilbras",
+      "description": "Entry point for OmniHilbras — local/remote AI gateway with OpenAI-compatible REST for chat, image, TTS, embeddings, web search, web fetch. Use when the user mentions OmniHilbras, OMNIHILBRAS_URL, or wants AI without writing provider boilerplate. This skill covers setup + indexes capability skills; fetch the relevant capability SKILL.md from the URLs below when needed.",
+      "sha256": "3faaa6ca6cf2245130c399a58c11ce972075ec5a9924ffa4aaac509ce4c5a8bc",
+      "content": "---\nname: omnihilbras\ndescription: Entry point for OmniHilbras — local/remote AI gateway with OpenAI-compatible REST for chat, image, TTS, embeddings, web search, web fetch. Use when the user mentions OmniHilbras, OMNIHILBRAS_URL, or wants AI without writing provider boilerplate. This skill covers setup + indexes capability skills; fetch the relevant capability SKILL.md from the URLs below when needed.\n---\n\n# OmniHilbras\n\nLocal/remote AI gateway exposing OpenAI-compatible REST. One key, many providers, auto-fallback.\n\n## Setup\n\n```bash\nexport OMNIHILBRAS_URL=\"http://localhost:20128\"      # or VPS / tunnel URL\nexport OMNIHILBRAS_KEY=\"sk-...\"                      # from Dashboard → Keys (only if requireApiKey=true)\n```\n\nAll requests: `${OMNIHILBRAS_URL}/v1/...` with header `Authorization: Bearer ${OMNIHILBRAS_KEY}` (omit if auth disabled).\n\nVerify: `curl $OMNIHILBRAS_URL/api/health` → `{\"ok\":true}`\n\n## Discover models\n\n```bash\ncurl $OMNIHILBRAS_URL/v1/models                  # chat/LLM (default)\ncurl $OMNIHILBRAS_URL/v1/models/image            # image-gen\ncurl $OMNIHILBRAS_URL/v1/models/tts              # text-to-speech\ncurl $OMNIHILBRAS_URL/v1/models/embedding        # embeddings\ncurl $OMNIHILBRAS_URL/v1/models/web              # web search + fetch (entries have `kind` field)\ncurl $OMNIHILBRAS_URL/v1/models/stt              # speech-to-text\ncurl $OMNIHILBRAS_URL/v1/models/image-to-text    # vision\n```\n\nUse `data[].id` as `model` field in requests. Combos appear with `owned_by:\"combo\"`.\n\nResponse shape:\n```json\n{ \"object\": \"list\", \"data\": [\n  { \"id\": \"openai/gpt-5\", \"object\": \"model\", \"owned_by\": \"openai\", \"created\": 1735000000 },\n  { \"id\": \"tavily/search\", \"object\": \"model\", \"kind\": \"webSearch\", \"owned_by\": \"tavily\", \"created\": 1735000000 }\n]}\n```\n\n## Capability skills\n\nWhen the user needs a specific capability, fetch that skill's `SKILL.md` from its raw URL:\n\n| Capability | Raw URL |\n|---|---|\n| Chat / code-gen | https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras-chat/SKILL.md |\n| Image generation | https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras-image/SKILL.md |\n| Text-to-speech | https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras-tts/SKILL.md |\n| Speech-to-text | https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras-stt/SKILL.md |\n| Embeddings | https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras-embeddings/SKILL.md |\n| Web search | https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras-web-search/SKILL.md |\n| Web fetch (URL → markdown) | https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras-web-fetch/SKILL.md |\n\n## Errors\n\n- 401 → set/refresh `OMNIHILBRAS_KEY` (Dashboard → Keys)\n- 400 `Invalid model format` → check `model` exists in `/v1/models/<kind>`\n- 503 `All accounts unavailable` → wait `retry-after` or add another provider account\n"
+    },
+    {
+      "id": "omnihilbras-chat",
+      "name": "omnihilbras-chat",
+      "description": "Chat / code generation via OmniHilbras using OpenAI /v1/chat/completions or Anthropic /v1/messages format with streaming + auto-fallback combos. Use when the user wants to ask an LLM, generate code, summarize text, or run prompts through OmniHilbras.",
+      "sha256": "79d79bd8b301f7d6e2ca9d4f12ce46e72e8ecb4be8e22168d0226ba3ab12ce94",
+      "content": "---\nname: omnihilbras-chat\ndescription: Chat / code generation via OmniHilbras using OpenAI /v1/chat/completions or Anthropic /v1/messages format with streaming + auto-fallback combos. Use when the user wants to ask an LLM, generate code, summarize text, or run prompts through OmniHilbras.\n---\n\n# OmniHilbras — Chat\n\nRequires `OMNIHILBRAS_URL` (and `OMNIHILBRAS_KEY` if auth enabled). See https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras/SKILL.md for setup.\n\n## Endpoints\n\n- `POST $OMNIHILBRAS_URL/v1/chat/completions` — OpenAI format\n- `POST $OMNIHILBRAS_URL/v1/messages` — Anthropic format\n\n## Discover\n\n```bash\ncurl $OMNIHILBRAS_URL/v1/models | jq '.data[].id'\n# Per-model metadata (contextWindow, params)\ncurl \"$OMNIHILBRAS_URL/v1/models/info?id=openai/gpt-4o\"\n```\n\nCombos (e.g. `vip`, `mycodex`) auto-fallback through multiple providers.\n\n## OpenAI format\n\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/chat/completions \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"openai/gpt-5\",\"messages\":[{\"role\":\"user\",\"content\":\"Hi\"}],\"stream\":false}'\n```\n\nJS (OpenAI SDK):\n\n```js\nimport OpenAI from \"openai\";\nconst client = new OpenAI({ baseURL: `${process.env.OMNIHILBRAS_URL}/v1`, apiKey: process.env.OMNIHILBRAS_KEY });\nconst res = await client.chat.completions.create({\n  model: \"openai/gpt-5\",\n  messages: [{ role: \"user\", content: \"Hi\" }],\n  stream: true,\n});\nfor await (const chunk of res) process.stdout.write(chunk.choices[0]?.delta?.content || \"\");\n```\n\n## Anthropic format\n\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/messages \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"anthropic-version: 2023-06-01\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"cc/claude-opus-4-7\",\"max_tokens\":1024,\"messages\":[{\"role\":\"user\",\"content\":\"Hi\"}]}'\n```\n\n## Response shape\n\nOpenAI (`/v1/chat/completions`):\n```json\n{ \"id\": \"chatcmpl-...\", \"object\": \"chat.completion\", \"model\": \"openai/gpt-5\",\n  \"choices\": [{ \"index\": 0, \"message\": { \"role\": \"assistant\", \"content\": \"Hello!\" }, \"finish_reason\": \"stop\" }],\n  \"usage\": { \"prompt_tokens\": 8, \"completion_tokens\": 2, \"total_tokens\": 10 } }\n```\n\nStreaming (`stream:true`) emits SSE: `data: {choices:[{delta:{content:\"...\"}}]}\\n\\n` ... `data: [DONE]\\n\\n`.\n\nAnthropic (`/v1/messages`):\n```json\n{ \"id\": \"msg_...\", \"type\": \"message\", \"role\": \"assistant\", \"model\": \"cc/claude-opus-4-7\",\n  \"content\": [{ \"type\": \"text\", \"text\": \"Hello!\" }],\n  \"stop_reason\": \"end_turn\", \"usage\": { \"input_tokens\": 8, \"output_tokens\": 2 } }\n```\n"
+    },
+    {
+      "id": "omnihilbras-embeddings",
+      "name": "omnihilbras-embeddings",
+      "description": "Generate vector embeddings via OmniHilbras /v1/embeddings using OpenAI / Gemini / Mistral / Voyage / Nvidia / GitHub embedding models for RAG, semantic search, similarity. Use when the user wants embeddings, vectors, RAG, semantic search, or to embed text.",
+      "sha256": "97fc86d31317bd23dfb248a34ba5c3c92d162ae3d67151a338f667683f01beab",
+      "content": "---\nname: omnihilbras-embeddings\ndescription: Generate vector embeddings via OmniHilbras /v1/embeddings using OpenAI / Gemini / Mistral / Voyage / Nvidia / GitHub embedding models for RAG, semantic search, similarity. Use when the user wants embeddings, vectors, RAG, semantic search, or to embed text.\n---\n\n# OmniHilbras — Embeddings\n\nRequires `OMNIHILBRAS_URL` (and `OMNIHILBRAS_KEY` if auth enabled). See https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras/SKILL.md for setup.\n\n## Discover\n\n```bash\ncurl $OMNIHILBRAS_URL/v1/models/embedding | jq '.data[].id'\n# Per-model dimensions\ncurl \"$OMNIHILBRAS_URL/v1/models/info?id=openai/text-embedding-3-small\"\n```\n\n## Endpoint\n\n`POST $OMNIHILBRAS_URL/v1/embeddings`\n\n| Field | Required | Notes |\n|---|---|---|\n| `model` | yes | from `/v1/models/embedding` |\n| `input` | yes | string OR array of strings |\n| `encoding_format` | no | `float` (default) / `base64` |\n| `dimensions` | no | OpenAI v3 only |\n\n## Examples\n\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/embeddings \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"openai/text-embedding-3-small\",\"input\":[\"hello\",\"world\"]}'\n```\n\nJS:\n\n```js\nconst r = await fetch(`${process.env.OMNIHILBRAS_URL}/v1/embeddings`, {\n  method: \"POST\",\n  headers: { \"Authorization\": `Bearer ${process.env.OMNIHILBRAS_KEY}`, \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ model: \"gemini/text-embedding-004\", input: \"RAG chunk text\" }),\n});\nconst { data } = await r.json();\nconsole.log(data[0].embedding.length);  // dimension\n```\n\n## Response shape\n\n```json\n{ \"object\": \"list\", \"model\": \"openai/text-embedding-3-small\",\n  \"data\": [\n    { \"object\": \"embedding\", \"index\": 0, \"embedding\": [0.0123, -0.045, ...] },\n    { \"object\": \"embedding\", \"index\": 1, \"embedding\": [...] }\n  ],\n  \"usage\": { \"prompt_tokens\": 5, \"total_tokens\": 5 } }\n```\n\n## Provider quirks\n\n| Provider | Notes |\n|---|---|\n| `openai`, `openrouter`, `mistral`, `voyage-ai`, `fireworks`, `together`, `nebius`, `github`, `nvidia`, `jina-ai` | Native OpenAI shape — `dimensions` works only on OpenAI v3 (`text-embedding-3-*`) |\n| `gemini`, `google_ai_studio` | Server auto-converts to `embedContent`/`batchEmbedContents` — send OpenAI shape |\n| `openai-compatible-*`, `custom-embedding-*` | Custom `baseUrl` from credentials |\n\nBatch (`input` as array) is faster; some providers cap batch size.\n"
+    },
+    {
+      "id": "omnihilbras-image",
+      "name": "omnihilbras-image",
+      "description": "Generate images via OmniHilbras /v1/images/generations using OpenAI / Gemini Imagen / DALL-E / FLUX / MiniMax / SDWebUI / ComfyUI / Codex models. Use when the user wants to create, generate, draw, or render an image, picture, or text-to-image (txt2img).",
+      "sha256": "559b4e82dc861854e40151f5665d90c7d064387aa6fcf24ebceb43600de46737",
+      "content": "---\nname: omnihilbras-image\ndescription: Generate images via OmniHilbras /v1/images/generations using OpenAI / Gemini Imagen / DALL-E / FLUX / MiniMax / SDWebUI / ComfyUI / Codex models. Use when the user wants to create, generate, draw, or render an image, picture, or text-to-image (txt2img).\n---\n\n# OmniHilbras — Image Generation\n\nRequires `OMNIHILBRAS_URL` (and `OMNIHILBRAS_KEY` if auth enabled). See https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras/SKILL.md for setup.\n\n## Discover\n\n```bash\ncurl $OMNIHILBRAS_URL/v1/models/image | jq '.data[].id'\n# Per-model params/options (size enum, quality enum, capabilities like edit)\ncurl \"$OMNIHILBRAS_URL/v1/models/info?id=openai/dall-e-3\"\n```\n\n## Endpoint\n\n`POST $OMNIHILBRAS_URL/v1/images/generations`\n\n| Field | Required | Notes |\n|---|---|---|\n| `model` | yes | from `/v1/models/image` |\n| `prompt` | yes | image description |\n| `n` | no | count (provider-dependent) |\n| `size` | no | `1024x1024`, `1792x1024`, ... |\n| `quality` | no | `standard` / `hd` (OpenAI) |\n| `response_format` | no | `url` (default) or `b64_json` |\n\nAdd query `?response_format=binary` to receive raw image bytes (handy for saving file).\n\n## Examples\n\nSave to file (binary):\n\n```bash\ncurl -X POST \"$OMNIHILBRAS_URL/v1/images/generations?response_format=binary\" \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"gemini/gemini-3-pro-image-preview\",\"prompt\":\"watercolor mountains at sunrise\",\"size\":\"1024x1024\"}' \\\n  --output out.png\n```\n\nJS (URL response):\n\n```js\nconst r = await fetch(`${process.env.OMNIHILBRAS_URL}/v1/images/generations`, {\n  method: \"POST\",\n  headers: { \"Authorization\": `Bearer ${process.env.OMNIHILBRAS_KEY}`, \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ model: \"gemini/gemini-3-pro-image-preview\", prompt: \"neon city\", size: \"1024x1024\" }),\n});\nconst { data } = await r.json();\nconsole.log(data[0].url || data[0].b64_json.slice(0, 40));\n```\n\n## Response shape\n\nJSON (default `response_format=url`):\n```json\n{ \"created\": 1735000000, \"data\": [{ \"url\": \"https://...\" }] }\n```\n\n`response_format=b64_json`:\n```json\n{ \"created\": 1735000000, \"data\": [{ \"b64_json\": \"iVBORw0KGgo...\" }] }\n```\n\nQuery `?response_format=binary` returns raw image bytes (Content-Type `image/png` or `image/jpeg`).\n\n## Provider quirks\n\nCommon fields above work everywhere. These add/override:\n\n| Provider | Extra/changed fields | Notes |\n|---|---|---|\n| `openai`, `minimax`, `openrouter`, `recraft` | `quality`, `style`, `response_format` | Standard OpenAI shape |\n| `gemini` (nano-banana) | — | Only `prompt`; ignores `size`/`n` |\n| `codex` (gpt-5.4-image) | `image`, `images[]`, `image_detail`, `output_format`, `background` | SSE stream; **ChatGPT Plus/Pro required** |\n| `huggingface` | — | Only `prompt`; returns single image |\n| `nanobanana` | `image`, `images[]` (edit mode) | `size` → aspect ratio; async polling |\n| `fal-ai` | `image` (img2img) | `n` → `num_images`; `size` → ratio; async |\n| `stability-ai` | `style` (preset), `output_format` | `size` → `aspect_ratio` |\n| `black-forest-labs` (FLUX) | `image` (ref) | `size` → exact `width`/`height`; async |\n| `runwayml` | `image` (ref) | `size` → ratio; async; video models exist |\n| `sdwebui`, `comfyui` | — | Localhost noAuth (`:7860` / `:8188`) |\n"
+    },
+    {
+      "id": "omnihilbras-stt",
+      "name": "omnihilbras-stt",
+      "description": "Speech-to-text via OmniHilbras /v1/audio/transcriptions using OpenAI Whisper / Groq / Gemini / Deepgram / AssemblyAI / NVIDIA / HuggingFace models. Use when the user wants to transcribe audio, convert speech to text, or get subtitles from audio files.",
+      "sha256": "5f49ab037d003ce5f48fd4d59a95182b562f751f1ad975a1068317bd963806a4",
+      "content": "---\nname: omnihilbras-stt\ndescription: Speech-to-text via OmniHilbras /v1/audio/transcriptions using OpenAI Whisper / Groq / Gemini / Deepgram / AssemblyAI / NVIDIA / HuggingFace models. Use when the user wants to transcribe audio, convert speech to text, or get subtitles from audio files.\n---\n\n# OmniHilbras — Speech-to-Text\n\nRequires `OMNIHILBRAS_URL` (and `OMNIHILBRAS_KEY` if auth enabled). See https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras/SKILL.md for setup.\n\n## Discover\n\n```bash\ncurl $OMNIHILBRAS_URL/v1/models/stt | jq '.data[].id'\n# Per-model params (language, response_format, prompt, temperature support)\ncurl \"$OMNIHILBRAS_URL/v1/models/info?id=openai/whisper-1\"\n```\n\n`model` = STT model ID (e.g. `openai/whisper-1`, `groq/whisper-large-v3`, `deepgram/nova-3`, `gemini/gemini-2.5-flash`).\n\n## Endpoint\n\n`POST $OMNIHILBRAS_URL/v1/audio/transcriptions` (OpenAI Whisper compatible, `multipart/form-data`)\n\n| Field | Required | Notes |\n|---|---|---|\n| `model` | yes | from `/v1/models/stt` |\n| `file` | yes | audio file (mp3, wav, m4a, webm, ogg, flac) |\n| `language` | no | ISO-639-1 (e.g. `en`, `vi`) |\n| `prompt` | no | hint text to guide transcription |\n| `response_format` | no | `json` (default) / `text` / `verbose_json` / `srt` / `vtt` |\n| `temperature` | no | 0–1 |\n\n## Examples\n\n```bash\ncurl -X POST \"$OMNIHILBRAS_URL/v1/audio/transcriptions\" \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -F \"model=openai/whisper-1\" \\\n  -F \"file=@audio.mp3\" \\\n  -F \"language=vi\"\n```\n\nJS (Node):\n\n```js\nimport { createReadStream } from \"node:fs\";\nconst form = new FormData();\nform.append(\"model\", \"groq/whisper-large-v3-turbo\");\nform.append(\"file\", new Blob([await (await import(\"node:fs/promises\")).readFile(\"audio.mp3\")]), \"audio.mp3\");\nconst r = await fetch(`${process.env.OMNIHILBRAS_URL}/v1/audio/transcriptions`, {\n  method: \"POST\",\n  headers: { \"Authorization\": `Bearer ${process.env.OMNIHILBRAS_KEY}` },\n  body: form,\n});\nconst { text } = await r.json();\nconsole.log(text);\n```\n\n## Response shape\n\nDefault (`response_format=json`):\n```json\n{ \"text\": \"Xin chào, đây là bản ghi âm.\" }\n```\n\n`verbose_json` adds `language`, `duration`, `segments[]` with timestamps.\n`srt` / `vtt` return subtitle text.\n\n## Provider quirks\n\n| Provider | `model` format | Notes |\n|---|---|---|\n| `openai` | `whisper-1`, `gpt-4o-transcribe`, `gpt-4o-mini-transcribe` | Native OpenAI shape |\n| `groq` | `whisper-large-v3`, `whisper-large-v3-turbo`, `distil-whisper-large-v3-en` | Fastest; OpenAI shape |\n| `gemini` | `gemini-2.5-flash`, `gemini-2.5-pro`, `gemini-2.5-flash-lite` | Server converts to `generateContent` with audio inline |\n| `deepgram` | `nova-3`, `nova-2`, `whisper-large` | Token auth; server adapts response |\n| `assemblyai` | `universal-3-pro`, `universal-2` | Async upload+poll handled server-side |\n| `nvidia` | `nvidia/parakeet-ctc-1.1b-asr` | NIM endpoint |\n| `huggingface` | `openai/whisper-large-v3`, `openai/whisper-small` | HF Inference API |\n| `elevenlabs` | `scribe_v1`, `scribe_v2` | Whisper-compatible shape; `xi-api-key` auth, not Bearer. Extra params: `timestamps_granularity` (`word`/`character`/`none`), `tag_audio_events`, and speaker labelling via **either** `diarize=true` **or** `num_speakers` (1–32) — sending both makes the request invalid, so `diarize` wins and `num_speakers` is dropped. Blank `language` is omitted upstream for auto-detect. `srt`/`vtt` and `verbose_json` segments are served from Scribe's own `additional_formats` render, so `segments[]` is omitted when the upstream render is unavailable rather than synthesized. Does not accept `temperature` or `prompt` — those are not forwarded. |\n"
+    },
+    {
+      "id": "omnihilbras-tts",
+      "name": "omnihilbras-tts",
+      "description": "Text-to-speech via OmniHilbras /v1/audio/speech using OpenAI / ElevenLabs / Deepgram / Edge TTS / Google TTS / Hyperbolic / Inworld voices. Use when the user wants to convert text to speech, generate audio, voiceover, narrate, or read text aloud.",
+      "sha256": "a95bf665df429861c53f46c64799140dd0bda750edca89a26aa177ebf87bd0bb",
+      "content": "---\nname: omnihilbras-tts\ndescription: Text-to-speech via OmniHilbras /v1/audio/speech using OpenAI / ElevenLabs / Deepgram / Edge TTS / Google TTS / Hyperbolic / Inworld voices. Use when the user wants to convert text to speech, generate audio, voiceover, narrate, or read text aloud.\n---\n\n# OmniHilbras — Text-to-Speech\n\nRequires `OMNIHILBRAS_URL` (and `OMNIHILBRAS_KEY` if auth enabled). See https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras/SKILL.md for setup.\n\n## Discover\n\n```bash\n# 1) List models\ncurl $OMNIHILBRAS_URL/v1/models/tts | jq '.data[].id'\n# 2) Per-model metadata (params, voicesUrl if voice-by-id)\ncurl \"$OMNIHILBRAS_URL/v1/models/info?id=el/eleven_multilingual_v2\"\n# 3) List voices (elevenlabs, edge-tts, deepgram, inworld, local-device). Optional ?lang=vi\ncurl \"$OMNIHILBRAS_URL/v1/audio/voices?provider=edge-tts&lang=vi\" | jq '.data[].model'\n```\n\n`model` field in `/v1/audio/speech` = voice ID directly (e.g. `edge-tts/vi-VN-HoaiMyNeural`, `el/<voice_id>`, or `openai/tts-1` model+default voice).\n\n## Endpoint\n\n`POST $OMNIHILBRAS_URL/v1/audio/speech`\n\n| Field | Required | Notes |\n|---|---|---|\n| `model` | yes | voice ID from `/v1/models/tts` |\n| `input` | yes | text to speak |\n\nQuery `?response_format=mp3` (default, raw bytes) or `?response_format=json` (`{audio: base64, format}`).\n\n## Examples\n\nSave MP3:\n\n```bash\ncurl -X POST \"$OMNIHILBRAS_URL/v1/audio/speech\" \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"openai/tts-1\",\"input\":\"Hello world\"}' \\\n  --output speech.mp3\n```\n\nJS (save file):\n\n```js\nimport { writeFile } from \"node:fs/promises\";\nconst r = await fetch(`${process.env.OMNIHILBRAS_URL}/v1/audio/speech`, {\n  method: \"POST\",\n  headers: { \"Authorization\": `Bearer ${process.env.OMNIHILBRAS_KEY}`, \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ model: \"el/eleven_multilingual_v2\", input: \"Xin chào\" }),\n});\nawait writeFile(\"speech.mp3\", Buffer.from(await r.arrayBuffer()));\n```\n\n## Response shape\n\nDefault → raw audio bytes (Content-Type `audio/mp3`).\n\n`?response_format=json`:\n```json\n{ \"audio\": \"SUQzBAAAA...\", \"format\": \"mp3\" }\n```\n\n## Provider quirks (model format)\n\n| Provider | `model` format | Notes |\n|---|---|---|\n| `openai` | `tts-1/alloy` (model/voice) or just voice | Default model `gpt-4o-mini-tts` |\n| `elevenlabs` | `<model_id>/<voice_id>` or `<voice_id>` | Default model `eleven_flash_v2_5`; list voices in Dashboard |\n| `openrouter` | `openai/gpt-4o-mini-tts/alloy` | Streamed via chat-completions audio modality |\n| `edge-tts` | voice id e.g. `vi-VN-HoaiMyNeural` | **noAuth**; default `vi-VN-HoaiMyNeural` |\n| `google-tts` | language code e.g. `en`, `vi` | **noAuth** |\n| `local-device` | OS voice name (`say -v ?` / SAPI) | **noAuth**; needs `ffmpeg` |\n| `deepgram` | `aura-asteria-en` etc | Token auth |\n| `nvidia`, `inworld`, `cartesia`, `playht` | `model/voice` | Provider-specific auth header |\n| `coqui`, `tortoise` | speaker / voice id | Localhost noAuth |\n| `hyperbolic` | model id | Body = `{text}` only |\n"
+    },
+    {
+      "id": "omnihilbras-video",
+      "name": "omnihilbras-video",
+      "description": "Generate videos via OmniHilbras /v1/videos/generations using xAI Grok Imagine (grok-imagine-video). Async job flow - submit, poll request_id until done, download MP4. Use when the user wants to create, generate, or render a video, text-to-video (txt2vid), or image-to-video.",
+      "sha256": "38586127031e374e2f792bed8514466d050eda87aa6face94bd54c3cec21515b",
+      "content": "---\nname: omnihilbras-video\ndescription: Generate videos via OmniHilbras /v1/videos/generations using xAI Grok Imagine (grok-imagine-video). Async job flow - submit, poll request_id until done, download MP4. Use when the user wants to create, generate, or render a video, text-to-video (txt2vid), or image-to-video.\n---\n\n# OmniHilbras — Video Generation (xAI Grok Imagine)\n\nRequires `OMNIHILBRAS_URL` (and `OMNIHILBRAS_KEY` if auth enabled). See https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras/SKILL.md for setup.\n\nRequires a connected **xAI account** in the OmniHilbras dashboard — either **Grok Build OAuth** (SuperGrok / X Premium+ subscription sign-in) or a direct **xAI API key** from console.x.ai. The two are separate auth types with separate billing; the dashboard shows which one each connection uses.\n\n## Endpoints (async job flow)\n\nVideo generation is **asynchronous**: the POST returns a `request_id` immediately, then you poll until the job is `done` or `failed`.\n\n| Endpoint | Purpose |\n|---|---|\n| `POST /v1/videos/generations` | text-to-video / image-to-video |\n| `POST /v1/videos/edits` | edit an existing video |\n| `POST /v1/videos/extensions` | extend an existing video |\n| `GET /v1/videos/{request_id}` | poll job status |\n\nRequest fields (passed through to xAI unchanged — see https://docs.x.ai/developers/rest-api-reference/inference/videos):\n\n| Field | Required | Notes |\n|---|---|---|\n| `model` | no | `xai/grok-imagine-video` (prefix is stripped before upstream) |\n| `prompt` | yes for T2V | video description |\n| `duration` | no | seconds |\n| `aspect_ratio` | no | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` |\n| `resolution` | no | `480p`, `720p`, `1080p` |\n| `image` | no | `{ \"url\": \"https://… or data:image/…;base64,…\" }` for image-to-video |\n| `video` | edits/extensions | `{ \"url\": \"…mp4\" }` or `{ \"file_id\": \"…\" }` |\n\n## Examples\n\nSubmit a job:\n\n```bash\ncurl -X POST \"$OMNIHILBRAS_URL/v1/videos/generations\" \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"xai/grok-imagine-video\",\"prompt\":\"A cinematic tracking shot through a neon city at night\",\"duration\":8,\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\"}'\n# → {\"request_id\":\"abc123\"}   (response header x-omnihilbras-connection-id: <id>)\n```\n\nPoll until done (echo the connection header back so the same account polls the job):\n\n```bash\ncurl \"$OMNIHILBRAS_URL/v1/videos/abc123\" \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"x-connection-id: <id from create response>\"\n# → {\"status\":\"pending\",\"progress\":42}\n# → {\"status\":\"done\",\"video\":{\"url\":\"https://…mp4\",\"duration\":8},\"model\":\"grok-imagine-video\"}\n# → {\"status\":\"failed\",\"error\":{\"code\":\"…\",\"message\":\"…\"}}\n```\n\nDownload: fetch `video.url` from the `done` response.\n\n## CLI one-shot\n\n```bash\nomnihilbras xai video \\\n  --prompt \"A cinematic tracking shot through a neon city at night\" \\\n  --output video.mp4\n# options: --model --duration --aspect-ratio --resolution --image --timeout --port --api-key\n```\n\nSubmits, polls with progress, downloads to `video.mp4.part`, atomically renames on success. Ctrl+C cancels cleanly; non-zero exit on failure.\n\n## Notes & limits\n\n- Jobs are **account-bound** upstream: poll with the same connection that created the job (`x-connection-id` header, value from the create response's `x-omnihilbras-connection-id`).\n- Creation POSTs are **never auto-retried** (a retry could create and bill two videos). Only a 401→token-refresh→single-retry is performed, which upstream rejects before job creation.\n- Video models are tagged `kind: \"video\"` and are excluded from chat model lists and chat fallback combos.\n- Grok Build **subscription OAuth** tokens are sent to the same `api.x.ai/v1/videos` endpoints as API keys; whether a given subscription tier includes video-generation quota is controlled by xAI and is not verified by OmniHilbras — a `403`/`permission_denied` from upstream means the connected account has no video access.\n"
+    },
+    {
+      "id": "omnihilbras-web-fetch",
+      "name": "omnihilbras-web-fetch",
+      "description": "Fetch URL → markdown / text / HTML via OmniHilbras /v1/web/fetch using Ollama Cloud / Firecrawl / Jina Reader / Tavily Extract / Exa Contents. Use when the user wants to scrape a webpage, extract URL content, read article, or convert a URL to markdown.",
+      "sha256": "0f21778c450430d35c110cc41071182a2682f302ae2b3ca0f26182115a8a69bb",
+      "content": "---\nname: omnihilbras-web-fetch\ndescription: Fetch URL → markdown / text / HTML via OmniHilbras /v1/web/fetch using Ollama Cloud / Firecrawl / Jina Reader / Tavily Extract / Exa Contents. Use when the user wants to scrape a webpage, extract URL content, read article, or convert a URL to markdown.\n---\n\n# OmniHilbras — Web Fetch\n\nRequires `OMNIHILBRAS_URL` (and `OMNIHILBRAS_KEY` if auth enabled). See https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras/SKILL.md for setup.\n\n## Discover\n\n```bash\ncurl $OMNIHILBRAS_URL/v1/models/web | jq '.data[] | select(.kind==\"webFetch\") | .id'\n# Per-provider params\ncurl \"$OMNIHILBRAS_URL/v1/models/info?id=firecrawl/fetch\"\n```\n\nIDs end in `/fetch` (e.g. `firecrawl/fetch`, `jina/fetch`). `fetch-combo` chains providers with auto-fallback.\n\n## Endpoint\n\n`POST $OMNIHILBRAS_URL/v1/web/fetch`\n\n| Field | Required | Notes |\n|---|---|---|\n| `model` (or `provider`) | yes | from `/v1/models/web` (e.g. `firecrawl` or `jina-reader`) |\n| `url` | yes | URL to extract |\n| `format` | no | `markdown` (default) / `text` / `html` |\n| `max_characters` | no | truncate output |\n\n## Examples\n\n### Jina Reader\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/web/fetch \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"jina-reader\",\"url\":\"https://omnihilbras.com\",\"format\":\"markdown\"}'\n```\n\n### Exa\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/web/fetch \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"exa\",\"url\":\"https://example.com\",\"format\":\"markdown\",\"max_characters\":0}'\n```\n\n### Firecrawl\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/web/fetch \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"firecrawl\",\"url\":\"https://example.com\",\"format\":\"markdown\",\"max_characters\":0}'\n```\n\n### Tavily\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/web/fetch \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"tavily\",\"url\":\"https://example.com\",\"format\":\"markdown\",\"max_characters\":0}'\n```\n\n### Ollama Cloud\n\nUses the API key from the existing `ollama` connection.\n\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/web/fetch \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"ollama\",\"url\":\"https://example.com\",\"format\":\"markdown\"}'\n```\n\n\nJS:\n\n```js\nconst r = await fetch(`${process.env.OMNIHILBRAS_URL}/v1/web/fetch`, {\n  method: \"POST\",\n  headers: { \"Authorization\": `Bearer ${process.env.OMNIHILBRAS_KEY}`, \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ model: \"fetch-combo\", url: \"https://example.com\", format: \"markdown\", max_characters: 5000 }),\n});\nconst { data } = await r.json();\nconsole.log(data.title, data.content.length);\n```\n\n## Response shape\n\n```json\n{\n  \"provider\": \"jina-reader\",\n  \"url\": \"...\",\n  \"title\": \"...\",\n  \"content\": { \"format\": \"markdown\", \"text\": \"...\", \"length\": 1234 },\n  \"links\": [\"https://example.com/related\"],\n  \"metadata\": { \"author\": null, \"published_at\": null, \"language\": null },\n  \"usage\": { \"fetch_cost_usd\": 0 },\n  \"metrics\": { \"response_time_ms\": 850, \"upstream_latency_ms\": 700 }\n}\n```\n\n`links` is included when the upstream provider returns discovered page links (currently Ollama Cloud).\n\n## Provider quirks\n\n| Provider | Auth | Best for |\n|---|---|---|\n| `firecrawl` | Bearer | JS-rendered pages, `format=markdown/html` |\n| `jina-reader` | Bearer (optional) | Free tier (~1M chars/mo); fastest plain markdown |\n| `tavily` | Bearer | Bulk extract; returns `raw_content` |\n| `exa` | `x-api-key` | Pre-indexed pages; fast text extraction |\n| `ollama` | Bearer | Markdown plus page title and discovered links; uses the Ollama Cloud key |\n"
+    },
+    {
+      "id": "omnihilbras-web-search",
+      "name": "omnihilbras-web-search",
+      "description": "Web and X search via OmniHilbras /v1/search using Tavily / Exa / Brave / Serper / SearXNG / Google PSE / Linkup / SearchAPI / You.com / Perplexity / Xquik. Use when the user wants to search the web, find articles, or search public X posts.",
+      "sha256": "fe116258a5127faecf750e7469d8fbea0f926157263739265e0fced3cfcb851d",
+      "content": "---\nname: omnihilbras-web-search\ndescription: Web and X search via OmniHilbras /v1/search using Tavily / Exa / Brave / Serper / SearXNG / Google PSE / Linkup / SearchAPI / You.com / Perplexity / Xquik. Use when the user wants to search the web, find articles, or search public X posts.\n---\n\n# OmniHilbras — Web Search\n\nRequires `OMNIHILBRAS_URL` (and `OMNIHILBRAS_KEY` if auth enabled). See https://raw.githubusercontent.com/hilbras/omnihilbras/refs/heads/main/skills/omnihilbras/SKILL.md for setup.\n\n## Discover\n\n```bash\ncurl $OMNIHILBRAS_URL/v1/models/web | jq '.data[] | select(.kind==\"webSearch\") | .id'\n# Per-provider params (searchTypes, maxResults, required options like cx for google-pse)\ncurl \"$OMNIHILBRAS_URL/v1/models/info?id=tavily/search\"\n```\n\nIDs end in `/search` (e.g. `tavily/search`). Combos (`owned_by:\"combo\"`) chain providers with auto-fallback.\n\n## Endpoint\n\n`POST $OMNIHILBRAS_URL/v1/search`\n\n| Field | Required | Notes |\n|---|---|---|\n| `model` (or `provider`) | yes | from `/v1/models/web` (e.g. `tavily` or `brave`) |\n| `query` | yes | search query |\n| `max_results` | no | default 5 |\n| `search_type` | no | `web` (default) / `news` / `x` for Xquik |\n| `country`, `language`, `time_range`, `domain_filter` | no | provider-dependent |\n\n## Examples\n\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/search \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"tavily\",\"query\":\"OmniHilbras open source\",\"max_results\":5}'\n```\n\nJS:\n\n```js\nconst r = await fetch(`${process.env.OMNIHILBRAS_URL}/v1/search`, {\n  method: \"POST\",\n  headers: { \"Authorization\": `Bearer ${process.env.OMNIHILBRAS_KEY}`, \"Content-Type\": \"application/json\" },\n  body: JSON.stringify({ model: \"search-combo\", query: \"latest LLM benchmarks\", max_results: 10 }),\n});\nconsole.log(await r.json());\n```\n\nX search with Xquik:\n\n```bash\ncurl -X POST $OMNIHILBRAS_URL/v1/search \\\n  -H \"Authorization: Bearer $OMNIHILBRAS_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"xquik\",\"query\":\"from:github release\",\"max_results\":10,\"provider_options\":{\"queryType\":\"Latest\"}}'\n```\n\nAdd the Xquik API key in OmniHilbras's provider settings. Xquik charges 1 credit per returned post. Continue a search by passing `pagination.next_cursor` as `provider_options.cursor`.\n\nXquik responses include provider pagination and credit usage:\n\n```json\n{\n  \"pagination\": { \"has_more\": true, \"next_cursor\": \"cursor-2\" },\n  \"usage\": { \"queries_used\": 1, \"search_cost_usd\": null, \"provider_credits_used\": 10 }\n}\n```\n\n## Response shape\n\n```json\n{\n  \"provider\": \"tavily\",\n  \"query\": \"OmniHilbras open source\",\n  \"results\": [\n    {\n      \"title\": \"...\", \"url\": \"https://...\", \"display_url\": \"github.com/...\",\n      \"snippet\": \"...\", \"position\": 1, \"score\": 0.92,\n      \"published_at\": null, \"favicon_url\": null, \"content\": null,\n      \"metadata\": { \"author\": null, \"language\": null, \"source_type\": null, \"image_url\": null },\n      \"citation\": { \"provider\": \"tavily\", \"retrieved_at\": \"2026-...\", \"rank\": 1 }\n    }\n  ],\n  \"answer\": null,\n  \"usage\": { \"queries_used\": 1, \"search_cost_usd\": 0.008 },\n  \"metrics\": { \"response_time_ms\": 850, \"upstream_latency_ms\": 700, \"total_results_available\": 12 },\n  \"errors\": []\n}\n```\n\n## Provider quirks\n\nAll accept `query` + `max_results`. Optional fields vary:\n\n| Provider | Supports | Required extras |\n|---|---|---|\n| `tavily` | country, domain_filter, news topic | — |\n| `exa` | domain_filter (incl/excl), news category | — |\n| `brave-search` | country, language | — |\n| `serper` | country, language, news endpoint | — |\n| `perplexity` | country, language, domain_filter | — |\n| `linkup` | domain_filter, time_range | `depth: fast/standard/deep` (option) |\n| `google-pse` | country, language, time_range, offset | **`cx` required** (providerOptions) |\n| `searchapi` | country, language, pagination | — |\n| `youcom` | country, language, time_range, domain_filter, full_page | — |\n| `searxng` | language, time_range | Self-hosted, **noAuth** |\n| `xquik` | X/Twitter search operators, language, cursor pagination | `queryType: Latest/Top`, `cursor` (options) |\n\nProvider IS the model — `\"provider\":\"tavily\" ≡ \"model\":\"tavily\"`.\n"
+    }
+  ]
+}

package/tests/translator/__snapshots__/golden-url-header.test.js.snap

@@ -139,6 +139,31 @@ exports[`GOLDEN buildHeaders (default executor providers) > anthropic → header
 }
 `;
 
+exports[`GOLDEN buildHeaders (default executor providers) > anyrouter → headers (apiKey / oauth) 1`] = `
+{
+  "apiKey": {
+    "Accept": "text/event-stream",
+    "Authorization": "Bearer <TOK>",
+    "Content-Type": "application/json",
+    "HTTP-Referer": "https://endpoint-proxy.local",
+    "X-Title": "Endpoint Proxy",
+  },
+  "nonStream": {
+    "Authorization": "Bearer <TOK>",
+    "Content-Type": "application/json",
+    "HTTP-Referer": "https://endpoint-proxy.local",
+    "X-Title": "Endpoint Proxy",
+  },
+  "oauth": {
+    "Accept": "text/event-stream",
+    "Authorization": "Bearer <TOK>",
+    "Content-Type": "application/json",
+    "HTTP-Referer": "https://endpoint-proxy.local",
+    "X-Title": "Endpoint Proxy",
+  },
+}
+`;
+
 exports[`GOLDEN buildHeaders (default executor providers) > api-airforce → headers (apiKey / oauth) 1`] = `
 {
   "apiKey": {
@@ -624,32 +649,50 @@ exports[`GOLDEN buildHeaders (default executor providers) > codebuddy-cn → hea
     "Accept": "text/event-stream",
     "Authorization": "Bearer <TOK>",
     "Content-Type": "application/json",
-    "User-Agent": "CLI/2.108.1 CodeBuddy/2.108.1",
+    "User-Agent": "CLI/2.177.0 CodeBuddy/2.177.0",
     "X-IDE-Name": "CLI",
     "X-IDE-Type": "CLI",
+    "X-IDE-Version": "2.177.0",
     "X-Product": "SaaS",
+    "x-agent-intent": "craft",
+    "x-agent-purpose": "conversation",
+    "x-agent-runtime": "other",
+    "x-agent-type": "main",
     "x-codebuddy-request": "1",
+    "x-private-data": "false",
     "x-requested-with": "XMLHttpRequest",
   },
   "nonStream": {
     "Authorization": "Bearer <TOK>",
     "Content-Type": "application/json",
-    "User-Agent": "CLI/2.108.1 CodeBuddy/2.108.1",
+    "User-Agent": "CLI/2.177.0 CodeBuddy/2.177.0",
     "X-IDE-Name": "CLI",
     "X-IDE-Type": "CLI",
+    "X-IDE-Version": "2.177.0",
     "X-Product": "SaaS",
+    "x-agent-intent": "craft",
+    "x-agent-purpose": "conversation",
+    "x-agent-runtime": "other",
+    "x-agent-type": "main",
     "x-codebuddy-request": "1",
+    "x-private-data": "false",
     "x-requested-with": "XMLHttpRequest",
   },
   "oauth": {
     "Accept": "text/event-stream",
     "Authorization": "Bearer <TOK>",
     "Content-Type": "application/json",
-    "User-Agent": "CLI/2.108.1 CodeBuddy/2.108.1",
+    "User-Agent": "CLI/2.177.0 CodeBuddy/2.177.0",
     "X-IDE-Name": "CLI",
     "X-IDE-Type": "CLI",
+    "X-IDE-Version": "2.177.0",
     "X-Product": "SaaS",
+    "x-agent-intent": "craft",
+    "x-agent-purpose": "conversation",
+    "x-agent-runtime": "other",
+    "x-agent-type": "main",
     "x-codebuddy-request": "1",
+    "x-private-data": "false",
     "x-requested-with": "XMLHttpRequest",
   },
 }
@@ -661,32 +704,50 @@ exports[`GOLDEN buildHeaders (default executor providers) > codebuddy-intl → h
     "Accept": "text/event-stream",
     "Authorization": "Bearer <TOK>",
     "Content-Type": "application/json",
-    "User-Agent": "IDE/2.108.1 CodeBuddy/2.108.1",
-    "X-IDE-Name": "IDE",
-    "X-IDE-Type": "IDE",
+    "User-Agent": "CLI/2.177.0 CodeBuddy/2.177.0",
+    "X-IDE-Name": "CLI",
+    "X-IDE-Type": "CLI",
+    "X-IDE-Version": "2.177.0",
     "X-Product": "SaaS",
+    "x-agent-intent": "craft",
+    "x-agent-purpose": "conversation",
+    "x-agent-runtime": "other",
+    "x-agent-type": "main",
     "x-codebuddy-request": "1",
+    "x-private-data": "false",
     "x-requested-with": "XMLHttpRequest",
   },
   "nonStream": {
     "Authorization": "Bearer <TOK>",
     "Content-Type": "application/json",
-    "User-Agent": "IDE/2.108.1 CodeBuddy/2.108.1",
-    "X-IDE-Name": "IDE",
-    "X-IDE-Type": "IDE",
+    "User-Agent": "CLI/2.177.0 CodeBuddy/2.177.0",
+    "X-IDE-Name": "CLI",
+    "X-IDE-Type": "CLI",
+    "X-IDE-Version": "2.177.0",
     "X-Product": "SaaS",
+    "x-agent-intent": "craft",
+    "x-agent-purpose": "conversation",
+    "x-agent-runtime": "other",
+    "x-agent-type": "main",
     "x-codebuddy-request": "1",
+    "x-private-data": "false",
     "x-requested-with": "XMLHttpRequest",
   },
   "oauth": {
     "Accept": "text/event-stream",
     "Authorization": "Bearer <TOK>",
     "Content-Type": "application/json",
-    "User-Agent": "IDE/2.108.1 CodeBuddy/2.108.1",
-    "X-IDE-Name": "IDE",
-    "X-IDE-Type": "IDE",
+    "User-Agent": "CLI/2.177.0 CodeBuddy/2.177.0",
+    "X-IDE-Name": "CLI",
+    "X-IDE-Type": "CLI",
+    "X-IDE-Version": "2.177.0",
     "X-Product": "SaaS",
+    "x-agent-intent": "craft",
+    "x-agent-purpose": "conversation",
+    "x-agent-runtime": "other",
+    "x-agent-type": "main",
     "x-codebuddy-request": "1",
+    "x-private-data": "false",
     "x-requested-with": "XMLHttpRequest",
   },
 }
@@ -1774,6 +1835,31 @@ exports[`GOLDEN buildHeaders (default executor providers) > tokenrouter → head
 }
 `;
 
+exports[`GOLDEN buildHeaders (default executor providers) > vengetic → headers (apiKey / oauth) 1`] = `
+{
+  "apiKey": {
+    "Accept": "text/event-stream",
+    "Authorization": "Bearer <TOK>",
+    "Content-Type": "application/json",
+    "HTTP-Referer": "https://endpoint-proxy.local",
+    "X-Title": "Endpoint Proxy",
+  },
+  "nonStream": {
+    "Authorization": "Bearer <TOK>",
+    "Content-Type": "application/json",
+    "HTTP-Referer": "https://endpoint-proxy.local",
+    "X-Title": "Endpoint Proxy",
+  },
+  "oauth": {
+    "Accept": "text/event-stream",
+    "Authorization": "Bearer <TOK>",
+    "Content-Type": "application/json",
+    "HTTP-Referer": "https://endpoint-proxy.local",
+    "X-Title": "Endpoint Proxy",
+  },
+}
+`;
+
 exports[`GOLDEN buildHeaders (default executor providers) > venice → headers (apiKey / oauth) 1`] = `
 {
   "apiKey": {
@@ -1978,6 +2064,13 @@ exports[`GOLDEN buildUrl (default executor providers) > anthropic → url (strea
 }
 `;
 
+exports[`GOLDEN buildUrl (default executor providers) > anyrouter → url (stream + non-stream) 1`] = `
+{
+  "nonStream": "https://anyrouter.dev/v1/chat/completions",
+  "stream": "https://anyrouter.dev/v1/chat/completions",
+}
+`;
+
 exports[`GOLDEN buildUrl (default executor providers) > api-airforce → url (stream + non-stream) 1`] = `
 {
   "nonStream": "https://api.airforce/v1/chat/completions",
@@ -2503,6 +2596,13 @@ exports[`GOLDEN buildUrl (default executor providers) > tokenrouter → url (str
 }
 `;
 
+exports[`GOLDEN buildUrl (default executor providers) > vengetic → url (stream + non-stream) 1`] = `
+{
+  "nonStream": "https://api.vengetic.biz.id/v1/chat/completions",
+  "stream": "https://api.vengetic.biz.id/v1/chat/completions",
+}
+`;
+
 exports[`GOLDEN buildUrl (default executor providers) > venice → url (stream + non-stream) 1`] = `
 {
   "nonStream": "https://api.venice.ai/api/v1/chat/completions",

package/tests/unit/custom-server-peer-headers.test.js

@@ -3,7 +3,7 @@
 import { describe, it, expect, beforeAll, afterAll } from "vitest";
 import { createRequire } from "node:module";
 import http from "node:http";
-import { __test__ as requestDetails } from "@/lib/db/repos/requestDetailsRepo.js";
+import { __test__ as requestDetails } from "@/lib/db/repos/observabilityRepo.js";
 
 const require = createRequire(import.meta.url);
 

package/tests/unit/observability-repo.test.js

@@ -0,0 +1,155 @@
+// Repo + helpers behind /api/observability/*.
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, it, expect, beforeAll, afterAll, vi } from "vitest";
+import { parseLogFilter, redactPayloads, toCsv, toJsonl } from "@/lib/observability/logQuery.js";
+
+const originalDataDir = process.env.DATA_DIR;
+let tempDir;
+let db;
+
+function insert(adapter, row) {
+  adapter.run(
+    `INSERT INTO requestDetails(id, timestamp, provider, model, connectionId, status, data) VALUES(?, ?, ?, ?, ?, ?, ?)`,
+    [row.id, row.timestamp, row.provider, row.model, row.connectionId || null, row.status, JSON.stringify(row)]
+  );
+}
+
+beforeAll(async () => {
+  tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "omnihilbras-observability-"));
+  process.env.DATA_DIR = tempDir;
+  vi.resetModules();
+  db = await import("@/lib/db/index.js");
+  await db.initDb();
+  await db.updateSettings({ enableObservability: true });
+  db.invalidateObservabilityConfig();
+
+  const { getAdapter } = await import("@/lib/db/driver.js");
+  const adapter = await getAdapter();
+  const now = Date.now();
+  insert(adapter, {
+    id: "a", timestamp: new Date(now - 60_000).toISOString(), provider: "openai", model: "gpt-4", status: "success",
+    latency: { total: 100 }, tokens: { prompt_tokens: 10, completion_tokens: 5 },
+  });
+  insert(adapter, {
+    id: "b", timestamp: new Date(now - 120_000).toISOString(), provider: "openai", model: "gpt-4", status: "error",
+    latency: { total: 300 }, tokens: {},
+  });
+  insert(adapter, {
+    id: "c", timestamp: new Date(now - 3 * 86400_000).toISOString(), provider: "claude", model: "sonnet", status: "success",
+    latency: { total: 200 }, tokens: { input_tokens: 7, output_tokens: 3 },
+  });
+});
+
+afterAll(() => {
+  if (tempDir) fs.rmSync(tempDir, { recursive: true, force: true });
+  if (originalDataDir === undefined) delete process.env.DATA_DIR;
+  else process.env.DATA_DIR = originalDataDir;
+});
+
+describe("observability stats", () => {
+  it("24h window counts only recent rows, with error rate and per-provider groups", async () => {
+    const s = await db.getObservabilityStats("24h");
+    expect(s.requests).toBe(2);
+    expect(s.errors).toBe(1);
+    expect(s.errorRate).toBe(0.5);
+    expect(s.promptTokens).toBe(10);
+    expect(s.completionTokens).toBe(5);
+    expect(s.avgLatency).toBe(200);
+    expect(s.byProvider).toEqual([{ key: "openai", requests: 2, errors: 1, tokens: 15, avgLatency: 200 }]);
+    expect(s.retention.records).toBe(3);
+  });
+
+  it("all period includes input_tokens/output_tokens shapes", async () => {
+    const s = await db.getObservabilityStats("all");
+    expect(s.period).toBe("all");
+    expect(s.requests).toBe(3);
+    expect(s.promptTokens).toBe(17);
+    expect(s.completionTokens).toBe(8);
+  });
+});
+
+describe("observability deletes and filters", () => {
+  it("filters by model and status", async () => {
+    const res = await db.getRequestLogEntries({ model: "gpt-4", status: "error" });
+    expect(res.details.map((d) => d.id)).toEqual(["b"]);
+  });
+
+  it("distinct facets", async () => {
+    expect(await db.getDistinctModels()).toEqual(["gpt-4", "sonnet"]);
+  });
+
+  it("deleteRequestLogsBefore removes only older rows", async () => {
+    const deleted = await db.deleteRequestLogsBefore(new Date(Date.now() - 86400_000));
+    expect(deleted).toBe(1);
+    expect(await db.getRequestLogDetailById("c")).toBeNull();
+  });
+
+  it("deleteRequestLogBatch and deleteRequestLogById", async () => {
+    expect(await db.deleteRequestLogBatch(["a", "missing"])).toBe(1);
+    expect(await db.deleteRequestLogById("b")).toBe(true);
+    expect(await db.deleteRequestLogById("b")).toBe(false);
+  });
+});
+
+describe("logQuery helpers", () => {
+  it("redacts every payload field but keeps metadata", () => {
+    const out = redactPayloads({ id: "x", model: "m", request: { messages: [] }, response: { content: "secret" } });
+    expect(out).toEqual({ id: "x", model: "m", request: { redacted: true }, response: { redacted: true } });
+  });
+
+  it("rejects invalid dates and skips empty values", () => {
+    expect(parseLogFilter(new URLSearchParams("startDate=nope")).error).toMatch(/startDate/);
+    expect(parseLogFilter({ provider: "", model: "gpt-4" }).filter).toEqual({ model: "gpt-4" });
+  });
+
+  it("CSV escapes quotes and commas; JSONL is one object per line", () => {
+    const rows = [{ id: "1", model: 'a,"b"', tokens: { input_tokens: 4 } }];
+    const csv = toCsv(rows).split("\n");
+    expect(csv[0]).toMatch(/^timestamp,id,provider,model/);
+    expect(csv[1]).toContain('"a,""b"""');
+    expect(csv[1]).toContain(",4,");
+    expect(toJsonl(rows)).toBe(JSON.stringify(rows[0]) + "\n");
+    expect(toJsonl([])).toBe("");
+  });
+});
+
+describe("observability on/off precedence", () => {
+  const saved = { obs: process.env.OBSERVABILITY_ENABLED, logs: process.env.ENABLE_REQUEST_LOGS };
+  const restore = () => {
+    for (const [key, value] of [["OBSERVABILITY_ENABLED", saved.obs], ["ENABLE_REQUEST_LOGS", saved.logs]]) {
+      if (value === undefined) delete process.env[key];
+      else process.env[key] = value;
+    }
+    db.invalidateObservabilityConfig();
+  };
+
+  it("UI toggle decides; ENABLE_REQUEST_LOGS (file logs) does not affect it", async () => {
+    try {
+      process.env.ENABLE_REQUEST_LOGS = "false";
+      await db.updateSettings({ enableObservability: true });
+      db.invalidateObservabilityConfig();
+      expect((await db.getObservabilityConfig()).enabled).toBe(true);
+
+      process.env.ENABLE_REQUEST_LOGS = "true";
+      await db.updateSettings({ enableObservability: false });
+      db.invalidateObservabilityConfig();
+      expect((await db.getObservabilityConfig()).enabled).toBe(false);
+    } finally {
+      restore();
+    }
+  });
+
+  it("OBSERVABILITY_ENABLED=false forces recording off over the UI toggle", async () => {
+    try {
+      process.env.OBSERVABILITY_ENABLED = "FALSE";
+      await db.updateSettings({ enableObservability: true });
+      db.invalidateObservabilityConfig();
+      expect(db.isObservabilityForcedOff()).toBe(true);
+      expect((await db.getObservabilityConfig()).enabled).toBe(false);
+    } finally {
+      restore();
+    }
+  });
+});

package/tests/unit/skill-store.test.js

@@ -0,0 +1,81 @@
+// Skill Marketplace service behind /api/skills.
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, it, expect, beforeAll, afterAll, vi } from "vitest";
+
+const originalDataDir = process.env.DATA_DIR;
+let tempDir;
+let store;
+let db;
+
+beforeAll(async () => {
+  tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "omnihilbras-skills-"));
+  process.env.DATA_DIR = tempDir;
+  vi.resetModules();
+  db = await import("@/lib/db/index.js");
+  await db.initDb();
+  store = await import("@/lib/skills/skillStore.js");
+});
+
+afterAll(() => {
+  if (tempDir) fs.rmSync(tempDir, { recursive: true, force: true });
+  if (originalDataDir === undefined) delete process.env.DATA_DIR;
+  else process.env.DATA_DIR = originalDataDir;
+});
+
+describe("skill store", () => {
+  it("catalog lists every bundled skill, entry skill first, none installed", async () => {
+    const all = await store.fetchManifest();
+    expect(all.length).toBeGreaterThanOrEqual(9);
+    expect(all[0].id).toBe("omnihilbras");
+    expect(all.every((s) => !s.installed)).toBe(true);
+  });
+
+  it("search matches text and filters by category", async () => {
+    expect((await store.searchSkills("transcribe")).map((s) => s.id)).toContain("omnihilbras-stt");
+    const web = await store.searchSkills("", "web");
+    expect(web.map((s) => s.id).sort()).toEqual(["omnihilbras-web-fetch", "omnihilbras-web-search"]);
+    expect(await store.searchSkills("no-such-skill-xyz")).toEqual([]);
+  });
+
+  it("install writes SKILL.md under DATA_DIR and records it", async () => {
+    const skill = await store.installSkill("omnihilbras-chat");
+    const file = path.join(tempDir, "skills", "omnihilbras-chat", "SKILL.md");
+    expect(skill.installed).toBe(true);
+    expect(skill.path).toBe(file);
+    expect(fs.readFileSync(file, "utf8")).toBe(store.getSkillText("omnihilbras-chat"));
+    expect((await store.listInstalledSkills()).map((s) => s.id)).toEqual(["omnihilbras-chat"]);
+  });
+
+  it("flags an update when the installed version differs, and update clears it", async () => {
+    const row = await db.getInstalledSkill("omnihilbras-chat");
+    await db.saveInstalledSkill("omnihilbras-chat", { ...row, sha256: "old" });
+    expect((await store.getSkill("omnihilbras-chat")).updateAvailable).toBe(true);
+    const updated = await store.installSkill("omnihilbras-chat");
+    expect(updated.updateAvailable).toBe(false);
+    expect(updated.installedAt).toBe(row.installedAt);
+  });
+
+  it("a row whose file was deleted by hand reads as not installed", async () => {
+    await store.installSkill("omnihilbras-tts");
+    fs.rmSync(path.join(tempDir, "skills", "omnihilbras-tts"), { recursive: true });
+    expect((await store.getSkill("omnihilbras-tts")).installed).toBe(false);
+    expect((await store.listInstalledSkills()).map((s) => s.id)).not.toContain("omnihilbras-tts");
+  });
+
+  it("uninstall removes the file and the row", async () => {
+    expect(await store.uninstallSkill("omnihilbras-chat")).toBe(true);
+    expect(fs.existsSync(path.join(tempDir, "skills", "omnihilbras-chat"))).toBe(false);
+    expect(await db.getInstalledSkill("omnihilbras-chat")).toBeNull();
+    expect(await store.uninstallSkill("omnihilbras-chat")).toBe(false);
+  });
+
+  it("rejects ids that are not catalog keys or could escape the install dir", async () => {
+    expect(await store.installSkill("not-in-catalog")).toBeNull();
+    for (const id of ["../etc", "a/b", "", "UPPER", ".hidden"]) {
+      expect(store.isValidSkillId(id)).toBe(false);
+      expect(await store.uninstallSkill(id)).toBe(false);
+    }
+  });
+});

package/tests/unit/skills-index.test.js

@@ -0,0 +1,20 @@
+// skills/SKILLS_INDEX.json is generated by `prebuild`; this fails when a
+// SKILL.md changed without regenerating it (run: node scripts/build-skills-index.mjs).
+import fs from "node:fs";
+import path from "node:path";
+import { describe, it, expect } from "vitest";
+import { buildSkillsIndex, parseFrontmatter } from "../../scripts/build-skills-index.mjs";
+
+const root = path.resolve(__dirname, "../..");
+
+describe("skills index", () => {
+  it("matches the skills/ folder", () => {
+    const committed = JSON.parse(fs.readFileSync(path.join(root, "skills/SKILLS_INDEX.json"), "utf8"));
+    expect(committed).toEqual(buildSkillsIndex(path.join(root, "skills")));
+  });
+
+  it("parses frontmatter name and description", () => {
+    expect(parseFrontmatter("---\nname: x\ndescription: \"Does y: z\"\n---\n# body")).toEqual({ name: "x", description: "Does y: z" });
+    expect(parseFrontmatter("# no frontmatter")).toEqual({});
+  });
+});