메뉴
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