1/**

2 * GENERATED by `scripts/gen-persistence-catalog.ts` — do not edit by hand; run

3 * `pnpm run gen-persistence-catalog` to regenerate (verified fresh by

4 * `pnpm run verify-persistence-catalog`, part of `doc-sync`).

5 * @module @deepseek-ai/dsh-session/known-event-types

6 */

7

8/**

9 * Every `SessionEventMap` member declared in this repository — the event

10 * vocabulary this build understands. The persistence read path refuses to

11 * interpret a log containing a type outside this set unless the event

12 * carries the envelope's `ignorable` marker (see `SessionEvent.ignorable`

13 * in `./types.ts`): such a log was likely written by a newer harness, and

14 * silently skipping a required event would reconstruct a wrong session.

15 * Downstream (out-of-repo) plugin events are outside this list by

16 * construction. The persisted `SessionEvent.ignorable` marker is the

17 * compatibility mechanism; event-name registration was rejected because

18 * it does not classify omission safety and would make reads

19 * composition-dependent. The rationale is in

20 * `.agents/notes/implemented/architecture/2026-08-30-retain-ignorable-external-session-events.md`.

21 */

22export const KNOWN_SESSION_EVENT_TYPES: ReadonlySet<string> = new Set([

23 'agent-preset/selected',

24 'agent/inbox/spliced',

25 'approval/asked',

26 'approval/decided',

27 'approval/policy',

28 'assistant/attempt',

29 'assistant/message',

30 'command/done',

31 'command/run',

32 'compaction/end',

33 'compaction/prune',

34 'compaction/start',

35 'compaction/summary',

36 'deliverables/presented',

37 'developer/message',

38 'feedback/message-delete',

39 'feedback/message-put',

40 'feedback/record',

41 'goal/change',

42 'hook/invoked',

43 'hook/result',

44 'image/offload',

45 'llm/retry',

46 'llm/retry-started',

47 'model/selection',

48 'permission/preset',

49 'plan/mode',

50 'request/context',

51 'request/header',

52 'sandbox/mode',

53 'schedule/change',

54 'session-log-deepseek/delivery-accepted',

55 'session/end-seed',

56 'session/title',

57 'session/title-llm-request',

58 'step/end',

59 'step/start',

60 'subagent/catalog',

61 'subagent/descriptor',

62 'subagent/model-selection-policy',

63 'system/message',

64 'team/member',

65 'team/message/delivered',

66 'team/message/queued',

67 'team/task',

68 'todo/write',

69 'tool-workflow/agent-end',

70 'tool-workflow/agent-start',

71 'tool-workflow/run-end',

72 'tool-workflow/run-start',

73 'tool/call',

74 'tool/ptc-dispatch',

75 'tool/ptc-dispatch-start',

76 'tool/result',

77 'turn/end',

78 'turn/start',

79 'user/message',

80 'web/deepseek-search-llm-request',

81 'workspace/changes',

82])

83

84/** Event types whose model-visible effects require an explicit pure interpreter. */

85export const MESSAGE_PROJECTION_EVENT_TYPES: ReadonlySet<string> = new Set([

86 'image/offload',

87])