Metadata-Version: 2.4
Name: flare-kernel
Version: 0.1.0
Summary: FLARE kernel runtime package
License: Proprietary
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: flare-engines<0.2.0,>=0.1.0
Requires-Dist: fastapi<1.0,>=0.115
Requires-Dist: pydantic<3,>=2
Requires-Dist: uvicorn<1.0,>=0.30

# flare-kernel

通用编排与执行内核。

职责：

1. Decision 路由与策略入口。
2. Execution 流程推进与状态管理。
3. Runtime（含重试、超时、追踪）。
4. 加载 domain pack 并执行。

## Day 2 最小骨架

目录：

1. `src/flare_kernel/router`：接口路由
2. `src/flare_kernel/runtime`：`trace_id` 与基础日志
3. `src/flare_kernel/contracts`：请求/响应契约

最小接口：

1. `POST /kernel/run`
2. `POST /kernel/stream`
3. `GET /kernel/health`

kernel 现已输出 mode/context 运行时占位事件与字段。

## Instance 注入（品牌信息）

1. kernel 支持从 instance 的 domain-pack 读取品牌配置：
   `branding/instance-branding.json`
2. 读取优先级：
   - 环境变量 `FLARE_DOMAIN_PACK_ROOT`
   - 自动探测 `apps/<instance_id>/domain-pack`
3. 注入位置：
   - `POST /kernel/run` 响应 `result.instance_profile`
   - `POST /kernel/stream` SSE 事件 `instance_profile`

说明：品牌注入仅在 instance 层配置，core 不写死产品名、logo、标签。

本地启动（示例）：

```bash
uvicorn flare_kernel.main:app --app-dir packages/flare-kernel/src --host 0.0.0.0 --port 8002
```

## 最小发布说明

1. 当前包版本：`0.1.0`
2. 发布元数据：`packages/flare-kernel/pyproject.toml`
3. 本地构建：`python -m build`
4. 本地安装：`pip install packages/flare-kernel`
