From 1e8b9a45e9fec0507e266d243918f2dd2c98345e Mon Sep 17 00:00:00 2001
From: Neko Ayaka <neko@ayaka.moe>
Date: Mon, 29 Dec 2025 19:18:21 +0800
Subject: [PATCH] feat(stage-*): added new devtool called context flow (can be
 updated with more feature)

---
 .../src/renderer/layouts/settings.vue         |   4 +
 .../pages/settings/system/developer.vue       |   6 +
 apps/stage-web/src/layouts/settings.vue       |   4 +
 .../src/pages/settings/system/developer.vue   |   6 +
 .../src/locales/en/tamagotchi/settings.yaml   |   2 +
 .../src/locales/es/tamagotchi/settings.yaml   |   2 +
 .../src/locales/fr/tamagotchi/settings.yaml   |   2 +
 .../src/locales/ja/tamagotchi/settings.yaml   |   2 +
 .../src/locales/ko/tamagotchi/settings.yaml   |   2 +
 .../src/locales/ru/tamagotchi/settings.yaml   |   2 +
 .../src/locales/vi/tamagotchi/settings.yaml   |   2 +
 .../locales/zh-Hans/tamagotchi/settings.yaml  |   2 +
 .../locales/zh-Hant/tamagotchi/settings.yaml  |   2 +
 .../src/pages/devtools/context-flow.vue       | 682 ++++++++++++++++++
 .../components/Form/SelectTab/SelectTab.vue   |   7 +-
 15 files changed, 723 insertions(+), 4 deletions(-)
 create mode 100644 packages/stage-pages/src/pages/devtools/context-flow.vue

