Add GitHub Actions workflows and testing infrastructure

- Added CI workflow with Node.js matrix testing (18.x, 20.x, 22.x)
- Added release workflow for automated npm publishing
- Added Dependabot configuration for dependency updates
- Added Dependabot auto-merge workflow for minor/patch updates
- Created Jest configuration and basic test suite
- Added comprehensive npm scripts for development workflow
- Updated package.json with additional dev dependencies

Co-authored-by: openhands <openhands@all-hands.dev>

Author: openhands-agent

.github/dependabot.yml

@@ -0,0 +1,31 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+    open-pull-requests-limit: 10
+    reviewers:
+      - "All-Hands-AI/core-team"
+    assignees:
+      - "All-Hands-AI/core-team"
+    commit-message:
+      prefix: "deps"
+      include: "scope"
+    groups:
+      typescript:
+        patterns:
+          - "typescript"
+          - "@typescript-eslint/*"
+      testing:
+        patterns:
+          - "jest"
+          - "@types/jest"
+          - "@jest/*"
+      linting:
+        patterns:
+          - "eslint"
+          - "prettier"
+          - "@typescript-eslint/*"

.github/workflows/ci.yml

@@ -0,0 +1,89 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x, 22.x]
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+        
+    - name: Install dependencies
+      run: npm ci
+      
+    - name: Run linter
+      run: npm run lint
+      
+    - name: Run type check
+      run: npm run build
+      
+    - name: Run tests
+      run: npm test
+      
+    - name: Check formatting
+      run: npm run format:check
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Use Node.js 20.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 20.x
+        cache: 'npm'
+        
+    - name: Install dependencies
+      run: npm ci
+      
+    - name: Build package
+      run: npm run build
+      
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/
+        retention-days: 7
+
+  security:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Use Node.js 20.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 20.x
+        cache: 'npm'
+        
+    - name: Install dependencies
+      run: npm ci
+      
+    - name: Run security audit
+      run: npm audit --audit-level=moderate
+      
+    - name: Check for vulnerabilities
+      run: npm audit --audit-level=high --production

.github/workflows/dependabot-auto-merge.yml

@@ -0,0 +1,37 @@
+name: Dependabot Auto-merge
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  auto-merge:
+    runs-on: ubuntu-latest
+    if: github.actor == 'dependabot[bot]'
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Use Node.js 20.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 20.x
+        cache: 'npm'
+        
+    - name: Install dependencies
+      run: npm ci
+      
+    - name: Run tests
+      run: npm test
+      
+    - name: Run build
+      run: npm run build
+      
+    - name: Auto-merge minor and patch updates
+      uses: pascalgn/merge-action@v0.15.6
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        merge_method: squash
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/release.yml

@@ -0,0 +1,55 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Use Node.js 20.x
+      uses: actions/setup-node@v4
+      with:
+        node-version: 20.x
+        cache: 'npm'
+        registry-url: 'https://registry.npmjs.org'
+        
+    - name: Install dependencies
+      run: npm ci
+      
+    - name: Run tests
+      run: npm test
+      
+    - name: Build package
+      run: npm run build
+      
+    - name: Publish to npm
+      run: npm publish --access public
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        
+    - name: Create GitHub Release
+      uses: actions/create-release@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        tag_name: ${{ github.ref }}
+        release_name: Release ${{ github.ref }}
+        draft: false
+        prerelease: false
+        body: |
+          ## Changes
+          
+          See [CHANGELOG.md](CHANGELOG.md) for details.
+          
+          ## Installation
+          
+          ```bash
+          npm install @openhands/agent-server-typescript-client@${{ github.ref_name }}
+          ```

jest.config.js

@@ -0,0 +1,29 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  testMatch: [
+    '**/__tests__/**/*.ts',
+    '**/?(*.)+(spec|test).ts'
+  ],
+  transform: {
+    '^.+\\.ts$': 'ts-jest'
+  },
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/__tests__/**/*'
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: [
+    'text',
+    'lcov',
+    'html'
+  ],
+  moduleFileExtensions: [
+    'ts',
+    'js',
+    'json'
+  ],
+  testTimeout: 10000
+};

package.json

@@ -6,10 +6,16 @@
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "jest",
     "lint": "eslint src/**/*.ts",
-    "format": "prettier --write src/**/*.ts"
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"examples/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"examples/**/*.ts\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
   },
   "keywords": [
     "openhands",
@@ -25,6 +31,7 @@
     "ws": "^8.14.2"
   },
   "devDependencies": {
+    "@types/jest": "^29.0.0",
     "@types/node": "^20.0.0",
     "@types/uuid": "^9.0.6",
     "@types/ws": "^8.5.8",
@@ -33,6 +40,7 @@
     "eslint": "^8.0.0",
     "jest": "^29.0.0",
     "prettier": "^3.0.0",
+    "ts-jest": "^29.0.0",
     "typescript": "^5.0.0"
   },
   "files": [

src/__tests__/index.test.ts

@@ -0,0 +1,52 @@
+import { RemoteConversation, RemoteWorkspace } from '../index';
+
+describe('OpenHands Agent Server TypeScript Client', () => {
+  describe('Exports', () => {
+    it('should export RemoteConversation', () => {
+      expect(RemoteConversation).toBeDefined();
+      expect(typeof RemoteConversation).toBe('function');
+    });
+
+    it('should export RemoteWorkspace', () => {
+      expect(RemoteWorkspace).toBeDefined();
+      expect(typeof RemoteWorkspace).toBe('function');
+    });
+  });
+
+  describe('RemoteConversation', () => {
+    it('should create instance with config', () => {
+      const config = {
+        baseUrl: 'http://localhost:8000',
+        apiKey: 'test-key'
+      };
+      
+      const conversation = new RemoteConversation(config);
+      expect(conversation).toBeInstanceOf(RemoteConversation);
+    });
+
+    it('should have workspace property', () => {
+      const config = {
+        baseUrl: 'http://localhost:8000',
+        apiKey: 'test-key'
+      };
+      
+      const conversation = new RemoteConversation(config);
+      expect(conversation.workspace).toBeDefined();
+      expect(conversation.workspace).toBeInstanceOf(RemoteWorkspace);
+    });
+  });
+
+  describe('RemoteWorkspace', () => {
+    it('should create instance with http client', () => {
+      const mockHttpClient = {
+        get: jest.fn(),
+        post: jest.fn(),
+        put: jest.fn(),
+        delete: jest.fn()
+      };
+      
+      const workspace = new RemoteWorkspace(mockHttpClient as any);
+      expect(workspace).toBeInstanceOf(RemoteWorkspace);
+    });
+  });
+});