feat(schedule): add durable after reminders
This commit is contained in:
pku-xht
@@ -12,7 +12,7 @@ The node half guards every entry under `/api` before bridging or upgrading (`src
|
||||
|
||||
`/api/events.mux` and `/api/events.host` each accept a WebSocket upgrade and send only the corresponding `ServerRequest` text messages to the browser; the client sends no application data over these sockets. If either socket ends, the current connection generation fails and rebuilds both streams; readiness still requires both sockets to be open and the `host.describe` HTTP call to succeed. Host teardown terminates both sockets, aborts their sources, and waits for source cleanup before returning. Ordinary network GETs to these paths return 426 with no SSE fallback; `toFetchHandler`'s SSE codec serves only the isomorphic in-process carrier.
|
||||
|
||||
`SessionEventView` is an optional non-persistent sidecar on both `session.history` entries and live `session/event` frames. Tool views keep their closed call/result shapes; a presented durable event instead carries `{ for: 'event', presentationKey, view }`, leaving the key space and JSON-compatible payload open to domain plugins. The same Session event may be delivered again with a new or changed sidecar, so consumers merge it by exact event identity and seq rather than treating the second frame as another log append.
|
||||
`SessionEventView` is an optional non-persistent sidecar on both `session.history` entries and live `session/event` frames. Tool views keep their closed call/result shapes; a presented durable event instead carries `{ for: 'event', view }`, leaving the JSON-compatible payload open to domain plugins while its durable event type selects the renderer. The same Session event may be delivered again with a new or changed sidecar, so consumers merge it by exact event identity and seq rather than treating the second frame as another log append.
|
||||
|
||||
## Keyless fixture
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@ node 半侧在桥接或 upgrade 前守卫 `/api` 下的每个入口（`src/api-r
|
||||
|
||||
`/api/events.mux` 与 `/api/events.host` 各接受一条 WebSocket upgrade，并只向浏览器发送对应的 `ServerRequest` text message；客户端不会在这些 socket 上发送业务数据。任一 socket 结束都会使当前 connection generation 失败并重建两条流，连接就绪仍要求两条 socket open 且 `host.describe` HTTP 调用成功。Host teardown 会终止两条 socket、中止各自的 source，并等待 source 清理完成后再返回。普通网络 GET 这些路径会返回 426，不保留 SSE 回退；`toFetchHandler` 的 SSE 编解码只服务进程内同构载体。
|
||||
|
||||
`SessionEventView` 是 `session.history` 条目与实时 `session/event` 帧上的可选、非持久 sidecar。工具 view 保持封闭的 call／result 形状；由 Host presentation 的持久事件则携带 `{ for: 'event', presentationKey, view }`，把 key 空间与兼容 JSON 的 payload 开放给领域插件。同一个 Session event 可以再次投递并带有新增或变化的 sidecar，因此消费方会按完全一致的事件身份与 seq 合并，而不会把第二个帧当作另一次日志 append。
|
||||
`SessionEventView` 是 `session.history` 条目与实时 `session/event` 帧上的可选、非持久 sidecar。工具 view 保持封闭的 call／result 形状；由 Host presentation 的持久事件则携带 `{ for: 'event', view }`，把兼容 JSON 的 payload 开放给领域插件，并由持久事件类型选择 renderer。同一个 Session event 可以再次投递并带有新增或变化的 sidecar，因此消费方会按完全一致的事件身份与 seq 合并，而不会把第二个帧当作另一次日志 append。
|
||||
|
||||
## 无密钥 fixture
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@ SlotsService gives the renderer separate bare observables for `useSessions` and
|
||||
|
||||
Because the projection is log-ordered, the node array is seq-monotonic by construction: log-only `command/run` / `command/done` nodes splice in by seq, `Session` merges interrupted frozen nodes by their fractional seqs, and a window whose checkpoint cites a shadowed range outside it renders the marker with nothing logged. The marker's summary text, replaced-item count, and estimated shadowed-token count come from the checkpoint's cited `compact/summary` event; a window cut that left that event outside makes those fields unavailable, and a later page that supplies it resolves them. `CommandNode.outcome.sourceEventSeq` preserves a successful command's explicit reference to that summary event, allowing the presentation layer to pair `/compact` with its checkpoint without parsing settlement copy or assuming the two rows are adjacent. Performance contract: one append materializes at most one node and copies the projection only when it adds that node; an event that changes no node keeps the previous array reference (a chunk storm costs nothing), and unchanged nodes keep their object identity.
|
||||
|
||||
A Host may redeliver the same Session event seq with a new or changed non-persistent view after the event reaches its presentation commit point. `Session` first requires deep event identity, then upgrades only the sidecar; a generic event view becomes one `PresentedEventNode` keyed by its `presentationKey`. The existing `liveBuffer` is the sole rendezvous during tail loading, gap stitching, and `loadOlder`. One merge path upgrades overlaps, consumes covered entries, and attaches only a contiguous suffix on every current-generation settlement, including rejected, empty, and discontinuous page responses. Reconnect advances the generation and clears its loading ownership, so an older request's result or `finally` cannot mutate or block the rebuilt window.
|
||||
A Host may redeliver the same Session event seq with a new or changed non-persistent view after the event reaches its presentation commit point. `Session` first requires deep event identity, then upgrades only the sidecar; a generic event view becomes one `PresentedEventNode` keyed by the durable event type. Tail loading and true gap repair continue to use the existing `liveBuffer`. Ordinary `loadOlder` leaves live-tail appends in the current window and prepends its page after the await, while an overlapping late sidecar upgrades immediately. Reconnect advances the generation and clears page or repair ownership, so an older request's result or `finally` cannot mutate or block the rebuilt window.
|
||||
|
||||
## Request inspection
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@ SlotsService 分别为 renderer 提供 `useSessions` 与 `useWorkspaces` 的裸
|
||||
|
||||
由于投影按日志顺序，节点数组天然按 seq 单调：仅日志的 `command/run` / `command/done` 节点按 seq 插入，`Session` 按分数 seq 归并被打断的冻结节点，而检查点所引范围落在窗口之外的窗口会渲染出标记且不打印任何日志。标记的摘要文本、被替换条目数量和估算的被遮蔽 token 数量都来自检查点引用的 `compact/summary` 事件；窗口切分把该事件留在窗口外时这些字段不可用，后续包含该事件的分页会解析出它们。`CommandNode.outcome.sourceEventSeq` 保留成功命令对该摘要事件的显式引用，使呈现层能够配对 `/compact` 与其检查点，而无须解析结算文案或假定两行相邻。性能约定：一次追加最多物化一个节点，并且仅在加入该节点时复制投影；不改变任何节点的事件保持上一次的数组引用（分片风暴零成本），未变化的节点保持其对象标识。
|
||||
|
||||
一个 Session event 到达其 presentation 提交点后，Host 可以用同一 seq 重新投递完全相同的事件，并携带新增或变化的非持久 view。`Session` 会先要求事件深度一致，再只升级 sidecar；通用 event view 会按 `presentationKey` 形成一个 `PresentedEventNode`。既有 `liveBuffer` 是尾部加载、gap stitching 与 `loadOlder` 期间唯一的汇合点。每个当前 generation 的结算出口都使用同一条 merge 路径升级窗口重叠项、消费已覆盖项，并只接入连续后缀；RPC 拒绝、空页和不连续页同样如此。重连会推进 generation 并清除其 loading 所有权，因此旧请求的结果或 `finally` 既不能改写，也不能阻塞重建后的窗口。
|
||||
一个 Session event 到达其 presentation 提交点后，Host 可以用同一 seq 重新投递完全相同的事件，并携带新增或变化的非持久 view。`Session` 会先要求事件深度一致，再只升级 sidecar；通用 event view 会按持久事件类型形成一个 `PresentedEventNode`。`liveBuffer` 仍只用于尾部加载与真正的 gap repair。普通 `loadOlder` 会将 live-tail 追加项留在当前窗口中，并在 await 后前插所取页面；重叠的迟到 sidecar 则会立即升级。重连会推进 generation 并清除 page／repair 的所有权，因此旧请求的结果或 `finally` 既不能改写，也不能阻塞重建后的窗口。
|
||||
|
||||
## 请求检查
|
||||
|
||||
|
||||
@@ -254,8 +254,8 @@ export interface CommandNode {
|
||||
|
||||
/**
|
||||
* Host-computed presentation for one durable non-surface event. The generic
|
||||
* runtime carries the keyed JSON-compatible payload without importing the
|
||||
* producing domain; a client plugin owns the keyed renderer.
|
||||
* runtime carries the durable event type and JSON-compatible payload without
|
||||
* importing the producing domain; a client plugin owns the keyed renderer.
|
||||
*/
|
||||
export interface PresentedEventNode {
|
||||
kind: 'presented-event'
|
||||
@@ -263,8 +263,8 @@ export interface PresentedEventNode {
|
||||
seq: number
|
||||
/** Unix epoch ms from the source Session event. */
|
||||
time: number
|
||||
/** Open runtime key selecting an optional domain renderer. */
|
||||
presentationKey: string
|
||||
/** Durable event type selecting an optional domain renderer. */
|
||||
eventType: string
|
||||
/** Domain-owned JSON-compatible presentation payload. */
|
||||
view: unknown
|
||||
}
|
||||
|
||||
@@ -392,6 +392,7 @@ export class Session implements SessionFace {
|
||||
async loadOlder(): Promise<void> {
|
||||
if (this.openState !== 'open' || !this.hasMore || this.loadingOlder) return
|
||||
const generation = this.openGeneration
|
||||
const requestedBaseSeq = this.baseSeq
|
||||
this.loadingOlder = true
|
||||
this.notifier.markDirty()
|
||||
try {
|
||||
@@ -404,34 +405,27 @@ export class Session implements SessionFace {
|
||||
return
|
||||
}
|
||||
const tail = older[older.length - 1]
|
||||
if (tail === undefined || tail.event.seq + 1 !== this.baseSeq) {
|
||||
if (tail === undefined || tail.event.seq + 1 !== requestedBaseSeq) {
|
||||
// §D.2 continuity assertion: on violation drop the page fail-soft rather than render an out-of-order stream.
|
||||
console.error(`[web-runtime] history page discontinuous: tail seq ${tail?.event.seq} vs baseSeq ${this.baseSeq}`)
|
||||
console.error(`[web-runtime] history page discontinuous: tail seq ${tail?.event.seq} vs baseSeq ${requestedBaseSeq}`)
|
||||
this.hasMore = false
|
||||
return
|
||||
}
|
||||
this.installWindow([
|
||||
...older,
|
||||
...this.events.map((event, index): HistoryEntry => {
|
||||
const view = this.views[index]
|
||||
return view === undefined ? { event } : { event, view }
|
||||
}),
|
||||
], result.value.hasMore)
|
||||
this.events = [...older.map(entry => entry.event), ...this.events]
|
||||
this.views = [...older.map(entry => entry.view), ...this.views]
|
||||
/* v8 ignore next -- the empty-page branch returned above. */
|
||||
this.baseSeq = older[0]?.event.seq ?? this.baseSeq
|
||||
this.hasMore = result.value.hasMore
|
||||
this.transcript.reset(this.events, this.views)
|
||||
this.rebuildDerivedFromWindow()
|
||||
} catch (error) {
|
||||
if (generation === this.openGeneration) {
|
||||
console.error('[web-runtime] loadOlder failed:', error)
|
||||
}
|
||||
} finally {
|
||||
if (generation === this.openGeneration) {
|
||||
try {
|
||||
const { hasGap } = this.mergeWindow()
|
||||
// oxlint-disable-next-line typescript/no-unnecessary-condition -- resync can close the window while the page request is awaited.
|
||||
if (hasGap && this.openState === 'open') void this.repairGap()
|
||||
} catch (error) {
|
||||
console.error('[web-runtime] loadOlder buffer merge failed:', error)
|
||||
void this.resync()
|
||||
}
|
||||
this.loadingOlder = false
|
||||
if (this.liveBuffer.length > 0) void this.repairGap()
|
||||
this.notifier.markDirty()
|
||||
}
|
||||
}
|
||||
@@ -816,6 +810,21 @@ export class Session implements SessionFace {
|
||||
this.applyEventSideEffects(event, view)
|
||||
}
|
||||
|
||||
/** Verify one retained event and apply a defined late sidecar immediately. */
|
||||
private upgradeLiveView(event: SessionEvent, view?: SessionEventView): boolean {
|
||||
const index = this.events.findIndex(candidate => candidate.seq === event.seq)
|
||||
if (index === -1) return false
|
||||
const retained = this.events[index]
|
||||
/* v8 ignore next -- findIndex returned a dense-array position. */
|
||||
if (retained === undefined) return false
|
||||
assertSameEvent(retained, event)
|
||||
if (view === undefined || sameWireValue(this.views[index], view)) return false
|
||||
this.views[index] = view
|
||||
this.transcript.reset(this.events, this.views)
|
||||
this.rebuildDerivedFromWindow()
|
||||
return true
|
||||
}
|
||||
|
||||
/** Retire the first matching live steering occurrence when its durable message takes over. */
|
||||
private handoffPendingSteering(event: SessionEvent): void {
|
||||
if (event.type !== 'user/message') return
|
||||
@@ -840,9 +849,8 @@ export class Session implements SessionFace {
|
||||
if (this.openState !== 'open') return // cold/error: no window upkeep (history fully backfills on open)
|
||||
const tailSeq = this.windowTailSeq()
|
||||
if (tailSeq !== null && event.seq <= tailSeq) {
|
||||
this.liveBuffer.push({ event, view })
|
||||
try {
|
||||
const { changed } = this.mergeWindow()
|
||||
const changed = this.upgradeLiveView(event, view)
|
||||
if (changed) this.notifier.markDirty()
|
||||
} catch (error) {
|
||||
console.error('[web-runtime] duplicate session event failed identity validation:', error)
|
||||
@@ -852,12 +860,12 @@ export class Session implements SessionFace {
|
||||
}
|
||||
if (tailSeq !== null && event.seq > tailSeq + 1) {
|
||||
this.liveBuffer.push({ event, view })
|
||||
void this.repairGap()
|
||||
if (!this.loadingOlder) void this.repairGap()
|
||||
return
|
||||
}
|
||||
if (tailSeq === null && event.seq !== 0) {
|
||||
this.liveBuffer.push({ event, view })
|
||||
void this.repairGap()
|
||||
if (!this.loadingOlder) void this.repairGap()
|
||||
return
|
||||
}
|
||||
this.appendLive(event, view)
|
||||
|
||||
@@ -125,7 +125,7 @@ function materializePresented(event: SessionEvent, sidecar: PresentedEventView):
|
||||
kind: 'presented-event',
|
||||
seq: event.seq,
|
||||
time: event.time,
|
||||
presentationKey: sidecar.presentationKey,
|
||||
eventType: event.type,
|
||||
view: sidecar.view,
|
||||
}
|
||||
}
|
||||
|
||||
@@ -45,7 +45,6 @@ function reminderEvent(seq: number, id: string): SessionEvent {
|
||||
function reminderView(id: string, prompt = '检查日志') {
|
||||
return {
|
||||
for: 'event' as const,
|
||||
presentationKey: 'schedule/reminder',
|
||||
view: { id, prompt },
|
||||
}
|
||||
}
|
||||
@@ -127,7 +126,7 @@ describe('late event views', () => {
|
||||
type: 'session/event', sessionId: SID, event, view: reminderView('schedule-1'),
|
||||
})
|
||||
expect(session.getSnapshot().nodes).toMatchObject([{
|
||||
kind: 'presented-event', seq: 0, presentationKey: 'schedule/reminder',
|
||||
kind: 'presented-event', seq: 0, eventType: 'schedule/change',
|
||||
view: { id: 'schedule-1', prompt: '检查日志' },
|
||||
}])
|
||||
|
||||
@@ -707,6 +706,27 @@ describe('paging', () => {
|
||||
expect(snapshot.nodes.map(n => n.seq)).toEqual([1, 3, 7, 9])
|
||||
})
|
||||
|
||||
it('keeps a concurrent live tail in the current window before prepending the older page', async () => {
|
||||
const older = plainTurn(0, 0, '旧问', '旧答')
|
||||
const newer = plainTurn(6, 1, '新问', '新答')
|
||||
const page = deferred<Awaited<ReturnType<FakeApiClient['onHistory']>>>()
|
||||
const { api, session } = makeSession()
|
||||
api.onHistory = payload => payload.beforeSeq === undefined
|
||||
? histResponse(newer, true)
|
||||
: page.promise
|
||||
await session.open()
|
||||
|
||||
const loading = session.loadOlder()
|
||||
session.handleMuxEnvelope('live-tail' as never, {
|
||||
type: 'session/event', sessionId: SID, event: ev.user(12, '并发尾部'),
|
||||
})
|
||||
expect(session.getSnapshot().nodes.map(node => node.seq)).toEqual([7, 9, 12])
|
||||
page.resolve(await histResponse(older, false))
|
||||
await loading
|
||||
|
||||
expect(session.getSnapshot().nodes.map(node => node.seq)).toEqual([1, 3, 7, 9, 12])
|
||||
})
|
||||
|
||||
it('renders a page whose checkpoint shadows seqs below the window head, logging nothing', async () => {
|
||||
// Pagination no longer spends maxMessages quota on replacement copies, so a
|
||||
// page can carry a compaction checkpoint whose surfaceOp.start lies outside
|
||||
|
||||
@@ -440,23 +440,21 @@ describe('TranscriptAdapter', () => {
|
||||
const adapter = new TranscriptAdapter()
|
||||
adapter.reset([replayed], [{
|
||||
for: 'event',
|
||||
presentationKey: 'schedule/reminder',
|
||||
view: { id: 'schedule-1', prompt: '检查日志' },
|
||||
}])
|
||||
adapter.append(live, {
|
||||
for: 'event',
|
||||
presentationKey: 'schedule/reminder',
|
||||
view: { id: 'schedule-2', prompt: '检查发布' },
|
||||
})
|
||||
expect(adapter.nodes()).toEqual([
|
||||
{
|
||||
kind: 'presented-event', seq: 0, time: 1_700_000_000_000,
|
||||
presentationKey: 'schedule/reminder',
|
||||
eventType: 'schedule/change',
|
||||
view: { id: 'schedule-1', prompt: '检查日志' },
|
||||
},
|
||||
{
|
||||
kind: 'presented-event', seq: 1, time: 1_700_000_000_001,
|
||||
presentationKey: 'schedule/reminder',
|
||||
eventType: 'schedule/change',
|
||||
view: { id: 'schedule-2', prompt: '检查发布' },
|
||||
},
|
||||
])
|
||||
|
||||
@@ -24,7 +24,7 @@ The chat view keeps Tool placement but delegates Tool presentation. It passes ea
|
||||
|
||||
The chat flow projects consecutive model-retry nodes across retry turns into one stable, muted status row updated to the latest attempt; every retry event remains in the runtime snapshot and session log. Its frontend countdown anchors the scheduled delay to client receipt, avoiding host/browser clock skew, rounds remaining time up to seconds, and has a one-second floor. The latest unresolved retry uses a left-to-right text shimmer. Subsequent turn facts distinguish an attempt that started from one cancelled during backoff, while the Host running bit only controls the live animation; the row then shows a static completed or cancelled label. Normal policy rows show the finite retry maximum; always policy rows show `∞`. Activating the row reveals the latest exact retry delay and failure message. The client runtime removes each failed step's streaming tail before its retry node arrives, while the status remains visible after a later attempt succeeds. An unretried terminal failure renders as a persistent inline status at its turn boundary, showing the display-safe durable message and optional error code without offering an action the Host cannot fulfill; AUTH copy never echoes provider-supplied credential fragments.
|
||||
|
||||
Host-presented durable events use the keyed `'conversation.chat.eventview'` seat alongside whole-Tool presentation. The React-free runtime turns a generic `{ presentationKey, view }` sidecar into a `PresentedEventNode`; Chat dispatches on that open key, and a domain UI plugin may register its own row without adding domain vocabulary here. When no registrant is loaded, `GenericEventCard` keeps the presentation key and JSON payload visible in an expandable disclosure rather than dropping the durable event.
|
||||
Host-presented durable events use the keyed `'conversation.chat.eventview'` seat alongside whole-Tool presentation. The React-free runtime turns a generic event sidecar into a `PresentedEventNode` carrying the durable event type and view; Chat dispatches on that open type, and a domain UI plugin may register its own row without adding domain vocabulary here. When no registrant is loaded, `GenericEventCard` keeps the event type and JSON payload visible in an expandable disclosure rather than dropping the durable event.
|
||||
|
||||
`TodoDock` takes the `'conversation.input.dock'` list slot at `order: 0` — before Goal and Queue — and is the plan strip: it reads the host-computed `todos` projection via `useProjection` (standing plan: latest `todo/write` with no later `turn/start`) and renders `TodoPanel`, which takes the plain list, hides itself while the list is empty, and starts collapsed as a header of title plus its own `·`-joined per-status counts (localized, `1 completed · 2 in progress · 1 pending`, zero-count segments omitted). The dock adapter owns selection so the panel stays a pure function of its props. Anything the input-zone composer chain hides (a `conversation.composer` takeover such as ui-question's) hides the whole dock, this strip included. The `todo_write` Tool row belongs to [`ui-tool`](../ui-tool/README.md).
|
||||
|
||||
|
||||
@@ -24,7 +24,7 @@ Think 行默认保持折叠，并在不展开思维链的情况下暴露实时
|
||||
|
||||
审批经由本包声明的链接管编辑器：`ApprovalPanel` 注册为按选择器路由的 `'conversation.composer'` 配置项（ui-question 模式），在审批等待未决期间取代 InputBar 占据编辑器（琥珀色条、理由标题、来自运行中调用参数的配对命令行、一次性的拒绝／允许）。`contract/slots.ts` 中的 `PendingApproval` 领域面在运行时 `PendingWait` 载体之上拥有 wire 编码——带审计关联的 `ApprovalResponsePayload` 值；广播的 `approval/resolved` 帧使等待落定并恢复编辑器。运行时 manager 会将所有审批或问题等待通过 `SessionSummary.pendingInteraction` 投影出来，未实例化的 Session 也不例外；`ui-workspace` 负责其侧边栏呈现。未决等待完全离开消息流：问题（ui-question）与审批（ApprovalPanel）都经编辑器接管作答，不再保留只读占位卡。编辑器底行的 Access 席位挂载 `PermissionSelect`，由 host 计算的 `permissions` 投影经标准工具包 `useProjection` 供数（key 缺席即隐藏 chip）；chip 打开 Menu 原语下拉，其中 kebab-case 预设名渲染为 Title Case 标签；普通安全预设会立即经输入栏注入的 `command` 回调提交 `/permission <preset>`，而 `danger-full-access` 在界面中显示为 `Full access`，选择后先打开页面内的 Modal 风险确认。用户勾选确认项前启用按钮始终不可用；取消、Escape、关闭按钮与点击遮罩都不会提交命令。
|
||||
|
||||
由 Host presentation 的持久事件使用键控的 `'conversation.chat.eventview'` 座位，与整体 Tool presentation 并行。无 React 的 runtime 会把通用 `{ presentationKey, view }` sidecar 转为 `PresentedEventNode`；Chat 按开放 key 分发，领域 UI 插件无需在本包增加领域词汇即可注册自己的行。没有 registrant 被加载时，`GenericEventCard` 会在可展开 disclosure 中保留可见的 presentation key 与 JSON payload，而不会丢弃该持久事件。
|
||||
由 Host presentation 的持久事件使用键控的 `'conversation.chat.eventview'` 座位，与整体 Tool presentation 并行。无 React 的 runtime 会把通用事件 sidecar 转为携带持久事件类型与 view 的 `PresentedEventNode`；Chat 按该开放类型分发，领域 UI 插件无需在本包增加领域词汇即可注册自己的行。没有 registrant 被加载时，`GenericEventCard` 会在可展开 disclosure 中保留可见的事件类型与 JSON payload，而不会丢弃该持久事件。
|
||||
|
||||
`TodoDock` 以 `order: 0` 占用 `'conversation.input.dock'` 列表 slot（位于 Goal 与 Queue 之前），作为计划条读取 host 计算的 `todos` 投影（站立计划：其后没有更晚 `turn/start` 的最近一次 `todo/write`）并渲染 `TodoPanel`。面板接收纯列表，列表为空时自我隐藏；列表非空时默认折叠，表头显示标题及以 `·` 连接的各状态计数（如 `1 已完成 · 2 进行中 · 1 待处理`，省略零计数）。dock adapter 拥有 selection，因此面板保持为 props 的纯函数。输入区 composer 链隐藏的一切也会隐藏整个 dock。`todo_write` Tool 行属于 [`ui-tool`](../ui-tool/README.md)。
|
||||
|
||||
|
||||
@@ -212,8 +212,8 @@ const CommandRow = memo(function CommandRow({ renderSlot, node, compaction, t }:
|
||||
)
|
||||
})
|
||||
|
||||
/** One Host-presented durable event: keyed dispatch on its open presentation
|
||||
* key, with a visible JSON disclosure when no domain renderer is loaded. */
|
||||
/** One Host-presented durable event: dispatch by durable event type, with a
|
||||
* visible JSON disclosure when no domain renderer is loaded. */
|
||||
const EventRow = memo(function EventRow({ renderSlot, node, t }: {
|
||||
renderSlot: RenderChatSlot
|
||||
node: PresentedEventNode
|
||||
@@ -223,7 +223,7 @@ const EventRow = memo(function EventRow({ renderSlot, node, t }: {
|
||||
return (
|
||||
<div className={css.callRow}>
|
||||
{renderSlot('conversation.chat.eventview', owner, {
|
||||
entryKey: node.presentationKey,
|
||||
entryKey: node.eventType,
|
||||
fallback: <GenericEventCard {...owner} t={t} />,
|
||||
})}
|
||||
</div>
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
// GenericEventCard: the visible fallback for a Host-presented durable event.
|
||||
// A domain plugin may replace it through the keyed eventview slot; without
|
||||
// one, the presentation key and JSON sidecar remain inspectable in the flow.
|
||||
// one, the durable event type and JSON sidecar remain inspectable in the flow.
|
||||
|
||||
import { useMemo, useState } from 'react'
|
||||
import { IconSparkle16 } from '@deepseek-ai/dsh-client-ui-primitives'
|
||||
@@ -22,7 +22,7 @@ export function GenericEventCard({ node, t }: GenericEventCardProps) {
|
||||
className={css.root}
|
||||
icon={<IconSparkle16 size={14} />}
|
||||
chevronClassName={css.chevron}
|
||||
title={t('message.presentedEvent', { key: node.presentationKey })}
|
||||
title={t('message.presentedEvent', { key: node.eventType })}
|
||||
open={open}
|
||||
expandable
|
||||
expandOnRowClick
|
||||
|
||||
@@ -110,7 +110,7 @@ const presentedEvent = (seq: number): PresentedEventNode => ({
|
||||
kind: 'presented-event',
|
||||
seq,
|
||||
time: seq * 1_000,
|
||||
presentationKey: 'schedule/reminder',
|
||||
eventType: 'schedule/change',
|
||||
view: { prompt: 'check logs', scheduleId: 'schedule-1' },
|
||||
})
|
||||
|
||||
@@ -969,8 +969,8 @@ describe('ChatView', () => {
|
||||
return opts?.fallback ?? null
|
||||
})
|
||||
const view = render(<h.ChatView {...h.props} />)
|
||||
expect(calls).toEqual([{ key: 'conversation.chat.eventview', entryKey: 'schedule/reminder' }])
|
||||
fireEvent.click(view.getByText('事件：schedule/reminder'))
|
||||
expect(calls).toEqual([{ key: 'conversation.chat.eventview', entryKey: 'schedule/change' }])
|
||||
fireEvent.click(view.getByText('事件：schedule/change'))
|
||||
expect(view.getByText(/"prompt": "check logs"/)).toBeTruthy()
|
||||
expect(view.getByText(/"scheduleId": "schedule-1"/)).toBeTruthy()
|
||||
})
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
English | [中文](README.zh.md)
|
||||
|
||||
Browser-only renderer for durable Schedule reminder receipts. The plugin registers the `schedule/reminder` key in the conversation-owned `conversation.chat.eventview` slot. The generic runtime continues to carry the durable event identity and its Host-computed JSON sidecar; this package owns only the Schedule card.
|
||||
Browser-only renderer for durable Schedule reminder receipts. The plugin registers the durable `schedule/change` event type in the conversation-owned `conversation.chat.eventview` slot. The generic runtime continues to carry the durable event identity and its Host-computed JSON sidecar; this package owns only the Schedule card.
|
||||
|
||||
The card displays the reminder prompt, Session-local Schedule ID, exact UTC occurrence, and the `session-local` delivery boundary. A malformed or incompatible sidecar remains visible as a contained unavailable receipt instead of crashing the conversation. Unloading the plugin removes only the keyed renderer; `ui-conversation` then shows its generic visible JSON fallback for the same durable event.
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
[English](README.md) | 中文
|
||||
|
||||
用于渲染持久 Schedule 提醒回执的纯浏览器插件。插件在会话拥有的 `conversation.chat.eventview` slot 中注册 `schedule/reminder` key。通用 runtime 继续携带持久事件身份与 Host 计算的 JSON sidecar；本包只拥有 Schedule 卡片。
|
||||
用于渲染持久 Schedule 提醒回执的纯浏览器插件。插件在会话拥有的 `conversation.chat.eventview` slot 中注册持久事件类型 `schedule/change`。通用 runtime 继续携带持久事件身份与 Host 计算的 JSON sidecar；本包只拥有 Schedule 卡片。
|
||||
|
||||
卡片显示提醒原文、Session 内的 Schedule ID、精确 UTC 发生时刻，以及 `session-local` 交付边界。若 sidecar 损坏或版本不兼容，组件会显示受控的不可用回执，而不会让会话崩溃。卸载插件只会移除该键控 renderer；`ui-conversation` 随后仍会为同一个持久事件显示通用且可见的 JSON fallback。
|
||||
|
||||
|
||||
@@ -44,7 +44,7 @@ export function ReminderRow({ node, t }: ReminderRowProps) {
|
||||
{reminder !== null && <span className={css.delivery}>{t('reminder.delivery')}</span>}
|
||||
</header>
|
||||
{reminder === null
|
||||
? <p className={css.invalid}>{t('reminder.invalid')} · {node.presentationKey}</p>
|
||||
? <p className={css.invalid}>{t('reminder.invalid')} · {node.eventType}</p>
|
||||
: (
|
||||
<>
|
||||
<p className={css.prompt}>{reminder.prompt}</p>
|
||||
|
||||
@@ -30,7 +30,7 @@ export function apply(ctx: ClientContext): void {
|
||||
ctx.effect(
|
||||
() => ctx.slots.register({
|
||||
name: 'conversation.chat.eventview',
|
||||
key: 'schedule/reminder',
|
||||
key: 'schedule/change',
|
||||
locale: NS,
|
||||
}, ReminderRow),
|
||||
'ui-schedule: reminder row registration',
|
||||
|
||||
@@ -38,7 +38,7 @@ describe('ui-schedule browser plugin', () => {
|
||||
await b.fiber.await()
|
||||
expect(b.entry()).toEqual({
|
||||
name: 'conversation.chat.eventview',
|
||||
key: 'schedule/reminder',
|
||||
key: 'schedule/change',
|
||||
locale: 'schedule',
|
||||
component: ReminderRow,
|
||||
})
|
||||
|
||||
@@ -16,7 +16,7 @@ function props(view: unknown): ReminderRowProps {
|
||||
kind: 'presented-event',
|
||||
seq: 4,
|
||||
time: Date.parse('2026-08-05T08:00:00.000Z'),
|
||||
presentationKey: 'schedule/reminder',
|
||||
eventType: 'schedule/change',
|
||||
view,
|
||||
}
|
||||
return { node, t } as ReminderRowProps
|
||||
@@ -48,7 +48,7 @@ describe('ReminderRow', () => {
|
||||
deliveryMode: 'external',
|
||||
})} />)
|
||||
|
||||
expect(screen.getByText('提醒回执不可用 · schedule/reminder')).toBeTruthy()
|
||||
expect(screen.getByText('提醒回执不可用 · schedule/change')).toBeTruthy()
|
||||
expect(screen.queryByText('not trusted')).toBeNull()
|
||||
expect(screen.queryByText('仅在当前会话中交付')).toBeNull()
|
||||
})
|
||||
|
||||
Reference in New Issue
Block a user