@viu/emporix-sdk 2.19.0 → 2.20.1

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-DhoFgoKf.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-DhoFgoKf.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-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 { CustomerService } from './customer.js';
 export { Address, AddressCreateInput, AddressUpdateInput, Customer, CustomerSession, CustomerSignupInput, CustomerUpdateInput, PasswordChangeInput, PasswordResetConfirmInput, PasswordResetRequestInput } from './customer.js';
 import { ProductService } from './product.js';
@@ -834,7 +834,7 @@ declare class CloudFunctionsService {
 
 type AbstractWebhookConfig = {
     /**
-     * Indicates whether a given configuration is active. Only one configuration can be active.
+     * Indicates whether a given configuration is active. Only one configuration can be active at a time.
      */
     active?: boolean;
     provider?: Provider;
@@ -942,9 +942,16 @@ type ConfigurationGet = {
     }>;
 };
 /**
- * Unique identifier of webhook configuration.
+ * Unique identifier of the webhook configuration type.
  */
 type ConfigCode = string;
+/**
+ * Webhook provider strategy. Maps to configuration types as follows:
+ *
+ * * `SVIX` – `svix`
+ * * `SVIX_SHARED` – `svix_shared`
+ * * `HTTP` – `http`
+ */
 type Provider = 'SVIX_SHARED' | 'SVIX' | 'HTTP';
 type WebhookConfigUpdate = AbstractWebhookConfig & {
     configuration?: Configuration;
@@ -1177,7 +1184,7 @@ declare class WebhookService {
 /**
  * Type which the schema should be assigned to. Can be one of the predefined values or any custom schema type id.
  */
-type SchemaType = 'CART' | 'CART_ITEM' | 'CATEGORY' | 'COMPANY' | 'COUPON' | 'CUSTOMER' | 'CUSTOMER_ADDRESS' | 'ORDER' | 'ORDER_ENTRY' | 'PRODUCT' | 'QUOTE' | 'RETURN' | 'PRICE_LIST' | 'SITE' | 'CUSTOM_ENTITY' | 'VENDOR';
+type SchemaType = 'CART' | 'CART_ITEM' | 'CATEGORY' | 'COMPANY' | 'COUPON' | 'CUSTOMER' | 'CUSTOMER_ADDRESS' | 'ORDER' | 'ORDER_ENTRY' | 'PRODUCT' | 'QUOTE' | 'RETURN' | 'PRICE_LIST' | 'SITE' | 'CUSTOM_ENTITY' | 'VENDOR' | 'MEDIA';
 /**
  * Type of the attribute.
  *
@@ -1378,6 +1385,40 @@ type CustomInstanceResponse = {
     media?: Array<string>;
     metadata?: CustomInstanceMetadata;
 };
+type BulkResponse = Array<{
+    /**
+     * Index of the processed item, matching the item position in request body.
+     */
+    index?: number;
+    /**
+     * HTTP Status Code.
+     */
+    code?: number;
+    /**
+     * HTTP Status description
+     */
+    status?: string;
+    /**
+     * Error message.
+     */
+    message?: string;
+    details?: Array<{
+        /**
+         * Error details.
+         */
+        message?: string;
+    }>;
+}>;
+type BulkPatchCustomInstanceRequest = {
+    /**
+     * Unique identifier of the custom instance to patch.
+     */
+    id: string;
+    /**
+     * List of patch operations to apply to the custom instance.
+     */
+    data: Array<PatchOperation$1>;
+};
 type CustomInstanceMetadata = {
     /**
      * Date and time when the object was created, compliant with the ISO 8601 standard. For example: `2022-03-31T09:52:15.423Z`
@@ -1398,7 +1439,31 @@ type CustomInstanceMetadata = {
         [key: string]: unknown;
     };
 };
+type PatchOperation$1 = {
+    /**
+     * Indicates an operation which should be done on a return. Available operations: `add` `remove` and `replace`
+     */
+    op: 'add' | 'remove' | 'replace';
+    /**
+     * Path to the field to update.
+     *
+     * Examples: `/name`, `/mixins/additionalAttributes/externalId`, `/mixins/additionalAttributes/careInstructions/1`.
+     *
+     * To append an item to an array mixin field (for example, a table row), use `add` with a path ending in `/-`. The `-` means append after the last element.
+     */
+    path: string;
+    /**
+     * Indicates a value that should be changed or added. The value can be of a primitive type, like string, number, boolean or it can be an object or an array.
+     */
+    value?: {
+        [key: string]: unknown;
+    } | string | number;
+};
 
+/** One item for {@link SchemaService.bulkPatchInstances} — `{ id, data: op[] }`. */
+type BulkPatchInstanceItem = BulkPatchCustomInstanceRequest;
+/** Per-item results of a bulk operation (207) — `{ index?, code?, status?, message?, details? }[]`. */
+type BulkInstanceResult = BulkResponse;
 /** A schema definition (typed attributes attached to one or more entity types). */
 type Schema = SchemaResponse;
 /** A single typed attribute within a schema (recursive for `OBJECT`). */
@@ -1541,6 +1606,13 @@ declare class SchemaService {
     replaceInstance<T = Record<string, unknown>>(type: string, id: string, draft: CustomInstanceDraft<T>, auth?: AuthContext): Promise<CustomInstance<T>>;
     /** Partially update an instance (`PATCH`). */
     patchInstance<T = Record<string, unknown>>(type: string, id: string, patch: Partial<CustomInstanceDraft<T>>, auth?: AuthContext): Promise<CustomInstance<T>>;
+    /**
+     * Patch up to 200 custom instances of `type` in one call
+     * (`PATCH /custom-entities/{type}/instances/bulk`). Returns a 207 envelope:
+     * a per-item result array — a 207 is success, individual failures live in
+     * each item's `code`/`status`.
+     */
+    bulkPatchInstances(type: string, items: BulkPatchInstanceItem[], auth?: AuthContext): Promise<BulkInstanceResult>;
     /** Delete an instance by id. */
     deleteInstance(type: string, id: string, auth?: AuthContext): Promise<void>;
     /**
@@ -1619,9 +1691,9 @@ type ExpandedTokenResponse = InnerTokenResponse & {
  */
 type ExpandableTokenResponse = InnerTokenResponse | ExpandedTokenResponse;
 /**
- * Type of the native tool.
+ * Type of the native tool. Value `teams` is in preview.
  */
-type NativeToolType = 'slack' | 'rag_custom' | 'rag_emporix';
+type NativeToolType = 'slack' | 'rag_custom' | 'rag_emporix' | 'teams';
 type BaseNativeTool = {
     type: NativeToolType;
     /**
@@ -1781,6 +1853,49 @@ type SlackNativeToolResponse = BaseNativeTool & {
     config?: SlackNativeToolConfigResponse;
     metadata?: MetadataResponse$1;
 };
+/**
+ * MS Teams native tool operation identifier.
+ */
+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.
+ */
+type TeamsNativeToolConfigResponse = {
+    /**
+     * Microsoft Teams team ID the tool is bound to.
+     */
+    teamId: string;
+    /**
+     * Customer Azure AD tenant ID for the Teams workspace.
+     */
+    tenantId?: string;
+    /**
+     * Agent ID that handles inbound Teams replies when no conversation-specific owner is set.
+     */
+    defaultInboundAgentId?: string;
+    /**
+     * Operations the tool instance exposes to assigned agents. At least one value is required when the tool is enabled.
+     */
+    allowedOperations?: Array<TeamsAllowedOperations>;
+};
+type TeamsNativeToolResponse = BaseNativeTool & {
+    /**
+     * Unique identifier of the tool.
+     */
+    id?: string;
+    /**
+     * For TeamsNativeTool it has to be set to `teams`.
+     */
+    type?: unknown;
+    config?: TeamsNativeToolConfigResponse;
+    metadata?: MetadataResponse$1;
+};
 type RagCustomNativeToolResponse = BaseNativeTool & {
     /**
      * Unique identifier of the tool.
@@ -1808,7 +1923,40 @@ type RagEmporixNativeToolResponse = BaseNativeTool & {
 /**
  * List of native tools which agents should have access to.
  */
-type NativeToolsResponse = Array<SlackNativeToolResponse | RagCustomNativeToolResponse | RagEmporixNativeToolResponse>;
+type NativeToolsResponse = Array<SlackNativeToolResponse | RagCustomNativeToolResponse | RagEmporixNativeToolResponse | TeamsNativeToolResponse>;
+/**
+ * Represents an active agent conversation context (MS Teams channel or group chat).
+ */
+type ConversationResponse = {
+    /**
+     * Provider-side conversation identifier (Teams conversation ID).
+     */
+    conversationId?: string;
+    /**
+     * Human-readable name of the conversation channel or group chat.
+     */
+    conversationName?: string;
+    /**
+     * Caller-supplied reference key used to reuse an existing conversation.
+     */
+    contextRef?: string;
+    /**
+     * Teams channel or chat identifier.
+     */
+    channelId?: string;
+    /**
+     * Identifier of the agent that owns this conversation.
+     */
+    agentId?: string;
+    /**
+     * LangGraph session (checkpointer) ID for agent continuity.
+     */
+    sessionId?: string;
+    /**
+     * Timestamp of the last message activity in this conversation.
+     */
+    lastMessageAt?: string;
+};
 type McpServerConfig = {
     /**
      * URL of the MCP server.
@@ -1893,11 +2041,11 @@ type BaseLlm = {
     /**
      * Value between 0.1 and 1.0 (inclusive), in steps of 0.1. The lower value the more creative (but less stable) the model is.
      */
-    temperature: 0.1 | 0.2 | 0.3 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 | 1;
+    temperature?: 0.1 | 0.2 | 0.3 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 | 1;
     /**
      * The limit of tokens which agent can burn during one request session.
      */
-    maxTokens: number;
+    maxTokens?: number;
 };
 type EmporixLlm = BaseLlm & {
     /**
@@ -1905,6 +2053,35 @@ 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.
@@ -1919,9 +2096,11 @@ type SelfHostedParamsRequest = SelfHostedParams & {
     [key: string]: unknown;
 } & {
     authorizationHeaderToken?: InnerTokenRequest;
+    oAuthParams?: OAuthParamsRequest;
 };
 type SelfHostedParamsResponse = SelfHostedParams & {
     authorizationHeaderToken?: ExpandableTokenResponse;
+    oAuthParams?: OAuthParamsResponse;
 };
 type SelfHostedLlm = BaseLlm & {
     /**
@@ -1948,8 +2127,24 @@ type ApiKeyLlmRequest = ApiKeyLlm & {
 type ApiKeyLlmResponse = ApiKeyLlm & {
     token?: ExpandableTokenResponse;
 };
-type IdWrapper = {
+/**
+ * ![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 %}
+ *
+ * Reference to a native tool assigned to an agent.
+ */
+type NativeToolReferenceRequest = {
+    /**
+     * Identifier of the native tool.
+     */
     id: string;
+    /**
+     * Optional per-agent override of allowed MS Teams operations. When omitted, the tool instance defaults apply.
+     */
+    allowedOperations?: Array<TeamsAllowedOperations>;
 };
 /**
  * List of agent collaborations which allows an agent to hand off its task to other agents.
@@ -2093,6 +2288,11 @@ type BaseForAgentAndTemplate = BaseForAgentAndTemplateAndHandOff & {
      */
     icon?: string;
     tags?: Array<string>;
+    /**
+     * Optional JSON Schema (provided as a JSON string) that constrains the structure of the agent's generated output. Use this when you need predictable, machine-readable output instead of free-form text.
+     *
+     */
+    outputFormat?: string;
     /**
      * Indicates whether the agent is enabled.
      */
@@ -2112,9 +2312,9 @@ type BaseForAgentRequestAndResponse = BaseForAgentAndTemplate & {
 };
 type AgentRequest = BaseForAgentRequestAndResponse & {
     /**
-     * ID of the native tools.
+     * Native tools assigned to the agent, optionally with per-agent `allowedOperations` overrides.
      */
-    nativeTools?: Array<IdWrapper>;
+    nativeTools?: Array<NativeToolReferenceRequest>;
     llmConfig: EmporixLlm | ApiKeyLlmRequest | SelfHostedLlmRequest;
     mcpServers: AgentMcpServersRequest;
     metadata?: MetadataRequest;
@@ -2186,6 +2386,7 @@ type PatchRequest = Array<{
         [key: string]: unknown;
     };
 }>;
+type QParamSearchBody2 = QParamSearchBody;
 
 /** Single-shot text generation request (`POST /texts`). Has `maxTokens`. */
 type TextRequest = TextGenerationRequest;
@@ -2241,6 +2442,18 @@ interface DeleteAgentOptions {
     /** Force deletion even if the agent is referenced elsewhere (`?force=true`). */
     force?: boolean;
 }
+/** Options for {@link AiService.chatStream}. */
+interface ChatStreamOptions {
+    /**
+     * Reuse an existing chat context (sent as the `session-id` header). If
+     * omitted, the server generates a new session id.
+     */
+    sessionId?: string;
+}
+/** A stored agentic conversation (Teams-backed). */
+type Conversation = ConversationResponse;
+/** Request body for `searchConversations` (`{ q? }`) — same shape as agent search. */
+type ConversationSearchQuery = QParamSearchBody2;
 
 /**
  * Emporix AI Service (`/ai-service/{tenant}/…`): text generation, chat
@@ -2292,6 +2505,17 @@ declare class AiService {
      * Returns the job-id ARRAY verbatim.
      */
     chatAsync(input: ChatRequest, auth?: AuthContext): Promise<JobIdResponse[]>;
+    /**
+     * Streaming agent chat (`POST /agentic/chat-stream`, `text/event-stream`).
+     * Yields each SSE `data` payload verbatim — the upstream contract types the
+     * stream body as an opaque string, so chunks are raw strings, not parsed
+     * objects. Consume with `for await`.
+     */
+    chatStream(input: ChatRequest, opts?: ChatStreamOptions, auth?: AuthContext): AsyncIterable<string>;
+    /** List stored agentic conversations (`GET /agentic/conversations`). */
+    listConversations(auth?: AuthContext): Promise<Conversation[]>;
+    /** Server-side conversation search (`POST /agentic/conversations/search`). */
+    searchConversations(query: ConversationSearchQuery, auth?: AuthContext): Promise<Conversation[]>;
 }
 
 type Metadata$7 = {
@@ -5103,9 +5327,9 @@ declare class SepaExportService {
 }
 
 /**
- * Informs about status of reindex job. `PENDING` means that the maximum number of parallel `IN_PROGRESS` jobs is reached and such job will be processed when one of current `IN_PROGRESS` jobs is released.
+ * Informs about status of reindex job. `PENDING` means that the maximum number of parallel `IN_PROGRESS` jobs is reached and such job will be processed when one of current `IN_PROGRESS` jobs is released. `PUBLISHED` means that all the indexing events were emitted. `SUCCESS` means that all the indexing events were consumed.
  */
-type ReindexJobStatus$1 = 'FAILURE' | 'IN_PROGRESS' | 'PENDING' | 'SUCCESS';
+type ReindexJobStatus$1 = 'FAILURE' | 'IN_PROGRESS' | 'PENDING' | 'PUBLISHED' | 'SUCCESS';
 type Metadata$3 = {
     /**
      * Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`
@@ -5131,6 +5355,14 @@ type ReindexJob$1 = {
      */
     message?: string;
     status?: ReindexJobStatus$1;
+    /**
+     * Expected number of entities which need to be indexed.
+     */
+    expectedCount?: number;
+    /**
+     * Actual number of entities which were indexed. Allows to track the progress of reindexing process.
+     */
+    processedCount?: number;
     metadata?: Metadata$3;
 };
 type ReindexRequest = {
@@ -5168,9 +5400,16 @@ type IndexConfiguration = IndexPublicConfiguration & {
      */
     writeKey?: string;
     /**
-     * Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the `BATTERY_INCLUDED` provider; ignored for `ALGOLIA`.
+     * Optional list of root product mixin keys to exclude from indexing. When set, the specified mixin keys are omitted from both the non-localized and localized portions of the indexed document. Applies only to the `BATTERY_INCLUDED` provider.
      */
     excludedMixinKeys?: Array<string>;
+    /**
+     * Optional allowlist of product mixin paths to include in indexing for the `BATTERY_INCLUDED` provider. Patterns are matched against full dot-notation paths rooted at the mixin key, for example `class_EA673_toolsClassification.sk.OnlineIsService_P`.
+     * `*` matches within a single path segment, `**` matches across one or more path segments, and matching is case sensitive.
+     * If a matched path points to an object, the entire subtree under that object is included. When this field is absent or an empty list, path filtering is inactive and existing `excludedMixinKeys` behavior applies.
+     * `includedMixinPaths` and `excludedMixinKeys` are mutually exclusive when `includedMixinPaths` is non-empty. Malformed glob patterns are rejected with a validation error on configuration writes.
+     */
+    includedMixinPaths?: Array<string>;
 };
 type IndexCreationResponse = {
     /**
@@ -7444,4 +7683,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, CartService, type Catalog, type CatalogCreated, type CatalogInput, type CatalogList, type CatalogPatch, CatalogService, type CatalogUpdate, CategoryService, type CgRelation, type CgRelationList, type ChatRequest, type ChatResponse, CheckoutService, ClientConfigService, type ClientConfiguration, ClientContext, CloudFunctionsService, CompaniesService, type CompletionMessage, type CompletionRequest, type CompletionResponse, type Configuration$1 as Configuration, type ConfigurationDraft, ContactsService, 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 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 };

package/dist/index.js

@@ -16,8 +16,8 @@ import { AvailabilityService } from './chunk-IVCCGJN5.js';
 export { AvailabilityService } from './chunk-IVCCGJN5.js';
 import { CartService } from './chunk-PAT4CS36.js';
 export { CartService } from './chunk-PAT4CS36.js';
-import { CategoryService } from './chunk-6XND7SYV.js';
-export { CategoryService } from './chunk-6XND7SYV.js';
+import { CategoryService } from './chunk-ZNLHLFQM.js';
+export { CategoryService } from './chunk-ZNLHLFQM.js';
 export { iterateAll } from './chunk-GWJ2U2CP.js';
 import { resolveQuery } from './chunk-S5HEIQDK.js';
 export { resolveQuery } from './chunk-S5HEIQDK.js';
@@ -296,6 +296,47 @@ function createNoopLogger() {
   return new NoopLogger();
 }
 
+// src/core/sse.ts
+function parseFrame(frame) {
+  const ev = { data: "" };
+  const dataLines = [];
+  let saw = false;
+  for (const line of frame.split("\n")) {
+    if (line === "" || line.startsWith(":")) continue;
+    const colon = line.indexOf(":");
+    const field = colon === -1 ? line : line.slice(0, colon);
+    let value = colon === -1 ? "" : line.slice(colon + 1);
+    if (value.startsWith(" ")) value = value.slice(1);
+    if (field === "data") {
+      dataLines.push(value);
+      saw = true;
+    } else if (field === "event") {
+      ev.event = value;
+      saw = true;
+    } else if (field === "id") {
+      ev.id = value;
+      saw = true;
+    }
+  }
+  if (!saw) return void 0;
+  ev.data = dataLines.join("\n");
+  return ev;
+}
+async function* parseSseStream(chunks) {
+  let buf = "";
+  for await (const chunk of chunks) {
+    buf += chunk.replace(/\r\n/g, "\n");
+    let idx;
+    while ((idx = buf.indexOf("\n\n")) !== -1) {
+      const ev = parseFrame(buf.slice(0, idx));
+      buf = buf.slice(idx + 2);
+      if (ev) yield ev;
+    }
+  }
+  const tail = parseFrame(buf);
+  if (tail) yield tail;
+}
+
 // src/core/http.ts
 var requestSeq = 0;
 function safeJson(text) {
@@ -485,10 +526,72 @@ var HttpClient = class {
       clearTimeout(timer);
     }
   }
+  /**
+   * Open a Server-Sent Events stream (`text/event-stream`) and yield parsed
+   * events. Unlike {@link request}, no overall read budget applies (streams are
+   * long-lived) — only `connectMs` bounds time-to-headers, and the consumer
+   * breaking the iterator aborts the fetch. Like {@link requestRaw}, it does
+   * NOT retry or re-auth on 401; a non-2xx maps to a typed error before the
+   * stream begins.
+   */
+  async *requestStream(o) {
+    const log = this.opts.logger.child({ requestId: `req-${++requestSeq}` });
+    const url = new URL(this.opts.host + o.path);
+    for (const [k, v] of Object.entries(o.query ?? {})) {
+      if (v !== void 0) url.searchParams.set(k, String(v));
+    }
+    const token = await resolveToken(o.auth, this.opts.provider);
+    const controller = new AbortController();
+    const connectTimer = setTimeout(() => controller.abort(), this.opts.timeouts.connectMs);
+    const headers = this.buildHeaders(o, token, false);
+    headers["Accept"] = "text/event-stream";
+    let res;
+    try {
+      res = await fetch(url, {
+        method: o.method,
+        headers,
+        signal: controller.signal,
+        ...o.body !== void 0 ? { body: JSON.stringify(o.body) } : {}
+      });
+    } catch (err) {
+      clearTimeout(connectTimer);
+      if (err.name === "AbortError") {
+        throw new EmporixTimeoutError(`${o.method} ${o.path} timed out opening stream`);
+      }
+      throw new EmporixNetworkError(
+        `${o.method} ${o.path} network failure: ${err.message}`
+      );
+    }
+    clearTimeout(connectTimer);
+    if (!res.ok) {
+      const text = await res.text().catch(() => "");
+      throw errorFromResponse(
+        res.status,
+        `${o.method} ${o.path} \u2192 ${res.status}`,
+        text ? safeJson(text) : void 0
+      );
+    }
+    log.debug("http stream open", { status: res.status });
+    if (!res.body) return;
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    async function* readChunks() {
+      try {
+        for (; ; ) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          yield decoder.decode(value, { stream: true });
+        }
+      } finally {
+        controller.abort();
+      }
+    }
+    yield* parseSseStream(readChunks());
+  }
 };
 
 // package.json
-var version = "2.19.0";
+var version = "2.20.1";
 
 // src/version.ts
 var SDK_VERSION = version;
@@ -1507,6 +1610,20 @@ var SchemaService = class {
       body: patch
     });
   }
+  /**
+   * Patch up to 200 custom instances of `type` in one call
+   * (`PATCH /custom-entities/{type}/instances/bulk`). Returns a 207 envelope:
+   * a per-item result array — a 207 is success, individual failures live in
+   * each item's `code`/`status`.
+   */
+  async bulkPatchInstances(type, items, auth2 = SERVICE7) {
+    return this.ctx.http.request({
+      method: "PATCH",
+      path: `${this.instancesBase(type)}/bulk`,
+      auth: auth2,
+      body: items
+    });
+  }
   /** Delete an instance by id. */
   async deleteInstance(type, id, auth2 = SERVICE7) {
     await this.ctx.http.request({
@@ -1642,6 +1759,39 @@ var AiService = class {
       body: input
     });
   }
+  /**
+   * Streaming agent chat (`POST /agentic/chat-stream`, `text/event-stream`).
+   * Yields each SSE `data` payload verbatim — the upstream contract types the
+   * stream body as an opaque string, so chunks are raw strings, not parsed
+   * objects. Consume with `for await`.
+   */
+  async *chatStream(input, opts = {}, auth2 = SERVICE8) {
+    const events = this.ctx.http.requestStream({
+      method: "POST",
+      path: `${this.base()}/agentic/chat-stream`,
+      auth: auth2,
+      body: input,
+      ...opts.sessionId ? { headers: { "session-id": opts.sessionId } } : {}
+    });
+    for await (const ev of events) yield ev.data;
+  }
+  /** List stored agentic conversations (`GET /agentic/conversations`). */
+  async listConversations(auth2 = SERVICE8) {
+    return this.ctx.http.request({
+      method: "GET",
+      path: `${this.base()}/agentic/conversations`,
+      auth: auth2
+    });
+  }
+  /** Server-side conversation search (`POST /agentic/conversations/search`). */
+  async searchConversations(query, auth2 = SERVICE8) {
+    return this.ctx.http.request({
+      method: "POST",
+      path: `${this.base()}/agentic/conversations/search`,
+      auth: auth2,
+      body: query
+    });
+  }
 };
 
 // src/services/tax.ts