@agent-earth/shared 0.0.4

package/dist/types/websocket.d.ts

@@ -0,0 +1,301 @@
+import type { CesiumCommand } from './cesium.js';
+export interface WebSocketConfig {
+    enabled: boolean;
+    port: number;
+    host: string;
+    path: string;
+    messageFormat: 'json' | 'binary';
+    heartbeatInterval: number;
+    maxConnections: number;
+}
+export interface WSMessage {
+    type: WSMessageType;
+    id: string;
+    timestamp: string;
+    payload: unknown;
+}
+export type WSMessageType = 'client_register' | 'user_input' | 'text_reply' | 'tool_choice_required' | 'build_model' | 'building_model' | 'cesium_command' | 'workspace_command' | 'workspace_connector_request' | 'workspace_connector_result' | 'command_result' | 'action_feedback' | 'agent_status' | 'error' | 'heartbeat' | 'status' | 'workspace_mode_change' | 'workspace_mode_changed' | 'profile_switched';
+export type ClientType = 'nl_component' | 'smart_earth' | 'workspace_ui' | 'workspace_connector';
+/**
+ * 三态状态机的作者身份角色:
+ * - `default`     常态,与实例 default 人格 1:1 对话(顶部显示实例本名)
+ * - `sub-agent`   接管态,@某子智能体后 1:1(顶部显示子智能体本名)
+ * - `orchestrator` 调度态,发起多人会诊(顶部显示「…·主调度」)
+ */
+export type AgentRole = 'default' | 'sub-agent' | 'orchestrator';
+/** profile_switched 的触发来源:意图门自动 / @mention 接管 / 用户手动勾选。 */
+export type ProfileSwitchTrigger = 'intent-gate' | 'mention' | 'manual';
+export interface HermesAction {
+    type: string;
+    interface?: string;
+    params: Record<string, unknown>;
+    id?: string;
+}
+export type RuntimeToolChoiceSource = 'mcp' | 'skill' | 'flowise' | 'auto';
+export interface RuntimeToolChoiceOption {
+    index: number;
+    source: RuntimeToolChoiceSource;
+    toolName?: string;
+    label: string;
+    description?: string;
+}
+export interface RuntimeToolConflict {
+    id: string;
+    originalMessage: string;
+    options: RuntimeToolChoiceOption[];
+    conflictingToolNames: string[];
+    prompt: string;
+}
+export interface ClientRegisterMessage extends WSMessage {
+    type: 'client_register';
+    payload: {
+        clientType: ClientType;
+        sessionId?: string;
+        userId?: string;
+        metadata?: Record<string, unknown>;
+    };
+}
+export interface UserInputMessage extends WSMessage {
+    type: 'user_input';
+    payload: {
+        text: string;
+        sessionId: string;
+        context?: Record<string, unknown>;
+        voiceInput?: boolean;
+        /**
+         * 前端当前 activeProfile:常态省略;接管态=子智能体 profile 名;
+         * 调度态=orchestrator profile 名。桥接据此选人格注入(非 Hermes 路由键)。
+         */
+        targetProfile?: string;
+        /** 调度态标志,true 时桥接走 orchestrator 人格(编排提示词 + 专家池)。 */
+        orchestratorMode?: boolean;
+    };
+}
+export interface TextReplyMessage extends WSMessage {
+    type: 'text_reply';
+    payload: {
+        /** 作者 profile 名:常态 'default';接管态=子智能体名;调度态=orchestrator 名。旧消息可能为 'hermes'。 */
+        text: string;
+        agentId: string;
+        sessionId: string;
+        actions?: HermesAction[];
+        isStreaming?: boolean;
+        isFinal?: boolean;
+        /** profile 人类可读名(实例本名 / 子智能体本名 / 编排显示名);前端身份头数据驱动渲染。 */
+        agentDisplayName?: string;
+        /** 三态作者身份,前端据此选渲染样式(缺失=旧消息,fallback 通用名)。 */
+        agentRole?: AgentRole;
+    };
+}
+export interface ToolChoiceRequiredMessage extends WSMessage {
+    type: 'tool_choice_required';
+    payload: {
+        agentId: string;
+        sessionId: string;
+        conflict: RuntimeToolConflict;
+    };
+}
+export interface CesiumCommandMessage extends WSMessage {
+    type: 'cesium_command';
+    payload: {
+        command: CesiumCommand;
+        agentId: string;
+        sessionId: string;
+    };
+}
+export interface WorkspaceCommandMessage extends WSMessage {
+    type: 'workspace_command';
+    payload: {
+        command: string;
+        targetMessageId?: string;
+        workspaceId?: string;
+        sessionId?: string;
+        agentId?: string;
+        [key: string]: unknown;
+    };
+}
+export interface BuildingModelMessage extends WSMessage {
+    type: 'build_model' | 'building_model';
+    payload: {
+        user_name?: string;
+        username?: string;
+        userName?: string;
+        model_id?: string;
+        modelId?: string;
+        id?: string;
+        model_url?: string;
+        modelUrl?: string;
+        url?: string;
+        glb_url?: string;
+        glbUrl?: string;
+        polygon?: unknown;
+        bbox?: unknown;
+        build_type?: string;
+        buildType?: string;
+        building_type?: string;
+        scale?: number;
+        request_id?: string;
+        requestId?: string;
+        task_id?: string;
+        taskId?: string;
+        [key: string]: unknown;
+    };
+}
+export type WorkspaceConnectorOperation = 'workspace_list' | 'workspace_info' | 'workspace_list_dir' | 'workspace_glob' | 'workspace_grep' | 'workspace_read' | 'workspace_write' | 'workspace_doc_status' | 'workspace_doc_outline' | 'workspace_doc_lines' | 'workspace_doc_chunks' | 'workspace_doc_search';
+export interface WorkspaceConnectorRequestMessage extends WSMessage {
+    type: 'workspace_connector_request';
+    payload: {
+        requestId: string;
+        workspaceId?: string;
+        operation: WorkspaceConnectorOperation;
+        args: Record<string, unknown>;
+    };
+}
+export interface WorkspaceConnectorResultMessage extends WSMessage {
+    type: 'workspace_connector_result';
+    payload: {
+        requestId: string;
+        workspaceId?: string;
+        success: boolean;
+        data?: Record<string, unknown>;
+        error?: string;
+    };
+}
+export interface CommandResultMessage extends WSMessage {
+    type: 'command_result';
+    payload: {
+        targetMessageId: string;
+        commandType: string;
+        success: boolean;
+        data?: Record<string, unknown>;
+        error?: string;
+    };
+}
+export interface ActionFeedbackMessage extends WSMessage {
+    type: 'action_feedback';
+    payload: {
+        targetMessageId: string;
+        actionId?: string;
+        actionType?: string;
+        result: 'success' | 'failure' | 'partial';
+        data?: Record<string, unknown>;
+        error?: string;
+    };
+}
+export interface AgentStatusMessage extends WSMessage {
+    type: 'agent_status';
+    payload: {
+        agentId: string;
+        status: 'idle' | 'processing' | 'waiting_for_tool' | 'error';
+        sessionId?: string;
+        currentActivity?: string;
+        processingTime?: number;
+    };
+}
+export interface ErrorMessage extends WSMessage {
+    type: 'error';
+    payload: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export interface HeartbeatMessage extends WSMessage {
+    type: 'heartbeat';
+    payload: {
+        status: 'alive' | 'busy' | 'idle';
+        activeAgents: string[];
+        memoryUsage?: number;
+    };
+}
+export interface StatusMessage extends WSMessage {
+    type: 'status';
+    payload: {
+        instanceId: string;
+        status: 'running' | 'stopped' | 'error';
+        activeConnections: number;
+        activeSessions: number;
+        version: string;
+    };
+}
+export interface WorkspaceModeChangeMessage extends WSMessage {
+    type: 'workspace_mode_change';
+    payload: {
+        mode: 'mcp' | 'llm-direct';
+    };
+}
+export interface WorkspaceModeChangedMessage extends WSMessage {
+    type: 'workspace_mode_changed';
+    payload: {
+        mode: 'mcp' | 'llm-direct';
+    };
+}
+/**
+ * 桥接主动下推:意图门自动触发 / @mention 接管 / 手动勾选导致 activeProfile 变化时,
+ * 通知前端同步状态机(更新 activeProfile + 勾选框 + 顶部身份条)。
+ */
+export interface ProfileSwitchedMessage extends WSMessage {
+    type: 'profile_switched';
+    payload: {
+        activeProfile: string;
+        displayName: string;
+        role: AgentRole;
+        trigger: ProfileSwitchTrigger;
+        sessionId: string;
+    };
+}
+export type AllWSMessages = ClientRegisterMessage | UserInputMessage | TextReplyMessage | ToolChoiceRequiredMessage | BuildingModelMessage | CesiumCommandMessage | WorkspaceCommandMessage | WorkspaceConnectorRequestMessage | WorkspaceConnectorResultMessage | CommandResultMessage | ActionFeedbackMessage | AgentStatusMessage | ErrorMessage | HeartbeatMessage | StatusMessage | WorkspaceModeChangeMessage | WorkspaceModeChangedMessage | ProfileSwitchedMessage;
+export interface SSEMessageUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    model?: string;
+    finishReason?: string;
+}
+export interface SSEMessage {
+    type: 'text_delta' | 'thinking_delta' | 'tool_call' | 'tool_result' | 'command_status' | 'tool_choice_required' | 'file' | 'sources' | 'usage' | 'status' | 'done' | 'error';
+    content?: string;
+    name?: string;
+    displayName?: string;
+    args?: Record<string, unknown>;
+    success?: boolean;
+    error?: string;
+    /** Stage label for streaming indicator (e.g. "正在查询知识库...", "正在生成...") */
+    stage?: string;
+    toolConflict?: RuntimeToolConflict;
+    file?: {
+        id: string;
+        name: string;
+        url: string;
+        mimeType?: string;
+        size?: number;
+    };
+    usage?: SSEMessageUsage;
+    /** 作者 profile 名(常态 'default' / 接管态=子智能体名 / 调度态=orchestrator 名);随 'done' 收尾下发。 */
+    agentId?: string;
+    /** profile 人类可读名(实例本名 / 子智能体本名 / 编排显示名);前端身份头数据驱动渲染。 */
+    agentDisplayName?: string;
+    /** 三态作者身份,前端据此选渲染样式。 */
+    agentRole?: AgentRole;
+    /** Number of tool calls made by sub-agents (explore tool) */
+    subAgentCalls?: number;
+    /** Number of parallel sub-agents spawned (explore tool) */
+    subAgentCount?: number;
+    /** Sources/references cited in the response (workspace files + wiki docs) */
+    sources?: Array<{
+        file: string;
+        line?: number;
+        content?: string;
+        score?: number;
+        accessed?: boolean;
+        /** 'workspace' (default) or 'wiki' */
+        type?: 'workspace' | 'wiki';
+        /** Wiki document ID */
+        docId?: string;
+        /** Wiki page ID */
+        pageId?: string;
+    }>;
+    /** Workspace ID for sources */
+    workspaceId?: string;
+}
+export type SSEMessageType = SSEMessage['type'];

