# Hikigai AgentSDK (Node.js) - LLM Context

## Overview

`@hikigai/agent-sdk` - Official Node.js/TypeScript SDK for deploying and managing AI agents on the Hikigai platform. Supports single-agent (LLM) and multi-agent workflows, TypeScript schemas, MCP connectors, and healthcare metadata tracking.

## Installation

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

## Quick Start

```ts
import { AgentClient, AgentConfig, InputSchema, OutputSchema } from '@hikigai/agent-sdk'

const client = new AgentClient({
  apiKey: process.env.HIKIGAI_API_KEY,
  projectId: process.env.HIKIGAI_PROJECT_ID,
})

// Deploy a simple LLM agent
const agent = await client.deploy({
  name: 'medical-summarizer',
  displayName: 'Clinical Note Summarizer',
  description: 'Summarizes clinical notes into SOAP format',
  instruction: 'You are a clinical assistant. Summarize the input into SOAP format.',
  model: 'gemini-2.0-flash',
  category: 'documentation',
  version: '1.0.0',
  inputSchema: new InputSchema({ note: { type: 'string', required: true } }),
  outputSchema: new OutputSchema({ summary: { type: 'string' } }),
})

console.log('Deployed agent:', agent.slug)
```

## Key APIs

### AgentClient

Methods:
- `deploy(config: AgentConfig) -> DeployedAgent`
- `listAgents()`
- `getAgent(agentId)`
- `updateAgent(agentId, update)`
- `deleteAgent(agentId)`

### AgentConfig (Core)

Fields:
- `name`, `displayName`, `instruction`, `model`, `agentType` ('llm' | 'sequential' | ...)
- `inputSchema`, `outputSchema` (TypeScript / Zod compatible)
- `tools` (functions, OpenAPI, MCP)
- `version`, `deploymentHints`, `hipaaCompliant`

## Multi-Agent & Advanced

- `subAgents` for sequential/parallel workflows
- `plannerConfig` for chain-of-thought reasoning
- `codeExecution` options (sandboxed runtimes)

## Integration Features

- MCP Connectors: connect Epic, FHIR, or external data sources
- Tooling: function tools, OpenAPI tools, and built-in connectors
- Healthcare: PHI redaction flags, clinical confidence, safety metrics

## Documentation

Full Node reference: https://docs.hikigai.com/node-agentsdk

# End of file