Hotplug TypeScript SDK

TypeScript SDK for the Hotplug control plane and MCP session runtime.

What It Does

This package provides a typed HTTP and Server-Sent Events client for a running Hotplug service.

Use it to:

• create sessions
• inspect sessions
• terminate sessions
• discover attachment tools
• retrieve MCP session URLs and tokens

It does not run tools by itself. It talks to a Hotplug daemon that manages the runtime lifecycle.

Install

npm install @shipsec/hotplug-sdk

Example

import { createClient, createConfig, health, createSession } from '@shipsec/hotplug-sdk';

const client = createClient(
  createConfig({
    baseUrl: 'http://127.0.0.1:10010',
    headers: {
      Authorization: 'Bearer change-me',
    },
  }),
);

const status = await health({ client });

const session = await createSession({
  client,
  body: {
    identity: {
      tenant_id: 'local',
      user_id: 'demo',
      run_id: 'run-123',
    },
  },
});

Regenerate

bun run generate