القائمة
Stello 仓库总览入口。快速理解各包的关系、推荐入口、编排模型、单一 Session 模型。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
StelloAgent 创建配置教程。完整说明 createStelloAgent 的每个配置项，包含 sessionDefaults、storage、tools、skills、forkProfiles、session 层接入、orchestration 等。
Engine 职责定义：per-session-round 生命周期管理器。驱动 tool call 循环，管理单个 Session 的多轮对话。不感知树结构，不感知调度。
Fork 机制完整说明。覆盖 ForkProfile 与 EngineForkOptions 的字段对齐、四层 fallback 合成链（sessionDefaults → parent → profile → forkOptions）、systemPrompt 合成三种模式、skills 三态语义、持久化边界（SerializableSessionConfig 只固化 systemPrompt/skills）。任何涉及 fork / profile / stello_create_session / 配置合成 的工作都应读这个。
Stello 框架内所有 LLM 调用位置的消息结构速查。覆盖 Session 对话、compress、consolidate；应用层 reflection 调用由 orchestrator 自行决定。
Consolidation 触发机制：自动触发通过 Factory 配置内联，手动触发通过 StelloAgent API；全局 reflection 由应用层在 SDK 之上自行实现。
Server 层设计：传输层架构决策、StelloAgent 映射原则、连接态管理模式。存储层见 server-storage，Engine 细节见 engine-design。
| name | stello-usage |
| description | Stello 仓库总览入口。快速理解各包的关系、推荐入口、编排模型、单一 Session 模型。 |
@stello-ai/session — 单个 Session 原语层（send / stream / consolidate）@stello-ai/core — 编排层（StelloAgent / SessionOrchestrator / Engine / SessionTree 拓扑）@stello-ai/server — 服务化适配层（PG 持久化 + REST/WS + 多租户 Space）@stello-ai/visualizer — 可视化层（星空图）createStelloAgent(config) 是 @stello-ai/core 的唯一推荐入口。
开发者不需要手动装配 SessionOrchestrator、DefaultEngineFactory、DefaultEngineRuntimeManager——由 StelloAgent 构造时自动组装。
Server 层承接 StelloAgent，不重写编排逻辑。
Stello 内部只有一种 Session。对话的起点是一个 parentId === null 的 root session，通过 agent.createSession() 创建（不传 parentId）；后续分支用 agent.forkSession() 创建子 session（parentId 指向父节点）。
拓扑允许多 root —— 同一个 agent 下可以并存多棵互相独立的对话树（森林）。所有 Session 共用同一套上下文组装规则、同一套 SessionStorage 接口；root 不具备任何特殊运行时行为，差异只体现在 TopologyNode.parentId 上。
跨 Session 的"全局意识层"由应用层承载——读取所有 Session 的 digest（memory + insight），用任意 LLM 反思后通过 agent.putInsight(targetId, content) 定向回写。详见 skill session-usage。
StelloAgent（门面 + orchestrator-facing 数据 SDK）
→ SessionOrchestrator（多 Session 协调）
→ EngineRuntimeManager（runtime 生命周期）
→ DefaultEngineFactory（内联 consolidation 触发逻辑，闭包注入 hooks）
→ StelloEngine（单 Session 对话循环 + fire-and-forget hooks）
→ SessionRuntime（@stello-ai/session 适配）
一句话：Session 做单次调用，Engine 做对话循环，Factory 内联触发逻辑，Orchestrator 协调多 Session，Agent 是统一入口。
并发语义：同 sessionId 内串行，不同 sessionId 之间并行。
@stello-ai/core 通过 StelloAgentSessionConfig 接入 @stello-ai/session：
sessionLoader(sessionId) — 按 ID 解析真实 Session 实例（所有 Session 共用同一个 loader）serializeSendResult / toolCallParser — 序列化与工具解析外加顶层 StelloAgentConfig.storage 用于 data-IO SDK（listSessionDigests / putMemory / putInsight 等）。应用层需保证 sessions（拓扑）与 storage（内容）指向同一份持久化后端。
core = 库server = 服务化适配层sdk = 对 server API 的薄客户端封装（未来）Skills：stello-agent-creation / stello-agent-usage / orchestrator-usage / engine-design / scheduler-design / session-usage / fork-design / storage-design / server-design