# Hikigai AppSDK (Node.js) - LLM Context

## Overview

`@hikigai/app-sdk` - Node.js / TypeScript SDK for invoking agents from applications. Supports streaming, WebSocket sessions, SONA personalization, and healthcare metadata.

## Installation

```bash
npm install @hikigai/app-sdk
# or
yarn add @hikigai/app-sdk
```

## Quick Start

```ts
import { AppClient } from '@hikigai/app-sdk'

const client = new AppClient({ apiKey: process.env.HIKIGAI_API_KEY })

const agent = await client.agent('medical-coder')

// Basic invocation
const resp = await agent.invoke('Patient presents with fever and cough...')
console.log(resp.content)

// Streaming
for await (const chunk of agent.stream('Tell me a story')) {
  process.stdout.write(chunk)
}
```

## Response Model

- `content` (string)
- `metadata` (invocation metadata: latency, tokens, trace)
- `plugins` (SONA, etc.)
- `confidence` and `safety_flags` for healthcare context

## Documentation

Full Node AppSDK docs: https://docs.hikigai.com/node-appsdk

# End of file