Open Kortyx on GitHub

Package Overview

Updated 29 days ago • April 23, 2026

This page maps the current OSS packages in this monorepo.

Recommended import strategy

  • Server/runtime app code: import from kortyx
  • Browser-safe low-level chunk helpers: import from kortyx/browser
  • React client state and chat helpers: import from @kortyx/react

Package map

PackagePurposeTypical consumers
kortyxbatteries-included facadeapplication code
@kortyx/reactReact client helpers (useChat, useStructuredStreams, transport/storage adapters)React apps consuming streamed chat/structured state
@kortyx/agentchat orchestration (createAgent + agent.streamChat)app backend adapters
@kortyx/coreworkflow + node + state contractsworkflow authors, framework users
@kortyx/runtimegraph execution + registries + framework adaptersadvanced runtime integration
@kortyx/hooksnode hooks (useReason, state hooks, interrupts, structured data)node authors
@kortyx/providersprovider contracts + registryruntime/provider wiring
@kortyx/googleGoogle Gemini provider implementationapps using Google models
@kortyx/streamstream chunk types + SSE server/client helpersweb APIs + clients
@kortyx/utilsshared helpers (deepMergeWithArrayOverwrite, withRetries, contentToText)framework internals
@kortyx/cliCLI tooling (early stage)CLI users

Notes about current implementation

  • Providers: install provider packages per need (for example @kortyx/google).
  • Business persistence: own it in your app; Kortyx only provides runtime/framework persistence.
  • React apps should start with @kortyx/react before reaching for raw browser stream reducers.
  • See React Client for the recommended useChat(...) and useStructuredStreams() path.
  • Stream structured-data schema currently has a built-in jobs discriminated type; apps may still emit custom structured payloads.