@agentskit/chat

Profile: major-package

Framework-neutral application definitions that compile to AgentsKit configuration. Owns typed routes, policy composition, component manifests, session metadata, deterministic answer adapters, and semantic fallback envelopes while the upstream controller keeps lifecycle, memory, and tool execution.

Protocol, server, devtools, and all seven framework renderers ship as subpath exports:

import { decodeTurnEvent } from '@agentskit/chat/protocol'
import { createChatHandler } from '@agentskit/chat/server'
import { createTraceCapture } from '@agentskit/chat/devtools'
import { AgentChat } from '@agentskit/chat/react'

They remain isolated private workspace modules for ownership and testing, while npm consumers install only @agentskit/chat. The former standalone package names remain available until the separate deprecation phase.

Actionable choices use createActionConfirmation, which delegates validation, canonical confirmation state, approval, denial, and execution to AgentsKit.

Verified proof

| Surface | Evidence | |---|---| | Standard components | catalog.generated.md | | Deterministic plane | ADR-0024 | | Upstream adoption | upstream matrix |

defineChat preserves the upstream ChatConfig; it does not create another runtime.

npm install @agentskit/chat @agentskit/core

Quick start

import { defineChat } from '@agentskit/chat'
import type { AdapterFactory } from '@agentskit/core'

export const createSupportChat = (adapter: AdapterFactory) => defineChat({
  id: 'support',
  chat: { adapter },
})

Use resumeChatSession(definition, { sessionId, storage }) for cross-client metadata and pass the returned session to any renderer. Custom UI flows through defineComponentManifest and resolveComponentFrame.

flowchart LR
  C["@agentskit/chat"] --> P["/protocol"]
  C --> S["/server"]
  C --> D["/devtools"]
  C --> R["seven renderer subpaths"]

Maturity and compatibility

Published at 0.4.0 with @agentskit/core ^1.12.3, @agentskit/memory ^0.11.0, and @agentskit/statechart ^0.2.0. See stability.

• Node.js 22+
• TypeScript strict mode

Contributing

Package ownership: packages/chat. Follow CONTRIBUTING.md and query doc-bridge before editing.

Tags: agentskit-chat, chat-definitions, deterministic-answers, typescript

AgentsKit ecosystem

Built on AgentsKit. Composes with Registry, Playbook, and Doc Bridge.