langchain_agentx_stream_ui 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/view/AgentSession.tsx","../src/core/store.ts","../src/view/tools/groupParallelTools.ts","../src/view/nodes/SubAgentNode.tsx","../src/transport/createAgentxSseSource.ts","../src/transport/createReplaySource.ts"],"sourcesContent":["/**\n * 职责：顶层容器，连接 Source → store → Timeline 渲染。\n * 链路位置：业务页面 <AgentSession source={...} /> 唯一入口。\n * 当前裁剪范围：单会话；initialEvents 支持 EventBuffer 快照续流（M3）；reducer/transport 异常自吞。\n */\nimport { useEffect, useMemo, useRef, type ReactNode } from 'react';\n\nimport { createSessionStore } from '../core/store';\nimport { replayEvents } from '../core/replay';\nimport {\n  SessionStoreContext,\n  NodeRegistryContext,\n  ToolDisplayOptionsContext,\n  SessionViewOptionsContext,\n} from '../core/context/SessionContext';\nimport type { Source } from '../transport/types';\nimport type { LangchainAgentEvent, TierOverrides } from '../types/events';\nimport type { ReducerError } from '../types/tree';\nimport { createDefaultRegistry } from './defaultRegistry';\nimport type { NodeRegistry } from './NodeRegistry';\nimport { SessionTimeline } from './SessionTimeline';\nimport { InteractionBusContext } from '../core/context/InteractionContext';\nimport type { InteractionBus } from '../core/interaction/InteractionBus';\nimport { getNoopInteractionBus } from '../core/interaction/InteractionBus';\nimport { useInternalErrors, useSessionStatus } from '../core/hooks';\nimport type { MarkdownRenderer } from '../core/context/MarkdownRendererContext';\nimport { MarkdownRendererContext } from '../core/context/MarkdownRendererContext';\nimport {\n  createDefaultToolRegistry,\n  type ToolDisplayRegistry,\n} from './tools/registry';\nimport type { ToolBodyMode } from './tools/types';\nimport type { PermissionUiMode, DisplayMode } from './sessionViewOptions';\nimport { DEFAULT_SESSION_VIEW_OPTIONS } from './sessionViewOptions';\n\nexport interface AgentSessionProps {\n  source: Source;\n  /** 挂载时先 replay 预灌树（含 EventBuffer ingest 快照），再接 source 续流 */\n  initialEvents?: LangchainAgentEvent[];\n  registry?: NodeRegistry;\n  tierOverrides?: TierOverrides;\n  onError?: (error: Error) => void;\n  autoReconnect?: boolean;\n  debug?: boolean;\n  /** 为 true 且主舞台节点数超过阈值时使用 VirtualTimeline（V2-E） */\n  virtualized?: boolean;\n  virtualizeThreshold?: number;\n  /** 权限回写薄层；PermissionCard 触发 onPermissionResolve（V2-D） */\n  interactionBus?: InteractionBus;\n  /** 按工具名注册 Body 组件（V3-T0） */\n  toolDisplayRegistry?: ToolDisplayRegistry;\n  /** 工具正文默认 preview / full（V3-T0） */\n  defaultBodyMode?: ToolBodyMode;\n  /** @deprecated Phase 4 起由 projection GroupedToolUseAccumulator 自动分组；保留 prop 兼容 */\n  groupParallelTools?: boolean;\n  /** 权限 UI：standalone | inline | both（V3-T4.6）；后台 bypass 时通常无 pending */\n  permissionUiMode?: PermissionUiMode;\n  /** 富 Markdown 渲染（simple demo 可注入 react-markdown + mermaid） */\n  markdownRenderer?: MarkdownRenderer;\n  /** 对齐 CLI display mode（normal / brief_only / transcript） */\n  displayMode?: DisplayMode;\n  /** 对齐 CC verbose；为 true 时跳过分组并展开 explore detail */\n  verbose?: boolean;\n  exploreFullscreenBash?: boolean;\n  memoryDir?: string | null;\n  workspaceRoot?: string | null;\n  children?: ReactNode;\n}\n\nfunction DebugPanel() {\n  const status = useSessionStatus();\n  const errors = useInternalErrors();\n  if (errors.length === 0) return null;\n  return (\n    <div className=\"lax-debug-panel\" data-testid=\"lax-debug-panel\">\n      <div>status: {status}</div>\n      <ul>\n        {errors.map((err: ReducerError, i: number) => (\n          <li key={`${err.eventIndex}-${i}`}>\n            [{err.eventType}] {err.message}\n          </li>\n        ))}\n      </ul>\n    </div>\n  );\n}\n\nexport function AgentSession({\n  source,\n  initialEvents,\n  registry,\n  tierOverrides: _tierOverrides,\n  onError,\n  autoReconnect: _autoReconnect,\n  debug = false,\n  virtualized = false,\n  virtualizeThreshold,\n  interactionBus,\n  toolDisplayRegistry,\n  defaultBodyMode = 'preview',\n  groupParallelTools = false,\n  permissionUiMode = 'standalone',\n  markdownRenderer,\n  displayMode = 'normal',\n  verbose = false,\n  exploreFullscreenBash = true,\n  memoryDir = null,\n  workspaceRoot = null,\n  children,\n}: AgentSessionProps) {\n  const storeRef = useRef<ReturnType<typeof createSessionStore> | null>(null);\n  if (storeRef.current === null) {\n    const replayOpts = {\n      tierOverrides: _tierOverrides,\n      collectDebug: debug,\n    };\n    const initialTree =\n      initialEvents && initialEvents.length > 0\n        ? replayEvents(initialEvents, replayOpts)\n        : undefined;\n    storeRef.current = createSessionStore(initialTree, {\n      tierOverrides: _tierOverrides,\n      debug,\n      initialEventCount: initialEvents?.length ?? 0,\n    });\n  }\n  const registryRef = useMemo(() => registry ?? createDefaultRegistry(), [registry]);\n  const busRef = useMemo(\n    () => interactionBus ?? getNoopInteractionBus(),\n    [interactionBus],\n  );\n  const toolDisplayRef = useMemo(\n    () => ({\n      registry: toolDisplayRegistry ?? createDefaultToolRegistry(),\n      defaultBodyMode,\n    }),\n    [toolDisplayRegistry, defaultBodyMode],\n  );\n  const sessionViewRef = useMemo(\n    () => ({\n      ...DEFAULT_SESSION_VIEW_OPTIONS,\n      groupParallelTools,\n      permissionUiMode,\n      verboseReasoning: debug,\n      displayMode,\n      verbose,\n      exploreFullscreenBash,\n      memoryDir,\n      workspaceRoot,\n    }),\n    [\n      groupParallelTools,\n      permissionUiMode,\n      debug,\n      displayMode,\n      verbose,\n      exploreFullscreenBash,\n      memoryDir,\n      workspaceRoot,\n    ],\n  );\n\n  useEffect(() => {\n    const store = storeRef.current!;\n    const controller = new AbortController();\n\n    void source.start((event, ctx) => {\n      store.getState().applyEvent(event, ctx);\n    }, controller.signal).catch((err: unknown) => {\n      const error = err instanceof Error ? err : new Error(String(err));\n      store.getState().markAsError(error);\n      onError?.(error);\n    });\n\n    return () => {\n      controller.abort();\n    };\n  }, [source, onError]);\n\n  return (\n    <SessionStoreContext.Provider value={storeRef.current!}>\n      <InteractionBusContext.Provider value={busRef}>\n        <NodeRegistryContext.Provider value={registryRef}>\n          <MarkdownRendererContext.Provider value={markdownRenderer}>\n            <ToolDisplayOptionsContext.Provider value={toolDisplayRef}>\n              <SessionViewOptionsContext.Provider value={sessionViewRef}>\n                <div className=\"lax-agent-session\" data-testid=\"lax-agent-session\">\n                  {children ?? (\n                    <SessionTimeline\n                      virtualized={virtualized}\n                      virtualizeThreshold={virtualizeThreshold}\n                      groupParallelTools={groupParallelTools}\n                    />\n                  )}\n                  {debug ? <DebugPanel /> : null}\n                </div>\n              </SessionViewOptionsContext.Provider>\n            </ToolDisplayOptionsContext.Provider>\n          </MarkdownRendererContext.Provider>\n        </NodeRegistryContext.Provider>\n      </InteractionBusContext.Provider>\n    </SessionStoreContext.Provider>\n  );\n}\n","import { createStore, type StoreApi } from 'zustand/vanilla';\n\nimport { createEmptyTree, type ReducerError, type SessionTree } from '../types/tree';\nimport type { LangchainAgentEvent, TierOverrides } from '../types/events';\nimport { markEventIdSeen, shouldSkipDuplicateEvent } from './dedupe';\nimport { reduceTree, type ReduceOptions } from './reducer';\nimport type { SourceEventContext } from '../transport/types';\n\nexport interface SessionStoreOptions {\n  tierOverrides?: TierOverrides;\n  debug?: boolean;\n  /** 预灌历史事件数；续流时保证 reducer eventIndex 连续 */\n  initialEventCount?: number;\n  /** 续传恢复：已见过的 SSE id，避免重叠帧重复建节点 */\n  initialSeenEventIds?: Iterable<string>;\n}\n\nexport interface SessionStoreState {\n  tree: SessionTree;\n  eventCount: number;\n  applyEvent: (event: LangchainAgentEvent, ctx?: SourceEventContext) => void;\n  applyEvents: (events: LangchainAgentEvent[]) => void;\n  reset: () => void;\n  markAsError: (error?: Error) => void;\n}\n\nfunction safeReduce(\n  tree: SessionTree,\n  event: LangchainAgentEvent,\n  eventIndex: number,\n  options?: ReduceOptions,\n): { tree: SessionTree; error?: ReducerError } {\n  try {\n    return { tree: reduceTree(tree, event, eventIndex, options) };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    const stack = err instanceof Error ? err.stack : undefined;\n    if (import.meta.env?.DEV) {\n      console.error('[langchain_agentx_stream_ui] reducer error:', err);\n    }\n    return {\n      tree: {\n        ...tree,\n        internalErrors: [\n          ...tree.internalErrors,\n          { eventIndex, eventType: event.event_type, message, stack },\n        ],\n      },\n    };\n  }\n}\n\nexport function createSessionStore(\n  initialTree: SessionTree = createEmptyTree(),\n  storeOptions?: SessionStoreOptions,\n): StoreApi<SessionStoreState> {\n  const reduceOpts: ReduceOptions = {\n    tierOverrides: storeOptions?.tierOverrides,\n    collectDebug: storeOptions?.debug === true,\n  };\n  const initialEventCount = storeOptions?.initialEventCount ?? 0;\n  const seenEventIds = new Set<string>(storeOptions?.initialSeenEventIds);\n  return createStore<SessionStoreState>((set, get) => ({\n    tree: initialTree,\n    eventCount: initialEventCount,\n    applyEvent(event, ctx) {\n      const sseEventId = ctx?.sseEventId;\n      if (shouldSkipDuplicateEvent(seenEventIds, sseEventId)) return;\n\n      const { tree, eventCount } = get();\n      const { tree: reduced } = safeReduce(tree, event, eventCount, reduceOpts);\n      const nextTree: SessionTree =\n        sseEventId\n          ? {\n              ...reduced,\n              meta: { ...reduced.meta, lastEventId: sseEventId },\n            }\n          : reduced;\n      markEventIdSeen(seenEventIds, sseEventId);\n      set({ tree: nextTree, eventCount: eventCount + 1 });\n    },\n    applyEvents(events) {\n      let { tree, eventCount } = get();\n      for (const event of events) {\n        const result = safeReduce(tree, event, eventCount, reduceOpts);\n        tree = result.tree;\n        eventCount += 1;\n      }\n      set({ tree, eventCount });\n    },\n    reset() {\n      seenEventIds.clear();\n      set({ tree: createEmptyTree(), eventCount: 0 });\n    },\n    markAsError(error?: Error) {\n      const { tree } = get();\n      set({\n        tree: {\n          ...tree,\n          status: 'error',\n          internalErrors: error\n            ? [\n                ...tree.internalErrors,\n                {\n                  eventIndex: -1,\n                  eventType: 'sse_connection_failed',\n                  message: error.message,\n                  stack: error.stack,\n                },\n              ]\n            : tree.internalErrors,\n        },\n      });\n    },\n  }));\n}\n\nexport type SessionStore = StoreApi<SessionStoreState>;\n","/**\n * groupParallelTools.ts — 主舞台 Timeline 条目分组（过渡实现）\n *\n * @deprecated Phase 4 由 core/projection GroupedToolUseAccumulator + mountCandidates 替代。\n * 对齐参考：CC GroupedToolUseContent · buildMessageLookups 并行同工具分组语义\n */\nimport type { SessionNode } from '../../types/nodes';\n\nexport type TimelineEntry =\n  | { kind: 'node'; nodeId: string }\n  | { kind: 'tool_group'; toolName: string; nodeIds: string[] };\n\nexport interface BuildTimelineEntriesOptions {\n  /** @deprecated 使用 projection grouped_tool_use；保留至 Phase 4 迁移完成 */\n  groupParallelTools?: boolean;\n  hideStandalonePermissions?: boolean;\n}\n\n/** @deprecated 见 core/projection；Phase 4 删除 */\nexport function buildTimelineEntries(\n  rootIds: string[],\n  byId: Record<string, SessionNode | undefined>,\n  options: BuildTimelineEntriesOptions = {},\n): TimelineEntry[] {\n  const filtered = options.hideStandalonePermissions\n    ? rootIds.filter((id) => byId[id]?.kind !== 'permission')\n    : [...rootIds];\n\n  if (!options.groupParallelTools) {\n    return filtered.map((nodeId) => ({ kind: 'node', nodeId }));\n  }\n\n  const entries: TimelineEntry[] = [];\n  let i = 0;\n\n  while (i < filtered.length) {\n    const id = filtered[i]!;\n    const node = byId[id];\n\n    if (node?.kind !== 'tool_call') {\n      entries.push({ kind: 'node', nodeId: id });\n      i += 1;\n      continue;\n    }\n\n    const toolName = node.toolName;\n    const groupIds = [id];\n    let j = i + 1;\n\n    while (j < filtered.length) {\n      const nextId = filtered[j]!;\n      const next = byId[nextId];\n      if (next?.kind !== 'tool_call' || next.toolName !== toolName) break;\n      groupIds.push(nextId);\n      j += 1;\n    }\n\n    if (groupIds.length >= 2) {\n      entries.push({ kind: 'tool_group', toolName, nodeIds: groupIds });\n    } else {\n      entries.push({ kind: 'node', nodeId: id });\n    }\n\n    i = j;\n  }\n\n  return entries;\n}\n","/**\n * 职责：默认 SubAgentNode 纵向嵌套容器 widget（方案 A 已退场）。\n * 链路位置：宿主可通过 NodeRegistry.register('subagent', SubAgentBlock) 恢复旧行为。\n * 当前裁剪范围：纵向缩进；不含横向并列布局。\n * @deprecated 方案 A 主时间线不再渲染 SubAgentBlock；子 agent progress 折叠在 AgentToolBody。\n */\nimport { useChildren, useNodeTyped } from '../../core/hooks';\nimport { useNodeRegistry } from '../../core/context/SessionContext';\nimport { TimelineItem } from '../Timeline';\n\nexport interface SubAgentBlockProps {\n  nodeId: string;\n}\n\nexport function SubAgentBlock({ nodeId }: SubAgentBlockProps) {\n  const node = useNodeTyped(nodeId, 'subagent');\n  const childIds = useChildren(nodeId);\n  const registry = useNodeRegistry();\n  if (!node) return null;\n\n  return (\n    <div className=\"lax-subagent-block\" data-status={node.status}>\n      <div className=\"lax-subagent-block__header\">SubAgent: {node.subagentId}</div>\n      <div className=\"lax-subagent-block__children\">\n        {childIds.map((childId) => (\n          <TimelineItem key={childId} nodeId={childId} registry={registry} />\n        ))}\n      </div>\n    </div>\n  );\n}\n","/**\n * 职责：浏览器 EventSource 封装，解码 meta/agentx 命名帧并校验协议版本。\n * 链路位置：业务页面 createAgentxSseSource({ url }) → AgentSession source prop。\n * 当前裁剪范围：protocol_version \"1\"；SSE id 行续传；网络错误依赖 EventSource 原生重连（Last-Event-ID）。\n */\nimport type { LangchainAgentEvent } from '../types/events';\nimport type { Source, SourceHandler, SourceEventContext } from './types';\n\nexport const EXPECTED_PROTOCOL_VERSION = '1';\n\nexport interface AgentxSseSourceOptions {\n  url: string;\n  onError?: (error: Error) => void;\n  autoReconnect?: boolean;\n  reconnectDelayMs?: number;\n  /** 每收到 agentx 帧 SSE id 时回调（含续传重叠 id） */\n  onLastEventId?: (id: string) => void;\n  /** 测试注入：替换全局 EventSource */\n  EventSourceImpl?: typeof EventSource;\n}\n\nexport interface AgentxMetaFrame {\n  protocol_version: string;\n  session_id?: string | null;\n  started_at?: number;\n}\n\nfunction defaultOnError(error: Error): void {\n  console.error('[langchain_agentx_stream_ui] SSE error:', error);\n}\n\n/** 手动重连时追加 resume 查询参数（EventSource 无法设 Last-Event-ID 请求头）。 */\nexport function buildResumeStreamUrl(\n  baseUrl: string,\n  lastEventId: string | null | undefined,\n  queryParam = 'last_event_id',\n): string {\n  if (!lastEventId) return baseUrl;\n  const sep = baseUrl.includes('?') ? '&' : '?';\n  return `${baseUrl}${sep}${encodeURIComponent(queryParam)}=${encodeURIComponent(lastEventId)}`;\n}\n\nexport function createAgentxSseSource(options: AgentxSseSourceOptions): Source {\n  const {\n    url,\n    onError = defaultOnError,\n    autoReconnect = true,\n    reconnectDelayMs = 1000,\n    onLastEventId,\n    EventSourceImpl = EventSource,\n  } = options;\n\n  return {\n    start(handler: SourceHandler, signal: AbortSignal): Promise<void> {\n      return new Promise((resolve, reject) => {\n        let es: EventSource | null = null;\n        let handshakeOk = false;\n        let lastEventId: string | null = null;\n        let fatal = false;\n\n        // Delta 合并缓冲：减少高频 text-delta/reasoning-delta 导致的 React 更新频率\n        type BufferedDelta = {\n          event: LangchainAgentEvent;\n          ctx?: SourceEventContext;\n        };\n        let bufferedDelta: BufferedDelta | null = null;\n        let flushTimer: ReturnType<typeof setTimeout> | null = null;\n\n        const flushBufferedDelta = (): void => {\n          if (flushTimer) {\n            clearTimeout(flushTimer);\n            flushTimer = null;\n          }\n          if (!bufferedDelta) return;\n          handler(bufferedDelta.event, bufferedDelta.ctx);\n          bufferedDelta = null;\n        };\n\n        const isBufferedDeltaEvent = (event: LangchainAgentEvent): boolean =>\n          event.event_type === 'text-delta' || event.event_type === 'reasoning-delta';\n\n        const mergeDeltaEvent = (\n          prev: LangchainAgentEvent,\n          next: LangchainAgentEvent,\n        ): LangchainAgentEvent | null => {\n          if (prev.event_type !== next.event_type) return null;\n          if (prev.step_index !== next.step_index) return null;\n          if (prev.tool_name !== next.tool_name) return null;\n          if (prev.session_id !== next.session_id) return null;\n\n          const prevData = prev.data as { delta?: string; text?: string; content?: string };\n          const nextData = next.data as { delta?: string; text?: string; content?: string };\n\n          const prevChunk = prevData.delta ?? prevData.text ?? prevData.content ?? '';\n          const nextChunk = nextData.delta ?? nextData.text ?? nextData.content ?? '';\n\n          return {\n            ...next,\n            data: {\n              ...next.data,\n              text: `${prevChunk}${nextChunk}`,\n            },\n          } as LangchainAgentEvent;\n        };\n\n        const cleanup = (): void => {\n          es?.close();\n          es = null;\n        };\n\n        const finish = (error?: Error): void => {\n          flushBufferedDelta();\n          cleanup();\n          if (error) reject(error); else resolve();\n        };\n\n        const connect = (resumeFromId?: string | null): void => {\n          if (signal.aborted || fatal) {\n            finish();\n            return;\n          }\n\n          const connectUrl =\n            resumeFromId != null && resumeFromId !== ''\n              ? buildResumeStreamUrl(url, resumeFromId)\n              : url;\n\n          es = new EventSourceImpl(connectUrl);\n          handshakeOk = false;\n\n          es.addEventListener('meta', (event: MessageEvent<string>) => {\n            try {\n              const meta = JSON.parse(event.data) as AgentxMetaFrame;\n              if (meta.protocol_version !== EXPECTED_PROTOCOL_VERSION) {\n                fatal = true;\n                const error = new Error(\n                  `Unsupported protocol_version: ${meta.protocol_version}`,\n                );\n                onError(error);\n                cleanup();\n                finish(error);\n                return;\n              }\n              handshakeOk = true;\n            } catch (err) {\n              fatal = true;\n              const error =\n                err instanceof Error ? err : new Error('Failed to decode meta frame');\n              onError(error);\n              cleanup();\n              finish(error);\n            }\n          });\n\n          es.addEventListener('agentx', (event: MessageEvent<string>) => {\n            if (!handshakeOk) {\n              fatal = true;\n              const error = new Error('Received agentx frame before meta handshake');\n              onError(error);\n              cleanup();\n              finish(error);\n              return;\n            }\n            try {\n              const agentEvent = JSON.parse(event.data) as LangchainAgentEvent;\n              const sseEventId = event.lastEventId || undefined;\n              if (sseEventId) {\n                lastEventId = sseEventId;\n                onLastEventId?.(sseEventId);\n              }\n\n              const ctx = sseEventId ? { sseEventId } : undefined;\n\n              // Delta 合并：减少高频流事件导致的 React 更新频率\n              if (isBufferedDeltaEvent(agentEvent)) {\n                if (bufferedDelta) {\n                  const merged = mergeDeltaEvent(bufferedDelta.event, agentEvent);\n                  if (merged) {\n                    bufferedDelta = { event: merged, ctx };\n                  } else {\n                    flushBufferedDelta();\n                    bufferedDelta = { event: agentEvent, ctx };\n                  }\n                } else {\n                  bufferedDelta = { event: agentEvent, ctx };\n                }\n\n                if (!flushTimer) {\n                  flushTimer = setTimeout(() => {\n                    flushBufferedDelta();\n                  }, 16);\n                }\n              } else {\n                flushBufferedDelta();\n                handler(agentEvent, ctx);\n              }\n            } catch (err) {\n              onError(\n                new Error(\n                  err instanceof Error\n                    ? `Failed to decode agentx frame: ${err.message}`\n                    : 'Failed to decode agentx frame',\n                ),\n              );\n            }\n          });\n\n          es.onerror = () => {\n            flushBufferedDelta();\n            if (signal.aborted || fatal) {\n              cleanup();\n              finish();\n              return;\n            }\n            if (!autoReconnect) {\n              fatal = true;\n              const error = new Error('SSE connection error');\n              onError(error);\n              cleanup();\n              finish(error);\n              return;\n            }\n            // 关闭旧连接并以 lastEventId 重连（浏览器原生重连无法注入自定义 EventSourceImpl）\n            cleanup();\n            setTimeout(() => connect(lastEventId), reconnectDelayMs);\n          };\n        };\n\n        signal.addEventListener('abort', () => {\n          flushBufferedDelta();\n          fatal = true;\n          finish();\n        }, { once: true });\n\n        connect();\n      });\n    },\n  };\n}\n\n/** 测试/Story 用：内存事件源 */\nexport function createMockSource(events: LangchainAgentEvent[]): Source {\n  return {\n    async start(handler, signal) {\n      for (const event of events) {\n        if (signal.aborted) break;\n        handler(event);\n      }\n    },\n  };\n}\n","/**\n * 职责：内存事件源，按序投递 events 实现 Source 接口。\n * 链路位置：历史回放、测试、AgentSession 只读时间线。\n * 当前裁剪范围：可选 delayMs 模拟流式；不含 SSE 续传。\n */\nimport type { LangchainAgentEvent } from '../types/events';\nimport type { ReplayOptions } from '../core/replay';\nimport type { Source, SourceHandler } from './types';\n\nexport interface ReplaySourceOptions extends ReplayOptions {\n  /** 事件间隔毫秒；默认 0 立即投递 */\n  delayMs?: number;\n}\n\nfunction sleep(ms: number, signal: AbortSignal): Promise<void> {\n  if (ms <= 0) return Promise.resolve();\n  return new Promise((resolve) => {\n    const timer = setTimeout(resolve, ms);\n    signal.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer);\n        resolve();\n      },\n      { once: true },\n    );\n  });\n}\n\nexport function createReplaySource(\n  events: LangchainAgentEvent[],\n  opts?: ReplaySourceOptions,\n): Source {\n  const delayMs = opts?.delayMs ?? 0;\n\n  return {\n    async start(handler: SourceHandler, signal: AbortSignal): Promise<void> {\n      for (const event of events) {\n        if (signal.aborted) break;\n        handler(event);\n        if (delayMs > 0) {\n          await sleep(delayMs, signal);\n        }\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["jsx","jsxs"]}

package/dist/multi-session-CviqerRl.d.ts

@@ -0,0 +1,494 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ComponentType, ReactNode } from 'react';
+import { a as SessionNodeKind, S as SessionNode, h as ToolCounts } from './nodes-DqhaBW7M.js';
+import { T as ToolDisplayRegistry, P as PermissionUiMode } from './sessionViewOptions-DLSFRQwZ.js';
+import { a as ToolBodyMode } from './types-aXj5TYSP.js';
+import { StoreApi } from 'zustand/vanilla';
+
+/** Common fields on every LangchainAgentEvent (SDK mirror). */
+interface CommonFields {
+    step_index: number | null;
+    tool_name: string | null;
+    session_id: string | null;
+    timestamp: number;
+}
+interface ToolCallData {
+    tool_call_id?: string;
+    input?: unknown;
+    [key: string]: unknown;
+}
+interface ToolResultData {
+    schema_version?: string;
+    status: string;
+    summary: string | null;
+    payload: unknown;
+    display?: unknown;
+    blocks?: unknown[];
+    artifacts?: unknown[];
+    hints?: unknown;
+    meta?: unknown;
+    error?: {
+        message: string;
+        type?: string;
+    } | null;
+    truncated?: boolean;
+    overflow_file?: string | null;
+    tool_name?: string;
+    tool_call_id?: string;
+}
+interface SubagentFoldKeys {
+    tool_call_id: string;
+    agent_id: string;
+    subagent_type?: string;
+    [key: string]: unknown;
+}
+/** SDK 1.2.0 subagent-start / subagent-end boundary payload。 */
+interface SubAgentBoundaryData extends SubagentFoldKeys {
+    tool_name: string;
+    child_session_id?: string;
+}
+/** SDK 1.2.0 subagent-tool-call / subagent-tool-result progress payload。 */
+interface SubagentProgressData extends SubagentFoldKeys {
+    tool_name: string;
+    step?: number;
+    summary?: string;
+    status?: string;
+}
+/** tool-progress：主 agent Bash 等无 agent_id；subagent 冒泡带 agent_id。 */
+interface ToolProgressData {
+    tool_call_id?: string;
+    agent_id?: string;
+    tool_name?: string;
+    phase?: string;
+    current?: number;
+    total?: number;
+    message?: string;
+    data?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface ErrorEventData {
+    /** 薄层 / 协议约定字段 */
+    message?: string;
+    type?: string;
+    source?: string;
+    /** SDK adapter 字段（loop_stream_driver.error_visible 等） */
+    error?: string;
+    error_type?: string;
+    synthetic?: boolean;
+    [key: string]: unknown;
+}
+type LangchainAgentEvent = ({
+    event_type: 'start';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'finish';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'text-start';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'text-delta';
+    data: {
+        delta?: string;
+        text?: string;
+    };
+} & CommonFields) | ({
+    event_type: 'text-end';
+    data: {
+        text?: string;
+    };
+} & CommonFields) | ({
+    event_type: 'reasoning-start';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'reasoning-delta';
+    data: {
+        delta?: string;
+        text?: string;
+    };
+} & CommonFields) | ({
+    event_type: 'reasoning-end';
+    data: {
+        text?: string;
+    };
+} & CommonFields) | ({
+    event_type: 'tool-input';
+    data: ToolCallData & {
+        params?: unknown;
+    };
+} & CommonFields) | ({
+    event_type: 'tool-call';
+    data: ToolCallData;
+} & CommonFields) | ({
+    event_type: 'tool-result';
+    data: ToolResultData;
+} & CommonFields) | ({
+    event_type: 'tool-artifact';
+    data: ToolResultData;
+} & CommonFields) | ({
+    event_type: 'tool-error';
+    data: {
+        message: string;
+        type?: string;
+    };
+} & CommonFields) | ({
+    event_type: 'tool-input-start';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'tool-input-delta';
+    data: {
+        delta: string;
+    };
+} & CommonFields) | ({
+    event_type: 'tool-progress';
+    data: ToolProgressData;
+} & CommonFields) | ({
+    event_type: 'start-step';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'finish-step';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'subagent-start';
+    data: SubAgentBoundaryData;
+} & CommonFields) | ({
+    event_type: 'subagent-end';
+    data: SubAgentBoundaryData;
+} & CommonFields) | ({
+    event_type: 'subagent-tool-call';
+    data: SubagentProgressData;
+} & CommonFields) | ({
+    event_type: 'subagent-tool-result';
+    data: SubagentProgressData;
+} & CommonFields) | ({
+    event_type: 'subagent-model-step';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'hook-progress';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'hook-finished';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'compact-start';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'compact-end';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'task-started';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'task-progress';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'task-notification-enqueued';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'task-notification-consumed';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'task-terminated';
+    data: Record<string, unknown>;
+} & CommonFields) | ({
+    event_type: 'task-list-snapshot';
+    data: TaskListSnapshotData;
+} & CommonFields) | ({
+    event_type: 'error';
+    data: ErrorEventData;
+} & CommonFields) | ({
+    event_type: 'permission-request';
+    data: PermissionRequestData;
+} & CommonFields) | ({
+    event_type: 'memory-saved';
+    data: MemorySavedEventData;
+} & CommonFields) | ({
+    event_type: string;
+    data: Record<string, unknown>;
+} & CommonFields);
+/** SDK MEMORY_SAVED 事件载荷（对齐 CLI MemorySavedSummaryHandler.parse）。 */
+interface MemorySavedEventData {
+    count?: number;
+    written_paths?: string[];
+    display_hint?: string;
+    [key: string]: unknown;
+}
+interface TaskListSnapshotTaskData {
+    id: string;
+    subject?: string;
+    description?: string;
+    status?: string;
+    blocked_by?: string[];
+    blocks?: string[];
+    owner?: string;
+    active_form?: string;
+    metadata?: Record<string, unknown>;
+}
+interface TaskListSnapshotData {
+    tasks: TaskListSnapshotTaskData[];
+    session_id: string;
+    timestamp: number;
+    /** 磁盘 task_list_id；与 UI session_id 可不同（Simple Demo 为 default） */
+    task_list_id?: string;
+}
+interface PermissionRequestData {
+    request_id: string;
+    tool_name?: string;
+    ask_prompt?: string;
+    ask_decision?: {
+        message?: string;
+        behavior?: string;
+    };
+    input_data?: unknown;
+    [key: string]: unknown;
+}
+type EventType = LangchainAgentEvent['event_type'];
+type EventTier = 'main' | 'collapsed' | 'debug' | 'state';
+type TierOverrides = Partial<Record<EventType, Exclude<EventTier, 'state'>>>;
+declare const DEFAULT_EVENT_TIERS: Record<string, EventTier>;
+
+/**
+ * 职责：定义 Source 抽象，解耦 transport 与 React 容器。
+ * 链路位置：AgentSession 消费 Source；createAgentxSseSource 提供 SSE 实现。
+ * 当前裁剪范围：单会话实时流、replay 与 SSE 续传去重。
+ */
+
+interface SourceEventContext {
+    /** SSE 帧 id: 行；续传重叠时用于 store 幂等去重 */
+    sseEventId?: string;
+}
+type SourceHandler = (event: LangchainAgentEvent, ctx?: SourceEventContext) => void;
+interface Source {
+    start(handler: SourceHandler, signal: AbortSignal): Promise<void>;
+}
+
+/**
+ * 职责：kind → React widget 映射，支持 override/register 扩展。
+ * 链路位置：Timeline 按节点 kind 查找 widget；业务通过 override 替换。
+ * 当前裁剪范围：8 类内置 kind + 自定义 register；无插件系统。
+ */
+
+interface NodeWidgetProps {
+    nodeId: string;
+}
+type NodeWidget = ComponentType<NodeWidgetProps>;
+declare class NodeRegistry {
+    private readonly widgets;
+    constructor(widgets: Map<string, NodeWidget>);
+    static default(): NodeRegistry;
+    override(kind: SessionNodeKind | string, widget: NodeWidget): NodeRegistry;
+    register(kind: string, widget: NodeWidget): NodeRegistry;
+    get(kind: string): NodeWidget | undefined;
+    has(kind: string): boolean;
+}
+
+/**
+ * 职责：人类回写薄层 API；PermissionNode 触发，业务实现 HTTP 回写。
+ * 链路位置：AgentSession interactionBus prop → PermissionNode 按钮。
+ * 当前裁剪范围：permission resolve；不含 HITL 表单协议。
+ */
+interface PermissionResolvePayload {
+    requestId: string;
+    allow: boolean;
+    message?: string;
+}
+interface InteractionBus {
+    resolvePermission: (payload: PermissionResolvePayload) => void | Promise<void>;
+}
+interface InteractionBusHandlers {
+    onPermissionResolve?: (payload: PermissionResolvePayload) => void | Promise<void>;
+}
+declare function createInteractionBus(handlers?: InteractionBusHandlers): InteractionBus;
+declare function getNoopInteractionBus(): InteractionBus;
+
+interface MarkdownRendererProps {
+    content: string;
+    className?: string;
+}
+type MarkdownRenderer = (props: MarkdownRendererProps) => ReactNode;
+
+interface MultiSessionSourceConfig {
+    sessionId: string;
+    source: Source;
+    /** EventBuffer ingest 快照或历史事件；挂载时 replay 后再接 source 续流（M3） */
+    initialEvents?: LangchainAgentEvent[];
+}
+interface MultiAgentSessionProps {
+    sessions: MultiSessionSourceConfig[];
+    /** 受控活跃 session */
+    activeSessionId?: string | null;
+    /** 非受控默认活跃 session */
+    defaultActiveSessionId?: string | null;
+    onActiveSessionChange?: (sessionId: string | null) => void;
+    maxSessions?: number;
+    tierOverrides?: TierOverrides;
+    debug?: boolean;
+    registry?: NodeRegistry;
+    onError?: (error: Error, sessionId: string) => void;
+    virtualized?: boolean;
+    virtualizeThreshold?: number;
+    interactionBus?: InteractionBus;
+    toolDisplayRegistry?: ToolDisplayRegistry;
+    defaultBodyMode?: ToolBodyMode;
+    groupParallelTools?: boolean;
+    permissionUiMode?: PermissionUiMode;
+    markdownRenderer?: MarkdownRenderer;
+    children?: ReactNode;
+}
+declare function MultiAgentSession({ sessions, activeSessionId: controlledActiveId, defaultActiveSessionId, onActiveSessionChange, maxSessions, tierOverrides, debug, registry, onError, virtualized, virtualizeThreshold, interactionBus, toolDisplayRegistry, defaultBodyMode, groupParallelTools, permissionUiMode, markdownRenderer, children, }: MultiAgentSessionProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * 任务类型定义（对齐 CC tasks.ts）
+ */
+type TaskStatus = 'pending' | 'in_progress' | 'completed';
+interface Task {
+    id: string;
+    subject: string;
+    description?: string;
+    activeForm?: string;
+    owner?: string;
+    status: TaskStatus;
+    blocks: string[];
+    blockedBy: string[];
+    metadata?: Record<string, unknown>;
+    startedAt?: number;
+    completedAt?: number;
+}
+
+type SessionStatus = 'connecting' | 'running' | 'done' | 'error';
+/** 任务列表可见性阶段（对齐 CC / 设计文档 §3.2.3） */
+type TaskPhase = 'hidden' | 'visible' | 'hidden-after-completion';
+interface ReducerError {
+    eventIndex: number;
+    eventType: string;
+    message: string;
+    stack?: string;
+}
+interface SessionTree {
+    rootChildren: string[];
+    byId: Record<string, SessionNode>;
+    openSubAgentStack: string[];
+    status: SessionStatus;
+    meta: {
+        sessionId: string | null;
+        startedAt: number | null;
+        lastEventId: string | null;
+    };
+    internalErrors: ReducerError[];
+    debugEvents: {
+        eventIndex: number;
+        eventType: string;
+        data: unknown;
+    }[];
+    /** hook-finished / compact-* 等；供 projection system_summary，不进入主舞台 Unknown */
+    systemEvents: {
+        eventIndex: number;
+        eventType: string;
+        data: unknown;
+        timestamp: number;
+    }[];
+    /** step:name → 下一 seq；无 tool_call_id 时分配 tool:step:name:seq */
+    toolSeqCounters: Record<string, number>;
+    /** step:name → 当前进行中的 tool 节点 id（result 后清除） */
+    activeToolByStepName: Record<string, string>;
+    /** 当前活跃的 thinking 轮次 ID */
+    activeRoundId: string | null;
+    /** 已完成的轮次摘要（用于回溯显示） */
+    roundSummaries: RoundSummary[];
+    /** 任务列表（由 task-list-snapshot 驱动） */
+    tasks: Record<string, Task>;
+    /** 任务列表可见阶段 */
+    taskPhase: TaskPhase;
+    /** 本轮是否曾显示过任务列表 */
+    hasEverShownTaskList: boolean;
+    /** 全部任务完成后等待最终主输出 */
+    waitingForFinalResponseAfterTasks: boolean;
+    /** 首个任务快照时间（毫秒） */
+    taskStartTime: number | null;
+    /** Hook 进度跟踪（对齐 CC stopHookSpinnerSuffix） */
+    hookProgress: {
+        /** 当前正在执行的 hook toolUseID */
+        currentToolUseID: string | null;
+        /** Hook 总数 */
+        total: number;
+        /** 已完成数 */
+        completed: number;
+        /** 自定义状态消息 */
+        customMessage: string | null;
+    };
+}
+/** 轮次摘要记录 */
+interface RoundSummary {
+    roundId: string;
+    reasoningNodeId: string;
+    exploreNodeId: string | null;
+    summaryNodeId: string | null;
+    startedAt: number;
+    endedAt: number;
+    toolCounts: ToolCounts;
+}
+declare function createEmptyTree(): SessionTree;
+
+interface SessionStoreOptions {
+    tierOverrides?: TierOverrides;
+    debug?: boolean;
+    /** 预灌历史事件数；续流时保证 reducer eventIndex 连续 */
+    initialEventCount?: number;
+    /** 续传恢复：已见过的 SSE id，避免重叠帧重复建节点 */
+    initialSeenEventIds?: Iterable<string>;
+}
+interface SessionStoreState {
+    tree: SessionTree;
+    eventCount: number;
+    applyEvent: (event: LangchainAgentEvent, ctx?: SourceEventContext) => void;
+    applyEvents: (events: LangchainAgentEvent[]) => void;
+    reset: () => void;
+    markAsError: (error?: Error) => void;
+}
+declare function createSessionStore(initialTree?: SessionTree, storeOptions?: SessionStoreOptions): StoreApi<SessionStoreState>;
+type SessionStore = StoreApi<SessionStoreState>;
+
+/**
+ * 职责：多会话顶层 store，按 sessionId 路由事件到独立 SessionTree。
+ * 链路位置：MultiAgentSession 消费；业务也可直接 createMultiSessionStore。
+ * 当前裁剪范围：进程内 LRU（默认 10）；不含 Source 生命周期管理。
+ */
+
+interface SessionSlice {
+    tree: SessionTree;
+    eventCount: number;
+}
+interface MultiSessionStoreOptions {
+    maxSessions?: number;
+    tierOverrides?: TierOverrides;
+    debug?: boolean;
+    /** 初始活跃 session；默认 null */
+    activeSessionId?: string | null;
+}
+interface MultiSessionStoreState {
+    sessions: Record<string, SessionSlice>;
+    activeSessionId: string | null;
+    order: string[];
+    applyEvent: (sessionId: string, event: LangchainAgentEvent, ctx?: SourceEventContext) => void;
+    applyEvents: (sessionId: string, events: LangchainAgentEvent[]) => void;
+    setActiveSessionId: (id: string | null) => void;
+    removeSession: (id: string) => void;
+    replaySession: (sessionId: string, events: LangchainAgentEvent[]) => void;
+    ensureSession: (sessionId: string, initialEvents?: LangchainAgentEvent[]) => void;
+    getSessionTree: (sessionId: string) => SessionTree | undefined;
+}
+declare function createMultiSessionStore(options?: MultiSessionStoreOptions): StoreApi<MultiSessionStoreState>;
+type MultiSessionStore = StoreApi<MultiSessionStoreState>;
+/** 将 MultiSessionStore 活跃会话投影为 SessionStore，供 Timeline hooks 复用。 */
+declare function createActiveSessionBridge(multiStore: MultiSessionStore): StoreApi<SessionStoreState>;
+
+interface ActiveSessionView {
+    activeSessionId: string | null;
+    tree: SessionTree;
+    setActiveSessionId: MultiSessionStoreState['setActiveSessionId'];
+}
+declare function useActiveSession(): ActiveSessionView;
+
+declare function useSessionIds(): string[];
+
+export { createSessionStore as A, getNoopInteractionBus as B, type CommonFields as C, DEFAULT_EVENT_TIERS as D, type EventTier as E, useActiveSession as F, useSessionIds as G, type InteractionBus as I, type LangchainAgentEvent as L, type MarkdownRenderer as M, NodeRegistry as N, type PermissionResolvePayload as P, type ReducerError as R, type SessionSlice as S, type Task as T, type EventType as a, type InteractionBusHandlers as b, type MarkdownRendererProps as c, MultiAgentSession as d, type MultiAgentSessionProps as e, type MultiSessionSourceConfig as f, type MultiSessionStore as g, type MultiSessionStoreOptions as h, type MultiSessionStoreState as i, type NodeWidget as j, type NodeWidgetProps as k, type SessionStatus as l, type SessionStore as m, type SessionStoreOptions as n, type SessionStoreState as o, type SessionTree as p, type Source as q, type SourceEventContext as r, type SourceHandler as s, type TaskPhase as t, type TaskStatus as u, type TierOverrides as v, createActiveSessionBridge as w, createEmptyTree as x, createInteractionBus as y, createMultiSessionStore as z };

package/dist/multi-session.d.ts

@@ -0,0 +1,7 @@
+export { d as MultiAgentSession, e as MultiAgentSessionProps, f as MultiSessionSourceConfig, g as MultiSessionStore, h as MultiSessionStoreOptions, i as MultiSessionStoreState, S as SessionSlice, w as createActiveSessionBridge, z as createMultiSessionStore, F as useActiveSession, G as useSessionIds } from './multi-session-CviqerRl.js';
+import 'react/jsx-runtime';
+import 'react';
+import './nodes-DqhaBW7M.js';
+import './sessionViewOptions-DLSFRQwZ.js';
+import './types-aXj5TYSP.js';
+import 'zustand/vanilla';

package/dist/multi-session.js

@@ -0,0 +1,21 @@
+import {
+  MultiAgentSession,
+  createActiveSessionBridge,
+  createMultiSessionStore
+} from "./chunk-W6QQHTJ4.js";
+import "./chunk-WM6Y6APP.js";
+import "./chunk-DP7V33X7.js";
+import {
+  useActiveSession,
+  useSessionIds
+} from "./chunk-G2KYJCMM.js";
+import "./chunk-MHK53ZHC.js";
+import "./chunk-4RIOBLGB.js";
+export {
+  MultiAgentSession,
+  createActiveSessionBridge,
+  createMultiSessionStore,
+  useActiveSession,
+  useSessionIds
+};
+//# sourceMappingURL=multi-session.js.map

package/dist/multi-session.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}