@infuro/cms-core 1.0.20 → 1.0.22

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { C as CompanyDetails, T as TemplateContext, E as EmailTemplateResult, a as EmailTemplateName, O as OrderPlacedLineItem, S as StorageService, b as EntityMap$2 } from './index-DGtM2Gsk.cjs';
-export { A as AnalyticsHandlerConfig, c as AuthHandlersConfig, B as BlogBySlugConfig, d as ChangePasswordConfig, e as ChatPublicConfig, f as CmsApiHandlerConfig, g as CmsGetter, h as CrudHandlerOptions, D as DashboardStatsConfig, i as EcommerceAnalyticsConfig, F as ForgotPasswordConfig, j as FormBySlugConfig, G as GetPublicSettingsGroupConfig, k as GetPublicSettingsGroupDataSource, I as InviteAcceptConfig, L as LlmAgentKnowledgeApiConfig, l as LlmAgentValidationRulesJson, P as ParsedLlmAgentValidation, m as SetPasswordConfig, n as SettingsApiConfig, o as SocialLinkItem, p as StorefrontApiConfig, q as StorefrontOtpFlags, U as UploadHandlerConfig, r as UserAuthApiConfig, s as UserAvatarConfig, t as UserProfileConfig, u as UsersApiConfig, v as createAnalyticsHandlers, w as createBlogBySlugHandler, x as createChangePasswordHandler, y as createCmsApiHandler, z as createCrudByIdHandler, H as createCrudHandler, J as createDashboardStatsHandler, K as createEcommerceAnalyticsHandler, M as createForgotPasswordHandler, N as createFormBySlugHandler, Q as createInviteAcceptHandler, R as createLlmAgentKnowledgeHandlers, V as createMediaZipExtractHandler, W as createSetPasswordHandler, X as createSettingsApiHandlers, Y as createStorefrontApiHandler, Z as createUploadHandler, _ as createUserAuthApiRouter, $ as createUserAvatarHandler, a0 as createUserProfileHandler, a1 as createUsersApiHandlers, a2 as getCompanyDetailsFromSettings, a3 as getPublicSettingsGroup, a4 as mergeEmailLayoutCompanyDetails, a5 as mergeGuardrailsIntoSystemPrompt, a6 as parseLlmAgentValidationRules, a7 as validateUserMessageAgainstAgentRules, a8 as validateUserMessageAgainstStructuredRules } from './index-DGtM2Gsk.cjs';
+import { C as CompanyDetails, T as TemplateContext, E as EmailTemplateResult, a as EmailTemplateName, O as OrderPlacedLineItem, S as StorageService, b as EntityMap$2 } from './index-BGAh4fPQ.cjs';
+export { A as AnalyticsHandlerConfig, c as AuthHandlersConfig, B as BlogBySlugConfig, d as ChangePasswordConfig, e as ChatPublicConfig, f as CmsApiHandlerConfig, g as CmsGetter, h as CrudHandlerOptions, D as DashboardStatsConfig, i as EcommerceAnalyticsConfig, F as ForgotPasswordConfig, j as FormBySlugConfig, G as GetPublicSettingsGroupConfig, k as GetPublicSettingsGroupDataSource, I as InviteAcceptConfig, L as LlmAgentKnowledgeApiConfig, l as LlmAgentValidationRulesJson, P as ParsedLlmAgentValidation, m as SetPasswordConfig, n as SettingsApiConfig, o as SocialLinkItem, p as StorefrontApiConfig, q as StorefrontOtpFlags, U as UploadHandlerConfig, r as UserAuthApiConfig, s as UserAvatarConfig, t as UserProfileConfig, u as UsersApiConfig, v as createAnalyticsHandlers, w as createBlogBySlugHandler, x as createChangePasswordHandler, y as createCmsApiHandler, z as createCrudByIdHandler, H as createCrudHandler, J as createDashboardStatsHandler, K as createEcommerceAnalyticsHandler, M as createForgotPasswordHandler, N as createFormBySlugHandler, Q as createInviteAcceptHandler, R as createLlmAgentKnowledgeHandlers, V as createMediaZipExtractHandler, W as createSetPasswordHandler, X as createSettingsApiHandlers, Y as createStorefrontApiHandler, Z as createUploadHandler, _ as createUserAuthApiRouter, $ as createUserAvatarHandler, a0 as createUserProfileHandler, a1 as createUsersApiHandlers, a2 as getCompanyDetailsFromSettings, a3 as getPublicSettingsGroup, a4 as mergeEmailLayoutCompanyDetails, a5 as mergeGuardrailsIntoSystemPrompt, a6 as parseLlmAgentValidationRules, a7 as validateUserMessageAgainstAgentRules, a8 as validateUserMessageAgainstStructuredRules } from './index-BGAh4fPQ.cjs';
 import { ClassValue } from 'clsx';
 import * as typeorm from 'typeorm';
 import { DataSource, EntityTarget, ObjectLiteral } from 'typeorm';
