Release v1.23.0

Installation from GitHub Packages

Option 1: Configure .npmrc (Recommended)

Add to your .npmrc file:

@openhands:registry=https://npm.pkg.github.com

Then install:

npm install @openhands/typescript-client@1.23.0

Option 2: Direct install with registry flag

npm install @openhands/typescript-client@1.23.0 --registry=https://npm.pkg.github.com

Usage

import { RemoteConversation } from '@openhands/typescript-client';

const conversation = new RemoteConversation({
  baseUrl: 'http://localhost:8000',
  apiKey: 'your-api-key'
});

What's Changed

• feat(skills): add CRUD management methods to SkillsClient by @malhotra5 in #166
• deps(deps-dev): bump jest from 30.3.0 to 30.4.2 in the testing group by @dependabot[bot] in #158
• deps(deps-dev): bump @types/node from 25.6.0 to 25.6.2 by @dependabot[bot] in #160
• deps(deps-dev): bump @babel/preset-env from 7.29.3 to 7.29.5 by @dependabot[bot] in #161
• deps(deps): bump @openrouter/sdk from 0.12.25 to 0.12.35 by @dependabot[bot] in #162
• deps(deps-dev): bump typescript-eslint from 8.59.1 to 8.59.3 by @dependabot[bot] in #159
• feat(acp): export typed ACP registry + CI drift check vs openhands-sdk by @simonrosenberg in #173
• fix(ci): clear two moderate npm audit advisories by @simonrosenberg in #175
• feat: add interruptConversation method to ConversationClient by @malhotra5 in #174
• Add typed agent-server compatibility helpers by @neubig in #176
• deps(deps-dev): bump @types/node from 25.6.2 to 25.9.0 by @dependabot[bot] in #170
• deps(deps-dev): bump eslint from 10.3.0 to 10.4.0 in the linting group across 1 directory by @dependabot[bot] in #168
• Add SDK v1.23 agent-server API parity helpers by @neubig in #177

New Contributors

• @malhotra5 made their first contribution in #166
• @simonrosenberg made their first contribution in #173

Full Changelog: v0.6.0...v1.23.0

Release v0.6.0

Installation from GitHub Packages

Option 1: Configure .npmrc (Recommended)

Add to your .npmrc file:

@openhands:registry=https://npm.pkg.github.com

Then install:

npm install @openhands/typescript-client@0.6.0

Option 2: Direct install with registry flag

npm install @openhands/typescript-client@0.6.0 --registry=https://npm.pkg.github.com

Usage

import { RemoteConversation } from '@openhands/typescript-client';

const conversation = new RemoteConversation({
  baseUrl: 'http://localhost:8000',
  apiKey: 'your-api-key'
});

What's Changed

• Fix duplicate package publish workflow by @neubig in #152
• fix(events): never throw at module load, defer error to connect() by @rbren in #157
• feat(conversation): add startWorkspaceSession to mint workspace cookie and return static asset base URL by @rbren in #155

Full Changelog: v0.5.0...v0.6.0

Release v0.5.0

Installation from GitHub Packages

Option 1: Configure .npmrc (Recommended)

Add to your .npmrc file:

@openhands:registry=https://npm.pkg.github.com

Then install:

npm install @openhands/typescript-client@0.5.0

Option 2: Direct install with registry flag

npm install @openhands/typescript-client@0.5.0 --registry=https://npm.pkg.github.com

Usage

import { RemoteConversation } from '@openhands/typescript-client';

const conversation = new RemoteConversation({
  baseUrl: 'http://localhost:8000',
  apiKey: 'your-api-key'
});

What's Changed

• Add clients for agent-canvas APIs by @neubig in #154

Full Changelog: v0.2.0...v0.5.0

Release v0.4.0

Installation from GitHub Packages

Option 1: Configure .npmrc (Recommended)

Add to your .npmrc file:

@openhands:registry=https://npm.pkg.github.com

Then install:

npm install @openhands/typescript-client@0.4.0

Option 2: Direct install with registry flag

npm install @openhands/typescript-client@0.4.0 --registry=https://npm.pkg.github.com

Usage

import { RemoteConversation } from '@openhands/typescript-client';

const conversation = new RemoteConversation({
  baseUrl: 'http://localhost:8000',
  apiKey: 'your-api-key'
});

What's Changed

• Add clients for agent-canvas APIs by @neubig in #154

Full Changelog: v0.2.0...v0.4.0

Release v0.2.0

Installation from GitHub Packages

Option 1: Configure .npmrc (Recommended)

Add to your .npmrc file:

@openhands:registry=https://npm.pkg.github.com

Then install:

npm install @openhands/typescript-client@0.2.0

Option 2: Direct install with registry flag

npm install @openhands/typescript-client@0.2.0 --registry=https://npm.pkg.github.com

Usage

import { RemoteConversation } from '@openhands/typescript-client';

