@xpert-ai/contracts 3.9.4 → 3.9.8

package/src/ai/ai.model.d.ts

@@ -1,3 +1,7 @@
+import type { TFollowUpConsumedEvent, TMessageContentComplex, TThreadContextUsageEvent } from '@xpert-ai/chatkit-types';
+import type { IChatConversation } from './chat.model';
+import type { IChatMessage } from './chat-message.model';
+import type { IXpertAgentExecution } from './xpert-agent-execution.model';
 /**
  * Business roles for AI copilot (commands or contexts)
  */
@@ -80,3 +84,87 @@ export declare enum AiProtocol {
 }
 export declare const OpenAIEmbeddingsProviders: AiProvider[];
 export declare const OllamaEmbeddingsProviders: AiProvider[];
+export declare enum ChatMessageTypeEnum {
+    MESSAGE = "message",
+    EVENT = "event"
+}
+export declare enum ChatMessageEventTypeEnum {
+    ON_CONVERSATION_START = "on_conversation_start",
+    ON_CONVERSATION_END = "on_conversation_end",
+    ON_MESSAGE_START = "on_message_start",
+    ON_MESSAGE_END = "on_message_end",
+    ON_TOOL_START = "on_tool_start",
+    ON_TOOL_END = "on_tool_end",
+    ON_TOOL_ERROR = "on_tool_error",
+    ON_TOOL_MESSAGE = "on_tool_message",
+    ON_AGENT_START = "on_agent_start",
+    ON_AGENT_END = "on_agent_end",
+    ON_RETRIEVER_START = "on_retriever_start",
+    ON_RETRIEVER_END = "on_retriever_end",
+    ON_RETRIEVER_ERROR = "on_retriever_error",
+    ON_INTERRUPT = "on_interrupt",
+    ON_ERROR = "on_error",
+    ON_CHAT_EVENT = "on_chat_event",
+    ON_CLIENT_EFFECT = "on_client_effect"
+}
+export declare enum ChatMessageStepCategory {
+    List = "list",
+    WebSearch = "web_search",
+    Files = "files",
+    File = "file",
+    Program = "program",
+    Iframe = "iframe",
+    Memory = "memory",
+    Tasks = "tasks",
+    Knowledges = "knowledges"
+}
+export type TChatStreamMessagePayload = {
+    type: ChatMessageTypeEnum.MESSAGE;
+    data: string | TMessageContentComplex;
+};
+export type TChatStreamConversationPayload = {
+    type: ChatMessageTypeEnum.EVENT;
+    event: ChatMessageEventTypeEnum.ON_CONVERSATION_START | ChatMessageEventTypeEnum.ON_CONVERSATION_END;
+    data: Partial<IChatConversation>;
+};
+export type TChatStreamMessageEndData = Pick<IChatMessage, 'id' | 'conversationId' | 'executionId' | 'role' | 'status' | 'error'>;
+export type TChatStreamMessageStartPayload = {
+    type: ChatMessageTypeEnum.EVENT;
+    event: ChatMessageEventTypeEnum.ON_MESSAGE_START;
+    data: Partial<IChatMessage>;
+};
+export type TChatStreamMessageEndPayload = {
+    type: ChatMessageTypeEnum.EVENT;
+    event: ChatMessageEventTypeEnum.ON_MESSAGE_END;
+    data: Partial<TChatStreamMessageEndData>;
+};
+export type TChatStreamMessageLifecyclePayload = TChatStreamMessageStartPayload | TChatStreamMessageEndPayload;
+export type TChatStreamAgentEndData = Pick<IXpertAgentExecution, 'id' | 'agentKey' | 'status' | 'error' | 'elapsedTime' | 'tokens' | 'totalTokens' | 'embedTokens' | 'inputTokens' | 'outputTokens' | 'totalPrice' | 'currency' | 'metadata' | 'responseLatency' | 'parentId' | 'xpertId'>;
+export type TChatStreamAgentEndPayload = {
+    type: ChatMessageTypeEnum.EVENT;
+    event: ChatMessageEventTypeEnum.ON_AGENT_END;
+    data: Partial<TChatStreamAgentEndData>;
+};
+export type TChatStreamErrorPayload = {
+    type: ChatMessageTypeEnum.EVENT;
+    event: ChatMessageEventTypeEnum.ON_ERROR;
+    data: string | {
+        error?: string;
+    };
+};
+export type TChatStreamChatEventData = NonNullable<IChatMessage['events']>[number] | TFollowUpConsumedEvent | TThreadContextUsageEvent;
+export type TChatStreamChatEventPayload = {
+    type: ChatMessageTypeEnum.EVENT;
+    event: ChatMessageEventTypeEnum.ON_CHAT_EVENT;
+    data: TChatStreamChatEventData;
+};
+export type TChatStreamUnhandledEventPayload = {
+    type: ChatMessageTypeEnum.EVENT;
+    event: Exclude<ChatMessageEventTypeEnum, ChatMessageEventTypeEnum.ON_CONVERSATION_START | ChatMessageEventTypeEnum.ON_CONVERSATION_END | ChatMessageEventTypeEnum.ON_MESSAGE_START | ChatMessageEventTypeEnum.ON_MESSAGE_END | ChatMessageEventTypeEnum.ON_AGENT_END | ChatMessageEventTypeEnum.ON_ERROR | ChatMessageEventTypeEnum.ON_CHAT_EVENT>;
+    data?: Partial<IChatConversation> | Partial<IChatMessage> | Partial<IXpertAgentExecution> | TChatStreamChatEventData | string;
+};
+export type TChatStreamEventPayload = TChatStreamMessagePayload | TChatStreamConversationPayload | TChatStreamMessageLifecyclePayload | TChatStreamAgentEndPayload | TChatStreamErrorPayload | TChatStreamChatEventPayload | TChatStreamUnhandledEventPayload;
+export type TChatStreamCompletePayload = {
+    type: 'complete';
+};
+export type TChatStreamPayload = TChatStreamEventPayload | TChatStreamCompletePayload;

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

