feat: align TypeScript SDK with AgentScope Python

.github/workflows/ci.yml

@@ -9,6 +9,32 @@ on:
             - main
 
 jobs:
+    parity-manifest:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout TypeScript repository
+              uses: actions/checkout@v4
+
+            - name: Checkout pinned Python baseline
+              uses: actions/checkout@v4
+              with:
+                  repository: agentscope-ai/agentscope
+                  ref: 61cdeae4ffe63182f3343229aa6fbd868e30b0c5
+                  path: python-baseline
+
+            - name: Setup Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 20.x
+
+            - name: Test parity tooling
+              run: node --test scripts/parity/*.test.mjs
+
+            - name: Verify parity manifest against Python
+              run: >-
+                  node scripts/parity/check-manifest.mjs
+                  --python-root python-baseline
+
     lint:
         runs-on: ubuntu-latest
         steps:
@@ -32,6 +58,9 @@ jobs:
             - name: Run linter and formatter
               run: pnpm run format
 
+            - name: Verify formatting produced no changes
+              run: git diff --exit-code
+
     check-i18n:
         runs-on: ubuntu-latest
         steps:
@@ -52,7 +81,7 @@ jobs:
 
         strategy:
             matrix:
-                os: [ubuntu-latest, macos-latest, windows-latest]
+                os: [ubuntu-latest, macos-latest, windows-2022]
                 node-version: [20.x]
 
         steps:
@@ -70,31 +99,55 @@ jobs:
                   node-version: ${{ matrix.node-version }}
                   cache: 'pnpm'
 
+            - name: Install ripgrep on Linux
+              if: runner.os == 'Linux'
+              run: sudo apt-get update && sudo apt-get install --yes ripgrep
+
+            - name: Install ripgrep on macOS
+              if: runner.os == 'macOS'
+              run: brew install ripgrep
+
+            - name: Install ripgrep on Windows
+              if: runner.os == 'Windows'
+              run: choco install ripgrep --yes --no-progress
+
             - name: Install dependencies
               run: pnpm install --frozen-lockfile
 
             - name: Build agentscope package
               run: pnpm run build:agentscope
+              env:
+                  NODE_OPTIONS: --max-old-space-size=8192
+
+            - name: Type-check AgentScope service
+              run: pnpm --filter @agentscope-ai/agentscope-service typecheck
+
+            - name: Build AgentScope service package
+              run: pnpm run build:service
+              env:
+                  NODE_OPTIONS: --max-old-space-size=8192
 
             - name: Test package installation
-              shell: bash
-              run: |
-                  cd packages/agentscope
-                  npm pack
-                  TARBALL=$(ls agentscope-ai-agentscope-*.tgz)
-                  mkdir -p ../../test-install
-                  cd ../../test-install
-                  npm init -y
-                  npm install "../packages/agentscope/$TARBALL"
-                  node -e "const { Agent } = require('@agentscope-ai/agentscope/agent'); console.log('CJS import successful:', typeof Agent === 'function');"
-                  node --input-type=module -e "import { Agent } from '@agentscope-ai/agentscope/agent'; console.log('ESM import successful:', typeof Agent === 'function');"
+              run: pnpm run test:package
 
             - name: Build Desktop app
               run: pnpm run build:desktop
 
+            - name: Rebuild SQLite native module for Node tests
+              run: >-
+                  npx --yes pnpm@9.15.9
+                  --filter @agentscope-ai/agentscope
+                  rebuild better-sqlite3
+
+            - name: Run Desktop runtime tests
+              run: pnpm --filter @agentscope-ai/desktop test
+
             - name: Run unit tests
               run: pnpm run test:agentscope
 
+            - name: Run service unit tests
+              run: pnpm run test:service
+
             - name: Upload test coverage
               uses: actions/upload-artifact@v4
               with:

README.md

@@ -15,7 +15,7 @@
     </a>
     <a href="https://pypi.org/project/agentscope/">
         <img
-            src="https://img.shields.io/badge/node-18.0.0+-blue?logo=node.js"
+            src="https://img.shields.io/badge/node-20.0.0+-blue?logo=node.js"
             alt="npm"
         />
     </a>
@@ -43,8 +43,8 @@ rather than constraining them with strict prompts and opinionated orchestrations
 
 ## Requirements
 
-- **Node.js**: 18.0.0 or higher (20.x recommended)
-- **Package Manager**: pnpm 8.0.0+ (recommended) or npm
+- **Node.js**: 20.0.0 or higher
+- **Package Manager**: pnpm 9.0.0+ (recommended) or npm
 
 ## Features
 
@@ -121,7 +121,8 @@ for await (const event of agent.replyStream({})) {
 This is a monorepo containing:
 
 - `packages/agentscope`: Core AgentScope library
-- `app/friday`: Example Electron application built with AgentScope
+- `packages/agentscope-service`: Node.js Agent Service runtime
+- `apps/desktop`: Electron desktop application built with AgentScope
 
 ## License
 

apps/desktop/electron.vite.config.ts

@@ -13,7 +13,12 @@ export default defineConfig({
         },
         build: {
             rollupOptions: {
-                external: ['@agentscope-ai/agentscope', /^@agentscope-ai\/agentscope\/.*/],
+                external: [
+                    '@agentscope-ai/agentscope',
+                    /^@agentscope-ai\/agentscope\/.*/,
+                    '@agentscope-ai/agentscope-service',
+                    /^@agentscope-ai\/agentscope-service\/.*/,
+                ],
             },
         },
     },

