@kartha-health/agent-server
v0.1.0
Published
CMA-shaped REST + SSE server exposing the @kartha-health/agent runtime as Kartha's own versioned HTTP contract.
Readme
@kartha-health/agent-server
The HTTP surface for the Kartha Health Agent SDK — exposes the
@kartha-health/agent runtime as a CMA-shaped REST + SSE API on Kartha's own
versioned /v1 contract (agents, skills, sessions, streaming turn events). It's
a fetch handler, so mount it with @hono/node-server or any edge runtime.
npm install @kartha-health/agent-server @kartha-health/agentimport { serve } from "@hono/node-server";
import { Runtime, SkillRegistry } from "@kartha-health/agent";
import { KarthaAgentServer } from "@kartha-health/agent-server";
const server = new KarthaAgentServer({
runtime, // a configured @kartha-health/agent Runtime
skills: new SkillRegistry(),
auth: { tokens: [process.env.APP_AUTH_TOKEN!] }, // caller↔server app bearer
});
serve({ fetch: server.fetch, port: 8850 });POST /v1/agents · POST /v1/sessions · POST /v1/sessions/:id/events →
consume the SSE stream (session.created → turn.started → tool.start /
tool.result → text.delta → message.completed → turn.completed). Every
request needs an app-level Authorization: Bearer (health endpoints bypass); the
tenant is never in the request — it's the signed MCP-JWT claim the runtime mints.
- Runtime: ESM, Node ≥ 20 · Depends on:
@kartha-health/agent - License: Apache-2.0