const conversation = new RemoteConversation({
  baseUrl: 'http://localhost:8000',
  apiKey: 'your-api-key'
});

What's Changed

• Support direct GitHub installs by @neubig in #130
• chore: add sandbox community files by @neubig in #129
• Fix OpenHands PR review workflow auth by @neubig in #131
• Fix git dependency package imports by @neubig in #132
• Onboard OpenHands by @neubig in #134
• deps(deps-dev): bump the linting group across 1 directory with 2 updates by @dependabot[bot] in #123
• deps(deps): bump @openrouter/sdk from 0.12.1 to 0.12.21 by @dependabot[bot] in #124
• Make windows install work through rimraf by @neubig in #137
• deps(deps-dev): bump the typescript group across 1 directory with 3 updates by @dependabot[bot] in #128
• deps(deps-dev): bump typescript-eslint from 8.58.2 to 8.59.0 by @dependabot[bot] in #138
• deps(deps): bump @openrouter/sdk from 0.12.21 to 0.12.25 by @dependabot[bot] in #144
• deps(deps-dev): bump globals from 17.5.0 to 17.6.0 by @dependabot[bot] in #143
• deps(deps-dev): bump typescript-eslint from 8.59.0 to 8.59.1 by @dependabot[bot] in #141
• deps(deps-dev): bump @babel/preset-env from 7.29.2 to 7.29.3 by @dependabot[bot] in #142
• Add optional ref option to RemoteWorkspace.gitChanges/gitDiff by @rbren in #146
• feat(profiles): add ProfilesClient and RemoteConversation.switchLlm by @VascoSch92 in #148
• Fix npm audit security failure by @neubig in #151
• deps(deps-dev): bump eslint from 10.2.1 to 10.3.0 in the linting group across 1 directory by @dependabot[bot] in #140
• Align PR review workflow with software-agent-sdk by @neubig in #150
• deps(deps-dev): bump the typescript group across 1 directory with 2 updates by @dependabot[bot] in #139
• Add LLM profile client APIs by @neubig in #147

New Contributors

• @VascoSch92 made their first contribution in #148

Full Changelog: v0.1.1...v0.2.0

Release v0.1.3

Highlights

• add prepare so git-based installs build dist/ automatically
• expose the client/http-client, events/remote-events-list, and workspace/remote-workspace subpath exports used by downstream consumers
• include the built dist/ output in the tagged source for direct GitHub consumption

Install from GitHub

npm install github:OpenHands/typescript-client#v0.1.3

This release was created by an AI agent (OpenHands) on behalf of the user.

Release v0.1.2

Installation from GitHub Packages

Option 1: Configure .npmrc (Recommended)

Add to your .npmrc file:

@openhands:registry=https://npm.pkg.github.com

Then install:

npm install @openhands/typescript-client@0.1.2

Option 2: Direct install with registry flag

npm install @openhands/typescript-client@0.1.2 --registry=https://npm.pkg.github.com

Usage

import { RemoteConversation } from '@openhands/typescript-client';

const conversation = new RemoteConversation({
  baseUrl: 'http://localhost:8000',
  apiKey: 'your-api-key'
});

What's Changed