package/dist/types/websocket.js

@@ -0,0 +1 @@
+export{};

package/dist/types/wiki.d.ts

@@ -0,0 +1,66 @@
+export interface WikiConfig {
+    id: string;
+    name: string;
+    description: string;
+    type: 'industry' | 'domain' | 'project';
+    schemaPath: string;
+    pages: WikiPage[];
+    entities: WikiEntity[];
+    concepts: WikiConcept[];
+}
+export interface WikiPage {
+    id: string;
+    title: string;
+    path: string;
+    type: 'entity' | 'concept' | 'general';
+    content: string;
+    tags: string[];
+    links: WikiLink[];
+    lastModified: string;
+}
+export interface WikiLink {
+    targetPageId: string;
+    relation: 'reference' | 'parent' | 'child' | 'related';
+}
+export interface WikiEntity {
+    id: string;
+    name: string;
+    type: string;
+    properties: Record<string, unknown>;
+    relations: WikiEntityRelation[];
+}
+export interface WikiEntityRelation {
+    targetEntityId: string;
+    relationType: string;
+    properties?: Record<string, unknown>;
+}
+export interface WikiConcept {
+    id: string;
+    name: string;
+    definition: string;
+    examples: string[];
+    relatedEntities: string[];
+    relatedConcepts: string[];
+}
+export interface WikiImportConfig {
+    source: 'file' | 'url';
+    format: 'pdf' | 'word' | 'markdown' | 'json';
+    path: string;
+    autoParse: boolean;
+    targetWikiId: string;
+}
+export interface WikiExportConfig {
+    format: 'markdown' | 'json' | 'html';
+    includeSchema: boolean;
+    includeLinks: boolean;
+    outputPath: string;
+}
+export type WikiSearchMethod = 'keyword' | 'semantic' | 'hybrid' | 'overview';
+export interface WikiSearchResult {
+    pageId: string;
+    pageTitle: string;
+    pageType: string;
+    snippet: string;
+    content: string;
+    relevanceScore: number;
+}

package/dist/types/wiki.js

@@ -0,0 +1 @@
+export{};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@agent-earth/shared",
+  "version": "0.0.4",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*.d.ts",
+    "dist/**/*.js"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "build": "pnpm clean && tsc && node ../../scripts/minify-dist-js.mjs dist",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc --noEmit"
+  }
+}