@absolutejs/absolute 0.19.0-beta.444 → 0.19.0-beta.446

package/dist/ai/index.js

@@ -2467,6 +2467,85 @@ var createRAGCollection = (options) => {
   };
 };
 
+// src/ai/rag/htmxWorkflowRenderers.ts
+var escapeHtml2 = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+var renderEmptyState = (kind) => {
+  switch (kind) {
+    case "documents":
+      return '<p class="rag-empty">No documents indexed.</p>';
+    case "searchResults":
+      return '<p class="rag-empty">No matching chunks.</p>';
+    case "chunkPreview":
+      return '<p class="rag-empty">No chunk preview available.</p>';
+    case "status":
+    default:
+      return '<p class="rag-empty">No status available.</p>';
+  }
+};
+var renderCapabilityList = (capabilities) => {
+  if (!capabilities) {
+    return "";
+  }
+  const items = [
+    `backend=${capabilities.backend}`,
+    `persistence=${capabilities.persistence}`,
+    `nativeVectorSearch=${capabilities.nativeVectorSearch ? "true" : "false"}`,
+    `serverSideFiltering=${capabilities.serverSideFiltering ? "true" : "false"}`,
+    `streamingIngestStatus=${capabilities.streamingIngestStatus ? "true" : "false"}`
+  ];
+  return '<ul class="rag-status-capabilities">' + items.map((item) => `<li>${escapeHtml2(item)}</li>`).join("") + "</ul>";
+};
+var defaultStatus = ({
+  status,
+  capabilities
+}) => {
+  if (!status) {
+    return renderEmptyState("status");
+  }
+  return '<dl class="rag-status">' + `<div><dt>Backend</dt><dd>${escapeHtml2(status.backend)}</dd></div>` + `<div><dt>Vector mode</dt><dd>${escapeHtml2(status.vectorMode)}</dd></div>` + `<div><dt>Embedding dimensions</dt><dd>${status.dimensions ?? "n/a"}</dd></div>` + `<div><dt>Vector acceleration</dt><dd>${status.native?.active ? "active" : "inactive"}</dd></div>` + "</dl>" + renderCapabilityList(capabilities);
+};
+var defaultSearchResultItem = (source, index) => '<article class="rag-search-result">' + `<h3>${escapeHtml2(source.title ?? source.chunkId ?? `Result ${index + 1}`)}</h3>` + `<p class="rag-search-source">${escapeHtml2(source.source ?? "unknown source")}</p>` + `<p class="rag-search-score">score ${source.score.toFixed(3)}</p>` + `<p class="rag-search-text">${escapeHtml2(source.text)}</p>` + "</article>";
+var defaultSearchResults = ({
+  query,
+  results
+}) => results.length === 0 ? renderEmptyState("searchResults") : '<section class="rag-search-results">' + `<p class="rag-search-summary">${results.length} results for ${escapeHtml2(query)}</p>` + results.map((result, index) => defaultSearchResultItem(result, index)).join("") + "</section>";
+var defaultDocumentItem = (document, index) => '<article class="rag-document">' + `<h3>${escapeHtml2(document.title || `Document ${index + 1}`)}</h3>` + `<p class="rag-document-id">${escapeHtml2(document.id)}</p>` + `<p class="rag-document-source">${escapeHtml2(document.source)}</p>` + `<p class="rag-document-meta">${escapeHtml2(document.format ?? "text")} \xB7 ${escapeHtml2(document.chunkStrategy ?? "paragraphs")} \xB7 ${document.chunkCount ?? 0} chunks</p>` + "</article>";
+var defaultDocuments = ({
+  documents
+}) => documents.length === 0 ? renderEmptyState("documents") : '<section class="rag-documents">' + documents.map((document, index) => defaultDocumentItem(document, index)).join("") + "</section>";
+var defaultChunkPreview = (input) => '<section class="rag-chunk-preview">' + `<h3>${escapeHtml2(input.document.title)}</h3>` + `<p class="rag-chunk-preview-source">${escapeHtml2(input.document.source)}</p>` + '<article class="rag-chunk-normalized">' + "<h4>Normalized text</h4>" + `<pre>${escapeHtml2(input.normalizedText)}</pre>` + "</article>" + input.chunks.map((chunk) => '<article class="rag-chunk">' + `<h4>${escapeHtml2(chunk.chunkId)}</h4>` + `<p class="rag-chunk-meta">chunk ${chunk.metadata?.chunkIndex ?? 0} of ${chunk.metadata?.chunkCount ?? input.chunks.length}</p>` + `<pre>${escapeHtml2(chunk.text)}</pre>` + "</article>").join("") + "</section>";
+var defaultMutationResult = (input) => {
+  if (!input.ok) {
+    return `<div class="rag-mutation error">${escapeHtml2(input.error ?? "Request failed")}</div>`;
+  }
+  const details = [];
+  if (input.status) {
+    details.push(input.status);
+  }
+  if (input.inserted) {
+    details.push(`inserted=${input.inserted}`);
+  }
+  if (input.deleted) {
+    details.push(`deleted=${input.deleted}`);
+  }
+  if (typeof input.documents === "number") {
+    details.push(`documents=${input.documents}`);
+  }
+  return `<div class="rag-mutation ok">${escapeHtml2(details.join(" \xB7 ") || "ok")}</div>`;
+};
+var defaultError2 = (message) => `<div class="rag-error">${escapeHtml2(message)}</div>`;
+var resolveRAGWorkflowRenderers = (custom) => ({
+  status: custom?.status ?? defaultStatus,
+  searchResults: custom?.searchResults ?? defaultSearchResults,
+  searchResultItem: custom?.searchResultItem ?? defaultSearchResultItem,
+  documents: custom?.documents ?? defaultDocuments,
+  documentItem: custom?.documentItem ?? defaultDocumentItem,
+  chunkPreview: custom?.chunkPreview ?? defaultChunkPreview,
+  mutationResult: custom?.mutationResult ?? defaultMutationResult,
+  emptyState: custom?.emptyState ?? renderEmptyState,
+  error: custom?.error ?? defaultError2
+});
+
 // src/ai/rag/types.ts
 var buildRAGContext = (hits) => {
   if (hits.length === 0) {
@@ -2492,6 +2571,7 @@ var DEFAULT_TOP_K2 = 6;
 var DEFAULT_PREFIX_LEN = 12;
 var DEFAULT_PROVIDER = "anthropic";
 var TITLE_MAX_LENGTH2 = 80;
+var HTML_HEADERS = { "Content-Type": "text/html; charset=utf-8" };
 var defaultParseProvider2 = (content) => {
   const colonIdx = content.indexOf(":");
   const hasPrefix = colonIdx > 0 && colonIdx < DEFAULT_PREFIX_LEN;
@@ -2502,6 +2582,7 @@ var defaultParseProvider2 = (content) => {
   };
 };
 var normalizeScore = (value) => Number.isFinite(value) ? value : 0;
+var isHTMXRequest = (request) => request.headers.get("HX-Request") === "true";
 var buildSources = (results) => results.map((result) => ({
   chunkId: result.chunkId,
   score: normalizeScore(result.score),
@@ -2619,6 +2700,14 @@ var ragChat = (config) => {
   const abortControllers = new Map;
   const includeCompleteSources = config.ragCompleteSources === true;
   const indexManager = config.indexManager;
+  const workflowRenderers = resolveRAGWorkflowRenderers(typeof config.htmx === "object" ? config.htmx.workflow?.render : undefined);
+  const toHTMXResponse = (html, status, extraHeaders) => new Response(html, {
+    headers: {
+      ...HTML_HEADERS,
+      ...extraHeaders
+    },
+    status: typeof status === "number" ? status : 200
+  });
   const appendMessage2 = (conversation, message) => {
     conversation.messages.push(message);
     conversation.lastMessageAt = Date.now();
@@ -3008,23 +3097,68 @@ var ragChat = (config) => {
         await handleMessage(ws, msg.content, msg.conversationId, msg.attachments);
       }
     }
-  }).post(`${path}/search`, async ({ body }) => handleSearch(body)).get(`${path}/status`, () => handleStatus()).get(`${path}/documents`, async ({ query, set }) => {
+  }).post(`${path}/search`, async ({ body, request, set }) => {
+    const result = await handleSearch(body);
+    if (!result.ok) {
+      set.status = result.error === "Invalid payload" || result.error?.startsWith("Expected payload shape:") ? 400 : 404;
+    }
+    if (config.htmx && isHTMXRequest(request)) {
+      if (!result.ok) {
+        return toHTMXResponse(workflowRenderers.error(result.error ?? "Search failed"), set.status);
+      }
+      const query = body && typeof body === "object" && typeof body.query === "string" ? body.query : "";
+      return toHTMXResponse(workflowRenderers.searchResults({
+        query,
+        results: result.results ?? []
+      }));
+    }
+    return result;
+  }).get(`${path}/status`, ({ request }) => {
+    const result = handleStatus();
+    if (config.htmx && isHTMXRequest(request)) {
+      return toHTMXResponse(workflowRenderers.status({
+        capabilities: result.capabilities,
+        status: result.status
+      }));
+    }
+    return result;
+  }).get(`${path}/documents`, async ({ query, request, set }) => {
     const result = await handleDocuments(typeof query?.kind === "string" ? query.kind : undefined);
     if (!result.ok) {
       set.status = 404;
     }
+    if (config.htmx && isHTMXRequest(request)) {
+      if (!result.ok) {
+        return toHTMXResponse(workflowRenderers.error(result.error), set.status);
+      }
+      return toHTMXResponse(workflowRenderers.documents({
+        documents: result.documents
+      }));
+    }
     return result;
-  }).post(`${path}/documents`, async ({ body, set }) => {
+  }).post(`${path}/documents`, async ({ body, request, set }) => {
     const result = await handleCreateDocument(body);
     if (!result.ok) {
       set.status = result.error === "Invalid payload" ? 400 : result.error?.includes("not configured") ? 404 : 400;
     }
+    if (config.htmx && isHTMXRequest(request)) {
+      const html = result.ok ? workflowRenderers.mutationResult(result) : workflowRenderers.error(result.error ?? "Failed to create document");
+      return toHTMXResponse(html, set.status, {
+        "HX-Trigger": "rag:mutated"
+      });
+    }
     return result;
-  }).get(`${path}/documents/:id/chunks`, async ({ params, set }) => {
+  }).get(`${path}/documents/:id/chunks`, async ({ params, request, set }) => {
     const result = await handleDocumentChunks(typeof params.id === "string" ? params.id.trim() : "");
     if (!result.ok) {
       set.status = result.error === "document id is required" ? 400 : result.error === "document not found" ? 404 : 404;
     }
+    if (config.htmx && isHTMXRequest(request)) {
+      if (!result.ok) {
+        return toHTMXResponse(workflowRenderers.error(result.error), set.status);
+      }
+      return toHTMXResponse(workflowRenderers.chunkPreview(result));
+    }
     return result;
   }).get(`${path}/backends`, async ({ set }) => {
     const result = await handleBackends();
@@ -3038,23 +3172,41 @@ var ragChat = (config) => {
     }
     await ragStore.clear?.();
     return { ok: true };
-  }).delete(`${path}/documents/:id`, async ({ params, set }) => {
+  }).delete(`${path}/documents/:id`, async ({ params, request, set }) => {
     const result = await handleDeleteDocument(typeof params.id === "string" ? params.id.trim() : "");
     if (!result.ok) {
       set.status = result.error === "document id is required" ? 400 : result.error === "document not found" ? 404 : 404;
     }
+    if (config.htmx && isHTMXRequest(request)) {
+      const html = result.ok ? workflowRenderers.mutationResult(result) : workflowRenderers.error(result.error ?? "Failed to delete document");
+      return toHTMXResponse(html, set.status, {
+        "HX-Trigger": "rag:mutated"
+      });
+    }
     return result;
-  }).post(`${path}/reseed`, async ({ set }) => {
+  }).post(`${path}/reseed`, async ({ request, set }) => {
     const result = await handleReseed();
     if (!result.ok) {
       set.status = 404;
     }
+    if (config.htmx && isHTMXRequest(request)) {
+      const html = result.ok ? workflowRenderers.mutationResult(result) : workflowRenderers.error(result.error ?? "Failed to reseed index");
+      return toHTMXResponse(html, set.status, {
+        "HX-Trigger": "rag:mutated"
+      });
+    }
     return result;
-  }).post(`${path}/reset`, async ({ set }) => {
+  }).post(`${path}/reset`, async ({ request, set }) => {
     const result = await handleReset();
     if (!result.ok) {
       set.status = 404;
     }
+    if (config.htmx && isHTMXRequest(request)) {
+      const html = result.ok ? workflowRenderers.mutationResult(result) : workflowRenderers.error(result.error ?? "Failed to reset index");
+      return toHTMXResponse(html, set.status, {
+        "HX-Trigger": "rag:mutated"
+      });
+    }
     return result;
   }).get(`${path}/conversations`, () => store.list()).get(`${path}/conversations/:id`, async ({ params }) => {
     const conv = await store.get(params.id);
@@ -4166,5 +4318,5 @@ export {
   aiChat
 };
 
-//# debugId=C4FB024A221A442464756E2164756E21
+//# debugId=8FF738CEBD89B6A864756E2164756E21
 //# sourceMappingURL=index.js.map