apps/desktop/jest.config.js

@@ -0,0 +1,15 @@
+const { createDefaultPreset } = require('ts-jest');
+
+const tsJestTransform = createDefaultPreset({
+    tsconfig: 'tsconfig.node.json',
+}).transform;
+
+/** @type {import('jest').Config} */
+module.exports = {
+    testEnvironment: 'node',
+    testMatch: ['<rootDir>/test/**/*.test.ts'],
+    transform: tsJestTransform,
+    moduleNameMapper: {
+        '^@shared/(.*)$': '<rootDir>/src/shared/$1',
+    },
+};

apps/desktop/package.json

@@ -8,6 +8,7 @@
     "scripts": {
         "format": "prettier --write .",
         "lint": "eslint --cache .",
+        "test": "jest --runInBand",
         "typecheck:node": "tsc --noEmit -p tsconfig.node.json --composite false",
         "typecheck:web": "tsc --noEmit -p tsconfig.web.json --composite false",
         "typecheck": "pnpm run typecheck:node && pnpm run typecheck:web",
@@ -22,6 +23,7 @@
     },
     "dependencies": {
         "@agentscope-ai/agentscope": "workspace:*",
+        "@agentscope-ai/agentscope-service": "workspace:*",
         "@electron-toolkit/preload": "^3.0.2",
         "@electron-toolkit/utils": "^4.0.0",
         "@milkdown/components": "^7.19.0",
@@ -70,6 +72,7 @@
         "@tailwindcss/typography": "^0.5.19",
         "@types/mime-types": "^3.0.1",
         "@types/node": "^22.19.11",
+        "@types/jest": "^30.0.0",
         "@types/node-cron": "^3.0.11",
         "@types/react": "^19.2.7",
         "@types/react-dom": "^19.2.3",
@@ -81,10 +84,12 @@
         "eslint-plugin-react": "^7.37.5",
         "eslint-plugin-react-hooks": "^7.0.1",
         "eslint-plugin-react-refresh": "^0.4.24",
+        "jest": "^30.2.0",
         "prettier": "^3.7.4",
         "react": "^19.2.1",
         "react-dom": "^19.2.1",
         "typescript": "^5.9.3",
+        "ts-jest": "^29.4.6",
         "vite": "^7.2.6"
     }
 }

apps/desktop/src/main/config/index.ts

