feat: add the community-funded Homarr assistant provider (#6563)

* Add Homarr provider proxy foundation

* Complete Homarr provider integration

* Harden Homarr provider integration

* Address Homarr provider review feedback

* Address CodeRabbit provider feedback

* Localize provider errors

* Handle provider activity load failures

* docs: improve workshop and homepage

* Harden Homarr provider limits

* fix: harden the Homarr provider

* fix: address provider review feedback

* fix: clarify provider request accounting

* feat: complete the Homarr provider endpoint

* fix: terminate invalid provider streams

apps/nextjs/src/components/workshop/workshop-client.ts

@@ -3,13 +3,23 @@ import { WORKSHOP_API_URL, WORKSHOP_WEB_URL } from "@homarr/workshop/schema";
 
 let browserClient: WorkshopBackend | undefined;
 
+export function getWorkshopApiUrl() {
+  const runtimeUrl =
+    typeof document === "undefined"
+      ? undefined
+      : document.querySelector<HTMLMetaElement>('meta[name="homarr-workshop-api-url"]')?.content;
+  return (runtimeUrl || WORKSHOP_API_URL).replace(/\/+$/u, "");
+}
+
+export function getWorkshopAssistantProviderUrl() {
+  return `${getWorkshopApiUrl()}/api/ai/v1`;
+}
+
 export function createWorkshopClient() {
-  if (typeof document === "undefined") return new WorkshopBackend(WORKSHOP_API_URL);
+  if (typeof document === "undefined") return new WorkshopBackend(getWorkshopApiUrl());
   if (browserClient) return browserClient;
 
-  const runtimeUrl = document.querySelector<HTMLMetaElement>('meta[name="homarr-workshop-api-url"]')?.content;
-
-  browserClient = new WorkshopBackend(runtimeUrl || WORKSHOP_API_URL);
+  browserClient = new WorkshopBackend(getWorkshopApiUrl());
   return browserClient;
 }
 

apps/nextjs/src/components/workshop/workshop-install-flow.spec.ts

@@ -3,7 +3,7 @@
 import { readFileSync } from "node:fs";
 import { afterEach, describe, expect, it } from "vitest";
 
-import { getWorkshopWebUrl } from "./workshop-client";
+import { getWorkshopAssistantProviderUrl, getWorkshopWebUrl } from "./workshop-client";
 
 describe("Workshop widget install flow", () => {
   afterEach(() => {
@@ -17,6 +17,12 @@ describe("Workshop widget install flow", () => {
     expect(getWorkshopWebUrl("widget/id")).toBe("https://preview.example/workshop/widget%2Fid");
   });
 
+  it("derives the Homarr provider endpoint from the runtime Workshop API", () => {
+    document.head.innerHTML = '<meta name="homarr-workshop-api-url" content="https://api.preview.example/">';
+
+    expect(getWorkshopAssistantProviderUrl()).toBe("https://api.preview.example/api/ai/v1");
+  });
+
   it("uses one registered modal stack for browsing, details, reports, and confirmation", () => {
     const installButton = readFileSync(
       `${process.cwd()}/apps/nextjs/src/components/workshop/workshop-install-button.tsx`,