类class io.agentscope.builder.web.managed 2.x

SessionEventMapper

@Component public class SessionEventMapper

源码Source io/agentscope/builder/web/managed/SessionEventMapper.java:52–515

会话事件 Mapper，承载智能体的部署、调度与服务化运行。位于 io.agentscope.builder.web.managed 包。核心成员包括 map、SessionEventMapper。

Maps harness AgentEvents onto persisted session event types / payloads and stream-only preview frames.

Streaming token/arg deltas are never persisted as rows. Tool call input and tool result bodies are accumulated across delta events and persisted on End. Preview event_id values are stable evt_* ids reused when the matching buffered event is appended, so clients can reconcile typewriter previews with the authoritative record.

嵌套类摘要Nested Class Summary

类Class	类型Kind	说明Description
`MappingResult`	记录record	承载 Mapping 结果数据的记录类型。 Outcome of mapping one harness event.
`PersistedEvent`	记录record	承载 Persisted 事件数据的记录类型。 Persisted event.
`PreviewFrame`	记录record	承载预览 Frame数据的记录类型。 Stream-only preview frame (`event_start` / `event_delta`).
`PreviewIds`	类class	预览 Ids，承载智能体的部署、调度与服务化运行。 Allocates stable preview / persist event ids for a turn and accumulates tool buffers.

构造器摘要Constructor Summary

构造器Constructor	说明Description
`public` `SessionEventMapper(ObjectMapper objectMapper)`	初始化 `SessionEventMapper` 实例。 Creates a new instance.

方法摘要Method Summary

方法Method	说明Description
`public` `MappingResult map(AgentEvent event, PreviewIds previewIds)`	执行映射相关操作。 Maps a harness event.

构造器详情Constructor Detail

SessionEventMapper

public SessionEventMapper(ObjectMapper objectMapper)

初始化 SessionEventMapper 实例。

Creates a new instance.

参数Parameters

名称Name	类型Type	说明Description
`objectMapper`	ObjectMapper	对象 Mapper（类型 `ObjectMapper`）。The object mapper.

源码Source io/agentscope/builder/web/managed/SessionEventMapper.java:60–62

方法详情Method Detail

map

public MappingResult map(AgentEvent event, PreviewIds previewIds)

执行映射相关操作。

Maps a harness event.

参数Parameters

名称Name	类型Type	说明Description
`event`	AgentEvent	事件（类型 `AgentEvent`）。The event.
`previewIds`	PreviewIds	预览 Ids（类型 `PreviewIds`）。The preview ids.

返回Returns MappingResult

返回MappingResult。Returns mapping result.

源码Source io/agentscope/builder/web/managed/SessionEventMapper.java:122–131

嵌套类详情Nested Class Detail

MappingResult

public record MappingResult( Optional<PersistedEvent> persisted, Optional<PreviewFrame> preview, List<PersistedEvent> preceding)

承载 Mapping 结果数据的记录类型。位于 io.agentscope.builder.web.managed 包。核心成员包括 persisted、preview、preceding、empty、persist、previewOnly。

Outcome of mapping one harness event.

PersistedEvent

public record PersistedEvent(String type, Map<String, Object> payload, String eventId)

承载 Persisted 事件数据的记录类型。位于 io.agentscope.builder.web.managed 包。核心成员包括 type、payload、eventId、PersistedEvent。

Persisted event. When eventId is non-null, io.agentscope.builder.web.managed.service.SessionEventLog must reuse it so previews reconcile.

PreviewFrame

public record PreviewFrame( String streamType, String targetType, String eventId, String delta)

承载预览 Frame数据的记录类型。位于 io.agentscope.builder.web.managed 包。核心成员包括 streamType、targetType、eventId、delta。

Stream-only preview frame (event_start / event_delta).

When delta is null, callers should emit start only (no delta frame).

PreviewIds

public static final class PreviewIds

预览 Ids，承载智能体的部署、调度与服务化运行。位于 io.agentscope.builder.web.managed 包。核心成员包括 messageEventId、consumeMessageEventId、thinkingEventId、toolUseEventId、beginToolUse、appendToolInput。

Allocates stable preview / persist event ids for a turn and accumulates tool buffers.