@@ -21,6 +21,11 @@ export type TChatConversationOptions = {
     features?: Array<'timeline' | 'sandbox' | 'files'>;
     workspacePath?: string;
     workspaceUrl?: string;
+    workspaceRoot?: string;
+    sharedWorkspacePath?: string;
+    agentWorkspacePath?: string;
+    sessionWorkspacePath?: string;
+    memoryWorkspacePath?: string;
     sandboxEnvironmentId?: string;
     runtimeCapabilities?: RuntimeCapabilitiesSelection;
 };

package/src/ai/context-compression.model.d.ts

@@ -1,12 +1,16 @@
+import type { I18nText } from '../i18n.model';
 export declare const CONTEXT_COMPRESSION_COMPONENT_TYPE = "context-compression";
 export type TContextCompressionComponentStatus = 'running' | 'success' | 'fail';
+export type TContextCompressionComponentReason = 'no_messages' | 'no_unprotected_history' | 'no_token_gain';
 export type TContextCompressionComponentData = {
     category: 'Tool';
     type: typeof CONTEXT_COMPRESSION_COMPONENT_TYPE;
     status: TContextCompressionComponentStatus;
-    title?: string;
-    message?: string;
-    error?: string;
+    reason?: TContextCompressionComponentReason;
+    title?: I18nText;
+    message?: I18nText;
+    summary?: string;
+    error?: I18nText;
     created_date?: string | Date | null;
     end_date?: string | Date | null;
 };

package/src/ai/feature.model.d.ts

