Package Overview

This page maps the current OSS packages in this monorepo.

Recommended import strategy

  • Default: import from kortyx for app code
  • Use scoped packages only when you want lower-level control

Package map

PackagePurposeTypical consumers
kortyxbatteries-included facadeapplication code
@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.
  • Stream structured-data schema currently has a built-in jobs discriminated type; apps may still emit custom structured payloads.