migrate-ts

Migrate TypeScript code from @honcho-ai/sdk v1.6.0 to v2.0.0.

6|1|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/plastic-labs/cursor-honcho --skill migrate-ts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-ts
Source: https://github.com/plastic-labs/cursor-honcho/tree/main/plugins/honcho-dev/skills/migrate-ts
Command: npx skills add https://github.com/plastic-labs/cursor-honcho --skill migrate-ts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrates TypeScript code that depends on older Honcho SDK APIs to the v2.0.0-compatible API surface so projects stop failing after upgrading to Honcho 3.0.0 and the new @honcho-ai/sdk. It addresses breaking changes such as removed core clients, renamed methods, snake_case → camelCase, streaming API updates, changed representation types, and new typed configurations.

Core Features & Use Cases

  • API Rename & Refactor Guidance: Exact mappings for client, peer, session, and message method renames and property conversions.
  • Behavioral Changes & Runtime Notes: Explains removed polling patterns, streaming changes, and how to move updateMessage calls to sessions.
  • Migration Checklist & Detailed Reference: Provides a step-by-step checklist and in-depth change notes to validate compilation and runtime behavior after upgrade.
  • Use Case: Upgrade a TypeScript service or assistant that integrates Honcho memory to be compatible with @honcho-ai/sdk v2.0.0 and Honcho 3.x releases.

Quick Start

Migrate my project from @honcho-ai/sdk v1.6.0 to v2.0.0 by renaming deprecated APIs, converting snake_case properties to camelCase, replacing streaming and representation patterns, and following the provided checklist to verify compilation and runtime behavior.

Frequently Asked Questions about migrate-ts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my TypeScript code to the Honcho SDK v2.0.0?

To migrate TypeScript code to the Honcho SDK v2.0.0, you refactor source-level APIs by renaming client.core to client.http, converting snake_case properties to camelCase, and replacing deprecated streaming methods to satisfy new runtime requirements.

What breaking changes are introduced in the Honcho SDK v2.0.0 upgrade?

Breaking changes in the Honcho SDK v2.0.0 upgrade include removed core clients, renamed methods like getConfig and getPeers, snake_case to camelCase conversions, updated streaming APIs, and removed polling patterns for message observations.

Why does my TypeScript project fail to compile after upgrading the Honcho SDK?

Your TypeScript project fails to compile after upgrading the Honcho SDK because v2.0.0 removes older APIs, requiring you to rename deprecated methods, swap streaming patterns, and update representation types to match the new SDK's type requirements.

How do I handle snake_case to camelCase property conversions for Honcho sessions?

To handle snake_case to camelCase property conversions for Honcho sessions, you apply source-level refactors across your client, peer, session, and message workflows, ensuring all object properties match the v2.0.0 SDK type definitions.

Can I keep using polling patterns for message observations with the new Honcho SDK?

You cannot keep using polling patterns for message observations with the new Honcho SDK, as v2.0.0 removes polling behaviors and requires swapping to updated streaming APIs and renamed conclusion methods.

What is the best way to verify TypeScript compilation after an Honcho SDK upgrade?

The best way to verify TypeScript compilation after an Honcho SDK upgrade is to follow a migration checklist that validates renamed methods, camelCase properties, and runtime behavior changes to ensure compatibility with Honcho 3.x releases.