mstool-shared 1.0.0

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "mstool-shared",
+  "version": "1.0.0",
+  "description": "MSTool shared types and protocols",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "keywords": ["mstool", "agent", "ops"],
+  "license": "MIT",
+  "repository": { "type": "git", "url": "https://github.com/scaleflower/mstools" }
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export * from './types/user';
+export * from './types/project';
+export * from './types/agent-node';
+export * from './types/target-host';
+export * from './types/database';
+export * from './types/session';
+export * from './types/skill';
+export * from './types/memory';
+export * from './types/model-provider';
+export * from './types/alert';
+export * from './types/ws-protocol';
+export * from './types/collection';
+export * from './types/awr';

package/src/types/agent-node.ts

@@ -0,0 +1,25 @@
+export enum AgentNodeStatus {
+  ONLINE = 'online',
+  OFFLINE = 'offline',
+  REGISTERING = 'registering',
+}
+
+export interface AgentNode {
+  id: string;
+  name: string;
+  projectId: string;
+  status: AgentNodeStatus;
+  version?: string;
+  lastSeenAt?: Date;
+  registeredAt: Date;
+}
+
+export interface NodeRegistrationToken {
+  id: string;
+  token: string;
+  projectId: string;
+  createdById: string;
+  usedAt?: Date;
+  expiresAt: Date;
+  createdAt: Date;
+}

package/src/types/alert.ts

