---
name: sdk
description: Use when the user asks how to embed Catui programmatically (createAgentSession).
surface: TODO  # user entry points: /command, --flag, config key, file location
owner: core/runtime/sdk.ts  # DIP P2 anchor — read its AGENT.md member list to find code
status: draft
---

# SDK Integration

> TODO: one line — what this feature does for the user.

## When to use
TODO: the user intents that should pull this doc (mirrors the frontmatter `description`).

## Usage
TODO: commands / flags / config keys / file locations, with one minimal example.

## Behavior & defaults
TODO: default on/off, side effects, opt-in/opt-out.

## Code map → DIP
- Owner: `core/runtime/sdk.ts` — read its DIP **P2 member list** (the nearest `AGENT.md`) to locate files.
- Then follow **P3** file headers (WHO / FROM / TO / HERE) to navigate. Do **not** duplicate code paths here.

## Related
[[extensions]] [[packages]]