• Implement TypeScript client for OpenHands Agent Server by @rbren in #1
• Add React Vite example app with TypeScript SDK integration by @rbren in #7
• Add settings modal to React example by @rbren in #8
• Fix incorrect API endpoints in RemoteConversation by @rbren in #9
• Add agent behavior guidelines to prevent automatic server startup by @rbren in #11
• feat: Replace homepage with conversation manager using TypeScript SDK by @rbren in #10
• Convert example app to use Tailwind CSS by @rbren in #12
• Fix example app to use user settings instead of hardcoded values by @rbren in #13
• Fix conversation run flow in example app by @rbren in #14
• Fix events display issue and implement expando UI by @rbren in #15
• Fix conversation list UI issues by @rbren in #16
• feat: Update SDK API to use Agent and Conversation aliases with explicit workspace creation by @rbren in #17
• Add alpha software warning to README by @rbren in #18
• Add GitHub Packages publishing workflow by @rbren in #19
• feat: make file operations browser-compatible by @rbren in #20
• deps(deps-dev): bump the typescript group with 2 updates by @dependabot[bot] in #2
• deps(deps-dev): bump @types/node from 20.19.24 to 25.0.3 by @dependabot[bot] in #26
• deps(deps-dev): bump ts-jest from 29.4.5 to 29.4.6 by @dependabot[bot] in #23
• deps(deps): bump uuid from 9.0.1 to 13.0.0 by @dependabot[bot] in #6
• deps(deps-dev): bump the linting group across 1 directory with 2 updates by @dependabot[bot] in #24
• deps(deps-dev): bump the testing group with 2 updates by @dependabot[bot] in #3
• Fix execute command api endpoint by @mihirukongahage in #31
• Consolidate repo guidance into AGENTS.md by @xingyaoww in #35
• Add comprehensive integration tests for agent-server by @rbren in #37
• Refactor workspace to support local and remote implementations by @rbren in #41
• Add UI interaction tools to local-agent example by @rbren in #42
• feat: Add browser-achievable features for Python SDK parity by @rbren in #43
• deps(deps-dev): bump the typescript group with 2 updates by @dependabot[bot] in #27
• deps(deps-dev): bump @types/uuid from 9.0.8 to 11.0.0 by @dependabot[bot] in #29
• deps(deps-dev): bump globals from 16.5.0 to 17.0.0 by @dependabot[bot] in #30
• deps(deps): bump ws from 8.18.3 to 8.19.0 by @dependabot[bot] in #32
• deps(deps-dev): bump prettier from 3.7.4 to 3.8.0 in the linting group by @dependabot[bot] in #38
• deps(deps-dev): bump typescript-eslint from 8.50.1 to 8.53.0 by @dependabot[bot] in #39
• deps(deps-dev): bump @types/node from 25.0.3 to 25.0.9 by @dependabot[bot] in #40
• deps(deps-dev): bump the typescript group with 2 updates by @dependabot[bot] in #44
• deps(deps-dev): bump prettier from 3.8.0 to 3.8.1 in the linting group by @dependabot[bot] in #45
• deps(deps): bump @openrouter/sdk from 0.4.0 to 0.5.1 by @dependabot[bot] in #48
• deps(deps-dev): bump @types/node from 25.0.10 to 25.2.0 by @dependabot[bot] in #49
• deps(deps-dev): bump globals from 17.1.0 to 17.3.0 by @dependabot[bot] in #50
• deps(deps-dev): bump @babel/preset-env from 7.28.6 to 7.29.0 by @dependabot[bot] in #51
• deps(deps-dev): bump typescript-eslint from 8.53.0 to 8.54.0 by @dependabot[bot] in #47
• Add setTitle() and persist title in generateTitle() by @rbren in #60
• add skill for making a frontend with the typescript client by @rbren in #59
• deps(deps): bump @openrouter/sdk from 0.5.1 to 0.8.0 by @dependabot[bot] in #54
• deps(deps-dev): bump eslint from 9.39.2 to 10.0.0 in the linting group by @dependabot[bot] in #56
• Remove eager full sync from RemoteEventsList by @rbren in #67
• Remove erroneous Node.js claims and add browser-compatibility rule by @rbren in #76
• Add hooks support to TypeScript client by @rbren in #77
• Unify WebSocket event handlers and remove noisy debug logs by @rbren in #85
• Extract shared buildRequestParams in OpenRouterLLM by @rbren in #84
• Use crypto.randomUUID() and remove unused uuid dependency by @rbren in #83
• Fix broken test coverage pipeline by @rbren in #80
• Remove console.log that leaks HTTP request bodies by @rbren in #79
• fix: add TTL-based caching to RemoteState + refresh method by @rbren in #86
• deps(deps-dev): bump eslint from 10.0.1 to 10.0.2 in the linting group by @dependabot[bot] in #62
• deps(deps-dev): bump jest from 30.2.0 to 30.3.0 in the testing group across 1 directory by @dependabot[bot] in #70
• deps(deps-dev): bump @types/node from 25.3.0 to 25.5.0 by @dependabot[bot] in #72
• deps(deps-dev): bump @babel/preset-env from 7.29.0 to 7.29.2 by @dependabot[bot] in #74
• deps(deps): bump ws from 8.19.0 to 8.20.0 by @dependabot[bot] in #75
• deps(deps-dev): bump typescript-eslint from 8.56.0 to 8.57.2 by @dependabot[bot] in #87
• deps(deps-dev): bump globals from 17.3.0 to 17.4.0 by @dependabot[bot] in #66
• deps(deps): bump @openrouter/sdk from 0.8.0 to 0.10.2 by @dependabot[bot] in #88
• deps(deps-dev): bump typescript from 5.9.3 to 6.0.2 in the typescript group across 1 directory by @dependabot[bot] in #90
• Consolidate duplicate type definitions by @rbren in #82
• Add conversation tags support by @rbren in #100
• deps(deps-dev): bump the linting group across 1 directory with 2 updates by @dependabot[bot] in #94
• deps(deps-dev): bump the typescript group with 2 updates by @dependabot[bot] in #95
• deps(deps-dev): bump @types/node from 25.5.0 to 25.6.0 by @dependabot[bot] in #96
• deps(deps-dev): bump typescript-eslint from 8.58.0 to 8.58.1 by @dependabot[bot] in #97
• deps(deps-dev): bump globals from 17.4.0 to 17.5.0 by @dependabot[bot] in #98
• deps(deps): bump @openrouter/sdk from 0.10.2 to 0.12.1 by @dependabot[bot] in #99
• fix: only register workspace-dependent tools when workspace supports them by @rbren in https://github.com/OpenHands/typescript...