@opencxh/domain 1.50.0 → 1.53.0

package/dist/entities/ai-message/types.d.ts

@@ -1,3 +1,4 @@
+import { ToolTraceEntry } from '../../platform/ai-tools';
 export interface AIMessageInput {
     text: string;
     type: "text";
@@ -17,16 +18,19 @@ export interface AIMessage {
     accountId?: string;
     model?: string;
     externalId?: string;
+    /** Tools the assistant invoked while producing this message (final, persisted trace). */
+    toolTrace?: ToolTraceEntry[];
 }
+/**
+ * Profile-driven ask payload. The selected profile is the source of truth, so
+ * the client sends only `profileId`; the server resolves account/model/
+ * systemPrompt/enabledTools from it.
+ */
 export interface AIMessageAskPayload {
     interactionId: string;
     input: AIMessageInput;
-    model: string;
-    accountId: string;
+    profileId: string;
     previousExternalId?: string;
-    providerConfig?: Record<string, any>;
-    instructions?: string;
-    systemPrompt?: string;
     context?: Record<string, any>;
 }
 export interface AIMessageAskResponse {

package/dist/entities/ai-profile/types.d.ts

@@ -13,4 +13,6 @@ export interface AIProfile<T extends Record<string, any> = Record<string, any>>
     systemPrompt: string;
     contextIds?: string[];
     predefinedPrompts?: PredefinedPrompt[];
+    /** Namespaced tool names this profile may use (default: none enabled). */
+    enabledTools?: string[];
 }

package/dist/entities/mcp/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/dist/entities/mcp/types.d.ts

@@ -0,0 +1,12 @@
+/** Configuration for an external MCP (Model Context Protocol) server, per organization. */
+export interface McpServerConfig {
+    id: string;
+    organizationId: string;
+    name: string;
+    /** Only Streamable HTTP transport is supported for server-side connections. */
+    transport: "http";
+    url: string;
+    /** Optional auth/extra headers sent on connect (e.g. `Authorization`). */
+    headers?: Record<string, string>;
+    enabled: boolean;
+}

package/dist/entities/shopify/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/dist/entities/shopify/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Shopify DTO's — gedeeld tussen de shopify-server (mapping uit Admin API),
+ * platform-api (typed client) en de frontend-tool. Geen Shopify-SDK-types
+ * lekken naar consumers; dit is de smalle, stabiele contractlaag.
+ */
+export interface ShopifyCustomer {
+    id: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    ordersCount?: number;
+    totalSpent?: string;
+    currency?: string;
+}
+export interface ShopifyLineItem {
+    title: string;
+    variantTitle?: string;
+    quantity: number;
+    price: string;
+}
+export interface ShopifyTracking {
+    company?: string;
+    number?: string;
+    url?: string;
+}
+export interface ShopifyAddress {
+    name?: string;
+    address1?: string;
+    address2?: string;
+    zip?: string;
+    city?: string;
+    province?: string;
+    country?: string;
+    phone?: string;
+}
+export interface ShopifyOrder {
+    id: string;
+    /** Human order-name, bv. "#1001". */
+    name: string;
+    createdAt: string;
+    financialStatus?: string;
+    fulfillmentStatus?: string;
+    totalPrice: string;
+    currency: string;
+    lineItems: ShopifyLineItem[];
+    shippingAddress?: ShopifyAddress;
+    tracking: ShopifyTracking[];
+    note?: string;
+    /** Deep-link naar de order in de Shopify-admin (nieuw tabblad). */
+    adminUrl: string;
+}
+export interface ShopifyOrderEvent {
+    id: string;
+    createdAt: string;
+    /** Mensvriendelijke omschrijving van het event. */
+    message: string;
+    /** Shopify "verb" (bv. "confirmed", "fulfilled", "sale"). */
+    verb?: string;
+}
+export interface ShopifyLookupResult {
+    /** False = geen verbonden/enabled shop voor deze org (admin moet koppelen). */
+    connected: boolean;
+    customer: ShopifyCustomer | null;
+    /** Deep-link naar de klant in de Shopify-admin. */
+    customerAdminUrl?: string;
+    orders: ShopifyOrder[];
+}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './entities/ai-account';
 export * from './entities/ai-context';
 export * from './entities/ai-message';
 export * from './entities/ai-profile';
+export * from './entities/mcp';
 export * from './entities/channel';
 export * from './entities/communication';
 export * from './entities/contact';
@@ -15,8 +16,10 @@ export * from './entities/task';
 export * from './entities/note';
 export * from './entities/team';
 export * from './entities/organization';
+export * from './entities/shopify';
 export * from './entities/transcript';
 export * from './entities/user';
+export * from './platform/ai-tools';
 export * from './platform/api';
 export * from './platform/common';
 export * from './platform/capabilities';

package/dist/platform/ai-tools.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Provider-agnostic tool-use contracts for the AI assistant.
+ *
+ * A tool is described once in this neutral shape; each AI provider adapter
+ * translates it to/from its own native function-calling format. Tools can come
+ * from internal apps (via the "ai-tool" provider role) or external MCP servers —
+ * both surface through the same {@link AiTool} shape.
+ */
+/** JSON-Schema object describing a tool's arguments. */
+export interface AiToolParameterSchema {
+    type: "object";
+    properties: Record<string, unknown>;
+    required?: string[];
+}
+/** A callable tool advertised to the model. */
+export interface AiTool {
+    /** Namespaced, model-facing name, e.g. `kb__kb_search` or `mcp__<server>__<tool>`. */
+    name: string;
+    description: string;
+    parameters: AiToolParameterSchema;
+}
+/** A model's request to call a tool. */
+export interface AiToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/** The result of executing a tool call, fed back to the model. */
+export interface AiToolResult {
+    id: string;
+    content: string;
+    isError?: boolean;
+}
+/** Returned by an app's `GET /provider/ai-tools/describe`. */
+export type AiToolDescriptor = AiTool;
+/** One step in the assistant's tool-use trace, persisted on the message. */
+export interface ToolTraceEntry {
+    call: AiToolCall;
+    state: "running" | "done" | "error";
+    result?: AiToolResult;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencxh/domain",
-  "version": "1.50.0",
+  "version": "1.53.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",