@@ -0,0 +1,53 @@
+export enum AlertTriggerType {
+  THRESHOLD = 'threshold',
+  AI_ANALYSIS = 'ai_analysis',
+}
+
+export enum AlertChannel {
+  DINGTALK = 'dingtalk',
+  EMAIL = 'email',
+  IN_PLATFORM = 'in_platform',
+}
+
+export enum AlertSeverity {
+  INFO = 'info',
+  WARNING = 'warning',
+  CRITICAL = 'critical',
+}
+
+export enum AlertStatus {
+  ACTIVE = 'active',
+  RESOLVED = 'resolved',
+  ACKNOWLEDGED = 'acknowledged',
+}
+
+export interface AlertRule {
+  id: string;
+  projectId: string;
+  name: string;
+  triggerType: AlertTriggerType;
+  condition?: AlertThresholdCondition;
+  channels: AlertChannel[];
+  isEnabled: boolean;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface AlertThresholdCondition {
+  metric: 'cpu' | 'memory' | 'disk';
+  operator: '>' | '<' | '>=' | '<=';
+  threshold: number;
+  durationSeconds: number;
+}
+
+export interface Alert {
+  id: string;
+  ruleId: string;
+  projectId: string;
+  hostId: string;
+  severity: AlertSeverity;
+  status: AlertStatus;
+  message: string;
+  triggeredAt: Date;
+  resolvedAt?: Date;
+}

package/src/types/awr.ts

@@ -0,0 +1,34 @@
+export enum AwrReportStatus {
+  PENDING = 'pending',
+  GENERATING = 'generating',
+  COMPLETED = 'completed',
+  FAILED = 'failed',
+}
+
+export interface AwrReport {
+  id: string;
+  projectId: string;
+  connectionId: string;
+  dbId?: string;
+  instanceNum?: number;
+  beginSnapId: number;
+  endSnapId: number;
+  status: AwrReportStatus;
+  htmlContent?: string;
+  aiAnalysis?: string;
+  errorMessage?: string;
+  triggeredById?: string;
+  createdAt: Date;
+  completedAt?: Date;
+}
+
+export interface AwrSchedule {
+  id: string;
+  projectId: string;
+  connectionId: string;
+  cronExpression: string;
+  snapIntervalMinutes: number;
+  isEnabled: boolean;
+  lastRunAt?: Date;
+  createdAt: Date;
+}

package/src/types/collection.ts

@@ -0,0 +1,32 @@
+export interface HostMetrics {
+  hostId: string;
+  collectedAt: Date;
+  cpuPercent: number;
+  memoryPercent: number;
+  memoryUsedBytes: number;
+  memoryTotalBytes: number;
+  diskUsedBytes: number;
+  diskTotalBytes: number;
+  networkRxBytesPerSec: number;
+  networkTxBytesPerSec: number;
+}
+
+export interface ProcessInfo {
+  hostId: string;
+  collectedAt: Date;
+  pid: number;
+  name: string;
+  cpuPercent: number;
+  memoryPercent: number;
+  status: string;
+}
+
+export interface CollectionSchedule {
+  id: string;
+  projectId: string;
+  hostId?: string;
+  intervalSeconds: number;
+  isEnabled: boolean;
+  lastRunAt?: Date;
+  createdAt: Date;
+}

package/src/types/database.ts

@@ -0,0 +1,27 @@
+export enum DbType {
+  ORACLE = 'oracle',
+  MYSQL = 'mysql',
+  POSTGRESQL = 'postgresql',
+}
+
+export interface DbConnection {
+  id: string;
+  projectId: string;
+  name: string;
+  dbType: DbType;
+  host: string;
+  port: number;
+  serviceName: string;
+  agentNodeId: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface UserDbCredential {
+  id: string;
+  userId: string;
+  connectionId: string;
+  username: string;
+  createdAt: Date;
+  updatedAt: Date;
+}

package/src/types/memory.ts

@@ -0,0 +1,9 @@
+export interface Memory {
+  id: string;
+  projectId: string;
+  key: string;
+  value: string;
+  createdById: string;
+  createdAt: Date;
+  updatedAt: Date;
+}

package/src/types/model-provider.ts

@@ -0,0 +1,18 @@
+export enum ModelProviderType {
+  ANTHROPIC = 'anthropic',
+  OPENAI = 'openai',
+  ALIYUN = 'aliyun',
+  OLLAMA = 'ollama',
+  VLLM = 'vllm',
+}
+
+export interface ModelProvider {
+  id: string;
+  name: string;
+  type: ModelProviderType;
+  baseUrl?: string;
+  isEnabled: boolean;
+  models: string[];
+  createdAt: Date;
+  updatedAt: Date;
+}

package/src/types/project.ts

@@ -0,0 +1,14 @@
+export interface Project {
+  id: string;
+  name: string;
+  description?: string;
+  createdById: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface ProjectMember {
+  projectId: string;
+  userId: string;
+  joinedAt: Date;
+}

package/src/types/session.ts

@@ -0,0 +1,34 @@
+export interface Session {
+  id: string;
+  projectId: string;
+  userId: string;
+  title: string;
+  skillId?: string;
+  modelProviderId?: string;
+  modelId?: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export enum MessageRole {
+  USER = 'user',
+  ASSISTANT = 'assistant',
+  TOOL = 'tool',
+}
+
+export interface Message {
+  id: string;
+  sessionId: string;
+  role: MessageRole;
+  content: string | ToolCallContent[];
+  createdAt: Date;
+}
+
+export interface ToolCallContent {
+  type: 'tool_call' | 'tool_result';
+  toolCallId: string;
+  toolName?: string;
+  args?: Record<string, unknown>;
+  result?: unknown;
+  isError?: boolean;
+}

package/src/types/skill.ts

@@ -0,0 +1,43 @@
+export interface Skill {
+  id: string;
+  name: string;
+  description: string;
+  prompt: string;
+  parameters: SkillParameter[];
+  createdById: string;
+  isPublished: boolean;
+  downloadCount: number;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface SkillParameter {
+  name: string;
+  type: 'string' | 'number' | 'boolean';
+  description: string;
+  required: boolean;
+  defaultValue?: string | number | boolean;
+}
+
+export interface SkillAuditLog {
+  id: string;
+  skillId: string;
+  userId: string;
+  sessionId: string;
+  calledAt: Date;
+}
+
+export enum SkillReviewStatus {
+  PENDING = 'pending',
+  APPROVED = 'approved',
+  REJECTED = 'rejected',
+}
+
+export interface SkillReview {
+  id: string;
+  skillId: string;
+  reviewerId: string;
+  status: SkillReviewStatus;
+  comment?: string;
+  reviewedAt: Date;
+}

package/src/types/target-host.ts

@@ -0,0 +1,34 @@
+export enum AuthType {
+  KEY = 'key',
+  PASSWORD = 'password',
+}
+
+export interface JumpHost {
+  host: string;
+  port: number;
+  username: string;
+  authType: AuthType;
+}
+
+export interface TargetHost {
+  id: string;
+  projectId: string;
+  name: string;
+  host: string;
+  port: number;
+  username: string;
+  authType: AuthType;
+  agentNodeId: string;
+  jumpHosts: JumpHost[];
+  logPaths: LogPath[];
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface LogPath {
+  id: string;
+  hostId: string;
+  path: string;
+  description?: string;
+  createdAt: Date;
+}

package/src/types/user.ts

@@ -0,0 +1,19 @@
+export enum UserRole {
+  PLATFORM_ADMIN = 'platform_admin',
+  PROJECT_ADMIN = 'project_admin',
+  PROJECT_MEMBER = 'project_member',
+}
+
+export interface User {
+  id: string;
+  username: string;
+  email: string;
+  role: UserRole;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface UserProfile extends User {
+  displayName?: string;
+  avatarUrl?: string;
+}

package/src/types/ws-protocol.ts

@@ -0,0 +1,46 @@
+export enum WsMessageType {
+  REQUEST = 'request',
+  RESULT = 'result',
+  STREAM_CHUNK = 'stream_chunk',
+  STREAM_END = 'stream_end',
+  ERROR = 'error',
+  PING = 'ping',
+  PONG = 'pong',
+  REGISTER = 'register',
+  REGISTER_ACK = 'register_ack',
+}
+
+export interface WsMessage<T = unknown> {
+  task_id: string;
+  type: WsMessageType;
+  payload: T;
+}
+
+export interface WsToolRequest {
+  tool: string;
+  args: Record<string, unknown>;
+}
+
+export interface WsToolResult {
+  output: unknown;
+}
+
+export interface WsStreamChunk {
+  chunk: string;
+}
+
+export interface WsError {
+  code: string;
+  message: string;
+}
+
+export interface WsRegisterPayload {
+  token: string;
+  version: string;
+  hostname: string;
+}
+
+export interface WsRegisterAckPayload {
+  nodeId: string;
+  nodeSecret: string;
+}