@@ -68,15 +68,21 @@ export function setConfig(updates: Partial<Config>): Config {
  * Register IPC handlers for configuration management
  *
  * @param ipcMain - The Electron IPC main instance
+ * @param onChange - Optional callback after configuration persistence
  */
-export function registerConfigHandlers(ipcMain: IpcMain): void {
+export function registerConfigHandlers(
+    ipcMain: IpcMain,
+    onChange?: (config: Config) => Promise<void>
+): void {
     initConfig();
 
     ipcMain.handle('config:get', () => {
         return getConfig();
     });
 
-    ipcMain.handle('config:set', (_event, updates: Partial<Config>) => {
-        return setConfig(updates);
+    ipcMain.handle('config:set', async (_event, updates: Partial<Config>) => {
+        const config = setConfig(updates);
+        await onChange?.(config);
+        return config;
     });
 }

apps/desktop/src/main/index.ts

@@ -3,15 +3,15 @@ import { join } from 'path';
 import { electronApp, optimizer, is } from '@electron-toolkit/utils';
 import { app, shell, BrowserWindow, ipcMain, Tray, Menu, nativeImage, dialog } from 'electron';
 
-import { registerConfigHandlers } from './config';
-import { shutdownScheduler } from './scheduler';
+import { getConfig, registerConfigHandlers } from './config';
+import { DesktopServiceRuntime } from './runtime';
 import { registerChatHandlers } from './services/chatService';
 import { registerDocumentHandlers } from './services/documentService';
 import { registerMcpHandlers } from './services/mcpHandlers';
-import { mcpShutdownAll } from './services/mcpService';
 import { registerScheduleHandlers } from './services/scheduleService';
 import { registerSkillHandlers } from './services/skillHandlers';
 import { ensureDirectories } from './storage';
+import { PATHS } from './storage/paths';
 import icon from '../../resources/icon.png?asset';
 
 interface AppWithQuitting extends Electron.App {
@@ -21,6 +21,7 @@ interface AppWithQuitting extends Electron.App {
 (app as AppWithQuitting).isQuitting = false;
 
 let tray: Tray | null = null;
+let serviceRuntime: DesktopServiceRuntime | null = null;
 
 /**
  * Create system tray icon with menu for the application
@@ -140,19 +141,25 @@ app.whenReady().then(async () => {
     });
 
     // Ensure storage directories exist
-    ensureDirectories();
-
-    // Register IPC handlers for each module (except those needing webContents)
-    registerConfigHandlers(ipcMain);
-    registerMcpHandlers(ipcMain);
-    registerSkillHandlers(ipcMain);
+    await ensureDirectories();
+
+    serviceRuntime = await new DesktopServiceRuntime({ dataDirectory: PATHS.root }).open();
+    await serviceRuntime.syncConfig(getConfig());
+    await serviceRuntime.migrateLegacyChats();
+    await serviceRuntime.migrateLegacyMCPs();
+    await serviceRuntime.migrateLegacySchedules();
+    await serviceRuntime.migrateLegacySkills();
+    await serviceRuntime.migrateLegacyDocuments();
+    registerConfigHandlers(ipcMain, config => serviceRuntime!.syncConfig(config));
+    registerMcpHandlers(ipcMain, serviceRuntime);
+    registerSkillHandlers(ipcMain, serviceRuntime);
 
     const mainWindow = createWindow();
 
     // Register handlers that need webContents
-    registerDocumentHandlers(ipcMain, mainWindow.webContents);
-    registerChatHandlers(ipcMain, mainWindow.webContents);
-    await registerScheduleHandlers(ipcMain, mainWindow.webContents);
+    registerDocumentHandlers(ipcMain, mainWindow.webContents, serviceRuntime);
+    registerChatHandlers(ipcMain, mainWindow.webContents, serviceRuntime);
+    registerScheduleHandlers(ipcMain, mainWindow.webContents, serviceRuntime);
 
     createTray(mainWindow);
 
@@ -168,7 +175,7 @@ app.whenReady().then(async () => {
 
 app.on('before-quit', async () => {
     (app as AppWithQuitting).isQuitting = true;
-    await Promise.allSettled([shutdownScheduler(), mcpShutdownAll()]);
+    await Promise.allSettled([serviceRuntime?.close()]);
 });
 
 // Don't quit when all windows are closed (hidden to tray)

apps/desktop/src/main/runtime/index.ts

@@ -0,0 +1,3 @@
+export { DesktopServiceRuntime } from './service-runtime';
+export type { DesktopServiceRuntimeOptions } from './service-runtime';
+export type { DesktopScheduleEvent } from './service-runtime';