From a23982b30a8e198fe3d583197dc45bc780e5c123 Mon Sep 17 00:00:00 2001 From: Tianyi Cui <53024+tianyicui@users.noreply.github.com> Date: Sat, 4 Jul 2026 23:42:47 +0800 Subject: [PATCH] Regenerate catalog for post-merge line shifts; drop pruned continuation trigger from turn/start JSDoc Merging master brought the producerless-vocabulary prune that removed TurnTriggerMap's continuation variant: the source pointers above SessionEventMap shifted by one line (the staleness CI caught on the merge tree), and the new turn/start JSDoc still named the pruned variant. --- docs/persistence-catalog/log-events.md | 28 +++++++++++++------------- packages/core/session/src/types.ts | 6 +++--- 2 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/persistence-catalog/log-events.md b/docs/persistence-catalog/log-events.md index 4bdda95f40..f49f59d08d 100644 --- a/docs/persistence-catalog/log-events.md +++ b/docs/persistence-catalog/log-events.md @@ -23,7 +23,7 @@ Raw stream chunk — token-level replay fidelity. Types: [StreamChunk](../core-data-structures/llm-streaming.md) -Source: [`packages/core/session/src/types.ts:238`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:237`](../../packages/core/session/src/types.ts) #### `assistant/message` — surface @@ -35,7 +35,7 @@ Assembled assistant message for one step (derived history uses this). Carries th Types: [ContentBlock](../core-data-structures/core.md) · [TokenUsage](../core-data-structures/llm-streaming.md) -Source: [`packages/core/session/src/types.ts:245`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:244`](../../packages/core/session/src/types.ts) ### `compact/*` @@ -83,7 +83,7 @@ In-session context injection (file-change notices, subdir AGENTS.md, skill conte Types: [ContentBlock](../core-data-structures/core.md) · [MessageSource](../core-data-structures/core.md) -Source: [`packages/core/session/src/types.ts:236`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:235`](../../packages/core/session/src/types.ts) ### `hook/*` @@ -119,7 +119,7 @@ A queued prompt an `agent/prompt-submit` listener VETOED — the durable record Types: [ContentBlock](../core-data-structures/core.md) · [MessageSource](../core-data-structures/core.md) -Source: [`packages/core/session/src/types.ts:230`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:229`](../../packages/core/session/src/types.ts) ### `steering/*` @@ -133,7 +133,7 @@ Steering content injected between steps of a running turn. Types: [ContentBlock](../core-data-structures/core.md) · [MessageSource](../core-data-structures/core.md) -Source: [`packages/core/session/src/types.ts:263`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:262`](../../packages/core/session/src/types.ts) ### `step/*` @@ -145,7 +145,7 @@ Closes step `step` of turn `turn`. 'step/end': { turn: number; step: number } ``` -Source: [`packages/core/session/src/types.ts:217`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:216`](../../packages/core/session/src/types.ts) #### `step/start` — log-only @@ -155,7 +155,7 @@ Opens step `step` of turn `turn` — one model call plus the tool executions it 'step/start': { turn: number; step: number } ``` -Source: [`packages/core/session/src/types.ts:215`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:214`](../../packages/core/session/src/types.ts) ### `todo/*` @@ -171,7 +171,7 @@ NOT a SurfaceEventType: it produces no LLM message and never reaches `deriveMess Types: [TodoItem](../core-data-structures/session.md) -Source: [`packages/core/session/src/types.ts:277`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:276`](../../packages/core/session/src/types.ts) ### `tool/*` @@ -185,7 +185,7 @@ The model requested one tool invocation: `name` with the raw `arguments` JSON st Types: [CallId](../core-data-structures/core.md) -Source: [`packages/core/session/src/types.ts:251`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:250`](../../packages/core/session/src/types.ts) #### `tool/result` — surface @@ -197,7 +197,7 @@ A completed tool call's model-facing result, plus an optional tool-private `meta Types: [CallId](../core-data-structures/core.md) · [ContentBlock](../core-data-structures/core.md) -Source: [`packages/core/session/src/types.ts:261`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:260`](../../packages/core/session/src/types.ts) ### `turn/*` @@ -211,11 +211,11 @@ Closes turn `turn` with the TurnEndReason that ended it. The loop fires the awai Types: [TurnEndReason](../core-data-structures/session.md) -Source: [`packages/core/session/src/types.ts:213`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:212`](../../packages/core/session/src/types.ts) #### `turn/start` — log-only -Opens turn `turn`. `trigger` records what started it — a drained message batch, a continuation, or an idle-time injection. The turn is the durability/replay boundary: every event sits between a `turn/start` and its matching `turn/end` (the turn-enclosure invariant). +Opens turn `turn`. `trigger` records what started it — a drained message batch or an idle-time injection. The turn is the durability/replay boundary: every event sits between a `turn/start` and its matching `turn/end` (the turn-enclosure invariant). ```ts persistence-catalog 'turn/start': { turn: number; trigger: TurnTrigger } @@ -223,7 +223,7 @@ Opens turn `turn`. `trigger` records what started it — a drained message batch Types: [TurnTrigger](../core-data-structures/session.md) -Source: [`packages/core/session/src/types.ts:207`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:206`](../../packages/core/session/src/types.ts) ### `user/*` @@ -237,4 +237,4 @@ A user-visible prompt (queued message drained at turn start). Types: [ContentBlock](../core-data-structures/core.md) · [MessageSource](../core-data-structures/core.md) -Source: [`packages/core/session/src/types.ts:219`](../../packages/core/session/src/types.ts) +Source: [`packages/core/session/src/types.ts:218`](../../packages/core/session/src/types.ts) diff --git a/packages/core/session/src/types.ts b/packages/core/session/src/types.ts index ce95959e25..82e080aa1a 100644 --- a/packages/core/session/src/types.ts +++ b/packages/core/session/src/types.ts @@ -199,9 +199,9 @@ export interface TodoItem { export interface SessionEventMap { /** * Opens turn `turn`. `trigger` records what started it — a drained message - * batch, a continuation, or an idle-time injection. The turn is the - * durability/replay boundary: every event sits between a `turn/start` and its - * matching `turn/end` (the turn-enclosure invariant). + * batch or an idle-time injection. The turn is the durability/replay + * boundary: every event sits between a `turn/start` and its matching + * `turn/end` (the turn-enclosure invariant). */ 'turn/start': { turn: number; trigger: TurnTrigger } /**