@metad/contracts 3.8.0 → 3.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metad/contracts",
-  "version": "3.8.0",
+  "version": "3.8.1",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",

package/src/ai/chat-message.model.d.ts

@@ -52,7 +52,7 @@ export type ChatMessageStatusEnum = XpertAgentExecutionStatusEnum | 'thinking' |
  * BaseMessage or AIMessage in Langchain.js
  */
 export interface CopilotBaseMessage {
-    id: string;
+    id?: string;
     createdAt?: Date;
     role: CopilotMessageType;
     /**

package/src/ai/index.d.ts

@@ -42,3 +42,4 @@ export * from './knowledge-doc-chunk.model';
 export * from './skill.model';
 export * from './middleware.model';
 export * from './sandbox';
+export * from './message-content.utils';

package/src/ai/message-content.utils.d.ts

@@ -0,0 +1,52 @@
+import { TMessageContent, TMessageContentComplex } from '@xpert-ai/chatkit-types';
+import { CopilotChatMessage } from './chat-message.model';
+export type TMessageJoinHint = 'none' | 'space' | 'line' | 'paragraph';
+export type TMessageAppendContext = {
+    source?: string;
+    streamId?: string;
+    joinHint?: TMessageJoinHint;
+};
+export type TAppendMessageContentOptions = TMessageAppendContext & {
+    previous?: TMessageAppendContext | null;
+};
+export type TResolveMessageAppendContextOptions = {
+    previous?: TMessageAppendContext | null;
+    incoming: string | TMessageContentComplex;
+    fallbackSource?: string;
+    fallbackStreamId?: string;
+};
+export type TResolvedMessageAppendContext = {
+    appendContext: TMessageAppendContext;
+    messageContext: TMessageAppendContext;
+};
+export type TMessageAppendContextTracker = {
+    resolve: (options: Omit<TResolveMessageAppendContextOptions, 'previous'>) => TResolvedMessageAppendContext;
+    reset: () => void;
+    current: () => TMessageAppendContext | null;
+};
+export declare function inferMessageAppendContext(content: string | TMessageContentComplex, fallbackSource?: string): TMessageAppendContext;
+export declare function resolveMessageAppendContext(options: TResolveMessageAppendContextOptions): TResolvedMessageAppendContext;
+/**
+ * Stateful helper for streaming append.
+ *
+ * It keeps the previous append context and resolves the current one, so callers
+ * can avoid passing `previous` manually for every chunk and still get stable
+ * join behavior (for example, same source + same stream -> `joinHint: 'none'`).
+ *
+ * Call `reset()` at turn/session boundaries to prevent cross-turn contamination.
+ */
+export declare function createMessageAppendContextTracker(initial?: TMessageAppendContext | null): TMessageAppendContextTracker;
+/**
+ * Append one incoming chunk into a chat message in place.
+ *
+ * Behavior:
+ * - Keeps `aiMessage` object reference stable (caller may hold this object).
+ * - Updates message properties with new references (`content`/`reasoning` arrays)
+ *   so UI change detection that relies on reference changes can react reliably.
+ * - Applies context-aware merge rules for text/reasoning/component chunks.
+ * - `previous` must be supplied by caller when same-stream join inference is needed.
+ */
+export declare function appendMessageContent(aiMessage: CopilotChatMessage, incoming: string | TMessageContentComplex, context?: TAppendMessageContentOptions): void;
+export declare function appendMessagePlainText(accumulator: string, incoming: string | TMessageContentComplex, context?: TMessageAppendContext): string;
+export declare function stringifyMessageContent(content: TMessageContent | TMessageContentComplex): string;
+export declare function filterMessageText(content: TMessageContent | TMessageContentComplex): string;

package/src/ai/xpert-tool-mcp.model.d.ts

@@ -1,7 +1,8 @@
 export declare enum MCPServerType {
     SSE = "sse",
     STDIO = "stdio",
-    CODE = "code"
+    CODE = "code",
+    HTTP = "http"
 }
 /**
  * Configuration for stdio transport connection
@@ -23,6 +24,19 @@ export interface SSEConnection {
     headers?: Record<string, string>;
     useNodeEventSource?: boolean;
 }
+/**
+ * Configuration for Streamable HTTP transport connection
+ */
+export interface HttpConnection {
+    transport: "http";
+    url: string;
+    headers?: Record<string, string>;
+    /**
+     * Whether to automatically fallback to SSE if Streamable HTTP is not available.
+     * Defaults to true.
+     */
+    automaticSSEFallback?: boolean;
+}
 export type TMCPServerReconnect = {
     /**
      * Whether to automatically restart the process if it exits
@@ -51,6 +65,11 @@ export type TMCPServer = {
     url?: string;
     headers?: Record<string, string>;
     useNodeEventSource?: boolean;
+    /**
+     * Whether to automatically fallback to SSE if Streamable HTTP is not available.
+     * Defaults to true. Only applicable for HTTP transport.
+     */
+    automaticSSEFallback?: boolean;
     /**
      * Default timeout in milliseconds for tool execution. Must be greater than 0.
      * If not specified, tools will use their own configured timeout values.

package/src/plugin.d.ts

@@ -1,9 +1,23 @@
 import { IBasePerTenantAndOrganizationEntityModel } from './base-entity.model';
 import { IconDefinition } from './types';
 export type PluginName = string;
+export declare const PLUGIN_LEVEL: {
+    readonly SYSTEM: "system";
+    readonly ORGANIZATION: "organization";
+};
+/**
+ * Classifies plugin scope and governance.
+ * - `system`: built-in/platform-managed plugin that users cannot install/uninstall from org APIs.
+ * - `organization`: tenant/org-managed plugin that can be installed and removed per organization.
+ */
+export type PluginLevel = (typeof PLUGIN_LEVEL)[keyof typeof PLUGIN_LEVEL];
 export interface PluginMeta {
     name: PluginName;
     version: string;
+    /**
+     * Declares the plugin's operational level used for visibility and install/uninstall guardrails.
+     */
+    level?: PluginLevel;
     icon?: IconDefinition;
     category: 'set' | 'doc-source' | 'agent' | 'tools' | 'model' | 'vlm' | 'vector-store' | 'integration' | 'datasource' | 'database' | 'middleware';
     displayName: string;
@@ -16,6 +30,7 @@ export interface IPlugin extends IBasePerTenantAndOrganizationEntityModel {
     pluginName: string;
     packageName: string;
     version?: string;
-    source?: "marketplace" | "local" | "git" | "url" | "npm" | "code";
+    source?: 'marketplace' | 'local' | 'git' | 'url' | 'npm' | 'code' | 'env';
+    level?: PluginLevel;
     config: Record<string, any>;
 }