@viu/emporix-sdk 2.20.1 → 2.21.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ClientContext, b as AuthContext, P as PaginatedItems, T as TokenProvider, n as ResolvedConfig, E as EmporixConfig, j as LogLevel, o as ServiceName, e as CustomerTokenRefresher } from './context-Dawv2AtS.js';
-export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as CustomerRefreshRegistry, D as DEFAULT_HOST, f as DefaultTokenProvider, H as HttpClient, g as HttpClientOptions, L as LEVEL, h as LevelResolver, i as LogFields, k as Logger, l as LoggerConfig, m as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, p as StorefrontCredentials, q as auth, r as createConsoleLogger, s as createNoopLogger, t as iterateAll, u as redact, v as resolveToken, w as validateConfig } from './context-Dawv2AtS.js';
+import { C as ClientContext, b as AuthContext, P as PaginatedItems, T as TokenProvider, n as ResolvedConfig, E as EmporixConfig, j as LogLevel, o as ServiceName, e as CustomerTokenRefresher } from './context-CfXJcYKP.js';
+export { A as AnonymousSession, a as AnonymousSessionStore, c as AuthKind, d as CustomerRefreshRegistry, D as DEFAULT_HOST, f as DefaultTokenProvider, H as HttpClient, g as HttpClientOptions, L as LEVEL, h as LevelResolver, i as LogFields, k as Logger, l as LoggerConfig, m as LoggerObjectConfig, R as RequestOptions, S as ServiceCredentials, p as StorefrontCredentials, q as auth, r as createConsoleLogger, s as createNoopLogger, t as iterateAll, u as redact, v as resolveToken, w as validateConfig } from './context-CfXJcYKP.js';
 import { CustomerService } from './customer.js';
 export { Address, AddressCreateInput, AddressUpdateInput, Customer, CustomerSession, CustomerSignupInput, CustomerUpdateInput, PasswordChangeInput, PasswordResetConfirmInput, PasswordResetRequestInput } from './customer.js';
 import { ProductService } from './product.js';
