refactor(core): rename Insight class to Service

This is a comprehensive refactoring that renames the Insight class
and all related types to Service for better semantic clarity.

Changes:
- Renamed directories: insight/ -> service/
- Renamed test files: insight.test.ts -> service.test.ts
- Updated 50+ type definitions
- Modified 18+ source files
- Synchronized all test files
- Updated external package dependencies

Core updates:
- Class: Insight -> Service
- Interface: InsightOptions -> ServiceOptions
- All InsightX types -> ServiceX types
- String literal 'Insight' -> 'Service'

Affected files:
- src/index.ts, src/yaml.ts, src/task-runner.ts
- src/agent/*.ts (agent, tasks, task-builder, ui-utils)
- tests/utils.ts and all test files
- External: chrome-extension, evaluation, report

Verification:
- TypeScript: 0 errors
- Lint: 530 files passed
- Build: successful (341.1 kB)

🤖 Generated with Claude Code

Co-Authored-By: Claude <[email protected]>

Author: quanru

apps/chrome-extension/src/utils/eventOptimizer.ts

@@ -1,4 +1,4 @@
-import Insight from '@midscene/core';
+import Service from '@midscene/core';
 import type { Rect, UIContext } from '@midscene/core';
 import type { RecordedEvent } from '@midscene/recorder';
 import { globalModelConfigManager } from '@midscene/shared/env';
@@ -110,7 +110,7 @@ export const generateAIDescription = async (
         size: { width: event.pageInfo.width, height: event.pageInfo.height },
       };
 
-      const insight = new Insight(mockContext);
+      const service = new Service(mockContext);
       const rect =
         event.elementRect?.x && event.elementRect?.y
           ? ([event.elementRect.x, event.elementRect.y] as [number, number])

apps/report/src/components/store/index.tsx

@@ -3,9 +3,9 @@ import type { PlaywrightTaskAttributes } from '@/types';
 import type {
   ExecutionDump,
   ExecutionTask,
-  ExecutionTaskInsightLocate,
+  ExecutionTaskServiceLocate,
   GroupedActionDump,
-  InsightDump,
+  ServiceDump,
 } from '@midscene/core';
 import type { AnimationScript } from '@midscene/visualizer';
 import {
@@ -55,7 +55,7 @@ export interface DumpStoreType {
   activeExecutionAnimation: AnimationScript[] | null;
   activeTask: ExecutionTask | null;
   setActiveTask: (task: ExecutionTask) => void;
-  insightDump: InsightDump | null;
+  insightDump: ServiceDump | null;
   _contextLoadId: number;
   hoverTask: ExecutionTask | null;
   hoverTimestamp: number | null;
@@ -203,8 +203,8 @@ export const useExecutionDump = create<DumpStoreType>((set, get) => {
             : null,
       });
       console.log('will set task', task);
-      if (task.type === 'Insight') {
-        const dump = (task as ExecutionTaskInsightLocate).log;
+      if (task.type === 'Service') {
+        const dump = (task as ExecutionTaskServiceLocate).log;
         set({
           insightDump: dump,
         });

packages/core/src/agent/agent.ts

@@ -10,10 +10,6 @@ import {
   type ExecutionTask,
   type ExecutionTaskLog,
   type GroupedActionDump,
-  Insight,
-  type InsightAction,
-  type InsightExtractOption,
-  type InsightExtractParam,
   type LocateOption,
   type LocateResultElement,
   type LocateValidatorResult,
@@ -23,6 +19,10 @@ import {
   type PlanningAction,
   type Rect,
   type ScrollParam,
+  Service,
+  type ServiceAction,
+  type ServiceExtractOption,
+  type ServiceExtractParam,
   type TUserPrompt,
   type TaskRunner,
   type UIContext,
@@ -82,7 +82,7 @@ const includedInRect = (point: [number, number], rect: Rect) => {
   return x >= left && x <= left + width && y >= top && y <= top + height;
 };
 
-const defaultInsightExtractOption: InsightExtractOption = {
+const defaultServiceExtractOption: ServiceExtractOption = {
   domIncluded: false,
   screenshotIncluded: true,
 };
@@ -107,7 +107,7 @@ export class Agent<
 > {
   interface: InterfaceType;
 
-  insight: Insight;
+  service: Service;
 
   dump: GroupedActionDump;
 
@@ -245,7 +245,7 @@ export class Agent<
 
     this.onTaskStartTip = this.opts.onTaskStartTip;
 
-    this.insight = new Insight(async () => {
+    this.service = new Service(async () => {
       return this.getUIContext();
     });
 
@@ -263,7 +263,7 @@ export class Agent<
       );
     }
 
-    this.taskExecutor = new TaskExecutor(this.interface, this.insight, {
+    this.taskExecutor = new TaskExecutor(this.interface, this.service, {
       taskCache: this.taskCache,
       onTaskStart: this.callbackOnTaskStartTip.bind(this),
       replanningCycleLimit: this.opts.replanningCycleLimit,
@@ -278,7 +278,7 @@ export class Agent<
     return this.interface.actionSpace();
   }
 
-  async getUIContext(action?: InsightAction): Promise<UIContext> {
+  async getUIContext(action?: ServiceAction): Promise<UIContext> {
     // Check VL model configuration when UI context is first needed
     this.ensureVLModelWarning();
 
@@ -765,8 +765,8 @@ export class Agent<
   }
 
   async aiQuery<ReturnType = any>(
-    demand: InsightExtractParam,
-    opt: InsightExtractOption = defaultInsightExtractOption,
+    demand: ServiceExtractParam,
+    opt: ServiceExtractOption = defaultServiceExtractOption,
   ): Promise<ReturnType> {
     const modelConfig = this.modelConfigManager.getModelConfig('VQA');
     const { output, runner } = await this.taskExecutor.createTypeQueryExecution(
@@ -781,7 +781,7 @@ export class Agent<
 
   async aiBoolean(
     prompt: TUserPrompt,
-    opt: InsightExtractOption = defaultInsightExtractOption,
+    opt: ServiceExtractOption = defaultServiceExtractOption,
   ): Promise<boolean> {
     const modelConfig = this.modelConfigManager.getModelConfig('VQA');
 
@@ -799,7 +799,7 @@ export class Agent<
 
   async aiNumber(
     prompt: TUserPrompt,
-    opt: InsightExtractOption = defaultInsightExtractOption,
+    opt: ServiceExtractOption = defaultServiceExtractOption,
   ): Promise<number> {
     const modelConfig = this.modelConfigManager.getModelConfig('VQA');
 
@@ -817,7 +817,7 @@ export class Agent<
 
   async aiString(
     prompt: TUserPrompt,
-    opt: InsightExtractOption = defaultInsightExtractOption,
+    opt: ServiceExtractOption = defaultServiceExtractOption,
   ): Promise<string> {
     const modelConfig = this.modelConfigManager.getModelConfig('VQA');
 
@@ -835,7 +835,7 @@ export class Agent<
 
   async aiAsk(
     prompt: TUserPrompt,
-    opt: InsightExtractOption = defaultInsightExtractOption,
+    opt: ServiceExtractOption = defaultServiceExtractOption,
   ): Promise<string> {
     return this.aiString(prompt, opt);
   }
@@ -873,7 +873,7 @@ export class Agent<
       // use same intent as aiLocate
       const modelConfig = this.modelConfigManager.getModelConfig('grounding');
 
-      const text = await this.insight.describe(center, modelConfig, {
+      const text = await this.service.describe(center, modelConfig, {
         deepThink,
       });
       debug('aiDescribe text', text);
@@ -961,15 +961,15 @@ export class Agent<
   async aiAssert(
     assertion: TUserPrompt,
     msg?: string,
-    opt?: AgentAssertOpt & InsightExtractOption,
+    opt?: AgentAssertOpt & ServiceExtractOption,
   ) {
     const modelConfig = this.modelConfigManager.getModelConfig('VQA');
 
-    const insightOpt: InsightExtractOption = {
-      domIncluded: opt?.domIncluded ?? defaultInsightExtractOption.domIncluded,
+    const serviceOpt: ServiceExtractOption = {
+      domIncluded: opt?.domIncluded ?? defaultServiceExtractOption.domIncluded,
       screenshotIncluded:
         opt?.screenshotIncluded ??
-        defaultInsightExtractOption.screenshotIncluded,
+        defaultServiceExtractOption.screenshotIncluded,
       doNotThrowError: opt?.doNotThrowError,
     };
 
@@ -980,7 +980,7 @@ export class Agent<
         'Assert',
         textPrompt,
         modelConfig,
-        insightOpt,
+        serviceOpt,
         multimodalPrompt,
       );
     await this.afterTaskRunning(runner, true);

packages/core/src/agent/task-builder.ts

@@ -1,22 +1,22 @@
 import { findAllMidsceneLocatorField, parseActionParam } from '@/ai-model';
 import type { AbstractInterface } from '@/device';
-import type Insight from '@/insight';
+import type Service from '@/service';
 import type {
   DetailedLocateParam,
   ElementCacheFeature,
   ExecutionTaskActionApply,
   ExecutionTaskApply,
   ExecutionTaskHitBy,
-  ExecutionTaskInsightLocateApply,
-  InsightDump,
+  ExecutionTaskServiceLocateApply,
   LocateResultElement,
   LocateResultWithDump,
   PlanningAction,
   PlanningActionParamSleep,
   PlanningLocateParam,
   Rect,
+  ServiceDump,
 } from '@/types';
-import { InsightError } from '@/types';
+import { ServiceError } from '@/types';
 import { sleep } from '@/utils';
 import type { IModelConfig } from '@midscene/shared/env';
 import { generateElementByPosition } from '@midscene/shared/extractor';
@@ -40,7 +40,7 @@ export function locatePlanForLocate(param: string | DetailedLocateParam) {
 
 interface TaskBuilderDeps {
   interfaceInstance: AbstractInterface;
-  insight: Insight;
+  service: Service;
   taskCache?: TaskCache;
 }
 
@@ -59,13 +59,13 @@ interface PlanBuildContext {
 export class TaskBuilder {
   private readonly interface: AbstractInterface;
 
-  private readonly insight: Insight;
+  private readonly service: Service;
 
   private readonly taskCache?: TaskCache;
 
-  constructor({ interfaceInstance, insight, taskCache }: TaskBuilderDeps) {
+  constructor({ interfaceInstance, service, taskCache }: TaskBuilderDeps) {
     this.interface = interfaceInstance;
-    this.insight = insight;
+    this.service = service;
     this.taskCache = taskCache;
   }
 
@@ -324,7 +324,7 @@ export class TaskBuilder {
     detailedLocateParam: DetailedLocateParam | string,
     context: PlanBuildContext,
     onResult?: (result: LocateResultElement) => void,
-  ): ExecutionTaskInsightLocateApply {
+  ): ExecutionTaskServiceLocateApply {
     const { cacheable, modelConfig } = context;
     let locateParam = detailedLocateParam;
 
@@ -341,8 +341,8 @@ export class TaskBuilder {
       };
     }
 
-    const taskFind: ExecutionTaskInsightLocateApply = {
-      type: 'Insight',
+    const taskFind: ExecutionTaskServiceLocateApply = {
+      type: 'Service',
       subType: 'Locate',
       subTask: context.subTask || undefined,
       param: locateParam,
@@ -359,15 +359,15 @@ export class TaskBuilder {
         );
 
         if (!uiContext) {
-          uiContext = await this.insight.contextRetrieverFn();
+          uiContext = await this.service.contextRetrieverFn();
         }
 
-        assert(uiContext, 'uiContext is required for Insight task');
+        assert(uiContext, 'uiContext is required for Service task');
 
-        let locateDump: InsightDump | undefined;
+        let locateDump: ServiceDump | undefined;
         let locateResult: LocateResultWithDump | undefined;
 
-        const applyDump = (dump?: InsightDump) => {
+        const applyDump = (dump?: ServiceDump) => {
           if (!dump) {
             return;
           }
@@ -422,7 +422,7 @@ export class TaskBuilder {
         let elementFromAiLocate: LocateResultElement | null | undefined;
         if (!userExpectedPathHitFlag && !cacheHitFlag && !planHitFlag) {
           try {
-            locateResult = await this.insight.locate(
+            locateResult = await this.service.locate(
               param,
               {
                 context: uiContext,
@@ -432,7 +432,7 @@ export class TaskBuilder {
             applyDump(locateResult.dump);
             elementFromAiLocate = locateResult.element;
           } catch (error) {
-            if (error instanceof InsightError) {
+            if (error instanceof ServiceError) {
               applyDump(error.dump);
             }
             throw error;
@@ -491,7 +491,7 @@ export class TaskBuilder {
 
         if (!element) {
           if (locateDump) {
-            throw new InsightError(
+            throw new ServiceError(
               `Element not found : ${param.prompt}`,
               locateDump,
             );