@@ -532,40 +532,48 @@ interface LlmServiceInterface {
     streamChatAgent(options: LlmAgentOptions): AsyncIterable<string>;
     /**
      * Embeddings for RAG / knowledge base. Wire format depends on {@link LlmServiceEmbedOptions}:
-     * OpenAI `{base}/v1/embeddings` or Hugging Face Inference `…/models/{model}`.
+     * OpenAI `{base}/v1/embeddings`, or Hugging Face via `@huggingface/inference` (Hub-routed feature extraction) with legacy HTTP fallback.
      */
     embed?(text: string, options?: {
         model?: string;
     }): Promise<number[]>;
 }
-/**
- * Normalize Hugging Face Inference feature-extraction response to a single `number[]`.
- */
 declare function parseHfInferenceEmbeddingBody(data: unknown): number[] | null;
 type LlmEmbeddingProvider = 'openai' | 'huggingface';
 interface LlmServiceEmbedOptions {
     embeddingProvider?: LlmEmbeddingProvider;
-    /** Default `https://api-inference.huggingface.co` when using Hugging Face Inference. */
+    /** Legacy manual HTTP base when the Inference SDK path fails; default `https://router.huggingface.co/v1` (router host is normalized to `…/hf-inference`). */
     hfInferenceBaseUrl?: string;
     /** Token for embedding calls; defaults to chat `apiKey`. */
     embeddingApiKey?: string;
+    /**
+     * Default `model` for `POST …/v1/chat/completions` when the caller omits `model`.
+     * Set via plugin / CMS `LLM_CHAT_MODEL` or env `LLM_CHAT_MODEL`.
+     * If unset, the library picks a fallback from `LLM_GATEWAY_URL` (HF router vs OpenRouter-style).
+     */
+    defaultChatModel?: string;
 }
 /**
  * Set `LLM_DEBUG=1` (or `true` / `yes`) to log composed chat payloads.
  * Set `LLM_EMBED_DEBUG=1` for per-request embedding logs (verbose with many chunks).
+ * Set `LLM_CHAT_MODEL` for the default chat model when agents/requests omit `model` (gateway-specific id).
+ * If unset, fallback is chosen from `LLM_GATEWAY_URL` (HF vs other).
  */
 declare class LlmService implements LlmServiceInterface {
     private static embedHttpErrorLogged;
     private static embedShapeErrorLogged;
     private static embedSuccessLogged;
     private static hfDimensionMismatchWarned;
+    private static hfInferenceSdkErrorLogged;
     private readonly baseURL;
     private readonly apiKey;
     private readonly defaultEmbeddingModel?;
     private readonly embeddingProvider;
     private readonly hfInferenceBaseURL;
     private readonly embeddingApiKey;
+    private readonly defaultChatModel;
     constructor(baseURL: string, apiKey: string, defaultEmbeddingModel?: string, embedOpts?: LlmServiceEmbedOptions);
+    private resolveChatModel;
     private get base();
     private get url();
     private llmDebugEnabled;
@@ -576,6 +584,21 @@ declare class LlmService implements LlmServiceInterface {
     embed(text: string, options?: {
         model?: string;
     }): Promise<number[]>;
+    /**
+     * POST `{ url }` with OpenAI-style `{ model, input }` and Bearer token; parses `{ data:[{embedding}] }`.
+     */
+    private fetchOpenAiShapeEmbeddings;
+    /**
+     * Hugging Face–recommended path: Hub resolves a provider that supports `feature-extraction` for the model.
+     */
+    private embedViaHuggingfaceInferenceSdk;
+    /** Base URL for legacy `…/pipeline/…` and `…/models/{model}` tries (HF router only). */
+    private hfLegacyInferenceBase;
+    /**
+     * Hugging Face embeddings: `@huggingface/inference` (Hub-routed feature extraction), then
+     * legacy direct `hf-inference` HTTP tries. Note: `https://router.huggingface.co/v1/embeddings` is not
+     * offered for embeddings (OpenAI-compatible `/v1` on HF is chat-only).
+     */
     private embedHuggingFaceInference;
     private buildAgentMessages;
     chatAgent(options: LlmAgentOptions): Promise<{
@@ -591,14 +614,16 @@ declare class LlmService implements LlmServiceInterface {
 interface LlmPluginConfig {
     baseURL?: string;
     apiKey?: string;
+    /** Default chat model when agents omit `model` (`POST /v1/chat/completions`). Env: `LLM_CHAT_MODEL`. If unset, inferred from `LLM_GATEWAY_URL` (HF vs OpenRouter-style default). */
+    defaultChatModel?: string;
     /** Default model for embed(); also from env EMBEDDING_MODEL. */
     embeddingModel?: string;
     /**
      * `openai` (default): `POST {LLM_GATEWAY_URL}/v1/embeddings`.
-     * `huggingface`: `POST {HF_INFERENCE_URL}/models/{EMBEDDING_MODEL}` (Inference API). Env: `EMBEDDING_PROVIDER=huggingface`.
+     * `huggingface`: `@huggingface/inference` feature extraction (Hub-routed), with legacy `…/hf-inference/…` HTTP fallback. Env: `EMBEDDING_PROVIDER=huggingface`.
      */
     embeddingProvider?: LlmEmbeddingProvider;
-    /** Hugging Face Inference API base; default `https://api-inference.huggingface.co`. Env: `HF_INFERENCE_URL`. */
+    /** Legacy HTTP base if the SDK path fails; default `https://router.huggingface.co/v1` (router hosts map to `…/hf-inference`). Env: `HF_INFERENCE_URL`. */
     hfInferenceBaseUrl?: string;
     /** Optional; defaults to `apiKey`. Env: `EMBEDDING_API_KEY`. */
     embeddingApiKey?: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CompanyDetails, T as TemplateContext, E as EmailTemplateResult, a as EmailTemplateName, O as OrderPlacedLineItem, S as StorageService, b as EntityMap$2 } from './index--GBYw5JE.js';
-export { A as AnalyticsHandlerConfig, c as AuthHandlersConfig, B as BlogBySlugConfig, d as ChangePasswordConfig, e as ChatPublicConfig, f as CmsApiHandlerConfig, g as CmsGetter, h as CrudHandlerOptions, D as DashboardStatsConfig, i as EcommerceAnalyticsConfig, F as ForgotPasswordConfig, j as FormBySlugConfig, G as GetPublicSettingsGroupConfig, k as GetPublicSettingsGroupDataSource, I as InviteAcceptConfig, L as LlmAgentKnowledgeApiConfig, l as LlmAgentValidationRulesJson, P as ParsedLlmAgentValidation, m as SetPasswordConfig, n as SettingsApiConfig, o as SocialLinkItem, p as StorefrontApiConfig, q as StorefrontOtpFlags, U as UploadHandlerConfig, r as UserAuthApiConfig, s as UserAvatarConfig, t as UserProfileConfig, u as UsersApiConfig, v as createAnalyticsHandlers, w as createBlogBySlugHandler, x as createChangePasswordHandler, y as createCmsApiHandler, z as createCrudByIdHandler, H as createCrudHandler, J as createDashboardStatsHandler, K as createEcommerceAnalyticsHandler, M as createForgotPasswordHandler, N as createFormBySlugHandler, Q as createInviteAcceptHandler, R as createLlmAgentKnowledgeHandlers, V as createMediaZipExtractHandler, W as createSetPasswordHandler, X as createSettingsApiHandlers, Y as createStorefrontApiHandler, Z as createUploadHandler, _ as createUserAuthApiRouter, $ as createUserAvatarHandler, a0 as createUserProfileHandler, a1 as createUsersApiHandlers, a2 as getCompanyDetailsFromSettings, a3 as getPublicSettingsGroup, a4 as mergeEmailLayoutCompanyDetails, a5 as mergeGuardrailsIntoSystemPrompt, a6 as parseLlmAgentValidationRules, a7 as validateUserMessageAgainstAgentRules, a8 as validateUserMessageAgainstStructuredRules } from './index--GBYw5JE.js';
+import { C as CompanyDetails, T as TemplateContext, E as EmailTemplateResult, a as EmailTemplateName, O as OrderPlacedLineItem, S as StorageService, b as EntityMap$2 } from './index-Cnwh7B3r.js';
+export { A as AnalyticsHandlerConfig, c as AuthHandlersConfig, B as BlogBySlugConfig, d as ChangePasswordConfig, e as ChatPublicConfig, f as CmsApiHandlerConfig, g as CmsGetter, h as CrudHandlerOptions, D as DashboardStatsConfig, i as EcommerceAnalyticsConfig, F as ForgotPasswordConfig, j as FormBySlugConfig, G as GetPublicSettingsGroupConfig, k as GetPublicSettingsGroupDataSource, I as InviteAcceptConfig, L as LlmAgentKnowledgeApiConfig, l as LlmAgentValidationRulesJson, P as ParsedLlmAgentValidation, m as SetPasswordConfig, n as SettingsApiConfig, o as SocialLinkItem, p as StorefrontApiConfig, q as StorefrontOtpFlags, U as UploadHandlerConfig, r as UserAuthApiConfig, s as UserAvatarConfig, t as UserProfileConfig, u as UsersApiConfig, v as createAnalyticsHandlers, w as createBlogBySlugHandler, x as createChangePasswordHandler, y as createCmsApiHandler, z as createCrudByIdHandler, H as createCrudHandler, J as createDashboardStatsHandler, K as createEcommerceAnalyticsHandler, M as createForgotPasswordHandler, N as createFormBySlugHandler, Q as createInviteAcceptHandler, R as createLlmAgentKnowledgeHandlers, V as createMediaZipExtractHandler, W as createSetPasswordHandler, X as createSettingsApiHandlers, Y as createStorefrontApiHandler, Z as createUploadHandler, _ as createUserAuthApiRouter, $ as createUserAvatarHandler, a0 as createUserProfileHandler, a1 as createUsersApiHandlers, a2 as getCompanyDetailsFromSettings, a3 as getPublicSettingsGroup, a4 as mergeEmailLayoutCompanyDetails, a5 as mergeGuardrailsIntoSystemPrompt, a6 as parseLlmAgentValidationRules, a7 as validateUserMessageAgainstAgentRules, a8 as validateUserMessageAgainstStructuredRules } from './index-Cnwh7B3r.js';
 import { ClassValue } from 'clsx';
 import * as typeorm from 'typeorm';
 import { DataSource, EntityTarget, ObjectLiteral } from 'typeorm';
@@ -532,40 +532,48 @@ interface LlmServiceInterface {
     streamChatAgent(options: LlmAgentOptions): AsyncIterable<string>;
     /**
      * Embeddings for RAG / knowledge base. Wire format depends on {@link LlmServiceEmbedOptions}:
-     * OpenAI `{base}/v1/embeddings` or Hugging Face Inference `…/models/{model}`.
+     * OpenAI `{base}/v1/embeddings`, or Hugging Face via `@huggingface/inference` (Hub-routed feature extraction) with legacy HTTP fallback.
      */
     embed?(text: string, options?: {
         model?: string;
     }): Promise<number[]>;
 }
-/**
- * Normalize Hugging Face Inference feature-extraction response to a single `number[]`.
- */
 declare function parseHfInferenceEmbeddingBody(data: unknown): number[] | null;
 type LlmEmbeddingProvider = 'openai' | 'huggingface';
 interface LlmServiceEmbedOptions {
     embeddingProvider?: LlmEmbeddingProvider;
-    /** Default `https://api-inference.huggingface.co` when using Hugging Face Inference. */
+    /** Legacy manual HTTP base when the Inference SDK path fails; default `https://router.huggingface.co/v1` (router host is normalized to `…/hf-inference`). */
     hfInferenceBaseUrl?: string;
     /** Token for embedding calls; defaults to chat `apiKey`. */
     embeddingApiKey?: string;
+    /**
+     * Default `model` for `POST …/v1/chat/completions` when the caller omits `model`.
+     * Set via plugin / CMS `LLM_CHAT_MODEL` or env `LLM_CHAT_MODEL`.
+     * If unset, the library picks a fallback from `LLM_GATEWAY_URL` (HF router vs OpenRouter-style).
+     */
+    defaultChatModel?: string;
 }
 /**
  * Set `LLM_DEBUG=1` (or `true` / `yes`) to log composed chat payloads.
  * Set `LLM_EMBED_DEBUG=1` for per-request embedding logs (verbose with many chunks).
+ * Set `LLM_CHAT_MODEL` for the default chat model when agents/requests omit `model` (gateway-specific id).
+ * If unset, fallback is chosen from `LLM_GATEWAY_URL` (HF vs other).
  */
 declare class LlmService implements LlmServiceInterface {
     private static embedHttpErrorLogged;
     private static embedShapeErrorLogged;
     private static embedSuccessLogged;
     private static hfDimensionMismatchWarned;
+    private static hfInferenceSdkErrorLogged;
     private readonly baseURL;
     private readonly apiKey;
     private readonly defaultEmbeddingModel?;
     private readonly embeddingProvider;
     private readonly hfInferenceBaseURL;
     private readonly embeddingApiKey;
+    private readonly defaultChatModel;
     constructor(baseURL: string, apiKey: string, defaultEmbeddingModel?: string, embedOpts?: LlmServiceEmbedOptions);
+    private resolveChatModel;
     private get base();
     private get url();
     private llmDebugEnabled;
@@ -576,6 +584,21 @@ declare class LlmService implements LlmServiceInterface {
     embed(text: string, options?: {
         model?: string;
     }): Promise<number[]>;
+    /**
+     * POST `{ url }` with OpenAI-style `{ model, input }` and Bearer token; parses `{ data:[{embedding}] }`.
+     */
+    private fetchOpenAiShapeEmbeddings;
+    /**
+     * Hugging Face–recommended path: Hub resolves a provider that supports `feature-extraction` for the model.
+     */
+    private embedViaHuggingfaceInferenceSdk;
+    /** Base URL for legacy `…/pipeline/…` and `…/models/{model}` tries (HF router only). */
+    private hfLegacyInferenceBase;
+    /**
+     * Hugging Face embeddings: `@huggingface/inference` (Hub-routed feature extraction), then
+     * legacy direct `hf-inference` HTTP tries. Note: `https://router.huggingface.co/v1/embeddings` is not
+     * offered for embeddings (OpenAI-compatible `/v1` on HF is chat-only).
+     */
     private embedHuggingFaceInference;
     private buildAgentMessages;
     chatAgent(options: LlmAgentOptions): Promise<{
@@ -591,14 +614,16 @@ declare class LlmService implements LlmServiceInterface {
 interface LlmPluginConfig {
     baseURL?: string;
     apiKey?: string;
+    /** Default chat model when agents omit `model` (`POST /v1/chat/completions`). Env: `LLM_CHAT_MODEL`. If unset, inferred from `LLM_GATEWAY_URL` (HF vs OpenRouter-style default). */
+    defaultChatModel?: string;
     /** Default model for embed(); also from env EMBEDDING_MODEL. */
     embeddingModel?: string;
     /**
      * `openai` (default): `POST {LLM_GATEWAY_URL}/v1/embeddings`.
-     * `huggingface`: `POST {HF_INFERENCE_URL}/models/{EMBEDDING_MODEL}` (Inference API). Env: `EMBEDDING_PROVIDER=huggingface`.
+     * `huggingface`: `@huggingface/inference` feature extraction (Hub-routed), with legacy `…/hf-inference/…` HTTP fallback. Env: `EMBEDDING_PROVIDER=huggingface`.
      */
     embeddingProvider?: LlmEmbeddingProvider;
-    /** Hugging Face Inference API base; default `https://api-inference.huggingface.co`. Env: `HF_INFERENCE_URL`. */
+    /** Legacy HTTP base if the SDK path fails; default `https://router.huggingface.co/v1` (router hosts map to `…/hf-inference`). Env: `HF_INFERENCE_URL`. */
     hfInferenceBaseUrl?: string;
     /** Optional; defaults to `apiKey`. Env: `EMBEDDING_API_KEY`. */
     embeddingApiKey?: string;