@@ -6,5 +6,6 @@ export declare enum AiFeatureEnum {
     FEATURE_XPERT_CHATBI = "FEATURE_XPERT_CHATBI",
     FEATURE_XPERT_CLAWXPERT = "FEATURE_XPERT_CLAWXPERT",
     FEATURE_XPERT_CODEXPERT = "FEATURE_XPERT_CODEXPERT",
-    FEATURE_XPERT_DEEP_RESEARCH = "FEATURE_XPERT_DEEP_RESEARCH"
+    FEATURE_XPERT_DEEP_RESEARCH = "FEATURE_XPERT_DEEP_RESEARCH",
+    FEATURE_XPERT_DATA_ONTOLOGY = "FEATURE_XPERT_DATA_ONTOLOGY"
 }

package/src/ai/index.d.ts

@@ -1,38 +1,5 @@
 export declare const STATE_VARIABLE_HUMAN = "human";
-export declare enum ChatMessageTypeEnum {
-    MESSAGE = "message",
-    EVENT = "event"
-}
-export declare enum ChatMessageEventTypeEnum {
-    ON_CONVERSATION_START = "on_conversation_start",
-    ON_CONVERSATION_END = "on_conversation_end",
-    ON_MESSAGE_START = "on_message_start",
-    ON_MESSAGE_END = "on_message_end",
-    ON_TOOL_START = "on_tool_start",
-    ON_TOOL_END = "on_tool_end",
-    ON_TOOL_ERROR = "on_tool_error",
-    ON_TOOL_MESSAGE = "on_tool_message",
-    ON_AGENT_START = "on_agent_start",
-    ON_AGENT_END = "on_agent_end",
-    ON_RETRIEVER_START = "on_retriever_start",
-    ON_RETRIEVER_END = "on_retriever_end",
-    ON_RETRIEVER_ERROR = "on_retriever_error",
-    ON_INTERRUPT = "on_interrupt",
-    ON_ERROR = "on_error",
-    ON_CHAT_EVENT = "on_chat_event",
-    ON_CLIENT_EFFECT = "on_client_effect"
-}
-export declare enum ChatMessageStepCategory {
-    List = "list",
-    WebSearch = "web_search",
-    Files = "files",
-    File = "file",
-    Program = "program",
-    Iframe = "iframe",
-    Memory = "memory",
-    Tasks = "tasks",
-    Knowledges = "knowledges"
-}
+export { ChatMessageEventTypeEnum, ChatMessageStepCategory, ChatMessageTypeEnum } from './ai.model';
 export type * from '@xpert-ai/chatkit-types';
 export type { TChatRequest } from './xpert-chat.model';
 export { CHAT_EVENT_TYPE_FOLLOW_UP_CONSUMED } from './chat-event.model';
@@ -81,6 +48,7 @@ export * from './knowledgebase-task.model';
 export * from './knowledge-pipeline';
 export * from './knowledge-retrieval-log.model';
 export * from './knowledge-doc-chunk.model';
+export * from './knowledge-graph.model';
 export * from './skill.model';
 export * from './prompt-workflow.model';
 export * from './middleware.model';

package/src/ai/knowledge-graph.model.d.ts

