docs(harness): annotate entry orchestration, enums, and exception recovery paths

This commit is contained in:
zhuyongxin
2026-07-30 19:08:03 +08:00
parent b39a625e5b
commit 5b2fb985d9
26 changed files with 639 additions and 6 deletions
@@ -1,7 +1,19 @@
package com.superbiz.agent.harness.contract;
/**
* SSE {@code done} 事件上的粗粒度结局(协议层)。
*
* <p>与 {@link ReleaseOutcome} 对齐的对外三态;取消场景连接可能已断,
* 不一定能发出 done(CANCELLED),故此处通常只有 SUCCESS / FALLBACK / FAILED。
*/
public enum SseOutcome {
/** 对应成功报告 content。 */
SUCCESS,
/** 对应安全降级 content。 */
FALLBACK,
/** 对应 failure 事件或失败 done(实现以 ChatSseSession 为准)。 */
FAILED
}