@opencxh/domain 1.52.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/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';
@@ -18,6 +19,7 @@ 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.52.0",
+  "version": "1.53.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",