@@ -0,0 +1,224 @@
+import type { IBasePerTenantAndOrganizationEntityModel } from '../base-entity.model';
+import type { IKnowledgebase } from './knowledgebase.model';
+import type { IKnowledgeDocument } from './knowledge-doc.model';
+import type { IKnowledgeDocumentChunk } from './knowledge-doc-chunk.model';
+export declare enum KnowledgeGraphStatus {
+    DISABLED = "disabled",
+    INDEXING = "indexing",
+    READY = "ready",
+    FAILED = "failed",
+    REBUILD_REQUIRED = "rebuild_required"
+}
+export declare enum KnowledgeGraphIndexJobStatus {
+    QUEUED = "queued",
+    RUNNING = "running",
+    SUCCESS = "success",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+export type KnowledgeGraphIndexJobType = 'document' | 'rebuild';
+export type GraphRagRetrievalMode = 'vector' | 'graph' | 'hybrid';
+export type KnowledgeGraphItemOrigin = 'extracted' | 'manual' | 'curated';
+export type KnowledgeGraphVisibility = 'active' | 'hidden';
+export type GraphRagConfig = {
+    enabled?: boolean;
+    entityTopK?: number;
+    neighborHops?: number;
+    communityTopK?: number;
+    graphWeight?: number;
+    extractionBatchSize?: number;
+    extractionMaxCharacters?: number;
+};
+export type KnowledgeGraphEvidence = {
+    chunkId: string;
+    quote?: string | null;
+    confidence?: number | null;
+};
+export interface IKnowledgeGraphEntity extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    type: string;
+    name: string;
+    normalizedName: string;
+    origin?: KnowledgeGraphItemOrigin;
+    visibility?: KnowledgeGraphVisibility;
+    aliases?: string[] | null;
+    description?: string | null;
+    summary?: string | null;
+    confidence?: number | null;
+    mentionCount?: number | null;
+    revision?: number | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface IKnowledgeGraphRelation extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    sourceEntityId?: string;
+    sourceEntity?: IKnowledgeGraphEntity;
+    targetEntityId?: string;
+    targetEntity?: IKnowledgeGraphEntity;
+    type: string;
+    normalizedType?: string | null;
+    origin?: KnowledgeGraphItemOrigin;
+    visibility?: KnowledgeGraphVisibility;
+    description?: string | null;
+    confidence?: number | null;
+    weight?: number | null;
+    evidenceCount?: number | null;
+    revision?: number | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface IKnowledgeGraphMention extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    entityId?: string;
+    entity?: IKnowledgeGraphEntity;
+    relationId?: string | null;
+    relation?: IKnowledgeGraphRelation | null;
+    documentId?: string;
+    document?: IKnowledgeDocument;
+    chunkId?: string;
+    chunk?: IKnowledgeDocumentChunk;
+    quote?: string | null;
+    confidence?: number | null;
+    startOffset?: number | null;
+    endOffset?: number | null;
+    revision?: number | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface IKnowledgeGraphCommunity extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    key: string;
+    title?: string | null;
+    summary?: string | null;
+    entityIds?: string[] | null;
+    revision?: number | null;
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface IKnowledgeGraphIndexJob extends IBasePerTenantAndOrganizationEntityModel {
+    knowledgebaseId?: string;
+    knowledgebase?: IKnowledgebase;
+    documentId?: string | null;
+    document?: IKnowledgeDocument | null;
+    type: KnowledgeGraphIndexJobType;
+    status: KnowledgeGraphIndexJobStatus;
+    revision?: number | null;
+    totalChunks?: number | null;
+    processedChunks?: number | null;
+    error?: string | null;
+    startedAt?: Date | null;
+    completedAt?: Date | null;
+}
+export type KnowledgeGraphStatusResponse = {
+    status: KnowledgeGraphStatus;
+    enabled: boolean;
+    revision?: number | null;
+    error?: string | null;
+    entityCount: number;
+    relationCount: number;
+    mentionCount: number;
+    queuedJobCount: number;
+    runningJobCount: number;
+    failedJobCount: number;
+    jobs?: IKnowledgeGraphIndexJob[];
+};
+export type KnowledgeGraphViewNode = {
+    id: string;
+    name: string;
+    type: string;
+    origin: KnowledgeGraphItemOrigin;
+    visibility: KnowledgeGraphVisibility;
+    mentionCount?: number | null;
+    confidence?: number | null;
+    symbolSize?: number;
+    value?: number;
+};
+export type KnowledgeGraphViewEdge = {
+    id: string;
+    source: string;
+    target: string;
+    type: string;
+    origin: KnowledgeGraphItemOrigin;
+    visibility: KnowledgeGraphVisibility;
+    weight?: number | null;
+    evidenceCount?: number | null;
+};
+export type KnowledgeGraphViewResponse = {
+    nodes: KnowledgeGraphViewNode[];
+    edges: KnowledgeGraphViewEdge[];
+    entityTypes: string[];
+    relationTypes: string[];
+    totalNodes: number;
+    totalEdges: number;
+};
+export type KnowledgeGraphVisualizationQuery = {
+    search?: string | null;
+    entityType?: string | null;
+    relationType?: string | null;
+    origin?: KnowledgeGraphItemOrigin | null;
+    visibility?: KnowledgeGraphVisibility | null;
+    focusEntityId?: string | null;
+    depth?: number | null;
+    take?: number | null;
+};
+export type KnowledgeGraphMentionListQuery = {
+    entityId?: string | null;
+    relationId?: string | null;
+    documentId?: string | null;
+    chunkId?: string | null;
+    take?: number | null;
+};
+export type KnowledgeGraphEntityChunksQuery = {
+    neighborHops?: number | null;
+    take?: number | null;
+    includeMentions?: boolean | null;
+    mentionTake?: number | null;
+    documentId?: string | null;
+};
+export type KnowledgeGraphEntityChunksResponse = {
+    entity: IKnowledgeGraphEntity;
+    chunks: IKnowledgeDocumentChunk[];
+    evidenceByChunkId: Record<string, IKnowledgeGraphMention[]>;
+    totals: {
+        chunks: number;
+        mentions: number;
+        entityIds: number;
+        relations: number;
+    };
+    limits: {
+        take: number;
+        neighborHops: number;
+        mentionTake: number;
+        includeMentions: boolean;
+    };
+    truncated?: {
+        chunks?: boolean;
+        mentions?: boolean;
+    };
+};
+export type KnowledgeGraphEntityCreateInput = {
+    name: string;
+    type: string;
+    aliases?: string[] | null;
+    description?: string | null;
+    visibility?: KnowledgeGraphVisibility;
+};
+export type KnowledgeGraphEntityUpdateInput = Partial<KnowledgeGraphEntityCreateInput>;
+export type KnowledgeGraphRelationCreateInput = {
+    sourceEntityId: string;
+    targetEntityId: string;
+    type: string;
+    description?: string | null;
+    weight?: number | null;
+    visibility?: KnowledgeGraphVisibility;
+};
+export type KnowledgeGraphRelationUpdateInput = Partial<KnowledgeGraphRelationCreateInput>;

package/src/ai/knowledge-pipeline.d.ts

@@ -94,6 +94,10 @@ export interface IWFNKnowledgeBase extends IWorkflowNode {
      * @deprecated Configure rerank model on the knowledgebase.
      */
     rerankModel?: ICopilotModel;
+    /**
+     * @deprecated Configure chat model on the knowledgebase.
+     */
+    chatModel?: ICopilotModel;
     /**
      * @deprecated Configure vision model on the knowledgebase.
      */

package/src/ai/knowledgebase.model.d.ts

@@ -5,6 +5,7 @@ import { IKnowledgeDocument } from './knowledge-doc.model';
 import { IXpert } from './xpert.model';
 import { IIntegration } from '../integration.model';
 import { IDocChunkMetadata } from './knowledge-doc-chunk.model';
+import type { GraphRagConfig, KnowledgeGraphStatus } from './knowledge-graph.model';
 /**
  * Non-internal types should remain the same as IntegrationEnum.
  */
@@ -67,6 +68,11 @@ export type TKnowledgebase = {
      */
     copilotModel?: ICopilotModel;
     copilotModelId?: string;
+    /**
+     * Chat model for knowledgebase LLM tasks.
+     */
+    chatModel?: ICopilotModel | null;
+    chatModelId?: string | null;
     embeddingCollectionName?: string | null;
     embeddingModelFingerprint?: string | null;
     embeddingDimensions?: number | null;
@@ -79,6 +85,10 @@ export type TKnowledgebase = {
     pendingEmbeddingRevision?: number | null;
     rebuildTaskId?: string | null;
     embeddingRebuildError?: string | null;
+    graphRag?: GraphRagConfig | null;
+    graphStatus?: KnowledgeGraphStatus | null;
+    graphRevision?: number | null;
+    graphIndexError?: string | null;
     rerankModel?: ICopilotModel;
     rerankModelId?: string;
     visionModel?: ICopilotModel;

package/src/ai/middleware.model.d.ts

@@ -1,7 +1,8 @@
-import { IWorkflowNode, WorkflowNodeTypeEnum } from "./xpert-workflow.model";
-import { I18nObject, IconDefinition } from "../types";
-import { TXpertFeatureKey, TXpertGraph, TXpertTeamNode } from "./xpert.model";
-import { JsonSchemaObjectType } from "./types";
+import { IWorkflowNode, WorkflowNodeTypeEnum } from './xpert-workflow.model';
+import { I18nObject, IconDefinition } from '../types';
+import { TXpertFeatureKey, TXpertGraph, TXpertTeamNode } from './xpert.model';
+import { JsonSchemaObjectType } from './types';
+import type { SkillSlashCommand } from './skill.model';
 export declare const LEGACY_SANDBOX_COMPRESSION_MIDDLEWARE_NAME = "SandboxCompressionMiddleware";
 export declare const CONTEXT_COMPRESSION_MIDDLEWARE_NAME = "ContextCompressionMiddleware";
 export interface IWFNMiddleware extends IWorkflowNode {
@@ -30,5 +31,6 @@ export type TAgentMiddlewareMeta = {
     description?: I18nObject;
     configSchema?: JsonSchemaObjectType;
     features?: TXpertFeatureKey[];
+    slashCommands?: SkillSlashCommand[];
 };
 export declare function getAgentMiddlewareNodes(graph: TXpertGraph, agentKey: string): TXpertTeamNode[];

package/src/ai/xpert.model.d.ts

@@ -522,16 +522,21 @@ export type TChatOptions = {
  * Knowledgebase retrieval settings
  */
 export type TKBRetrievalSettings = {
-    metadata: {
+    mode?: 'vector' | 'graph' | 'hybrid';
+    neighborHops?: number;
+    entityTopK?: number;
+    communityTopK?: number;
+    graphWeight?: number;
+    metadata?: {
         filtering_mode: 'disabled' | 'automatic' | 'manual';
         /**
          * Conditions (filter) when mode is manual
          */
-        filtering_conditions: TWFCase;
+        filtering_conditions?: TWFCase;
         /**
          * Parameter fields (tool call) when mode is automatic
          */
-        fields: Record<string, object>;
+        fields?: Record<string, object>;
     };
 };
 export declare function isXpertNodeType<T extends TXpertTeamNodeType>(type: T): (node: TXpertTeamNode) => node is NodeOf<T>;

package/src/ai/xpert.utils.d.ts

@@ -1,6 +1,6 @@
 import { IPoint } from '../types';
 import { IXpertAgent } from './xpert-agent.model';
-import { IXpert, TXpertTeamConnection, TXpertTeamDraft, TXpertTeamNode } from './xpert.model';
+import { IXpert, TXpertGraph, TXpertTeamConnection, TXpertTeamDraft, TXpertTeamNode } from './xpert.model';
 export declare function omitXpertRelations(xpert: Partial<IXpert>): {
     environmentId?: string;
     workspaceId?: string;
@@ -37,7 +37,7 @@ export declare function omitXpertRelations(xpert: Partial<IXpert>): {
     latest?: boolean;
     releaseNotes?: string;
     exportedTemplate?: import("./xpert.model").TXpertExportedTemplate | null;
-    graph?: import("./xpert.model").TXpertGraph;
+    graph?: TXpertGraph;
     api?: import("./xpert.model").TChatApi;
     app?: import("./xpert.model").TChatApp;
     userId?: string;
@@ -54,6 +54,9 @@ export declare function omitXpertRelations(xpert: Partial<IXpert>): {
  * @returns
  */
 export declare function figureOutXpert(xpert: IXpert, isDraft: boolean): Partial<IXpert>;
+export declare function resolveRuntimeXpert(xpert: IXpert, isDraft: boolean): IXpert;
+export declare function resolveDraftRuntimeGraph(xpert: IXpert, draft: TXpertTeamDraft): TXpertGraph;
+export declare function resolveDraftPrimaryAgent(xpert: IXpert, draft: TXpertTeamDraft, graph: TXpertGraph): IXpertAgent | undefined;
 export declare function xpertLabel(agent: Partial<IXpert>): string;
 export declare function createXpertGraph(xpert: IXpert, position: IPoint): {
     nodes: TXpertTeamNode[];

package/src/analytics/features.d.ts

@@ -3,6 +3,9 @@ export declare enum AnalyticsFeatures {
     FEATURE_INDICATOR = "FEATURE_INDICATOR",
     FEATURE_INDICATOR_MARKET = "FEATURE_INDICATOR_MARKET",
     FEATURE_INDICATOR_REGISTER = "FEATURE_INDICATOR_REGISTER",
+    /**
+     * @deprecated Indicator App is no longer exposed in the system menu.
+     */
     FEATURE_INDICATOR_APP = "FEATURE_INDICATOR_APP",
     FEATURE_STORY = "FEATURE_STORY",
     FEATURE_STORY_CREATION = "FEATURE_STORY_CREATION",

package/src/analytics/role-permissions.d.ts

@@ -16,6 +16,9 @@ export declare enum AnalyticsPermissionsEnum {
     BUSINESS_AREA_VIEW = "BUSINESS_AREA_VIEW",
     BUSINESS_AREA_EDIT = "BUSINESS_AREA_EDIT",
     INDICATOR_VIEW = "INDICATOR_VIEW",
+    /**
+     * @deprecated Indicator App is no longer exposed in the system menu.
+     */
     INDICATOR_MARTKET_VIEW = "INDICATOR_MARTKET_VIEW",
     INDICATOR_EDIT = "INDICATOR_EDIT",
     DATA_FACTORY_VIEW = "DATA_FACTORY_VIEW",

package/src/i18n.model.d.ts

@@ -0,0 +1,6 @@
+export interface I18nObject {
+    en_US: string;
+    zh_Hans?: string;
+}
+export type I18nText = string | I18nObject;
+export declare function resolveI18nText(value: unknown, language?: string): string | null;

package/src/index.d.ts

@@ -1,4 +1,6 @@
 export * from './types';
+export type { I18nObject, I18nText } from './i18n.model';
+export { resolveI18nText } from './i18n.model';
 export * from './contact.model';
 export * from './core.model';
 export * from './country.model';

package/src/types.d.ts

@@ -1,6 +1,9 @@
 import ShortUniqueId from 'short-unique-id';
-import type * as z3 from "zod/v3";
-import type * as z4 from "zod/v4/core";
+import type * as z3 from 'zod/v3';
+import type * as z4 from 'zod/v4/core';
+import type { I18nObject } from './i18n.model';
+export type { I18nObject, I18nText } from './i18n.model';
+export { resolveI18nText } from './i18n.model';
 declare const uuidGenerator: ShortUniqueId;
 export declare const uuid: (...args: Parameters<(typeof uuidGenerator)["randomUUID"]>) => string;
 /**
@@ -11,10 +14,6 @@ export declare const uuid: (...args: Parameters<(typeof uuidGenerator)["randomUU
  * @docsSubcategory Identifiers
  */
 export type ID = string;
-export interface I18nObject {
-    en_US: string;
-    zh_Hans?: string;
-}
 export type TAvatar = {
     emoji?: {
         id: string;
@@ -245,4 +244,3 @@ export interface IconDefinition {
 export type ZodObjectV3 = z3.ZodObject<any, any, any, any>;
 export type ZodObjectV4 = z4.$ZodObject;
 export type InteropZodObject = ZodObjectV3 | ZodObjectV4;
-export {};