@@ -72,35 +72,183 @@ declare class EmporixInsufficientScopeError extends EmporixForbiddenError {
 declare function errorFromResponse(status: number, message: string, body: unknown): EmporixError;
 
 /**
- * One site as returned by the Site Settings Service. Mirrors the public
- * SiteDto schema with the fields a storefront actually consumes.
+ * Site address.
  */
-interface Site$1 {
+type AddressDto = {
+    street?: string;
+    streetNumber?: string;
+    streetAppendix?: string;
+    extraLine1?: string;
+    extraLine2?: string;
+    extraLine3?: string;
+    extraLine4?: string;
+    zipCode: string;
+    city?: string;
+    country: string;
+    state?: string;
+};
+/**
+ * Currency used by the site, compliant with the ISO 4217 standard.
+ */
+type CurrencyDto = string;
+type DefaultDtoMetadata$1 = {
+    /**
+     * Mixin schema URLs.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    version?: number;
+};
+/**
+ * Site location.
+ */
+type HomeBaseDto = {
+    address: AddressDto;
+    location?: LocationDto;
+    /**
+     * The timezone of the site home base location. Must be a valid IANA timezone identifier.
+     *
+     * If not specified, no timezone will be set. When specified, the value must be a valid timezone ID as defined in the IANA Time Zone Database.
+     *
+     * Examples of valid timezones:
+     * - Europe/Paris
+     * - America/New_York
+     * - Asia/Tokyo
+     * - UTC
+     *
+     * Invalid timezone values (e.g., "Europe/Xp") will result in a 400 Bad Request response.
+     *
+     */
+    timezone?: string;
+};
+/**
+ * Site geographical location.
+ */
+type LocationDto = {
+    latitude?: number;
+    longitude?: number;
+};
+/**
+ * Information about the site.
+ */
+type SiteDto = {
+    /**
+     * Site unique identifier.
+     */
     code: string;
+    /**
+     * Site name.
+     */
     name: string;
-    active: boolean;
-    default: boolean;
+    /**
+     * Flag indicating whether the site is active.
+     */
+    active?: boolean;
+    /**
+     * Flag indicating whether the site is the  tenant default site.
+     */
+    default?: boolean;
+    /**
+     * Indicates whether prices for the site should be returned in gross (when includesTax=true) or net (when includesTax=false).
+     */
     includesTax?: boolean;
+    /**
+     * Site's default language, compliant with the ISO 639-1 standard.
+     */
     defaultLanguage: string;
-    languages: string[];
-    currency: string;
-    availableCurrencies?: string[];
-    homeBase: {
-        address: {
-            country: string;
-            zipCode: string;
-            street?: string;
-            city?: string;
-            state?: string;
-        };
-        timezone?: string;
+    /**
+     * Languages supported by the site.
+     *
+     * **Note**: The languages must be compliant with the ISO 639-1 standard.
+     */
+    languages: Array<string>;
+    currency: CurrencyDto;
+    /**
+     * List of the currencies supported by the site
+     */
+    availableCurrencies?: Array<CurrencyDto>;
+    homeBase: HomeBaseDto;
+    /**
+     * Codes of countries to which the site ships products.
+     *
+     * **Note**: The country codes must be compliant with the ISO 3166-1 alpha-2 standard.
+     */
+    shipToCountries: Array<string>;
+    /**
+     * Shipping service configurations.
+     */
+    shipping?: Array<ServiceConfigurationDto>;
+    /**
+     * Payment service configurations.
+     */
+    payment?: Array<ServiceConfigurationDto>;
+    /**
+     * Tax service configurations.
+     *
+     * **The `tax` field is in preview mode** - some of the features may not be fully operational yet.
+     */
+    tax?: Array<ServiceConfigurationDto>;
+    assistedBuying?: AssistedBuying$1;
+    metadata?: DefaultDtoMetadata$1;
+    taxDeterminationBasedOn: TaxDeterminationBasedOn;
+    /**
+     * Site additional properties.
+     */
+    mixins?: {
+        [key: string]: unknown;
     };
-    shipToCountries: string[];
+    /**
+     * Number of decimal points used in the cart calculation. Must be zero or a positive value.
+     */
     cartCalculationScale?: number;
-    metadata?: {
-        version?: number;
+};
+type ServiceConfigurationDto = {
+    /**
+     * Service configuration's unique identifier.
+     */
+    id?: string;
+    /**
+     * Service configuration's name.
+     */
+    name?: string;
+    serviceType?: string;
+    serviceUrl?: string;
+    /**
+     * Flag indicating whether the service is active.
+     */
+    active?: boolean;
+    configuration?: ServiceSettingsDto;
+};
+type ServiceSettingsDto = {
+    public?: {
+        [key: string]: unknown;
     };
-}
+    restricted?: {
+        [key: string]: unknown;
+    };
+};
+type AssistedBuying$1 = {
+    /**
+     * Storefront URL, where an employee should be redirected when the assisted buying mechanism is used.
+     */
+    storefrontUrl?: string;
+};
+/**
+ * Specifies whether tax calculation is based on customer billing address or shipping address. Default value is `BILLING_ADDRESS`.
+ */
+type TaxDeterminationBasedOn = 'BILLING_ADDRESS' | 'SHIPPING_ADDRESS';
+
+/**
+ * A site as returned by the Site Settings Service. Mirrors the generated
+ * `SiteDto`, but re-tightens `active`/`default` to required — the storefront
+ * relies on both being present (see {@link SiteService.current}).
+ */
+type Site$1 = Omit<SiteDto, "active" | "default"> & {
+    active: boolean;
+    default: boolean;
+};
+
 /**
  * Read-only access to the tenant's site catalog. List returns active sites
  * visible to the storefront context (the `site_manage` scope is only needed
@@ -121,43 +269,116 @@ declare class SiteService {
     current(authCtx?: AuthContext): Promise<Site$1>;
 }
 
+type SessionContextGet = SessionContextBase & {
+    context?: Context;
+} & {
+    metadata?: Metadata$9;
+};
 /**
- * One session context as returned by `GET /session-context/{tenant}/me/context`.
- * Created server-side when the user creates a cart. Until then, the server
- * returns 404 and {@link SessionContextService.get} resolves to `null`.
+ * Request body for partially updating own session context (PATCH /me/context).
+ * Only the following fields can be updated; all other fields are ignored.
+ *
  */
-interface SessionContext {
-    sessionId: string;
+type SessionContextPatch$1 = {
+    /**
+     * Code of the site, as defined in the Site Settings Service.
+     */
+    siteCode?: string;
+    /**
+     * Three-letter currency code, as defined in the Currency Service.
+     */
+    currency?: string;
+    /**
+     * The country code, as defined in the country service.
+     */
+    targetLocation?: string;
+    /**
+     * Language associated with the session.
+     */
+    language?: string;
+    context?: Context;
+    metadata: MetadataUpdate$2;
+};
+type SessionContextBase = {
+    /**
+     * Unique identifier of the customer's session.
+     */
+    sessionId?: string;
+    /**
+     * Customer unique identifier.
+     *
+     * **Note**: This field is only applicable to logged-in customers.
+     */
     customerId?: string;
+    /**
+     * Code of the site, as defined in the Site Settings Service.
+     *
+     * **Note**: The default country code for anonymous sessions is based on the home base address country of the default site. In the case of a logged-in customer session, the country code is derived from the customer's shipping address, with the billing address being used as a fallback if the former is not available. If both addresses are not set, the home base address country code from the default site is used.
+     */
     siteCode?: string;
+    /**
+     * Three-letter currency code, as defined in the Currency Service.
+     *
+     * **Note**: During an anonymous session, the default currency of the site serves as the initial currency. Whereas, for a user session, the customer's preferred currency is set as the initial currency.
+     */
     currency?: string;
+    /**
+     * Unique identifier of the active customer cart, generated when the cart is created through the Cart Service.
+     */
     cartId?: string;
+    /**
+     * The country code, as defined in the country service.
+     *
+     *
+     * **Note**: The default country code for anonymous sessions is based on the home base address country of the default site. In the case of a logged-in customer session, the country code is derived from the customer's shipping address, with the billing address being used as a fallback if the former is not available. If both addresses are not set, the home base address country code from the default site is used.
+     */
     targetLocation?: string;
+    /**
+     * Language associated with the session.
+     */
     language?: string;
-    context?: Record<string, unknown>;
-    metadata?: {
-        version?: number;
-        createdAt?: string;
-        modifiedAt?: string;
+};
+type MetadataUpdate$2 = {
+    /**
+     * Version of the session context object.
+     */
+    version?: number;
+};
+type Metadata$9 = MetadataUpdate$2 & {
+    /**
+     * Date and time when the object was created.
+     */
+    createdAt?: string;
+    /**
+     * Date and time when the object was last modified.
+     */
+    modifiedAt?: string;
+};
+type Context = {
+    [key: string]: {
+        [key: string]: unknown;
     };
-}
+};
+
 /**
- * Input for {@link SessionContextService.patch}. Only the listed fields are
- * accepted by the server; everything else is ignored.
- *
- * If `version` is omitted, the service fetches the current version via GET
- * before PATCHing (one extra round-trip). Pass it explicitly when you already
- * know it (e.g. after a `get()` call earlier in the same flow).
+ * The current session context (`GET /me/context`). Mirrors the generated
+ * `SessionContextGet` but re-tightens `sessionId` to required — a returned
+ * context always carries one.
  */
-interface SessionContextPatch {
-    siteCode?: string;
-    currency?: string;
-    targetLocation?: string;
-    language?: string;
-    context?: Record<string, unknown>;
-    /** Override for optimistic-locking version. If omitted, GET resolves it. */
+type SessionContext = Omit<SessionContextGet, "sessionId"> & {
+    sessionId: string;
+};
+/**
+ * Input for {@link SessionContextService.patch}. The updatable fields are
+ * derived from the generated patch body; `version` is a flat convenience for
+ * the wire's `metadata.version` (the service maps it). Omit `version` to have
+ * the service resolve it via a GET first.
+ */
+type SessionContextPatch = Pick<SessionContextPatch$1, "siteCode" | "currency" | "targetLocation" | "language" | "context"> & {
+    /** Optimistic-locking version. If omitted, resolved via GET. */
     version?: number;
-}
+};
+
 /**
  * Session-context binding for the current storefront session. Both endpoints
  * resolve the session-id from the `Authorization` token — no path/query
@@ -1667,19 +1888,13 @@ type TextGenerationRequest = {
      */
     maxTokens?: number;
 };
-type InnerTokenRequest = {
-    /**
-     * ID of the token.
-     */
-    id: string;
-};
-type InnerTokenResponse = {
+type IdResponse = {
     /**
-     * ID of the token.
+     * Identifier of the resource.
      */
     id?: string;
 };
-type ExpandedTokenResponse = InnerTokenResponse & {
+type ExpandedTokenResponse = IdResponse & {
     /**
      * Name of the token.
      */
@@ -1689,9 +1904,15 @@ type ExpandedTokenResponse = InnerTokenResponse & {
 /**
  * The full response representing token. If the `expand=token` is **not** used, then only `id` field is returned, otherwise all fields are returned.
  */
-type ExpandableTokenResponse = InnerTokenResponse | ExpandedTokenResponse;
+type ExpandableTokenResponse = IdResponse | ExpandedTokenResponse;
 /**
- * Type of the native tool. Value `teams` is in preview.
+ * Type of the native tool. Possible values:
+ * * `slack`
+ * * `rag_custom`
+ * * `rag_emporix`
+ * * `teams`
+ *
+ * **The `teams` value is in preview mode** - some of the features may not be fully operational yet.
  */
 type NativeToolType = 'slack' | 'rag_custom' | 'rag_emporix' | 'teams';
 type BaseNativeTool = {
@@ -1711,6 +1932,9 @@ type RagCustomEmbeddingNativeToolConfig = {
      */
     model: string;
 };
+type RagCustomEmbeddingNativeToolConfigRequest = RagCustomEmbeddingNativeToolConfig & {
+    token: IdWrapperRequest;
+};
 type RagCustomEmbeddingNativeToolConfigResponse = RagCustomEmbeddingNativeToolConfig & {
     token?: ExpandableTokenResponse;
 };
@@ -1734,6 +1958,9 @@ type RagCustomDatabaseNativeToolConfig = {
      */
     collectionName: string;
 };
+type RagCustomDatabaseNativeToolConfigRequest = RagCustomDatabaseNativeToolConfig & {
+    token: IdWrapperRequest;
+};
 type RagCustomDatabaseNativeToolConfigResponse = RagCustomDatabaseNativeToolConfig & {
     token?: ExpandableTokenResponse;
 };
@@ -1747,6 +1974,10 @@ type RagCustomNativeToolConfig = {
      */
     maxResults?: number;
 };
+type RagCustomNativeToolConfigRequest = RagCustomNativeToolConfig & {
+    databaseConfig: RagCustomDatabaseNativeToolConfigRequest;
+    embeddingConfig: RagCustomEmbeddingNativeToolConfigRequest;
+};
 type RagCustomNativeToolConfigResponse = RagCustomNativeToolConfig & {
     databaseConfig?: RagCustomDatabaseNativeToolConfigResponse;
     embeddingConfig?: RagCustomEmbeddingNativeToolConfigResponse;
@@ -1772,6 +2003,9 @@ type OpenAiRagEmporixEmbeddingNativeToolConfig = {
      */
     dimensions: number;
 };
+type OpenAiRagEmporixEmbeddingNativeToolConfigRequest = OpenAiRagEmporixEmbeddingNativeToolConfig & {
+    token: IdWrapperRequest;
+};
 type OpenAiRagEmporixEmbeddingNativeToolConfigResponse = OpenAiRagEmporixEmbeddingNativeToolConfig & {
     token?: ExpandableTokenResponse;
 };
@@ -1793,6 +2027,9 @@ type SelfHostedOllamaRagEmporixEmbeddingNativeToolConfig = {
      */
     url: string;
 };
+type SelfHostedOllamaRagEmporixEmbeddingNativeToolConfigRequest = SelfHostedOllamaRagEmporixEmbeddingNativeToolConfig & {
+    token: IdWrapperRequest;
+};
 type SelfHostedOllamaRagEmporixEmbeddingNativeToolConfigResponse = SelfHostedOllamaRagEmporixEmbeddingNativeToolConfig & {
     token?: ExpandableTokenResponse;
 };
@@ -1832,6 +2069,9 @@ type RagEmporixNativeToolConfig = {
         key: string;
     }>;
 };
+type RagEmporixNativeToolConfigRequest = RagEmporixNativeToolConfig & {
+    embeddingConfig: EmporixOpenAiRagEmporixEmbeddingNativeToolConfig | OpenAiRagEmporixEmbeddingNativeToolConfigRequest | SelfHostedOllamaRagEmporixEmbeddingNativeToolConfigRequest;
+};
 type RagEmporixNativeToolConfigResponse = RagEmporixNativeToolConfig & {
     embeddingConfig?: EmporixOpenAiRagEmporixEmbeddingNativeToolConfig | OpenAiRagEmporixEmbeddingNativeToolConfigResponse | SelfHostedOllamaRagEmporixEmbeddingNativeToolConfigResponse;
 };
@@ -1841,6 +2081,20 @@ type SlackNativeToolConfigResponse = {
      */
     teamId: string;
 };
+type SlackNativeToolConfigRequest = SlackNativeToolConfigResponse & {
+    /**
+     * OAuth token used to authenticate the Slack bot within the specified workspace. Required for performing authorized actions on behalf of the bot. Format usually starts with `xoxb-...`. It is required only for creation, for update operation it can be omitted.
+     */
+    botToken: string;
+};
+type SlackNativeToolRequest = BaseNativeTool & {
+    /**
+     * For SlackNativeTool it has to be set to `slack`.
+     */
+    type?: unknown;
+    config: SlackNativeToolConfigRequest;
+    metadata?: MetadataRequest;
+};
 type SlackNativeToolResponse = BaseNativeTool & {
     /**
      * Unique identifier of the tool.
@@ -1858,13 +2112,9 @@ type SlackNativeToolResponse = BaseNativeTool & {
  */
 type TeamsAllowedOperations = 'sendMessage' | 'createChat' | 'createChannel' | 'inviteParticipants' | 'collaborateOnChannel' | 'collaborateOnChat';
 /**
- * ![Preview](https://res.cloudinary.com/saas-ag/image/upload/v1752824268/emporix/icons/preview_api1.png)
- *
- * {% hint style="danger" %}
- * This functionality is in preview mode - some of the features may not be fully operational yet.
- * {% endhint %}
- *
  * Configuration of an MS Teams native tool instance.
+ *
+ * **The MS Teams native tool configuration is in preview mode** - some of the features may not be fully operational yet.
  */
 type TeamsNativeToolConfigResponse = {
     /**
@@ -1884,6 +2134,15 @@ type TeamsNativeToolConfigResponse = {
      */
     allowedOperations?: Array<TeamsAllowedOperations>;
 };
+type TeamsNativeToolConfigRequest = TeamsNativeToolConfigResponse;
+type TeamsNativeToolRequest = BaseNativeTool & {
+    /**
+     * For TeamsNativeTool it has to be set to `teams`.
+     */
+    type?: unknown;
+    config: TeamsNativeToolConfigRequest;
+    metadata?: MetadataRequest;
+};
 type TeamsNativeToolResponse = BaseNativeTool & {
     /**
      * Unique identifier of the tool.
@@ -1896,6 +2155,14 @@ type TeamsNativeToolResponse = BaseNativeTool & {
     config?: TeamsNativeToolConfigResponse;
     metadata?: MetadataResponse$1;
 };
+type RagCustomNativeToolRequest = BaseNativeTool & {
+    /**
+     * For `RagCustomNativeTool`, it has to be set to `rag_custom`.
+     */
+    type?: unknown;
+    config: RagCustomNativeToolConfigRequest;
+    metadata?: MetadataRequest;
+};
 type RagCustomNativeToolResponse = BaseNativeTool & {
     /**
      * Unique identifier of the tool.
@@ -1908,6 +2175,14 @@ type RagCustomNativeToolResponse = BaseNativeTool & {
     config?: RagCustomNativeToolConfigResponse;
     metadata?: MetadataResponse$1;
 };
+type RagEmporixNativeToolRequest = BaseNativeTool & {
+    /**
+     * For `RagEmporixNativeTool`, it has to be set to `rag_emporix`.
+     */
+    type?: unknown;
+    config: RagEmporixNativeToolConfigRequest;
+    metadata?: MetadataRequest;
+};
 type RagEmporixNativeToolResponse = BaseNativeTool & {
     /**
      * Unique identifier of the tool.
@@ -1967,6 +2242,9 @@ type McpServerConfig = {
      */
     authorizationHeaderName?: string;
 };
+type McpServerConfigRequest = McpServerConfig & {
+    authorizationHeaderToken?: IdWrapperRequest;
+};
 type McpServerConfigResponse = McpServerConfig & {
     authorizationHeaderToken?: ExpandableTokenResponse;
 };
@@ -1984,10 +2262,20 @@ type BaseMcpServer = {
     enabled?: boolean;
     transport?: CustomMcpServerTransportType;
 };
+type McpServerRequest = BaseMcpServer & {
+    config: McpServerConfigRequest;
+    metadata?: MetadataRequest;
+};
 type McpServerResponse = BaseMcpServer & {
     config?: McpServerConfigResponse;
     metadata?: MetadataResponse$1;
 };
+type CommerceEventsResponse = {
+    /**
+     * List of events available to use by an agent with the `COMMERCE_EVENTS` trigger.
+     */
+    events?: Array<string>;
+};
 /**
  * Type of the MCP server. The `custom` type allows you to integrate with your own MCP server instance, while the `predefined` type allows you to integrate with one of the instances provided by Emporix.
  */
@@ -2053,35 +2341,6 @@ type EmporixLlm = BaseLlm & {
      */
     provider: 'emporix_openai';
 };
-/**
- * OAuth 2.0 client-credentials settings for authenticating with a self-hosted LLM backend.
- */
-type OAuthParams = {
-    /**
-     * Base URL of the OAuth 2.0 authorization server. The access token is requested from `{url}/token`.
-     */
-    url: string;
-    /**
-     * OAuth 2.0 client identifier registered with the authorization server.
-     */
-    clientId: string;
-    /**
-     * OAuth 2.0 grant type used to obtain an access token.
-     */
-    grantType: 'client_credentials';
-    /**
-     * Optional space-separated list of scopes to request for the access token.
-     */
-    scope?: string;
-};
-type OAuthParamsRequest = OAuthParams & {
-    [key: string]: unknown;
-} & {
-    clientSecret?: InnerTokenRequest;
-};
-type OAuthParamsResponse = OAuthParams & {
-    clientSecret?: ExpandableTokenResponse;
-};
 type SelfHostedParams = {
     /**
      * Url of the self-hosted LLM.
@@ -2095,12 +2354,12 @@ type SelfHostedParams = {
 type SelfHostedParamsRequest = SelfHostedParams & {
     [key: string]: unknown;
 } & {
-    authorizationHeaderToken?: InnerTokenRequest;
-    oAuthParams?: OAuthParamsRequest;
+    authorizationHeaderToken?: IdWrapperRequest;
+    oauth?: IdWrapperRequest;
 };
 type SelfHostedParamsResponse = SelfHostedParams & {
     authorizationHeaderToken?: ExpandableTokenResponse;
-    oAuthParams?: OAuthParamsResponse;
+    oauth?: ExpandableOAuthResponse;
 };
 type SelfHostedLlm = BaseLlm & {
     /**
@@ -2118,22 +2377,105 @@ type SelfHostedLlmResponse = SelfHostedLlm & {
  * Type of the LLM Provider. The supported providers allows you to provide your own API key. When using this providers, the `apiKey` property cannot be omitted.
  */
 type ApiKeyLlmProvider = 'openai' | 'google' | 'anthropic';
-type ApiKeyLlm = BaseLlm & {
-    provider: ApiKeyLlmProvider;
-};
-type ApiKeyLlmRequest = ApiKeyLlm & {
-    token: InnerTokenRequest;
-};
-type ApiKeyLlmResponse = ApiKeyLlm & {
-    token?: ExpandableTokenResponse;
-};
-/**
- * ![Preview](https://res.cloudinary.com/saas-ag/image/upload/v1752824268/emporix/icons/preview_api1.png)
- *
- * {% hint style="danger" %}
- * This functionality is in preview mode - some of the features may not be fully operational yet.
- * {% endhint %}
- *
+type ModelResponse = {
+    /**
+     * Model identifier to use in agent LLM configuration.
+     */
+    id: string;
+    /**
+     * Display name of the model.
+     */
+    name: string;
+    /**
+     * Short description of the model. Available for some providers, such as Google.
+     */
+    description?: string;
+    /**
+     * Indicates whether the model supports thinking capabilities.
+     */
+    thinking?: boolean;
+};
+type ProviderModelsResponse = {
+    provider: ApiKeyLlmProvider;
+    /**
+     * List of models available for the provider.
+     */
+    models: Array<ModelResponse>;
+};
+type ApiKeyLlm = BaseLlm & {
+    provider: ApiKeyLlmProvider;
+};
+type ApiKeyLlmRequest = ApiKeyLlm & {
+    token: IdWrapperRequest;
+};
+type ApiKeyLlmResponse = ApiKeyLlm & {
+    token?: ExpandableTokenResponse;
+};
+/**
+ * OAuth 2.0 client-credentials settings for authenticating with a self-hosted LLM backend.
+ */
+type OAuth = {
+    /**
+     * Token endpoint URL of the OAuth 2.0 authorization server used to request an access token.
+     */
+    url: string;
+    /**
+     * OAuth 2.0 client identifier registered with the authorization server.
+     */
+    clientId: string;
+    /**
+     * OAuth 2.0 grant type used to obtain an access token. Currently only `client_credentials` is supported.
+     */
+    grantType: 'client_credentials';
+    /**
+     * Optional space-separated list of scopes to request for the access token.
+     */
+    scope?: string;
+    /**
+     * Indicates whether the OAuth configuration is enabled.
+     */
+    enabled?: boolean;
+};
+type OAuthRequest = OAuth & {
+    clientSecretToken?: IdWrapperRequest;
+    metadata?: MetadataRequest;
+};
+type OAuthResponse = OAuth & {
+    /**
+     * Unique identifier of the entity.
+     */
+    id?: string;
+    clientSecretToken?: ExpandableTokenResponse;
+    metadata?: MetadataResponse$1;
+};
+/**
+ * The full response representing OAuth. If the `expand=oauth` is **not** used, then only `id` field is returned, otherwise all fields are returned.
+ */
+type ExpandableOAuthResponse = IdResponse | OAuthResponse;
+type BaseToken = {
+    /**
+     * Name of the token.
+     */
+    name: string;
+};
+type TokenRequest = BaseToken & {
+    /**
+     * Value which represents token.
+     */
+    value: string;
+    metadata?: MetadataRequest;
+};
+type TokenResponse = BaseToken & {
+    /**
+     * Unique identifier of the token.
+     */
+    id?: string;
+    metadata?: MetadataResponse$1;
+};
+type IdWrapperRequest = {
+    id: string;
+};
+/**
  * Reference to a native tool assigned to an agent.
  */
 type NativeToolReferenceRequest = {
@@ -2143,6 +2485,8 @@ type NativeToolReferenceRequest = {
     id: string;
     /**
      * Optional per-agent override of allowed MS Teams operations. When omitted, the tool instance defaults apply.
+     *
+     * **The `allowedOperations` field is in preview mode** - some of the features may not be fully operational yet.
      */
     allowedOperations?: Array<TeamsAllowedOperations>;
 };
@@ -2310,6 +2654,18 @@ type BaseForAgentRequestAndResponse = BaseForAgentAndTemplate & {
      */
     enabledMemory?: boolean;
 };
+type AgentTemplateResponse = BaseForAgentAndTemplate & {
+    /**
+     * Immutable LLM base prompt which is concatenated with the `userPrompt`.
+     */
+    templatePrompt?: string;
+    /**
+     * Identifier of the agent.
+     */
+    id?: string;
+    nativeTools?: NativeToolsResponse;
+    mcpServers?: AgentMcpServersResponse;
+};
 type AgentRequest = BaseForAgentRequestAndResponse & {
     /**
      * Native tools assigned to the agent, optionally with per-agent `allowedOperations` overrides.
@@ -2351,6 +2707,176 @@ type MetadataResponse$1 = MetadataRequest & {
      */
     modifiedAt: string;
 };
+/**
+ * Status of the job.
+ */
+type JobStatus = 'in_progress' | 'success' | 'failure' | 'skipped';
+/**
+ * Type of the job.
+ */
+type JobType = 'IMPORT' | 'EXPORT' | 'AGENT_CHAT';
+/**
+ * Contains information about the job result - whether it was successful or not, what was the agent output etc.
+ */
+type Job$1 = {
+    /**
+     * Unique identifier of the job.
+     */
+    id?: string;
+    agentType?: AgentType;
+    status?: JobStatus;
+    type?: JobType;
+    exportResult?: ExportResult;
+    importResult?: ImportResult;
+    /**
+     * Unique identifier of the session.
+     */
+    sessionId?: string;
+    /**
+     * Unique identifier of the agent.
+     */
+    agentId?: string;
+    /**
+     * Agent message.
+     */
+    message?: string;
+    /**
+     * Commerce event which triggered the job.
+     */
+    commerceEvent?: string;
+    metadata?: MetadataResponse$1;
+};
+type ImportResult = {
+    /**
+     * Short summary of the import.
+     */
+    message?: string;
+    /**
+     * Summary of the import.
+     */
+    summary?: {
+        agents?: Array<ImportedEntity>;
+        tools?: Array<ImportedEntity>;
+        mcpServers?: Array<ImportedEntity>;
+    };
+};
+type ExportResult = {
+    /**
+     * The base64 encoded JSON value of the exported agents with related tools and MCP servers.
+     */
+    data?: string;
+    /**
+     * Checksum calculated based on JSON value. Validates if importing JSON is exactly the same as the exported one.
+     */
+    checksum?: string;
+};
+type ImportedEntity = {
+    /**
+     * ID of the imported entity.
+     */
+    id?: string;
+    /**
+     * Name of the imported entity.
+     */
+    name?: string;
+    /**
+     * State of the imported entity.
+     */
+    state?: 'TO_CREATE' | 'ENABLED' | 'DISABLED' | 'EXISTS';
+};
+type AttachmentResponse = {
+    /**
+     * Unique identifier of the created attachment.
+     */
+    id?: string;
+    /**
+     * Unique identifier of the session. The same sessionId must be used when calling chat endpoints to ensure the correct attachment is found.
+     */
+    sessionId?: string;
+};
+/**
+ * Severity level of the log entry.
+ */
+type LogSeverity = 'INFO' | 'WARNING' | 'ERROR';
+type AgentLogMessageResponse = {
+    /**
+     * Timestamp when the log message was created.
+     */
+    timestamp?: string;
+    severity?: LogSeverity;
+    /**
+     * The log message content.
+     */
+    message?: string;
+    /**
+     * Unique identifier of the agent that generated the log.
+     */
+    agentId?: string;
+    /**
+     * Unique identifier of the request associated with the log.
+     */
+    requestId?: string;
+    /**
+     * Whether this is a business log entry.
+     */
+    isBusinessLog?: boolean;
+};
+type AgentRequestResponse = {
+    /**
+     * Unique identifier of the request log.
+     */
+    id?: string;
+    /**
+     * Unique identifier of the session.
+     */
+    sessionId?: string;
+    /**
+     * Unique identifier of the request.
+     */
+    requestId?: string;
+    /**
+     * Unique identifier of the agent that triggered the request.
+     */
+    triggerAgentId?: string;
+    /**
+     * List of agent IDs that collaborated in this request.
+     */
+    collaborationAgents?: Array<string>;
+    severity?: LogSeverity;
+    /**
+     * List of log messages associated with this request.
+     */
+    messages?: Array<AgentLogMessageResponse>;
+    /**
+     * Duration of the request in seconds.
+     */
+    duration?: number;
+    metadata?: MetadataResponse$1;
+};
+type AgentSessionResponse = {
+    /**
+     * Unique identifier of the session.
+     */
+    sessionId?: string;
+    /**
+     * Unique identifier of the agent that triggered the session.
+     */
+    triggerAgentId?: string;
+    severity?: LogSeverity;
+    /**
+     * List of agent IDs that participated in this session.
+     */
+    agents?: Array<string>;
+    /**
+     * List of log messages associated with this session.
+     */
+    messages?: Array<AgentLogMessageResponse>;
+    /**
+     * Duration of the session in seconds.
+     */
+    duration?: number;
+    metadata?: MetadataResponse$1;
+};
 type CompletionRequest$1 = {
     /**
      * Identifier of the request. The value is not mandatory - if provided, then the ID is returned in the text generation response.
@@ -2376,6 +2902,12 @@ type QParamSearchBody = {
      */
     q?: string;
 };
+type AgentFromTemplateRequest = BaseForAgentAndTemplateAndHandOff & {
+    /**
+     * LLM Prompt which describes how agent should work in a detailed way, which tools it could use to solve problems etc; it can contain examples and step by step guidance.
+     */
+    userPrompt: string;
+};
 /**
  * Partial update operation list.
  */
@@ -2386,7 +2918,151 @@ type PatchRequest = Array<{
         [key: string]: unknown;
     };
 }>;
+type ExportResponse = DataWithChecksum & {
+    /**
+     * Date of the export process.
+     */
+    exportedAt?: string;
+    /**
+     * ID of the job.
+     */
+    jobId?: string;
+};
+type DataWithChecksum = {
+    /**
+     * The base64 encoded JSON value of the exported agents with related tools and MCP servers.
+     */
+    data?: string;
+    /**
+     * Checksum calculated based on decoded `data` value. Validates if importing JSON is exactly the same as the exported one.
+     */
+    checksum?: string;
+};
+type ExportRequest = {
+    /**
+     * List of the agents IDs.
+     */
+    agentIds: Array<string>;
+};
+type ImportResponse = ImportResult & {
+    /**
+     * Date of the import process.
+     */
+    importedAt?: string;
+    /**
+     * ID of the job.
+     */
+    jobId?: string;
+};
+type ImportRequest = DataWithChecksum;
+/**
+ * Request log counts by severity.
+ */
+type AnalyticsSeverityCounts = {
+    info?: number;
+    warning?: number;
+    error?: number;
+};
+/**
+ * Session counts by outcome severity.
+ */
+type AnalyticsSessionSeverityCounts = {
+    success?: number;
+    warning?: number;
+    error?: number;
+};
+type AnalyticsLogMetrics = {
+    /**
+     * Total number of request logs in scope.
+     */
+    total?: number;
+    bySeverity?: AnalyticsSeverityCounts;
+    /**
+     * Share of error-severity logs among request logs.
+     */
+    errorRate?: number;
+};
+type AnalyticsSessionMetrics = {
+    /**
+     * Total number of sessions in scope.
+     */
+    total?: number;
+    bySeverity?: AnalyticsSessionSeverityCounts;
+    /**
+     * Share of error outcome sessions among sessions.
+     */
+    errorRate?: number;
+};
+type AnalyticsResolutionEfficiency = {
+    /**
+     * Average number of requests per session.
+     */
+    requestsPerSession?: number;
+    totalRequests?: number;
+    totalSessions?: number;
+};
+type AnalyticsRequestTrendPoint = {
+    /**
+     * Week start instant (UTC).
+     */
+    date?: string;
+    total?: number;
+    errors?: number;
+    errorRate?: number;
+};
+type AnalyticsSessionTrendPoint = {
+    /**
+     * Week start instant (UTC).
+     */
+    date?: string;
+    totalSessions?: number;
+    errorSessions?: number;
+    errorRate?: number;
+};
+/**
+ * Combined analytics payload for admin and partner dashboards.
+ */
+type AgentAnalyticsResponse = {
+    requests?: AnalyticsLogMetrics;
+    sessions?: AnalyticsSessionMetrics;
+    resolutionEfficiency?: AnalyticsResolutionEfficiency;
+    requestTrend?: Array<AnalyticsRequestTrendPoint>;
+    sessionTrend?: Array<AnalyticsSessionTrendPoint>;
+};
+type AnalyticsPeriod = {
+    /**
+     * Human-readable period label (e.g. quarter name).
+     */
+    label?: string;
+    /**
+     * Period start (inclusive), UTC.
+     */
+    start?: string;
+    /**
+     * Period end (exclusive), UTC.
+     */
+    end?: string;
+};
+type AgentExecutionSeries = {
+    agentId?: string;
+    /**
+     * Execution counts per period, same order as `periods`.
+     */
+    counts?: Array<number>;
+};
+type ExecutionsResponse = {
+    /**
+     * Time bucket used for periods and series (enum constant name).
+     */
+    granularity?: 'QUARTER' | 'MONTH' | 'WEEK';
+    periods?: Array<AnalyticsPeriod>;
+    series?: Array<AgentExecutionSeries>;
+};
 type QParamSearchBody2 = QParamSearchBody;
+type McpServerUpsertBody = McpServerRequest;
+type TokenUpsertBody = TokenRequest;
+type OauthUpsertBody = OAuthRequest;
+type ToolUpsertBody = SlackNativeToolRequest | RagCustomNativeToolRequest | RagEmporixNativeToolRequest | TeamsNativeToolRequest;
 
 /** Single-shot text generation request (`POST /texts`). Has `maxTokens`. */
 type TextRequest = TextGenerationRequest;
@@ -2454,14 +3130,204 @@ interface ChatStreamOptions {
 type Conversation = ConversationResponse;
 /** Request body for `searchConversations` (`{ q? }`) — same shape as agent search. */
 type ConversationSearchQuery = QParamSearchBody2;
-
+/** `{ id? }` — returned by an upsert on create (HTTP 201). */
+type Created = IdResponse;
 /**
- * Emporix AI Service (`/ai-service/{tenant}/…`): text generation, chat
- * completions, and the agentic layer (agent CRUD + synchronous/asynchronous
- * chat). Every endpoint requires a backend-only `ai.*` scope and the
- * **service (clientCredentials) token** — default auth: service.
- *
- * Server-side use only; the service token must never reach a browser. A
+ * One PATCH op for any agentic resource. `op` is the upstream UPPERCASE enum
+ * (`ADD | REMOVE | REPLACE`) — NOT RFC-6902. Passed verbatim. Same shape as
+ * {@link AgentPatchOp}.
+ */
+type AgenticPatchOp = PatchRequest[number];
+/** Query for a CRUD `list` (`q`/paging/sort/fields/expand). Extra keys pass through. */
+interface ListQuery {
+    q?: string;
+    pageSize?: number;
+    pageNumber?: number;
+    sort?: string;
+    fields?: string;
+    expand?: string;
+    [key: string]: string | number | undefined;
+}
+/** Options for a CRUD `get`. */
+interface GetOptions {
+    fields?: string;
+    expand?: string;
+    [key: string]: string | number | undefined;
+}
+/** Options for a mutating CRUD call (`upsert`/`delete`). */
+interface MutateOptions {
+    /** Cascade even if the entity is referenced elsewhere (`?force=true`). */
+    force?: boolean;
+}
+/** Body for any agentic `/search` endpoint. */
+interface SearchQuery {
+    q?: string;
+}
+/** An OAuth 2.0 client-credentials configuration (read shape). */
+type OAuthConfig = OAuthResponse;
+/** Write shape for {@link AiService.oauths}`.upsert` (`OAuthRequest`). */
+type OAuthInput = OauthUpsertBody;
+/** One agentic tool (union of the native-tool response variants). */
+type Tool = NativeToolsResponse[number];
+/** Write shape for {@link AiService.tools}`.upsert`. */
+type ToolInput = ToolUpsertBody;
+/** A stored token (holds an OAuth client secret, referenced by OAuth configs). */
+type Token = TokenResponse;
+/** Write shape for {@link AiService.tokens}`.upsert`. */
+type TokenInput = TokenUpsertBody;
+/** An MCP-server configuration for the agentic layer. */
+type McpServer = McpServerResponse;
+/** Write shape for {@link AiService.mcpServers}`.upsert`. */
+type McpServerInput = McpServerUpsertBody;
+/** An async AI job (`IMPORT` / `EXPORT` / `AGENT_CHAT`) with status + result. */
+type Job = Job$1;
+/** An available agent template. */
+type AgentTemplate = AgentTemplateResponse;
+/** Body for {@link AiService.templates}`.clone` — the user prompt + overrides. */
+type AgentFromTemplate = AgentFromTemplateRequest;
+/** One agent request-log entry. */
+type AgentRequestLog = AgentRequestResponse;
+/** One agent session-log entry. */
+type AgentSessionLog = AgentSessionResponse;
+/** Aggregated agent analytics (request/session metrics, trends). */
+type AgentAnalytics = AgentAnalyticsResponse;
+/** Per-agent execution counts aligned to returned periods. */
+type AgentExecutions = ExecutionsResponse;
+/** Query for {@link AiService.analytics}`.get`. */
+interface AnalyticsQuery {
+    /** Scope metrics to one agent; omit for tenant-wide aggregates. */
+    agentId?: string;
+}
+/** Query for {@link AiService.analytics}`.executions` — `agentIds` is required. */
+interface ExecutionsQuery {
+    /** Comma-separated agent IDs (no spaces, ≤100). */
+    agentIds: string;
+    /** Time bucket per period (UTC). */
+    granularity?: "QUARTER" | "MONTH" | "WEEK";
+}
+/** Models available to the tenant, grouped by LLM provider. */
+type ProviderModels = ProviderModelsResponse;
+/** The set of commerce events an agent trigger can subscribe to. */
+type CommerceEvents = CommerceEventsResponse;
+/** Result of an attachment upload — `{ id?, sessionId? }`. */
+type Attachment = AttachmentResponse;
+/** Options for {@link AiService.uploadAttachment}. */
+interface AttachmentOptions {
+    /**
+     * Reuse a chat context — sent as the `session-id` header. Thread the
+     * returned `sessionId` into chat calls to bind the file.
+     */
+    sessionId?: string;
+}
+/** Base64+checksum export of agents with their components. */
+type AgentsExport = ExportResponse;
+/** Body for {@link AiService.exportAgents} — `{ agentIds }`. */
+type AgentsExportRequest = ExportRequest;
+/** Result of an agents import. */
+type AgentsImport = ImportResponse;
+/** Body for {@link AiService.importAgents} — `{ data, checksum }`. */
+type AgentsImportRequest = ImportRequest;
+
+/**
+ * A symmetric CRUD resource over an agentic sub-collection (`tools`,
+ * `mcp-servers`, `tokens`, `oauths`). All six operations share the upstream
+ * shape; only the base path and the Read/Write types differ. Server-side only
+ * — every call defaults to the SERVICE (backend) token.
+ */
+declare class AgenticCrudResource<Read, Write> {
+    private readonly ctx;
+    private readonly path;
+    constructor(ctx: ClientContext, path: string);
+    private item;
+    /** List the collection (`GET {path}`). Optional `q`/paging/sort/fields/expand. */
+    list(query?: ListQuery, auth?: AuthContext): Promise<Read[]>;
+    /** Structured search (`POST {path}/search`). Body is `{ q? }`. */
+    search(query: SearchQuery, auth?: AuthContext): Promise<Read[]>;
+    /** Retrieve one entry by id (`GET {path}/{id}`). */
+    get(id: string, opts?: GetOptions, auth?: AuthContext): Promise<Read>;
+    /**
+     * Create-or-replace by id (`PUT {path}/{id}`). Resolves to `{ id }` on create
+     * (HTTP 201) and `undefined` on update (HTTP 204). `{ force: true }`
+     * cascade-disables dependents.
+     */
+    upsert(id: string, body: Write, opts?: MutateOptions, auth?: AuthContext): Promise<Created | undefined>;
+    /**
+     * Partial update with an op array (`PATCH {path}/{id}`, 204). `ops` use the
+     * upstream UPPERCASE enum (`ADD | REMOVE | REPLACE`), sent verbatim.
+     */
+    patch(id: string, ops: AgenticPatchOp[], auth?: AuthContext): Promise<void>;
+    /** Delete by id (`DELETE {path}/{id}`). `{ force: true }` removes even if referenced. */
+    delete(id: string, opts?: MutateOptions, auth?: AuthContext): Promise<void>;
+}
+/**
+ * AI async jobs (`/ai-service/{tenant}/jobs`). NOTE: not under `/agentic`.
+ * `chatAsync` returns a `jobId`; poll/list/delete it here.
+ */
+declare class JobsResource {
+    private readonly ctx;
+    private readonly base;
+    constructor(ctx: ClientContext, base: string);
+    /** List jobs (`GET /jobs`). */
+    list(query?: ListQuery, auth?: AuthContext): Promise<Job[]>;
+    /** Structured job search (`POST /jobs/search`). */
+    search(query: SearchQuery, auth?: AuthContext): Promise<Job[]>;
+    /** Retrieve one job (`GET /jobs/{jobId}`). */
+    get(jobId: string, auth?: AuthContext): Promise<Job>;
+    /** Delete one job (`DELETE /jobs/{jobId}`). */
+    delete(jobId: string, auth?: AuthContext): Promise<void>;
+}
+/** Agent templates (`/agentic/templates`). `list · search · clone`. */
+declare class TemplatesResource {
+    private readonly ctx;
+    private readonly path;
+    constructor(ctx: ClientContext, path: string);
+    /** List available templates (`GET /agentic/templates`). */
+    list(query?: ListQuery, auth?: AuthContext): Promise<AgentTemplate[]>;
+    /** Structured template search (`POST /agentic/templates/search`). */
+    search(query: SearchQuery, auth?: AuthContext): Promise<AgentTemplate[]>;
+    /**
+     * Instantiate a new agent from a template
+     * (`POST /agentic/templates/{templateId}/agents`, HTTP 201). Returns the
+     * created agent's id.
+     */
+    clone(templateId: string, body: AgentFromTemplate, auth?: AuthContext): Promise<Created>;
+}
+/** Agent logs (`/agentic/logs`): request logs and session logs. */
+declare class LogsResource {
+    private readonly ctx;
+    private readonly path;
+    constructor(ctx: ClientContext, path: string);
+    /** List request logs (`GET /agentic/logs/requests`). */
+    listRequests(query?: ListQuery, auth?: AuthContext): Promise<AgentRequestLog[]>;
+    /** Retrieve one request log (`GET /agentic/logs/requests/{requestId}`). */
+    getRequest(requestId: string, auth?: AuthContext): Promise<AgentRequestLog>;
+    /** Structured request-log search (`POST /agentic/logs/requests/search`). */
+    searchRequests(query: SearchQuery, auth?: AuthContext): Promise<AgentRequestLog[]>;
+    /** List session logs (`GET /agentic/logs/sessions`). */
+    listSessions(query?: ListQuery, auth?: AuthContext): Promise<AgentSessionLog[]>;
+    /** Retrieve one session log (`GET /agentic/logs/sessions/{sessionId}`). */
+    getSession(sessionId: string, auth?: AuthContext): Promise<AgentSessionLog>;
+    /** Structured session-log search (`POST /agentic/logs/sessions/search`). */
+    searchSessions(query: SearchQuery, auth?: AuthContext): Promise<AgentSessionLog[]>;
+}
+/** Agent analytics (`/agentic/analytics`). */
+declare class AnalyticsResource {
+    private readonly ctx;
+    private readonly path;
+    constructor(ctx: ClientContext, path: string);
+    /** Aggregated metrics (`GET /agentic/analytics`); scope with `agentId`. */
+    get(opts?: AnalyticsQuery, auth?: AuthContext): Promise<AgentAnalytics>;
+    /** Per-agent execution counts (`GET /agentic/analytics/executions`). `agentIds` required. */
+    executions(query: ExecutionsQuery, auth?: AuthContext): Promise<AgentExecutions>;
+}
+
+/**
+ * Emporix AI Service (`/ai-service/{tenant}/…`): text generation, chat
+ * completions, and the agentic layer (agent CRUD + synchronous/asynchronous
+ * chat). Every endpoint requires a backend-only `ai.*` scope and the
+ * **service (clientCredentials) token** — default auth: service.
+ *
+ * Server-side use only; the service token must never reach a browser. A
  * storefront chat (scope `ai.agentexecution_manage_own`) would require a
  * BFF / token-proxy — out of scope for this SDK.
  *
@@ -2472,6 +3338,30 @@ declare class AiService {
     static readonly channel: "ai";
     constructor(ctx: ClientContext);
     private base;
+    private _oauths?;
+    /** OAuth 2.0 client-credentials configs (`/agentic/oauths`). CRUD sub-resource. */
+    get oauths(): AgenticCrudResource<OAuthConfig, OAuthInput>;
+    private _tools?;
+    /** Agentic tools (`/agentic/tools`). CRUD sub-resource. */
+    get tools(): AgenticCrudResource<Tool, ToolInput>;
+    private _tokens?;
+    /** Stored tokens (`/agentic/tokens`) — an OAuth config's client secret. CRUD sub-resource. */
+    get tokens(): AgenticCrudResource<Token, TokenInput>;
+    private _mcpServers?;
+    /** MCP-server configs (`/agentic/mcp-servers`). CRUD sub-resource. */
+    get mcpServers(): AgenticCrudResource<McpServer, McpServerInput>;
+    private _jobs?;
+    /** AI async jobs (`/jobs`). `list · search · get · delete`. */
+    get jobs(): JobsResource;
+    private _templates?;
+    /** Agent templates (`/agentic/templates`). `list · search · clone`. */
+    get templates(): TemplatesResource;
+    private _logs?;
+    /** Agent logs (`/agentic/logs`): request + session logs. */
+    get logs(): LogsResource;
+    private _analytics?;
+    /** Agent analytics (`/agentic/analytics`). `get · executions`. */
+    get analytics(): AnalyticsResource;
     /** Generate text from a single prompt (`POST /texts`). Honors `maxTokens`. */
     generateText(input: TextRequest, auth?: AuthContext): Promise<TextResponse>;
     /** Run a chat completion over a message list (`POST /completions`). No `maxTokens`. */
@@ -2516,6 +3406,21 @@ declare class AiService {
     listConversations(auth?: AuthContext): Promise<Conversation[]>;
     /** Server-side conversation search (`POST /agentic/conversations/search`). */
     searchConversations(query: ConversationSearchQuery, auth?: AuthContext): Promise<Conversation[]>;
+    /** List models available to the tenant, grouped by provider (`GET /agentic/models`). */
+    listModels(auth?: AuthContext): Promise<ProviderModels[]>;
+    /** List commerce events available to agent triggers (`GET /agentic/commerce-events`). */
+    listCommerceEvents(auth?: AuthContext): Promise<CommerceEvents>;
+    /**
+     * Upload a chat attachment for an agent
+     * (`POST /agentic/{agentId}/attachments`, multipart, HTTP 201). The response
+     * `sessionId` must be threaded into subsequent chat calls to bind the file.
+     * Pass `opts.sessionId` to attach to an existing session.
+     */
+    uploadAttachment(agentId: string, attachment: Blob | File, opts?: AttachmentOptions, auth?: AuthContext): Promise<Attachment>;
+    /** Export agents + components as a base64/checksum blob (`POST /agentic/agents/export`). */
+    exportAgents(body: AgentsExportRequest, auth?: AuthContext): Promise<AgentsExport>;
+    /** Import previously-exported agents (`POST /agentic/agents/import`). */
+    importAgents(body: AgentsImportRequest, auth?: AuthContext): Promise<AgentsImport>;
 }
 
 type Metadata$7 = {
@@ -4506,7 +5411,7 @@ type Address$2 = {
 /**
  * Example quote response which contains a list of fees for various methods and delivery zone.
  */
-type QuoteResponse = Array<QuoteResponseItem>;
+type QuoteResponse$1 = Array<QuoteResponseItem>;
 /**
  * Example quote response which contains fee for specific method and zone.
  */
@@ -4610,7 +5515,7 @@ type CgRelationList = CgRelationList$1;
 /** Body for `quote` / `quoteMinimum`. */
 type QuoteInput = QuotePayload;
 /** `quote` result. */
-type QuoteResult = QuoteResponse;
+type QuoteResult = QuoteResponse$1;
 /** Body for `quoteSlot`. */
 type QuoteSlotInput = QuoteSlot;
 /** `quoteMinimum` / `quoteSlot` result. */
@@ -4748,6 +5653,1099 @@ declare class ShippingService {
     generateDeliveryCycle(input: DeliveryCycleInput, auth?: AuthContext): Promise<string>;
 }
 
+type JobRequest = {
+    /**
+     * A list of order IDs for which the invoices should be created.
+     */
+    orderIds?: Array<string>;
+    /**
+     * A job type determines if the orders are searched automatically based on parameters configured in configuration service or are manually provided in orderIds array.
+     */
+    jobType: 'AUTOMATIC' | 'MANUAL';
+};
+type JobCreationResponse = {
+    /**
+     * The created job ID.
+     */
+    jobId?: string;
+};
+type JobStatusResponse = {
+    /**
+     * Status of the processed job. Possible values: `DONE`,` IN_PROGRESS`
+     */
+    jobStatus?: 'DONE' | 'IN_PROGRESS';
+    /**
+     * Job type determines if the orders are provided manually or searched by a parametrized query.
+     */
+    jobType?: 'AUTOMATIC' | 'MANUAL';
+    orders?: Array<{
+        /**
+         * The ID of the processed order.
+         */
+        orderId?: string;
+        /**
+         * Status determining if the order was processed successfully.
+         */
+        orderStatus?: 'SUCCESS' | 'FAILURE' | 'PENDING';
+        /**
+         * Information about the result of order processing.
+         */
+        message?: string;
+        /**
+         * URL to the generated invoice PDF.
+         */
+        downloadLink?: string;
+        /**
+         * Number of the generated invoice.
+         */
+        invoiceNumber?: string;
+    }>;
+};
+
+/** Input for {@link InvoiceService.createJob} — order ids + job type. */
+type InvoiceJobDraft = JobRequest;
+/** Result of creating an invoice job — `{ jobId? }`. */
+type InvoiceJobCreated = JobCreationResponse;
+/** Status of an invoice job + per-order results. */
+type InvoiceJob = JobStatusResponse;
+
+/**
+ * Invoice Service (`/invoice/{tenant}/…`): create invoice-generation jobs and
+ * poll their status. Backend-only — default auth: service.
+ */
+declare class InvoiceService {
+    private readonly ctx;
+    static readonly channel: "invoice";
+    constructor(ctx: ClientContext);
+    private base;
+    /** Create an invoice-generation job (`POST …/jobs/invoices`, 201). */
+    createJob(draft: InvoiceJobDraft, auth?: AuthContext): Promise<InvoiceJobCreated>;
+    /** Retrieve a job and its per-order results (`GET …/jobs/invoices/{jobId}`). */
+    getJob(jobId: string, auth?: AuthContext): Promise<InvoiceJob>;
+}
+
+/**
+ * Access control identifier that determines who can view or manage the quotes.
+ *
+ * **Purpose**: Restricts quote visibility based on scope permissions. Only users/applications
+ * with matching restriction scopes can access quotes with a specific restriction value.
+ *
+ * **Access Control**:
+ * - *Reading*: Users can only query and view quotes with the `restriction` value that matches one of their authorized restrictions.
+ *
+ * **Validation**: The value must exist in the tenant's configured list of valid restrictions.
+ *
+ * **Restriction Synchronization**:
+ * - If quote is created by a customer (based on a cart) and `restriction` property is not set, the `restriction` value of quote is inherited from customer's restriction.
+ * - If a quote is created by an employee and the `restriction` property is not set with tenant configuration property `enableSyncBetweenRestrictionsAndSiteCodes` set to `true`, the `restriction` field automatically syncs with quote's siteCode property.
+ *
+ */
+type Restriction$1 = string | null;
+/**
+ * Price details
+ */
+type QuoteItemUpdatePriceRow = {
+    /**
+     * The ID of the matched price
+     */
+    priceId?: string;
+    /**
+     * The effective unit price of the product
+     */
+    unitePrice?: number;
+    /**
+     * The total net value for the entire quantity of the item.
+     */
+    totalNetValue?: number;
+    /**
+     * The tax information of the item.
+     */
+    tax: {
+        /**
+         * The matched tax class of the item.
+         */
+        taxClass: string;
+        /**
+         * The tax rate of the item.
+         */
+        taxRate?: number;
+    };
+};
+/**
+ * Quote status.
+ */
+type QuoteUpdateStatus = {
+    /**
+     * The status value of the code.
+     */
+    value: string;
+    /**
+     * The comment to the status.
+     */
+    comment?: string;
+    /**
+     * The ID of the quote reason. Can be provided only in following scenarios:
+     * - when changing state from OPEN to IN_PROGRESS - quote reason has to be of CHANGE type
+     * - when changing state from OPEN to DECLINED - quote reason has to be of DECLINE type
+     * - when changing state from IN_PROGRESS to DECLINED_BY_MERCHANT - quote reason has to be of DECLINE type
+     */
+    quoteReasonId?: string;
+};
+/**
+ * ID of the generated quote.
+ */
+type QuoteIdResponse = {
+    /**
+     * ID of the generated document.
+     */
+    id?: string;
+};
+/**
+ * ID of the generated quote reason.
+ */
+type QuoteReasonIdResponse = {
+    /**
+     * ID of the generated document.
+     */
+    id?: string;
+};
+/**
+ * TotalNetValue item model.
+ */
+type QuoteItemUpdatePrice = {
+    totalNetValue?: number;
+};
+/**
+ * Quote item model.
+ */
+type QuoteItemUpdate = {
+    quantity: {
+        quantity?: number;
+        unitCode?: string;
+    };
+    price: QuoteItemUpdatePriceRow;
+    product: {
+        productId?: string;
+    };
+};
+/**
+ * Quote item ID.
+ */
+type QuoteItemsReplaceUpdate = Array<QuoteItemUpdate & {
+    /**
+     * ID of the item. It's generated automatically when it's not provided.
+     */
+    itemId?: string;
+}>;
+type AddressResponse = {
+    /**
+     * The ID of the address.
+     */
+    id?: string;
+    /**
+     * The name of the address.
+     */
+    name?: string;
+    /**
+     * First line of the address.
+     */
+    addressLine1?: string;
+    /**
+     * Second line of the address.
+     */
+    addressLine2?: string;
+    /**
+     * City name.
+     */
+    city?: string;
+    /**
+     * The postal code of the city.
+     */
+    postcode?: string;
+    /**
+     * The state where the city is located.
+     */
+    state?: string;
+    /**
+     * The code of the country location.
+     */
+    countryCode?: string;
+};
+type QuoteReasonResponse = {
+    /**
+     * The quote reason ID.
+     */
+    id?: string;
+    /**
+     * Type of the quote reason.
+     */
+    type?: 'CHANGE' | 'DECLINE';
+    /**
+     * Localized message - can be either string or map with languages as map's keys accordingly to specified 'Accept-Language' header.
+     */
+    message?: {
+        [key: string]: string;
+    } | string;
+    /**
+     * Code of the reason for the quote status change.
+     */
+    code?: string;
+    /**
+     * The Quote Reason metadata details.
+     */
+    metadata?: {
+        /**
+         * Version of the quote reason that is used for the optimistic locking handling.
+         */
+        version?: number;
+        /**
+         * The Quote Reason creation timestamp.
+         */
+        createdAt?: string;
+        /**
+         * The Quote Reason modification timestamp.
+         */
+        modifiedAt?: string;
+    };
+};
+type QuoteResponse = {
+    /**
+     * Quote ID
+     *
+     * **NOTE**:
+     * If not specified during creation, this attribute is automatically generated. It is also possible to assign a custom ID.
+     */
+    id?: string;
+    /**
+     * Business model of the quote.
+     */
+    businessModel?: 'B2B' | 'B2C';
+    /**
+     * Customer-provided reference stored on the quote.
+     */
+    customerReference?: string;
+    /**
+     * Customer-provided comment stored on the quote.
+     */
+    customerComment?: string;
+    /**
+     * This attribute contains details about the customer for whom the quote was created.
+     */
+    customer?: {
+        /**
+         * The ID of the customer for whom the quote was created.
+         */
+        customerId?: string;
+        /**
+         * Customer's first name
+         *
+         * **NOTE**:
+         * This attribute is filled automatically after the quote is created.
+         */
+        firstName?: string;
+        /**
+         * Customer's last name
+         *
+         * **NOTE**:
+         * This attribute is filled automatically after the quote is created.
+         */
+        lastName?: string;
+        /**
+         * Customer's contact email
+         *
+         * **NOTE**:
+         * This attribute is filled automatically after the quote is created.
+         */
+        contactEmail?: string;
+    };
+    /**
+     * This attribute contains details about the employee that is processing the quote.
+     */
+    employee?: {
+        /**
+         * The ID of the employee that is processing the quote.
+         */
+        employeeId?: string;
+        /**
+         * Employee's first name
+         *
+         * **NOTE**:
+         * This attribute is filled automatically after the quote is created or the employee ID is updated.
+         */
+        firstName?: string;
+        /**
+         * Employee's last name.
+         *
+         * **NOTE**:
+         * This attribute is filled automatically after the quote is created or the employee ID is updated.
+         */
+        lastName?: string;
+    };
+    /**
+     * The ID of the cart from which the quote was created (not available when the quote was created manually)
+     */
+    cartId?: string;
+    /**
+     * The company for which the quote was created.
+     */
+    company?: {
+        /**
+         * The company name for which the quote was created.
+         */
+        name?: string;
+    };
+    /**
+     * The site code for which the quote was created
+     */
+    siteCode?: string;
+    /**
+     * The ID of the order which was created based on the quote. The order is created and assigned to the quote when status of the quote transitions to `ACCEPTED`.
+     */
+    orderId?: string;
+    /**
+     * The currency of the quote prices.
+     */
+    currency?: string;
+    /**
+     * The status of the quote.
+     */
+    status?: {
+        /**
+         * The status value of the quote.
+         */
+        value?: string;
+        /**
+         * Comment relating to the status.
+         */
+        comment?: string;
+        quoteReason?: QuoteReasonResponse & {
+            [key: string]: unknown;
+        };
+    };
+    /**
+     * The date until which the quote is valid and can be accepted by the customer.
+     */
+    validTo?: string;
+    /**
+     * Employee and customer comments.
+     */
+    comment?: {
+        /**
+         * Employee comment
+         */
+        employeeComment?: string;
+    };
+    billingAddress?: AddressResponse;
+    shippingAddress?: AddressResponse;
+    /**
+     * The calculated total price details.
+     */
+    totalPrice?: {
+        /**
+         * Currency of the value.
+         */
+        currency?: string;
+        /**
+         * The total net value.
+         */
+        netValue?: number;
+        /**
+         * The total gross value.
+         */
+        grossValue?: number;
+        /**
+         * The amount of the tax for the total price.
+         */
+        taxValue?: number;
+    };
+    /**
+     * The calculated quote subtotal price.
+     */
+    subtotalPrice?: {
+        /**
+         * Currency of the value.
+         */
+        currency?: string;
+        /**
+         * The subtotal net value.
+         */
+        netValue?: number;
+        /**
+         * The subtotal gross value.
+         */
+        grossValue?: number;
+        /**
+         * The subtotal tax value.
+         */
+        taxValue?: number;
+    };
+    /**
+     * Tax aggregation of the total price.
+     */
+    taxAggregate?: {
+        lines?: Array<{
+            /**
+             * The tax code.
+             */
+            name?: string;
+            /**
+             * The amount of the tax.
+             */
+            amount?: number;
+            /**
+             * The tax rate.
+             */
+            rate?: number;
+            /**
+             * The total taxable amount.
+             */
+            taxable?: number;
+        }>;
+    };
+    shipping?: QuoteShipping & {
+        /**
+         * Gross value of the shipping cost.
+         */
+        grossValue?: number;
+        /**
+         * Localized name of the shipping method selected by the customer.
+         */
+        methodName?: {
+            [key: string]: string;
+        };
+    };
+    /**
+     * A list of quote items.
+     */
+    items?: Array<{
+        /**
+         * The ID of the quote item used for patch operations on the item.
+         */
+        id?: string;
+        /**
+         * The attribute contains details about the item quantity.
+         */
+        quantity?: {
+            /**
+             * The quantity of the item that is used for the price calculation.
+             */
+            quantity?: number;
+            /**
+             * The unit code of the quantity (it must be one of the units defined in the Unit Handling Service).
+             */
+            unitCode?: string;
+        };
+        /**
+         * Item price details.
+         */
+        price?: {
+            /**
+             * Defines if product is external or internal. If the product is internal, it's taken from the Emporix Product Service. If the price is external, it's a custom product from external system.
+             */
+            type?: 'INTERNAL' | 'EXTERNAL';
+            /**
+             * The ID of the price that was initially assigned to the item.
+             */
+            priceId?: string;
+            /**
+             * The original unit price of the item that is copied from the initial price.
+             */
+            unitPrice?: number;
+            /**
+             * The new unit price that is auto-calculated based on provided `quantity` and `totalNetValue` values.
+             */
+            newUnitPrice?: number;
+            /**
+             * The difference in percentage between `unitPrice` and `newUnitPrice`.
+             */
+            discount?: number;
+            /**
+             * The total net price of the item that is initially based on the provided price, but it can be overridden to allow for a merchant discount.
+             */
+            totalNetValue?: number;
+            /**
+             * This attribute contains information about the calculated item tax.
+             */
+            tax?: {
+                /**
+                 * The tax class assigned to the item is initially copied from the initial price.
+                 */
+                taxClass?: string;
+                /**
+                 * The tax rate that is copied from the initial price.
+                 */
+                taxRate?: number;
+                /**
+                 * The auto-calculated item net and gross prices
+                 */
+                prices?: {
+                    grossValue?: number;
+                    netValue?: number;
+                };
+            };
+            /**
+             * Mixins request.
+             */
+            mixins?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Metadata request.
+             */
+            metadata?: {
+                /**
+                 * Links to the mixin schemas.
+                 */
+                mixins?: {
+                    [key: string]: unknown;
+                };
+            };
+        };
+        /**
+         * Product details.
+         */
+        product?: {
+            /**
+             * Defines if product is external or internal. If the product is internal, it's taken from the Emporix Product Service. If the price is external, it's a custom product from external system.
+             */
+            type?: 'INTERNAL' | 'EXTERNAL';
+            /**
+             * The ID of the product or variant assigned to the quote item.
+             */
+            productId?: string;
+            /**
+             * This attribute contains the product name language map.
+             *
+             * **NOTE**:
+             * After the item has been added to the quote, the product name language map attribute is automatically populated.
+             */
+            name?: {
+                [key: string]: unknown;
+            };
+            /**
+             * This attribute comprises the product media information and is automatically populated upon the creation of the quote.
+             */
+            media?: {
+                /**
+                 * ID of the media.
+                 */
+                id?: string;
+                /**
+                 * The content type of the media. For example: `image/jpg`.
+                 */
+                contentType?: string;
+                /**
+                 * The url to the product media.
+                 */
+                url?: string;
+            };
+            /**
+             * Map of key-value pairs that associates tax classes with locations (countries).
+             */
+            taxClasses?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Mixins request.
+             */
+            mixins?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Metadata request.
+             */
+            metadata?: {
+                /**
+                 * Links to the mixin schemas.
+                 */
+                mixins?: {
+                    [key: string]: unknown;
+                };
+            };
+        };
+    }>;
+    /**
+     * Mixins request.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Quote metadata details.
+     */
+    metadata?: {
+        /**
+         * Links to the mixin schemas.
+         */
+        mixins?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Version of the quote that is used for the optimistic locking handling.
+         */
+        version?: number;
+        /**
+         * Quote creation timestamp.
+         */
+        createdAt?: string;
+        /**
+         * Quote modification timestamp.
+         */
+        modifiedAt?: string;
+    };
+    restriction?: Restriction$1;
+};
+/**
+ * The schema specifies the attributes that must be provided when creating a quote reason.
+ */
+type QuoteReasonCreateRequest = {
+    /**
+     * The ID for a quote reason can either be manually provided at the time of the quote reason creation, or is automatically generated if not provided.
+     */
+    id?: string;
+    /**
+     * Type of the quote reason.
+     */
+    type: 'CHANGE' | 'DECLINE';
+    /**
+     * Code of the reason for the quote status change.
+     */
+    code: string;
+    /**
+     * Localized message in the form of a map of translations.
+     */
+    message: {
+        [key: string]: string;
+    };
+};
+/**
+ * The schema specifies the attributes that must be provided when creating a quote reason.
+ */
+type QuoteReasonUpdateRequest = {
+    /**
+     * Type of the quote reason.
+     */
+    type: 'CHANGE' | 'DECLINE';
+    /**
+     * Code of the reason for the quote status change.
+     */
+    code: string;
+    /**
+     * Localized message in the form of a map of translations.
+     */
+    message: {
+        [key: string]: string;
+    };
+    /**
+     * The Quote Reason metadata details
+     */
+    metadata: {
+        /**
+         * Version of the quote reason that is used for the optimistic locking handling
+         */
+        version: number;
+    };
+};
+/**
+ * The schema specifies the attributes that must be provided when creating a quote manually.
+ */
+type QuoteCreateRequest = {
+    /**
+     * The ID for a quote can either be manually provided at the time of the quote creation, or is automatically generated if not provided.
+     */
+    id?: string;
+    /**
+     * The customer ID for which the new quote is created. Either this attribute or the `customerEmail` attribute is required for the quote creation
+     */
+    customerId: string;
+    /**
+     * The employee ID for which the new quote is created. By default, the employeeId is taken from session token, but in case the session token is not provided, employeeId is taken from the payload. Default employee from the configuration will be assigned to the quote in case session token nor 'employeeId' is not provided.
+     */
+    employeeId?: string;
+    /**
+     * The name of the merchant company.
+     */
+    companyName?: string;
+    /**
+     * The site code for which the quote is created.
+     */
+    siteCode: string;
+    /**
+     * The currency for which the quote is created.
+     */
+    currency: string;
+    /**
+     * For B2B customers, it represents the location which should specify the billing address. For B2C customers, it represents identifier of customer's billing address.
+     */
+    billingAddressId: string;
+    /**
+     * For B2B customers, it represents the location which should specify the shipping address. For B2C customers, it represents identifier of customer's shipping address.
+     */
+    shippingAddressId: string;
+    /**
+     * The date until which the quote is valid for the customer. After this date, the quote cannot be approved and transformed into order by the customer.
+     */
+    validTo?: string;
+    shipping?: QuoteShipping;
+    /**
+     * Quote items.
+     */
+    items?: Array<{
+        /**
+         * ID of the item. It's generated automatically when it's not provided.
+         */
+        itemId?: string;
+        /**
+         * The quantity of the quote item in a given unit.
+         */
+        quantity?: {
+            /**
+             * The quantity of quote items.
+             */
+            quantity: number;
+            /**
+             * The unit of the quantity as defined in the Unit Handling Service.
+             */
+            unitCode: string;
+        };
+        /**
+         * Product reference.
+         */
+        product: {
+            /**
+             * Defines if product is external or internal. If the product is internal, it's taken from the Emporix Product Service. If the price is external, it's a custom product from external system.
+             */
+            type?: 'INTERNAL' | 'EXTERNAL';
+            /**
+             * Product or variant ID.
+             */
+            productId: string;
+            /**
+             * Localized name of a product. Used for the `EXTERNAL` products as the `INTERNAL` ones are populated from the product catalog data.
+             */
+            name?: {
+                [key: string]: string;
+            };
+            /**
+             * Media object that can be provided for an `EXTERNAL` product. `INTERNAL` products have media populated automatically and override the given value.
+             */
+            media?: {
+                /**
+                 * ID of the media.
+                 */
+                id?: string;
+                /**
+                 * The content type of the media. For example: `image/jpg`.
+                 */
+                contentType?: string;
+                /**
+                 * The url to the product media.
+                 */
+                url?: string;
+            };
+            /**
+             * Mixins request.
+             */
+            mixins?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Metadata request.
+             */
+            metadata?: {
+                /**
+                 * Links to the mixin schemas.
+                 */
+                mixins?: {
+                    [key: string]: unknown;
+                };
+            };
+        };
+        /**
+         * Matched price of the product.
+         */
+        price?: {
+            /**
+             * Defines if price is internal or external. If the price is internal, it's taken from the Emporix Price Service. If the price is external, it's a custom price from external system.
+             */
+            type?: 'INTERNAL' | 'EXTERNAL';
+            /**
+             * ID of the matched price. Required only for type=`INTERNAL`.
+             */
+            priceId: string;
+            /**
+             * Identifier of price list. The field should be populated only in case when the price belongs to any price list.
+             */
+            priceListId?: string;
+            /**
+             * Effective unit price of the product.
+             */
+            unitPrice: number;
+            /**
+             * Total net value for the entire quantity of the item.
+             */
+            totalNetValue: number;
+            /**
+             * Tax information of the item.
+             */
+            tax: {
+                /**
+                 * Matched tax class of the item.
+                 */
+                taxClass: string;
+                /**
+                 * Tax rate of the item.
+                 */
+                taxRate: number;
+            };
+        };
+        /**
+         * Mixins request.
+         */
+        mixins?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Metadata request.
+         */
+        metadata?: {
+            /**
+             * Links to the mixin schemas.
+             */
+            mixins?: {
+                [key: string]: unknown;
+            };
+        };
+    }>;
+    restriction?: Restriction$1;
+    /**
+     * Mixins request.
+     */
+    mixins?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Metadata request.
+     */
+    metadata?: {
+        /**
+         * Links to the mixin schemas.
+         */
+        mixins?: {
+            [key: string]: unknown;
+        };
+    };
+    /**
+     * The contact email that identifies the customer. Either this attribute or the `customerId` attribute is mandatory for the quote creation request.
+     */
+    customerEmail?: string;
+};
+/**
+ * The shipping cost of the quote.
+ */
+type QuoteShipping = {
+    /**
+     * Net value of the shipping cost.
+     */
+    value?: number;
+    /**
+     * Shipping method's unique identifier.
+     */
+    methodId?: string;
+    /**
+     * Shipping zone identifier.
+     */
+    zoneId?: string;
+    /**
+     * Tax code of the shipping method.
+     */
+    shippingTaxCode?: string;
+};
+/**
+ * List of item IDs.
+ */
+type QuoteItemIds = Array<{
+    /**
+     * ID of the item.
+     */
+    itemId?: string;
+}>;
+/**
+ * Quote update operation list.
+ */
+type QuoteUpdateRequest = Array<{
+    op: 'ADD' | 'REMOVE' | 'REPLACE';
+    path: '/status' | '/validTo' | '/comment' | '/billingAddressId' | '/shippingAddressId' | '/companyName' | '/customerId' | '/shipping' | '/restriction' | '/items' | '/items/{itemId}' | '/items/{itemId}/price' | '/items/{itemId}/mixins/{mixinsPath}' | '/items/{itemId}/metadata/mixins/{mixinsPath}' | '/items/{itemId}/product/mixins/{mixinsPath}' | '/items/{itemId}/product/metadata/mixins/{mixinsPath}' | '/mixins/{mixinsPath}' | '/metadata/{mixinsPath}';
+    value?: QuoteUpdateValues;
+}>;
+type QuoteUpdateValues = QuoteItemUpdate | QuoteItemsReplaceUpdate | QuoteItemUpdatePrice | QuoteUpdateStatus | QuoteShipping | QuoteItemIds | string | {
+    [key: string]: unknown;
+};
+/**
+ * Quote update operation list.
+ */
+type QuoteHistory$1 = Array<{
+    /**
+     * The unique ID of the audit log.
+     */
+    id?: string;
+    /**
+     * operation type
+     */
+    op?: 'ADD' | 'REMOVE' | 'REPLACE' | 'CREATE';
+    /**
+     * Path that indicates on which element the update has been executed.
+     */
+    path?: '/quote' | '/status' | '/validTo' | '/comment' | '/billingAddressId' | '/shippingAddressId' | '/companyName' | '/customerId' | '/shipping' | '/restriction' | '/items' | '/items/{itemId}' | '/items/{itemId}/price' | '/items/{itemId}/mixins/{mixinsPath}' | '/items/{itemId}/metadata/mixins/{mixinsPath}' | '/items/{itemId}/product/mixins/{mixinsPath}' | '/items/{itemId}/product/metadata/mixins/{mixinsPath}' | '/mixins/{mixinsPath}' | '/metadata/{mixinsPath}';
+    newValue?: QuoteUpdateValues & {
+        [key: string]: unknown;
+    };
+    /**
+     * Value before update.
+     */
+    previousValue?: QuoteUpdateValues & {
+        [key: string]: unknown;
+    };
+    /**
+     * ID of the user who modified the item.
+     */
+    userId?: string;
+    /**
+     * First name of the user who modified the item.
+     */
+    userFirstName?: string;
+    /**
+     * Last name of the user who modified the item.
+     */
+    userLastName?: string;
+    userType?: 'EMPLOYEE' | 'CUSTOMER' | 'SYSTEM';
+    restriction?: Restriction$1;
+    /**
+     * Modification date.
+     */
+    modifiedAt?: string;
+}>;
+/**
+ * This schema includes the attributes that are required to be provided when creating a quote from the cart.
+ */
+type QuoteCreateFromCartRequest = {
+    /**
+     * ID of the cart from which the new quote should be created.
+     */
+    cartId: string;
+    /**
+     * The employee ID for which the new quote is created. By default, the employeeId is taken from the configuration, but in case the 'employeeId' property is provided, the employeeId from the request is assigned to the quote. Only user of EMPLOYEE type can assign employee to the quote.
+     */
+    employeeId?: string;
+    /**
+     * For B2B customers, it represents the location which should specify the billing address. For B2C customers, it represents identifier of customer's billing address.
+     */
+    billingAddressId?: string;
+    /**
+     * For B2B customers, it represents the location which should specify the shipping address. For B2C customers, it represents identifier of customer's shipping address.
+     */
+    shippingAddressId?: string;
+    shipping?: QuoteShipping;
+    /**
+     * Customer-provided reference stored on the quote.
+     */
+    customerReference?: string;
+    /**
+     * Customer-provided comment stored on the quote.
+     */
+    customerComment?: string;
+};
+
+/** A quote (read shape). */
+type Quote = QuoteResponse;
+/** Body for {@link QuoteService.create} — a from-scratch quote or a from-cart quote. */
+type QuoteDraft = QuoteCreateRequest | QuoteCreateFromCartRequest;
+/** Result of creating a quote — `{ id? }`. */
+type QuoteCreated = QuoteIdResponse;
+/** Body for {@link QuoteService.update} — the upstream update-op array. */
+type QuoteUpdate = QuoteUpdateRequest;
+/** A quote's change history. */
+type QuoteHistory = QuoteHistory$1;
+/** A quote reason (read shape). */
+type QuoteReason = QuoteReasonResponse;
+/** Body for `reasons.create`. */
+type QuoteReasonDraft = QuoteReasonCreateRequest;
+/** Body for `reasons.update` (`metadata.version` required for optimistic locking). */
+type QuoteReasonUpdate = QuoteReasonUpdateRequest;
+/** Result of creating a quote reason — `{ id? }`. */
+type QuoteReasonCreated = QuoteReasonIdResponse;
+/** Filter/pagination for {@link QuoteService.list}. */
+interface ListQuotesQuery {
+    /** Emporix `q`-syntax filter. */
+    q?: string;
+    /** Sort spec (e.g. `createdAt:desc`). */
+    sort?: string;
+    pageNumber?: number;
+    pageSize?: number;
+}
+/** Pagination for `reasons.list`. */
+interface ListQuoteReasonsQuery {
+    pageNumber?: number;
+    pageSize?: number;
+}
+
+/**
+ * Quote Service (`/quote/{tenant}/…`): B2B quotes and quote reasons. Quotes are
+ * customer-owned and never anonymous, so every method takes a REQUIRED `auth`:
+ * pass `auth.customer(token)` for a customer's own quotes, or `auth.service()`
+ * (an admin token) for `quote_manage`-scoped ops (`delete`, reason mutations).
+ */
+declare class QuoteService {
+    private readonly ctx;
+    static readonly channel: "quote";
+    constructor(ctx: ClientContext);
+    private quotesBase;
+    private _reasons?;
+    /** Quote reasons config (`/quote-reasons`). CRUD sub-resource. */
+    get reasons(): QuoteReasonsResource;
+    /** List quotes, wrapped in {@link PaginatedItems}. Pass `{}` for no filter. */
+    list(query: ListQuotesQuery, auth: AuthContext): Promise<PaginatedItems<Quote>>;
+    /** Create a quote (`POST /quotes`, 201). */
+    create(draft: QuoteDraft, auth: AuthContext): Promise<QuoteCreated>;
+    /** Retrieve one quote by id. */
+    get(quoteId: string, auth: AuthContext): Promise<Quote>;
+    /** Apply an update-op array to a quote (`PATCH /quotes/{id}`, 204). */
+    update(quoteId: string, update: QuoteUpdate, auth: AuthContext): Promise<void>;
+    /** Delete a quote (`DELETE /quotes/{id}`). Requires the admin `quote_manage` scope. */
+    delete(quoteId: string, auth: AuthContext): Promise<void>;
+    /** Retrieve a quote's change history (`GET /quotes/{id}/history`). */
+    history(quoteId: string, auth: AuthContext): Promise<QuoteHistory>;
+    /**
+     * Generate a quote PDF (`POST /quotes/{id}/pdf`). Returns the raw PDF bytes.
+     * Uses `requestRaw` (no typed-error mapping) — a non-2xx is thrown explicitly.
+     */
+    generatePdf(quoteId: string, auth: AuthContext): Promise<Blob>;
+}
+/**
+ * Quote reasons (`/quote/{tenant}/quote-reasons`). Config data. Like the rest
+ * of the quote domain, every method takes a REQUIRED `auth`: reads accept a
+ * customer or admin token; `create`/`update`/`delete` need the admin
+ * `quote.quote_manage` scope (`auth.service()`).
+ */
+declare class QuoteReasonsResource {
+    private readonly ctx;
+    constructor(ctx: ClientContext);
+    private base;
+    /** List reasons, wrapped in {@link PaginatedItems}. Pass `{}` for no paging override. */
+    list(query: ListQuoteReasonsQuery, auth: AuthContext): Promise<PaginatedItems<QuoteReason>>;
+    /** Retrieve one reason by id. */
+    get(reasonId: string, auth: AuthContext): Promise<QuoteReason>;
+    /** Create a reason (`POST /quote-reasons`). Requires the admin `quote_manage` scope. */
+    create(draft: QuoteReasonDraft, auth: AuthContext): Promise<QuoteReasonCreated>;
+    /**
+     * Replace a reason (`PUT /quote-reasons/{id}`, 204). `draft.metadata.version`
+     * is required for optimistic locking. Requires the admin `quote_manage` scope.
+     */
+    update(reasonId: string, draft: QuoteReasonUpdate, auth: AuthContext): Promise<void>;
+    /** Delete a reason (`DELETE /quote-reasons/{id}`). Requires the admin `quote_manage` scope. */
+    delete(reasonId: string, auth: AuthContext): Promise<void>;
+}
+
 /**
  * Price calculation derived from the order entry `calculatedPrice.finalPrice`. The `finalPrice` reflects already applied discounts and fees.
  */
@@ -7572,6 +9570,8 @@ declare class EmporixClient {
     readonly countries: CountryService;
     readonly currencies: CurrencyService;
     readonly shipping: ShippingService;
+    readonly invoices: InvoiceService;
+    readonly quotes: QuoteService;
     readonly returns: ReturnsService;
     readonly sepaExport: SepaExportService;
     readonly indexing: IndexingService;
@@ -7683,4 +9683,4 @@ declare function createEmporixClient<S extends Record<string, ServiceClass<unkno
  */
 declare function productIdFromYrn(yrn: string | undefined): string;
 
-export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerInput, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type Agent, type AgentInput, type AgentPatchOp, type AgentSearchQuery, AiService, type Approval, type ApprovalCreated, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Assignee, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, type BulkInstanceResult, type BulkPatchInstanceItem, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type Conversation, type ConversationSearchQuery, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime$1 as DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$2 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListReindexJobsOptions, type ListSchemasQuery, LocationsService, LogLevel, MediaService, type MetadataFilter, type MinimumFee, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, type PointsSummary, PriceService, ProductService, QueryFor, type QuoteInput, type QuoteResult, type QuoteSlotInput, RagIndexerService, type RagType, type RecalculationJob, type RecalculationJobCreated, type RecalculationJobInput, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexEntityType, type ReindexInput, type ReindexJob, type ReindexJobInput, type ReindexJobStatus, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, SchemaService, type SchemaTypeName, type SchemaUpdate, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServiceClass, ServiceName, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteList, SiteService, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, TokenProvider, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type Vendor, type VendorCreated, type VendorInput, type VendorList, type VendorLocation, type VendorLocationInput, type VendorLocationList, type VendorLocationUpdate, type VendorSearchQuery, VendorService, type VendorUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, createCore, createEmporixClient, errorFromResponse, productIdFromYrn };
+export { type AddedPoints, type AdminCustomer, type AdminCustomerAddress, type AdminCustomerAddressInput, type AdminCustomerAddressList, type AdminCustomerAddressUpdate, type AdminCustomerCreated, type AdminCustomerInput, type AdminCustomerList, type AdminCustomerPatch, type AdminCustomerSearchQuery, type AdminCustomerUpdate, type Agent, type AgentAnalytics, type AgentExecutions, type AgentFromTemplate, type AgentInput, type AgentPatchOp, type AgentRequestLog, type AgentSearchQuery, type AgentSessionLog, type AgentTemplate, type AgenticPatchOp, type AgentsExport, type AgentsExportRequest, type AgentsImport, type AgentsImportRequest, AiService, type AnalyticsQuery, type Approval, type ApprovalCreated, type ApprovalInput, type ApprovalList, type ApprovalPatch, type ApprovalPermittedInput, type ApprovalPermittedResult, ApprovalService, type ApprovalUsersQuery, type ApprovalUsersResult, type Assignee, type Attachment, type AttachmentOptions, AuthContext, AvailabilityService, type BatchNextIdEntry, type Brand, type BrandInput, type BrandList, BrandService, type BrandUpdate, type BulkInstanceResult, type BulkPatchInstanceItem, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, type ChatStreamOptions, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, type CommerceEvents, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, type Conversation, type ConversationSearchQuery, type ConversionFactorInput, type ConversionFactorResult, type ConvertUnitInput, type ConvertUnitResult, type Country, type CountryList, CountryService, type CountryUpdate, type Coupon$1 as Coupon, type CouponCreated, type CouponInput, type CouponList, CouponService, type CouponUpdate, type Created, type Currency, type CurrencyCreated, type CurrencyInput, type CurrencyList, CurrencyService, type CurrencyUpdate, type CustomEntity, type CustomEntityDraft, type CustomInstance, type CustomInstanceDraft, CustomerAdminService, CustomerGroupsService, CustomerService, type CustomerSummaryBatch, CustomerTokenRefresher, type DeleteAgentOptions, type DeleteConfigOptions, type DeliveryCreated, type DeliveryCycleInput, type DeliverySlot, type DeliverySlotList, type DeliveryTime$1 as DeliveryTime, type DeliveryTimeInput, type DeliveryTimeList, type DeliveryTimeUpdate, type DeliveryWindow$2 as DeliveryWindow, type DeliveryWindowList, type DeliveryWindowValidation, EmporixAuthError, EmporixClient, EmporixConfig, type EmporixCore, EmporixError, EmporixForbiddenError, EmporixInsufficientScopeError, EmporixNetworkError, EmporixNotFoundError, EmporixServerError, EmporixTimeoutError, EmporixValidationError, type ExchangeRate, type ExchangeRateCreated, type ExchangeRateInput, type ExchangeRateList, type ExchangeRateUpdate, type ExecutionsQuery, type Fee$1 as Fee, type FeeDraft, FeeService, type FindSiteInput, type GetOptions, type IndexConfig, type IndexConfigCreated, type IndexPublicConfig, IndexingService, type InstanceSearchBody, type InvoiceJob, type InvoiceJobCreated, type InvoiceJobDraft, InvoiceService, type InvokeCloudFunctionOptions, type ItemFee, type ItemFeeDraft, type ItemFeeSearch, type Job, type JobIdResponse, type Label, type LabelInput, type LabelList, LabelService, type LabelUpdate, type ListConfigOptions, type ListCustomEntitiesOptions, type ListFeesQuery, type ListInstancesQuery, type ListQuery, type ListQuoteReasonsQuery, type ListQuotesQuery, type ListReindexJobsOptions, type ListSchemasQuery, LocationsService, LogLevel, type McpServer, type McpServerInput, MediaService, type MetadataFilter, type MinimumFee, type MutateOptions, type NewPointsEntry, type NextIdCommandRequest, type NextIdOptions, type NextIdResponse, type NextIdsBatchRequest, type NextIdsBatchResponse, type OAuthConfig, type OAuthInput, type OrderCycleList, type OrderEntryEventCreate, type OrderStatusChange, OrdersService, type PackagingProductsChange, type PackingEvent, type PackingEventList, PaginatedItems, PaymentGatewayService, type PickOrder, type PickOrderList, type PickPackAck, PickPackService, type PointsSummary, PriceService, ProductService, type ProviderModels, QueryFor, type Quote, type QuoteCreated, type QuoteDraft, type QuoteHistory, type QuoteInput, type QuoteReason, type QuoteReasonCreated, type QuoteReasonDraft, type QuoteReasonUpdate, type QuoteResult, QuoteService, type QuoteSlotInput, type QuoteUpdate, RagIndexerService, type RagType, type RecalculationJob, type RecalculationJobCreated, type RecalculationJobInput, type RedeemCouponResult, type RedeemMyPointsInput, type RedeemOption, type RedeemOptionList, type RedeemedPoints, type Redemption, type RedemptionCreated, type RedemptionInput, type ReferralCoupon, type Region, type RegionList, type ReindexEntityType, type ReindexInput, type ReindexJob, type ReindexJobInput, type ReindexJobStatus, ResolvedConfig, type ResourceCreated, type Return, type ReturnCreated, type ReturnInput, type ReturnList, type ReturnPatch, type ReturnUpdate, ReturnsService, RewardPointsService, SalesOrdersService, type Schema, type SchemaAttribute, type SchemaDraft, SchemaService, type SchemaTypeName, type SchemaUpdate, type SearchQuery, SegmentService, SepaExportService, type SepaJob, type SepaJobCreated, type SepaJobInput, type SequenceSchema, type SequenceSchemaCreate, SequentialIdService, type ServiceClass, ServiceName, type SessionContext, type SessionContextPatch, SessionContextService, type SetItemFeesOptions, type ShippingGroup, type ShippingGroupList, type ShippingMethod, type ShippingMethodList, type ShippingPatch, ShippingService, type ShoppingList, type ShoppingListDraft, type ShoppingListItem, ShoppingListService, type Site$1 as Site, type SiteList, SiteService, type TaxCalculationInput, type TaxCalculationRequest, type TaxCalculationResult, type TaxClass, type TaxConfig, type TaxConfigCreated, type TaxCreation as TaxConfigInput, type TaxUpdate as TaxConfigUpdate, type TaxLocation, TaxService, TenantConfigService, type TextRequest, type TextResponse, type Token, type TokenInput, TokenProvider, type Tool, type ToolInput, type Unit, type UnitCreated, UnitHandlingService, type UnitInput, type UnitUpdate, type Vendor, type VendorCreated, type VendorInput, type VendorList, type VendorLocation, type VendorLocationInput, type VendorLocationList, type VendorLocationUpdate, type VendorSearchQuery, VendorService, type VendorUpdate, type WebhookConfig, type WebhookConfigCreated, type WebhookConfigDraft, type WebhookConfigPatch, type WebhookDashboardAccess, WebhookService, type WebhookStatistics, type WebhookStatisticsQuery, type WebhookSubscription, type WebhookSubscriptionUpdateItem, type WebhookSubscriptionUpdateResultItem, type Zone, type ZoneList, createCore, createEmporixClient, errorFromResponse, productIdFromYrn };