diff --git a/apps/stage-tamagotchi/src/renderer/layouts/settings.vue b/apps/stage-tamagotchi/src/renderer/layouts/settings.vue
index 2101ccabc..81d49b1a2 100644
--- a/apps/stage-tamagotchi/src/renderer/layouts/settings.vue
+++ b/apps/stage-tamagotchi/src/renderer/layouts/settings.vue
@@ -120,6 +120,10 @@ const routeHeaderMetadataMap = computed(() => {
       subtitle: t('tamagotchi.settings.devtools.title'),
       title: t('tamagotchi.settings.devtools.pages.widgets-calling.title'),
     },
+    '/devtools/context-flow': {
+      subtitle: t('tamagotchi.settings.devtools.title'),
+      title: t('tamagotchi.settings.devtools.pages.context-flow.title'),
+    },
   }
 
   for (const metadata of allProvidersMetadata.value) {
diff --git a/apps/stage-tamagotchi/src/renderer/pages/settings/system/developer.vue b/apps/stage-tamagotchi/src/renderer/pages/settings/system/developer.vue
index 3653b8477..7ad82a6ec 100644
--- a/apps/stage-tamagotchi/src/renderer/pages/settings/system/developer.vue
+++ b/apps/stage-tamagotchi/src/renderer/pages/settings/system/developer.vue
@@ -35,6 +35,12 @@ const menu = computed(() => [
     icon: 'i-solar:sledgehammer-bold-duotone',
     to: '/devtools/widgets-calling',
   },
+  {
+    title: t('tamagotchi.settings.devtools.pages.context-flow.title'),
+    description: 'Inspect incoming context updates and outgoing chat stream events',
+    icon: 'i-solar:chat-square-call-bold-duotone',
+    to: '/devtools/context-flow',
+  },
   {
     title: 'Relative Mouse',
     description: 'Get mouse position relative to the window',
diff --git a/apps/stage-web/src/layouts/settings.vue b/apps/stage-web/src/layouts/settings.vue
index 3645f1286..c4d693e8f 100644
--- a/apps/stage-web/src/layouts/settings.vue
+++ b/apps/stage-web/src/layouts/settings.vue
@@ -106,6 +106,10 @@ const routeHeaderMetadataMap = computed(() => {
     '/settings': {
       title: t('settings.title'),
     },
+    '/devtools/context-flow': {
+      subtitle: t('tamagotchi.settings.devtools.title'),
+      title: t('tamagotchi.settings.devtools.pages.context-flow.title'),
+    },
   }
 
   for (const metadata of allProvidersMetadata.value) {
diff --git a/apps/stage-web/src/pages/settings/system/developer.vue b/apps/stage-web/src/pages/settings/system/developer.vue
index a104e4736..f8c9750ff 100644
--- a/apps/stage-web/src/pages/settings/system/developer.vue
+++ b/apps/stage-web/src/pages/settings/system/developer.vue
@@ -50,6 +50,12 @@ const menu = computed(() => [
     icon: 'i-solar:sledgehammer-bold-duotone',
     to: '/devtools/polaroid',
   },
+  {
+    title: t('tamagotchi.settings.devtools.pages.context-flow.title'),
+    description: 'Inspect incoming context updates and outgoing chat stream events',
+    icon: 'i-solar:chat-square-call-bold-duotone',
+    to: '/devtools/context-flow',
+  },
   {
     title: t('settings.pages.system.sections.section.developer.sections.section.use-magic-keys.title'),
     description: t('settings.pages.system.sections.section.developer.sections.section.use-magic-keys.description'),
diff --git a/packages/i18n/src/locales/en/tamagotchi/settings.yaml b/packages/i18n/src/locales/en/tamagotchi/settings.yaml
index 951086a33..6e5fbe1e0 100644
--- a/packages/i18n/src/locales/en/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/en/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: Developer
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: Widget Calling
diff --git a/packages/i18n/src/locales/es/tamagotchi/settings.yaml b/packages/i18n/src/locales/es/tamagotchi/settings.yaml
index c95c6510e..6ee611d59 100644
--- a/packages/i18n/src/locales/es/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/es/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: Developer
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: Widget Calling
diff --git a/packages/i18n/src/locales/fr/tamagotchi/settings.yaml b/packages/i18n/src/locales/fr/tamagotchi/settings.yaml
index 003addaa2..7fac21611 100644
--- a/packages/i18n/src/locales/fr/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/fr/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: Developer
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: Widget Calling
diff --git a/packages/i18n/src/locales/ja/tamagotchi/settings.yaml b/packages/i18n/src/locales/ja/tamagotchi/settings.yaml
index 3830428e4..dde832b0b 100644
--- a/packages/i18n/src/locales/ja/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/ja/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: 開発者
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: ウィジェット呼び出し
diff --git a/packages/i18n/src/locales/ko/tamagotchi/settings.yaml b/packages/i18n/src/locales/ko/tamagotchi/settings.yaml
index 951086a33..6e5fbe1e0 100644
--- a/packages/i18n/src/locales/ko/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/ko/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: Developer
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: Widget Calling
diff --git a/packages/i18n/src/locales/ru/tamagotchi/settings.yaml b/packages/i18n/src/locales/ru/tamagotchi/settings.yaml
index 6158c818c..fc992eb06 100644
--- a/packages/i18n/src/locales/ru/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/ru/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: Developer
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: Widget Calling
diff --git a/packages/i18n/src/locales/vi/tamagotchi/settings.yaml b/packages/i18n/src/locales/vi/tamagotchi/settings.yaml
index 6ec1103dc..622ea00fc 100644
--- a/packages/i18n/src/locales/vi/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/vi/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: Developer
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: Widget Calling
diff --git a/packages/i18n/src/locales/zh-Hans/tamagotchi/settings.yaml b/packages/i18n/src/locales/zh-Hans/tamagotchi/settings.yaml
index cefa50151..0b7da76cc 100644
--- a/packages/i18n/src/locales/zh-Hans/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/zh-Hans/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: 开发者选项
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: 挂件调用
diff --git a/packages/i18n/src/locales/zh-Hant/tamagotchi/settings.yaml b/packages/i18n/src/locales/zh-Hant/tamagotchi/settings.yaml
index 2533b4352..98d9a00ac 100644
--- a/packages/i18n/src/locales/zh-Hant/tamagotchi/settings.yaml
+++ b/packages/i18n/src/locales/zh-Hant/tamagotchi/settings.yaml
@@ -30,5 +30,7 @@ pages:
 devtools:
   title: Developer
   pages:
+    context-flow:
+      title: Context Flow
     widgets-calling:
       title: Widget Calling
diff --git a/packages/stage-pages/src/pages/devtools/context-flow.vue b/packages/stage-pages/src/pages/devtools/context-flow.vue
new file mode 100644
index 000000000..f83630a6a
--- /dev/null
+++ b/packages/stage-pages/src/pages/devtools/context-flow.vue
@@ -0,0 +1,682 @@
+<script setup lang="ts">
+import type { ChatStreamEvent, ContextMessage } from '@proj-airi/stage-ui/types/chat'
+
+import { ContextUpdateStrategy } from '@proj-airi/server-sdk'
+import { Callout, Collapsable, Section } from '@proj-airi/stage-ui/components'
+import { CHAT_STREAM_CHANNEL_NAME, CONTEXT_CHANNEL_NAME, useChatStore } from '@proj-airi/stage-ui/stores/chat'
+import { useModsServerChannelStore } from '@proj-airi/stage-ui/stores/mods/api/channel-server'
+import { Button, FieldCheckbox, FieldInput, FieldTextArea, Input, SelectTab } from '@proj-airi/ui'
+import { useBroadcastChannel } from '@vueuse/core'
+import { computed, nextTick, onMounted, onUnmounted, ref, watch } from 'vue'
+
+type FlowDirection = 'incoming' | 'outgoing'
+type FlowChannel = 'server' | 'broadcast' | 'chat' | 'devtools'
+
+interface FlowEntry {
+  id: number
+  timestamp: number
+  direction: FlowDirection
+  channel: FlowChannel
+  type: string
+  summary?: string
+  payload?: unknown
+  searchText: string
+}
+
+const chatStore = useChatStore()
+const serverChannelStore = useModsServerChannelStore()
+
+const entries = ref<FlowEntry[]>([])
+const captureBroadcast = ref(true)
+const captureChatHooks = ref(true)
+const captureServerUpdates = ref(true)
+const autoScroll = ref(true)
+const showIncoming = ref(true)
+const showOutgoing = ref(true)
+const filterText = ref('')
+const maxEntries = ref('200')
+
+const testPayload = ref('{"type":"coding:context","data":{"file":{"path":"README.md"}}}')
+const testStrategy = ref<ContextUpdateStrategy>(ContextUpdateStrategy.ReplaceSelf)
+
+const streamContainer = ref<HTMLDivElement>()
+
+const directionOptions = [
+  { label: 'All', value: 'all' },
+  { label: 'Incoming', value: 'incoming' },
+  { label: 'Outgoing', value: 'outgoing' },
+]
+
+const directionFilter = ref<'all' | FlowDirection>('all')
+const previewMaxLength = 420
+
+interface PreviewItem {
+  label: string
+  value: string
+}
+
+const maxEntriesValue = computed(() => {
+  const parsed = Number.parseInt(maxEntries.value, 10)
+  if (!Number.isFinite(parsed))
+    return 200
+  return Math.min(Math.max(parsed, 50), 1000)
+})
+
+const filteredEntries = computed(() => {
+  const query = filterText.value.trim().toLowerCase()
+  return entries.value.filter((entry) => {
+    if (directionFilter.value !== 'all' && entry.direction !== directionFilter.value)
+      return false
+    if (!showIncoming.value && entry.direction === 'incoming')
+      return false
+    if (!showOutgoing.value && entry.direction === 'outgoing')
+      return false
+    if (!query)
+      return true
+    return entry.searchText.includes(query)
+  })
+})
+
+function normalizePayload(payload: unknown) {
+  try {
+    return JSON.parse(JSON.stringify(payload)) as unknown
+  }
+  catch {
+    return payload
+  }
+}
+
+function truncateText(value: string, limit = 160) {
+  if (value.length <= limit)
+    return value
+  return `${value.slice(0, limit)}...`
+}
+
+function summarizeContextUpdate(update: { text?: string, content?: unknown }) {
+  const summaryParts: string[] = []
+  if (update.text) {
+    summaryParts.push(`text="${truncateText(update.text, 120)}"`)
+  }
+  if (update.content !== undefined) {
+    const contentText = typeof update.content === 'string'
+      ? update.content
+      : (() => {
+          try {
+            return JSON.stringify(update.content)
+          }
+          catch {
+            return '[unserializable]'
+          }
+        })()
+    summaryParts.push(`content="${truncateText(contentText, 120)}"`)
+  }
+  return summaryParts.join(' ')
+}
+
+function toPreviewValue(value: unknown) {
+  if (value === undefined || value === null)
+    return ''
+  if (typeof value === 'string')
+    return value
+  try {
+    return JSON.stringify(value, null, 2)
+  }
+  catch {
+    return String(value)
+  }
+}
+
+function formatPreviewValue(value: unknown) {
+  const text = toPreviewValue(value)
+  if (!text)
+    return ''
+  return truncateText(text, previewMaxLength)
+}
+
+function getContextUpdatePreview(entry: FlowEntry) {
+  const payload = entry.payload as Record<string, any> | undefined
+  if (!payload)
+    return null
+  const candidate = entry.type === 'context:update' && payload.data
+    ? payload.data
+    : payload
+  if (!candidate || (candidate.text === undefined && candidate.content === undefined))
+    return null
+  return {
+    text: candidate.text as string | undefined,
+    content: candidate.content as unknown,
+  }
+}
+
+function buildPreviewItems(entry: FlowEntry): PreviewItem[] {
+  const items: PreviewItem[] = []
+  const contextPreview = getContextUpdatePreview(entry)
+  if (contextPreview) {
+    if (contextPreview.text) {
+      items.push({ label: 'Text', value: formatPreviewValue(contextPreview.text) })
+    }
+    if (contextPreview.content !== undefined) {
+      items.push({ label: 'Content', value: formatPreviewValue(contextPreview.content) })
+    }
+    return items
+  }
+
+  const payload = entry.payload as Record<string, any> | undefined
+  if (payload?.messageText) {
+    items.push({ label: 'Message', value: formatPreviewValue(payload.messageText) })
+  }
+  else if (payload?.literal) {
+    items.push({ label: 'Token', value: formatPreviewValue(payload.literal) })
+  }
+  else if (payload?.special) {
+    items.push({ label: 'Token', value: formatPreviewValue(payload.special) })
+  }
+  else if (payload?.message) {
+    items.push({ label: 'Message', value: formatPreviewValue(payload.message) })
+  }
+  else if (entry.summary) {
+    items.push({ label: 'Summary', value: formatPreviewValue(entry.summary) })
+  }
+
+  return items
+}
+
+function buildSearchText(entry: Omit<FlowEntry, 'searchText'>) {
+  const payloadText = typeof entry.payload === 'string'
+    ? entry.payload
+    : (() => {
+        try {
+          return JSON.stringify(entry.payload)
+        }
+        catch {
+          return ''
+        }
+      })()
+  return [
+    entry.direction,
+    entry.channel,
+    entry.type,
+    entry.summary ?? '',
+    payloadText,
+  ].join(' ').toLowerCase()
+}
+
+let entryId = 0
+function pushEntry(entry: Omit<FlowEntry, 'id' | 'timestamp' | 'searchText'>) {
+  const normalizedPayload = normalizePayload(entry.payload)
+  const nextEntry: FlowEntry = {
+    ...entry,
+    id: entryId++,
+    timestamp: Date.now(),
+    payload: normalizedPayload,
+    searchText: '',
+  }
+  nextEntry.searchText = buildSearchText(nextEntry)
+
+  entries.value.push(nextEntry)
+  if (entries.value.length > maxEntriesValue.value)
+    entries.value.splice(0, entries.value.length - maxEntriesValue.value)
+}
+
+function formatTimestamp(value: number) {
+  const date = new Date(value)
+  return date.toLocaleTimeString('en-US', { hour12: false })
+}
+
+function formatPayload(payload: unknown) {
+  if (payload === undefined)
+    return '-'
+  if (typeof payload === 'string')
+    return payload
+  try {
+    return JSON.stringify(payload, null, 2)
+  }
+  catch {
+    return String(payload)
+  }
+}
+
+function directionBadgeClasses(direction: FlowDirection) {
+  if (direction === 'incoming') {
+    return [
+      'bg-emerald-500/15',
+      'text-emerald-600',
+      'dark:text-emerald-300',
+      'border-emerald-500/30',
+    ]
+  }
+  return [
+    'bg-sky-500/15',
+    'text-sky-600',
+    'dark:text-sky-300',
+    'border-sky-500/30',
+  ]
+}
+
+function channelBadgeClasses(channel: FlowChannel) {
+  switch (channel) {
+    case 'server':
+      return ['bg-orange-500/15', 'text-orange-600', 'dark:text-orange-300', 'border-orange-500/30']
+    case 'broadcast':
+      return ['bg-violet-500/15', 'text-violet-600', 'dark:text-violet-300', 'border-violet-500/30']
+    case 'chat':
+      return ['bg-lime-500/15', 'text-lime-600', 'dark:text-lime-300', 'border-lime-500/30']
+    default:
+      return ['bg-neutral-400/15', 'text-neutral-600', 'dark:text-neutral-300', 'border-neutral-500/30']
+  }
+}
+
+function clearEntries() {
+  entries.value = []
+}
+
+function sendTestContextUpdate() {
+  const text = testPayload.value.trim()
+  if (!text)
+    return
+
+  serverChannelStore.sendContextUpdate({
+    strategy: testStrategy.value,
+    text,
+  })
+
+  pushEntry({
+    direction: 'outgoing',
+    channel: 'devtools',
+    type: 'context:update',
+    summary: `strategy=${testStrategy.value} length=${text.length}`,
+    payload: { strategy: testStrategy.value, text },
+  })
+}
+
+const { data: incomingContext } = useBroadcastChannel<ContextMessage, ContextMessage>({
+  name: CONTEXT_CHANNEL_NAME,
+})
+const { data: incomingStreamEvent } = useBroadcastChannel<ChatStreamEvent, ChatStreamEvent>({
+  name: CHAT_STREAM_CHANNEL_NAME,
+})
+
+const cleanupFns: Array<() => void> = []
+
+onMounted(() => {
+  cleanupFns.push(serverChannelStore.onContextUpdate((event) => {
+    if (!captureServerUpdates.value)
+      return
+
+    pushEntry({
+      direction: 'incoming',
+      channel: 'server',
+      type: event.type,
+      summary: [
+        `source=${event.source}`,
+        `strategy=${event.data.strategy}`,
+        summarizeContextUpdate(event.data),
+      ].filter(Boolean).join(' '),
+      payload: event,
+    })
+  }))
+
+  cleanupFns.push(
+    chatStore.onBeforeMessageComposed(async (message, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'before-compose',
+        summary: truncateText(message),
+        payload: { message, context },
+      })
+    }),
+    chatStore.onAfterMessageComposed(async (message, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'after-compose',
+        summary: truncateText(message),
+        payload: { message, context },
+      })
+    }),
+    chatStore.onBeforeSend(async (message, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'before-send',
+        summary: truncateText(message),
+        payload: { message, context },
+      })
+    }),
+    chatStore.onAfterSend(async (message, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'after-send',
+        summary: truncateText(message),
+        payload: { message, context },
+      })
+    }),
+    chatStore.onTokenLiteral(async (literal, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'token-literal',
+        summary: truncateText(literal, 80),
+        payload: { literal, context },
+      })
+    }),
+    chatStore.onTokenSpecial(async (special, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'token-special',
+        summary: truncateText(special, 80),
+        payload: { special, context },
+      })
+    }),
+    chatStore.onStreamEnd(async (context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'stream-end',
+        summary: 'stream completed',
+        payload: { context },
+      })
+    }),
+    chatStore.onAssistantResponseEnd(async (message, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'assistant-end',
+        summary: truncateText(message),
+        payload: { message, context },
+      })
+    }),
+    chatStore.onAssistantMessage(async (message, messageText, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'assistant-message',
+        summary: truncateText(messageText),
+        payload: { message, messageText, context },
+      })
+    }),
+    chatStore.onChatTurnComplete(async (chat, context) => {
+      if (!captureChatHooks.value)
+        return
+      pushEntry({
+        direction: 'outgoing',
+        channel: 'chat',
+        type: 'chat-turn-complete',
+        summary: truncateText(chat.outputText),
+        payload: { chat, context },
+      })
+    }),
+  )
+})
+
+watch(incomingContext, (event) => {
+  if (!event || !captureBroadcast.value)
+    return
+
+  pushEntry({
+    direction: 'incoming',
+    channel: 'broadcast',
+    type: 'context:broadcast',
+    summary: [
+      `source=${event.source}`,
+      `strategy=${event.strategy}`,
+      summarizeContextUpdate(event),
+    ].filter(Boolean).join(' '),
+    payload: event,
+  })
+})
+
+watch(incomingStreamEvent, (event) => {
+  if (!event || !captureBroadcast.value)
+    return
+
+  pushEntry({
+    direction: 'incoming',
+    channel: 'broadcast',
+    type: `stream:${event.type}`,
+    summary: event.type === 'token-literal'
+      ? truncateText(event.literal, 80)
+      : event.type === 'token-special'
+        ? truncateText(event.special, 80)
+        : event.type === 'assistant-message'
+          ? truncateText(event.messageText ?? '', 120)
+          : `session=${event.sessionId}`,
+    payload: event,
+  })
+})
+
+watch(() => entries.value.length, async () => {
+  if (!autoScroll.value)
+    return
+  await nextTick()
+  if (streamContainer.value)
+    streamContainer.value.scrollTop = streamContainer.value.scrollHeight
+})
+
+watch(maxEntriesValue, () => {
+  if (entries.value.length > maxEntriesValue.value)
+    entries.value.splice(0, entries.value.length - maxEntriesValue.value)
+})
+
+onUnmounted(() => {
+  for (const cleanup of cleanupFns)
+    cleanup()
+})
+</script>
+
+<template>
+  <div :class="['flex', 'flex-col', 'gap-6']">
+    <Callout label="Context Flow">
+      Inspect incoming context updates (server + broadcast) and outgoing chat hooks in real time. Use this to verify
+      how plugin context (e.g. VSCode coding context) travels into the chat pipeline and out to server events.
+    </Callout>
+
+    <div :class="['grid', 'gap-6', 'lg:grid-cols-[360px_1fr]']">
+      <div :class="['flex', 'flex-col', 'gap-6', 'rounded-xl', 'bg-neutral-50', 'p-4', 'dark:bg-[rgba(0,0,0,0.3)]', 'h-fit']">
+        <div :class="['flex', 'items-center', 'gap-2', 'text-sm', 'font-semibold', 'text-neutral-600', 'dark:text-neutral-300']">
+          <div :class="['size-5', 'i-solar:filter-bold-duotone']" />
+          Capture toggles
+        </div>
+        <div :class="['flex', 'flex-col', 'gap-3']">
+          <FieldCheckbox v-model="captureServerUpdates" label="Server context updates" description="Listen for context:update events from the channel server." />
+          <FieldCheckbox v-model="captureBroadcast" label="Broadcast channels" description="Listen for context + stream events from BroadcastChannel." />
+          <FieldCheckbox v-model="captureChatHooks" label="Chat hooks" description="Record outgoing chat lifecycle hooks (compose/send/stream)." />
+          <FieldCheckbox v-model="autoScroll" label="Auto scroll" description="Stick to the latest entry as events arrive." />
+        </div>
+      </div>
+
+      <div :class="['flex', 'flex-col', 'gap-2']">
+        <Section title="Send" icon="i-solar:plain-2-bold-duotone" inner-class="gap-3" :expand="false">
+          <div :class="['flex', 'flex-col', 'gap-2']">
+            <div :class="['text-xs', 'font-medium', 'text-neutral-500', 'dark:text-neutral-400']">
+              Strategy
+            </div>
+            <SelectTab
+              v-model="testStrategy"
+              size="sm"
+              :options="[
+                { label: 'Replace', value: ContextUpdateStrategy.ReplaceSelf },
+                { label: 'Append', value: ContextUpdateStrategy.AppendSelf },
+              ]"
+            />
+            <FieldTextArea
+              v-model="testPayload"
+              label="Payload"
+              description="Raw text payload sent as ContextUpdate.text. JSON is allowed."
+              :input-class="['font-mono', 'min-h-32']"
+            />
+            <div :class="['flex', 'justify-end']">
+              <Button label="Send context update" icon="i-solar:paper-plane-bold-duotone" size="sm" @click="sendTestContextUpdate" />
+            </div>
+          </div>
+        </Section>
+
+        <div :class="['flex', 'items-center', 'gap-2']">
+          <div :class="['size-5', 'i-solar:stream-bold-duotone']" />
+          <div :class="['text-base', 'font-semibold', 'text-neutral-700', 'dark:text-neutral-200']">
+            Event stream
+          </div>
+        </div>
+        <Input
+          v-model="filterText"
+          placeholder="Search type, source, text..."
+        />
+        <Collapsable :default="false" label="Filters">
+          <div :class="['grid', 'gap-3', 'py-2', 'grid-cols-1', 'md:grid-cols-2', 'lg:grid-cols-3']">
+            <div :class="['flex', 'flex-col', 'gap-2', 'w-full']">
+              <div :class="['text-xs', 'font-medium', 'text-neutral-500', 'dark:text-neutral-400']">
+                Direction
+              </div>
+              <SelectTab
+                v-model="directionFilter"
+                size="sm"
+                :options="directionOptions"
+              />
+            </div>
+            <div :class="['flex', 'flex-col', 'gap-2', 'w-full']">
+              <div :class="['text-xs', 'font-medium', 'text-neutral-500', 'dark:text-neutral-400']">
+                Visibility
+              </div>
+              <div :class="['flex', 'flex-wrap', 'gap-2']">
+                <FieldCheckbox v-model="showIncoming" label="Show incoming" />
+                <FieldCheckbox v-model="showOutgoing" label="Show outgoing" />
+              </div>
+            </div>
+            <div :class="['flex', 'flex-col', 'gap-2', 'w-full']">
+              <FieldInput
+                v-model="maxEntries"
+                label="Max entries"
+                description="50-1000 (default 200)"
+                type="number"
+              />
+            </div>
+            <div :class="['flex', 'items-end', 'justify-end', 'w-full']">
+              <Button label="Clear" icon="i-solar:trash-bin-trash-bold-duotone" size="sm" @click="clearEntries" />
+            </div>
+          </div>
+        </Collapsable>
+
+        <div
+          ref="streamContainer"
+          :class="[
+            'max-h-[60vh]',
+            'min-h-[360px]',
+            'overflow-y-auto',
+            'rounded-lg',
+            'bg-white/70',
+            'p-3',
+            'dark:bg-neutral-950/50',
+          ]"
+        >
+          <div
+            v-if="!filteredEntries.length"
+            :class="['h-full', 'w-full', 'flex', 'items-center', 'justify-center', 'text-sm', 'text-neutral-500', 'dark:text-neutral-400']"
+          >
+            No data yet. Trigger a chat, send a context update, or enable broadcast capture.
+          </div>
+          <div v-else :class="['grid', 'gap-3']">
+            <div
+              v-for="entry in filteredEntries"
+              :key="entry.id"
+              :class="[
+                'rounded-xl',
+                'border',
+                'border-neutral-200/70',
+                'bg-neutral-50/80',
+                'p-4',
+                'shadow-sm',
+                'dark:border-neutral-800/80',
+                'dark:bg-neutral-950/60',
+              ]"
+            >
+              <div :class="['flex', 'flex-wrap', 'items-center', 'gap-2', 'text-xs']">
+                <span :class="['rounded-full', 'border', 'px-2', 'py-0.5', ...directionBadgeClasses(entry.direction)]">
+                  {{ entry.direction.toUpperCase() }}
+                </span>
+                <span :class="['rounded-full', 'border', 'px-2', 'py-0.5', ...channelBadgeClasses(entry.channel)]">
+                  {{ entry.channel }}
+                </span>
+                <span :class="['font-mono', 'text-neutral-500', 'dark:text-neutral-400']">
+                  {{ formatTimestamp(entry.timestamp) }}
+                </span>
+                <span :class="['font-semibold', 'text-neutral-800', 'dark:text-neutral-100']">
+                  {{ entry.type }}
+                </span>
+              </div>
+
+              <div v-if="entry.summary" :class="['mt-2', 'text-xs', 'text-neutral-500', 'dark:text-neutral-400']">
+                {{ entry.summary }}
+              </div>
+
+              <div :class="['mt-3', 'grid', 'gap-2']">
+                <div :class="['text-[11px]', 'uppercase', 'tracking-[0.08em]', 'text-neutral-400', 'dark:text-neutral-500']">
+                  Preview
+                </div>
+                <div v-if="buildPreviewItems(entry).length" :class="['grid', 'gap-2', 'sm:grid-cols-2']">
+                  <div
+                    v-for="item in buildPreviewItems(entry)"
+                    :key="`${entry.id}-${item.label}`"
+                    :class="[
+                      'rounded-lg',
+                      'border',
+                      'border-neutral-200/70',
+                      'bg-white/80',
+                      'p-3',
+                      'dark:border-neutral-800/80',
+                      'dark:bg-neutral-900/70',
+                    ]"
+                  >
+                    <div :class="['text-[11px]', 'uppercase', 'tracking-[0.06em]', 'text-neutral-400', 'dark:text-neutral-500']">
+                      {{ item.label }}
+                    </div>
+                    <pre :class="['mt-2', 'max-h-40', 'overflow-auto', 'whitespace-pre-wrap', 'break-words', 'text-xs', 'font-mono', 'text-neutral-800', 'dark:text-neutral-100']">
+{{ item.value || '-' }}
+                    </pre>
+                  </div>
+                </div>
+                <div v-else :class="['text-xs', 'text-neutral-500', 'dark:text-neutral-400']">
+                  No preview available.
+                </div>
+              </div>
+
+              <details :class="['mt-3']">
+                <summary :class="['cursor-pointer', 'text-xs', 'text-neutral-500', 'dark:text-neutral-400']">
+                  Details
+                </summary>
+                <pre :class="['mt-2', 'max-h-64', 'overflow-auto', 'rounded-lg', 'bg-neutral-900/90', 'p-3', 'text-xs', 'text-neutral-100']">
+{{ formatPayload(entry.payload) }}
+                </pre>
+              </details>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<route lang="yaml">
+meta:
+  layout: settings
+</route>
diff --git a/packages/ui/src/components/Form/SelectTab/SelectTab.vue b/packages/ui/src/components/Form/SelectTab/SelectTab.vue
index 5a9802714..6ac781f43 100644
--- a/packages/ui/src/components/Form/SelectTab/SelectTab.vue
+++ b/packages/ui/src/components/Form/SelectTab/SelectTab.vue
@@ -48,11 +48,10 @@ const rootStyle = computed(() => ({
     :aria-readonly="props.readonly"
     :class="[
       'select-tab',
-      'relative', 'flex', 'w-full', 'items-stretch', 'rounded-xl',
+      'relative', 'flex', 'w-full', 'items-stretch', 'rounded-lg',
       'overflow-hidden',
-      'bg-white-400/6', 'dark:bg-neutral-900/70',
-      'transition-[border-color,box-shadow,opacity]', 'duration-200', 'ease-out', 'border-2',
-      'border-neutral-100', 'dark:border-neutral-800',
+      'bg-white-400/6', 'dark:bg-neutral-950/70',
+      'transition-[border-color,box-shadow,opacity]', 'duration-200', 'ease-out',
       isDisabled ? ['cursor-not-allowed', 'opacity-60'] : ['shadow-[0_14px_50px_-32px_rgba(0,0,0,0.55)]', 'backdrop-blur-sm'],
       // before
       'before:bg-primary-300/50', 'dark:before:bg-primary-400/50',