@brainpilot/web 0.0.3 → 0.0.5

package/src/contracts/demoBundle.ts

@@ -0,0 +1,83 @@
+import { AgentStatus, ChatMessage, TraceGraph } from "./backend";
+
+/**
+ * Portable "live demo" bundle — a single self-contained JSON file capturing a
+ * session's conversation, reasoning/trace graph, and produced files so it can be
+ * shared and replayed offline (in-app import). See the demo player in
+ * components/demo/DemoView.tsx.
+ */
+
+export const DEMO_BUNDLE_FORMAT = "neuro-demo-bundle";
+export const DEMO_BUNDLE_VERSION = 1;
+
+/** Per-file embed cap (original bytes). Larger files are recorded but skipped. */
+export const MAX_FILE_BYTES = 2 * 1024 * 1024;
+/** Total embed budget, counted on encoded (base64/utf8) length. */
+export const MAX_TOTAL_BYTES = 25 * 1024 * 1024;
+
+/** A raw AG-UI event line from frontend_events.jsonl, carrying a real `_ts`. */
+export interface RawAgUiEvent {
+  _ts?: string | number;
+  type: string;
+  [key: string]: unknown;
+}
+
+export interface DemoFile {
+  /** Workspace-relative path, e.g. "results/fig1.png". */
+  path: string;
+  /** Best-effort MIME from the extension. */
+  mime: string;
+  encoding: "utf8" | "base64";
+  /** Original byte size. */
+  size: number;
+  /** True when the file was not embedded (too large, over budget, or unreadable). */
+  truncated: boolean;
+  /** Why it was not embedded — distinguishes a real size cap from a read failure. */
+  reason?: "tooLarge" | "unreadable";
+  /** Human-readable detail for `reason: "unreadable"` (e.g. the backend error). */
+  detail?: string;
+  /** Omitted when truncated. */
+  data?: string;
+}
+
+export interface DemoBundle {
+  format: typeof DEMO_BUNDLE_FORMAT;
+  version: number;
+  exportedAt: string;
+  appVersion?: string;
+  /** "timestamped" = real `events`; "ordered" = pre-folded `messages` fallback. */
+  timeline: "timestamped" | "ordered";
+
+  session: {
+    id: string;
+    title: string;
+    createdAt?: string;
+    updatedAt?: string;
+  };
+
+  /** Present iff timeline === "timestamped". Folded by the player at replay. */
+  events?: RawAgUiEvent[];
+  /** Present iff timeline === "ordered". Already folded ChatMessages. */
+  messages?: ChatMessage[];
+
+  trace: TraceGraph;
+  agents: AgentStatus[];
+  files: DemoFile[];
+}
+
+/** Runtime validation for imported bundles. */
+export function isDemoBundle(value: unknown): value is DemoBundle {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const v = value as Record<string, unknown>;
+  return (
+    v.format === DEMO_BUNDLE_FORMAT &&
+    typeof v.version === "number" &&
+    typeof v.session === "object" &&
+    v.session !== null &&
+    typeof v.trace === "object" &&
+    v.trace !== null &&
+    Array.isArray(v.files)
+  );
+}

package/src/i18n/messages/analytics.ts

@@ -0,0 +1,96 @@
+import { defineMessages } from "../types";
+
+export default defineMessages(
+  {
+    // AnalyticsTab
+    "analytics.empty": "暂无数据。Agent 开始通信后这里会出现统计图表。",
+    "analytics.card.totalMessages": "消息总数",
+    "analytics.card.activeAgents": "活跃 Agent",
+    "analytics.card.runningNow": "{count} 个正在运行",
+    "analytics.card.avgLatency": "平均延迟",
+    "analytics.card.median": "中位数 {value}",
+    "analytics.card.noPairs": "暂无配对",
+    "analytics.card.errors": "错误",
+    "analytics.card.allClear": "一切正常",
+    "analytics.card.needsAttention": "需要关注",
+    "analytics.chart.volume": "消息量（最近一小时）",
+    "analytics.chart.load": "Agent 负载",
+    "analytics.chart.types": "消息类型",
+    "analytics.chart.latency": "响应延迟",
+    "analytics.chart.tokens": "Token 估算（已发送）",
+    "analytics.chart.heatmap": "活动热力图",
+    "analytics.table.agent": "Agent",
+    "analytics.table.msgs": "消息数",
+    "analytics.table.avgLen": "平均长度",
+    "analytics.table.tokens": "~Token",
+    "analytics.aria.volume": "消息量随时间变化",
+    "analytics.aria.load": "Agent 负载分布",
+    "analytics.aria.types": "消息类型分布",
+    "analytics.aria.latency": "响应延迟箱线图",
+    "analytics.aria.heatmap": "Agent 活动热力图",
+    // TimelineTab
+    "timeline.empty": "暂无消息。Agent 开始通信后这里会出现时间轴。",
+    "timeline.fit": "适应",
+    "timeline.filter.delegate": "委派",
+    "timeline.filter.result": "结果",
+    "timeline.filter.other": "其他",
+    "timeline.aria": "消息时间轴",
+    "overview.title": "会话概览",
+    "overview.agents": "Agent",
+    "overview.liveDormant": "{live} 在线 · {dormant} 休眠",
+    "overview.total": "共 {total} 个",
+    "overview.runningNow": "正在运行",
+    "overview.messages": "消息",
+    "overview.acrossLinks": "跨 {count} 条连接",
+    "overview.avgResponse": "平均响应",
+    "overview.median": "中位数 {value}",
+    "overview.lastActivity": "最近活动",
+    "overview.tipPrefix": "点击节点或消息链接查看详情，或切换到 ",
+    "overview.tipSuffix": " 获取更深入的洞察。",
+  },
+  {
+    "analytics.empty": "No data yet. Charts will appear here once agents start communicating.",
+    "analytics.card.totalMessages": "Total messages",
+    "analytics.card.activeAgents": "Active agents",
+    "analytics.card.runningNow": "{count} running now",
+    "analytics.card.avgLatency": "Avg latency",
+    "analytics.card.median": "median {value}",
+    "analytics.card.noPairs": "no pairs yet",
+    "analytics.card.errors": "Errors",
+    "analytics.card.allClear": "all clear",
+    "analytics.card.needsAttention": "needs attention",
+    "analytics.chart.volume": "Message volume (last hour)",
+    "analytics.chart.load": "Agent load",
+    "analytics.chart.types": "Message types",
+    "analytics.chart.latency": "Response latency",
+    "analytics.chart.tokens": "Token estimate (sent)",
+    "analytics.chart.heatmap": "Activity heatmap",
+    "analytics.table.agent": "Agent",
+    "analytics.table.msgs": "Msgs",
+    "analytics.table.avgLen": "Avg len",
+    "analytics.table.tokens": "~Tokens",
+    "analytics.aria.volume": "Message volume over time",
+    "analytics.aria.load": "Agent load distribution",
+    "analytics.aria.types": "Message type distribution",
+    "analytics.aria.latency": "Response latency box plot",
+    "analytics.aria.heatmap": "Agent activity heatmap",
+    "timeline.empty": "No messages yet. A timeline will appear here once agents start communicating.",
+    "timeline.fit": "Fit",
+    "timeline.filter.delegate": "delegate",
+    "timeline.filter.result": "result",
+    "timeline.filter.other": "other",
+    "timeline.aria": "Message timeline",
+    "overview.title": "Session Overview",
+    "overview.agents": "Agents",
+    "overview.liveDormant": "{live} live · {dormant} dormant",
+    "overview.total": "{total} total",
+    "overview.runningNow": "Running now",
+    "overview.messages": "Messages",
+    "overview.acrossLinks": "across {count} links",
+    "overview.avgResponse": "Avg response",
+    "overview.median": "median {value}",
+    "overview.lastActivity": "Last activity",
+    "overview.tipPrefix": "Click a node or message link for details, or switch to ",
+    "overview.tipSuffix": " for deeper insights.",
+  },
+);

package/src/i18n/messages/chat.ts

@@ -0,0 +1,108 @@
+import { defineMessages } from "../types";
+
+export default defineMessages(
+  {
+    "chat.generating": "正在生成...",
+    "chat.totalTime": "本轮对话用时 {time}",
+    "chat.streaming": "生成中",
+    "chat.toolPrefix": "工具：{name}",
+    "chat.thinkingSteps": "思考过程 · {count} 步",
+    "chat.toolCall": "调用工具：{name}",
+    "chat.thinking": "思考中…",
+    "chat.heading": "要在 BrainPilot 中研究什么？",
+    "chat.aria.messages": "对话消息",
+    "chat.messageCount": "{count} 条消息",
+    "chat.aria.expandThinking": "展开思考过程",
+    "chat.agentThinking": "智能体思考中",
+    "chat.aria.stop": "停止生成",
+    "chat.stop": "停止",
+    "chat.aria.newPrompt": "新的研究提问",
+    "chat.srAsk": "提出一个研究问题",
+    "chat.placeholder": "向 MAS 提问。输入 @ 使用插件或提及文件",
+    "chat.aria.attachContext": "添加上下文",
+    "chat.command": "命令",
+    "chat.modelPlaceholder": "模型",
+    "chat.aria.voice": "语音输入",
+    "chat.aria.attachFile": "添加文件",
+    "chat.aria.send": "发送消息",
+    "chat.copy": "复制",
+    "chat.copied": "已复制",
+    "chat.aria.copyMessage": "复制消息",
+    "chat.aria.suggested": "推荐研究任务",
+    "chat.noActiveProvider": "无活动服务商",
+    "chat.providerTitle": "服务商：{name}",
+    "chat.status.startSandbox": "请先启动 sandbox。",
+    "chat.status.preparing": "正在准备发送。",
+    "chat.status.connecting": "正在连接实时通道。",
+    "chat.error.saveModel": "保存模型选择失败：{msg}",
+    "chat.error.reloadConfig": "模型已保存，但容器热更新失败：{msg}",
+    "chat.system.info": "信息",
+    "chat.system.warning": "警告",
+    "chat.system.error": "错误",
+    "chat.system.fatal": "严重错误",
+    "chat.system.details": "技术详情",
+    "chat.ask.title": "需要你的输入",
+    "chat.ask.freeTextPlaceholder": "输入你的回答…",
+    "chat.ask.submit": "提交",
+    "chat.ask.answered": "已回答：{answer}",
+    "chat.ask.timeoutLeft": "剩余 {sec} 秒",
+    "chat.ask.timedOut": "已超时",
+    "chat.retry.title": "自动重试中",
+    "chat.retry.attempt": "第 {attempt}/{max} 次尝试",
+    "chat.retry.countdown": "{sec} 秒后重试",
+    "chat.retry.cancel": "取消",
+    "chat.retry.cancelled": "已取消重试",
+  },
+  {
+    "chat.generating": "Generating...",
+    "chat.totalTime": "Total time: {time}",
+    "chat.streaming": "streaming",
+    "chat.toolPrefix": "Tool: {name}",
+    "chat.thinkingSteps": "Thinking · {count} steps",
+    "chat.toolCall": "Calling tool: {name}",
+    "chat.thinking": "Thinking…",
+    "chat.heading": "What would you like to research in BrainPilot?",
+    "chat.aria.messages": "Conversation messages",
+    "chat.messageCount": "{count} messages",
+    "chat.aria.expandThinking": "Expand thinking process",
+    "chat.agentThinking": "Agent is thinking",
+    "chat.aria.stop": "Stop generating",
+    "chat.stop": "stop",
+    "chat.aria.newPrompt": "New research prompt",
+    "chat.srAsk": "Ask a research question",
+    "chat.placeholder": "Ask MAS. Type @ to use plugins or mention files",
+    "chat.aria.attachContext": "Attach context",
+    "chat.command": "command",
+    "chat.modelPlaceholder": "Model",
+    "chat.aria.voice": "Voice input",
+    "chat.aria.attachFile": "Attach file",
+    "chat.aria.send": "Send message",
+    "chat.copy": "Copy",
+    "chat.copied": "Copied",
+    "chat.aria.copyMessage": "Copy message",
+    "chat.aria.suggested": "Suggested research tasks",
+    "chat.noActiveProvider": "No active provider",
+    "chat.providerTitle": "Provider: {name}",
+    "chat.status.startSandbox": "Please start the sandbox first.",
+    "chat.status.preparing": "Preparing to send.",
+    "chat.status.connecting": "Connecting to the live channel.",
+    "chat.error.saveModel": "Failed to save model selection: {msg}",
+    "chat.error.reloadConfig": "Model saved, but container hot-reload failed: {msg}",
+    "chat.system.info": "Info",
+    "chat.system.warning": "Warning",
+    "chat.system.error": "Error",
+    "chat.system.fatal": "Fatal error",
+    "chat.system.details": "Technical details",
+    "chat.ask.title": "Your input is needed",
+    "chat.ask.freeTextPlaceholder": "Type your answer…",
+    "chat.ask.submit": "Submit",
+    "chat.ask.answered": "Answered: {answer}",
+    "chat.ask.timeoutLeft": "{sec}s left",
+    "chat.ask.timedOut": "Timed out",
+    "chat.retry.title": "Auto-retrying",
+    "chat.retry.attempt": "Attempt {attempt}/{max}",
+    "chat.retry.countdown": "Retrying in {sec}s",
+    "chat.retry.cancel": "Cancel",
+    "chat.retry.cancelled": "Retry cancelled",
+  },
+);

package/src/i18n/messages/contexts.ts

@@ -0,0 +1,40 @@
+import { defineMessages } from "../types";
+
+export default defineMessages(
+  {
+    "ctx.session.loadFailed": "加载会话失败",
+    "ctx.session.updateFailed": "更新会话失败",
+    "ctx.session.deleteFailed": "删除会话失败",
+    "ctx.session.startSandbox": "请先启动 sandbox",
+    "ctx.session.createFailed": "创建会话失败",
+    "ctx.session.newSession": "新研究会话",
+    "ctx.session.noConnection": "实时连接尚未建立",
+    "ctx.session.sendFailed": "发送失败",
+    "ctx.session.interruptFailed": "中断失败",
+    "ctx.session.refreshFailed": "刷新消息失败",
+    "ctx.sandbox.loadFailed": "加载沙箱失败",
+    "ctx.sandbox.createFailed": "创建沙箱失败",
+    "ctx.sandbox.rebuildFailed": "重建沙箱失败",
+    "ctx.sandbox.deleteFailed": "删除沙箱失败",
+    "ctx.sandbox.reloadFailed": "热更新失败",
+    "ctx.sse.parseError": "无法解析 SSE 事件",
+  },
+  {
+    "ctx.session.loadFailed": "Failed to load sessions",
+    "ctx.session.updateFailed": "Failed to update session",
+    "ctx.session.deleteFailed": "Failed to delete session",
+    "ctx.session.startSandbox": "Please start the sandbox first",
+    "ctx.session.createFailed": "Failed to create session",
+    "ctx.session.newSession": "New research session",
+    "ctx.session.noConnection": "Live connection not established yet",
+    "ctx.session.sendFailed": "Failed to send",
+    "ctx.session.interruptFailed": "Failed to interrupt",
+    "ctx.session.refreshFailed": "Failed to refresh messages",
+    "ctx.sandbox.loadFailed": "Failed to load sandbox",
+    "ctx.sandbox.createFailed": "Failed to create sandbox",
+    "ctx.sandbox.rebuildFailed": "Failed to rebuild sandbox",
+    "ctx.sandbox.deleteFailed": "Failed to delete sandbox",
+    "ctx.sandbox.reloadFailed": "Hot-reload failed",
+    "ctx.sse.parseError": "Unable to parse SSE event",
+  },
+);

package/src/i18n/messages/demo.ts

@@ -0,0 +1,80 @@
+import { defineMessages } from "../types";
+
+export default defineMessages(
+  {
+    "demo.title": "Live Demo",
+    "demo.eyebrow": "推理过程回放",
+    "demo.landing.heading": "生成或导入一个 Live Demo",
+    "demo.landing.subtitle": "把一次对话打包成可分享的回放,或导入他人分享的 demo。",
+    "demo.landing.fromSession.title": "从已有对话生成",
+    "demo.landing.fromSession.desc": "选择一个会话,打包对话、推理图与产出文件。",
+    "demo.landing.fromSession.empty": "暂无会话",
+    "demo.landing.import.title": "导入本地文件",
+    "demo.landing.import.desc": "打开一个 .json demo 文件进行离线回放。",
+    "demo.landing.import.button": "点击选择文件",
+    "demo.landing.import.dropHint": "或将 .json 文件拖到此处",
+    "demo.packing": "正在打包…",
+    "demo.exportButton": "导出 Live Demo",
+    "demo.reselect": "重新选择",
+    "demo.error.build": "生成 demo 失败",
+    "demo.error.parse": "无法读取该文件",
+    "demo.files.title": "产出文件",
+    "demo.files.empty": "本 demo 未包含文件",
+    "demo.files.skipped": "已跳过(过大)",
+    "demo.files.unreadable": "读取失败",
+    "demo.files.noSandbox": "打包时无运行中的沙箱,文件未嵌入",
+    "demo.files.none": "选择一个文件以预览",
+    "demo.tree.title": "文件树",
+    "demo.trace.title": "推理图",
+    "demo.conversation.title": "对话",
+    "demo.conversation.empty": "回放到此处尚无对话内容。",
+    "demo.transport.play": "播放",
+    "demo.transport.pause": "暂停",
+    "demo.transport.prev": "上一步",
+    "demo.transport.next": "下一步",
+    "demo.transport.restart": "重新开始",
+    "demo.transport.speed": "速度",
+    "demo.transport.step": "第 {index}/{total} 步",
+    "demo.node.modalClose": "关闭",
+    "demo.meta.exported": "导出于 {time}",
+    "demo.meta.steps": "{visible} / {total} 节点",
+  },
+  {
+    "demo.title": "Live Demo",
+    "demo.eyebrow": "Reasoning replay",
+    "demo.landing.heading": "Generate or import a Live Demo",
+    "demo.landing.subtitle": "Package a conversation into a shareable replay, or import one shared with you.",
+    "demo.landing.fromSession.title": "Generate from a conversation",
+    "demo.landing.fromSession.desc": "Pick a session to package its conversation, reasoning graph, and produced files.",
+    "demo.landing.fromSession.empty": "No conversations yet",
+    "demo.landing.import.title": "Import a local file",
+    "demo.landing.import.desc": "Open a .json demo file for offline replay.",
+    "demo.landing.import.button": "Click to choose a file",
+    "demo.landing.import.dropHint": "or drag a .json file here",
+    "demo.packing": "Packing…",
+    "demo.exportButton": "Export Live Demo",
+    "demo.reselect": "Start over",
+    "demo.error.build": "Failed to generate demo",
+    "demo.error.parse": "Could not read that file",
+    "demo.files.title": "Produced files",
+    "demo.files.empty": "This demo contains no files",
+    "demo.files.skipped": "skipped (too large)",
+    "demo.files.unreadable": "unreadable",
+    "demo.files.noSandbox": "No running sandbox at pack time; files not embedded",
+    "demo.files.none": "Select a file to preview",
+    "demo.tree.title": "Files",
+    "demo.trace.title": "Reasoning graph",
+    "demo.conversation.title": "Conversation",
+    "demo.conversation.empty": "No conversation revealed at this point yet.",
+    "demo.transport.play": "Play",
+    "demo.transport.pause": "Pause",
+    "demo.transport.prev": "Previous step",
+    "demo.transport.next": "Next step",
+    "demo.transport.restart": "Restart",
+    "demo.transport.speed": "Speed",
+    "demo.transport.step": "Step {index}/{total}",
+    "demo.node.modalClose": "Close",
+    "demo.meta.exported": "Exported {time}",
+    "demo.meta.steps": "{visible} / {total} nodes",
+  },
+);

package/src/i18n/messages/files.ts

@@ -0,0 +1,82 @@
+import { defineMessages } from "../types";
+
+export default defineMessages(
+  {
+    "files.aria.sidebar": "工作区文件",
+    "files.aria.resizeSidebar": "调整文件栏宽度",
+    "files.eyebrow.workspace": "工作区",
+    "files.title": "文件",
+    "files.selectedCount": "已选 {count} 个",
+    "files.packing": "打包中",
+    "files.download": "下载",
+    "files.aria.clearSelection": "清除文件选择",
+    "files.aria.refresh": "刷新文件",
+    "files.aria.close": "关闭文件",
+    "files.live": "实时后端",
+    "files.offline": "沙盒离线",
+    "files.aria.tree": "文件树",
+    "files.selectForDownload": "选择 {name} 以下载",
+    "files.error.notRunning": "Sandbox 未运行，无法读取文件。",
+    "files.error.downloadFailed": "下载文件失败",
+    "files.error.refreshFailed": "刷新文件失败",
+    "files.error.previewFailed": "无法预览文件",
+    "files.error.loadPreviewFailed": "无法加载文件预览",
+    "files.preview.aria": "文件预览",
+    "files.preview.ariaResize": "调整预览宽度",
+    "files.preview.eyebrow": "预览",
+    "files.preview.downloading": "下载中",
+    "files.preview.download": "下载",
+    "files.preview.restore": "还原预览",
+    "files.preview.maximize": "最大化预览",
+    "files.preview.close": "关闭预览",
+    "files.preview.path": "路径",
+    "files.preview.size": "大小",
+    "files.preview.modified": "修改时间",
+    "files.preview.mode": "权限",
+    "files.preview.tooLarge": "该文件超过内嵌预览大小上限，可下载后查看。",
+    "files.preview.unreadable": "打包时无法读取该文件（可能路径无效或不在当前沙箱中）。",
+    "files.preview.loadingImage": "正在加载图片…",
+    "files.preview.loadingPdf": "正在加载 PDF…",
+    "files.preview.notPreviewable": "该文件类型可下载，但不支持内嵌预览。",
+    "files.preview.loading": "正在加载预览…",
+  },
+  {
+    "files.aria.sidebar": "Workspace files",
+    "files.aria.resizeSidebar": "Resize files sidebar",
+    "files.eyebrow.workspace": "Workspace",
+    "files.title": "Files",
+    "files.selectedCount": "{count} selected",
+    "files.packing": "Packing",
+    "files.download": "Download",
+    "files.aria.clearSelection": "Clear file selection",
+    "files.aria.refresh": "Refresh files",
+    "files.aria.close": "Close files",
+    "files.live": "live backend",
+    "files.offline": "sandbox offline",
+    "files.aria.tree": "File tree",
+    "files.selectForDownload": "Select {name} for download",
+    "files.error.notRunning": "Sandbox is not running; cannot read files.",
+    "files.error.downloadFailed": "Failed to download file",
+    "files.error.refreshFailed": "Failed to refresh files",
+    "files.error.previewFailed": "Unable to preview file",
+    "files.error.loadPreviewFailed": "Unable to load file preview",
+    "files.preview.aria": "File preview",
+    "files.preview.ariaResize": "Resize file preview",
+    "files.preview.eyebrow": "Preview",
+    "files.preview.downloading": "Downloading",
+    "files.preview.download": "Download",
+    "files.preview.restore": "Restore preview",
+    "files.preview.maximize": "Maximize preview",
+    "files.preview.close": "Close preview",
+    "files.preview.path": "Path",
+    "files.preview.size": "Size",
+    "files.preview.modified": "Modified",
+    "files.preview.mode": "Mode",
+    "files.preview.tooLarge": "This file is larger than the inline preview limit; download it to view.",
+    "files.preview.unreadable": "This file could not be read when the demo was packaged (path invalid or not in the current sandbox).",
+    "files.preview.loadingImage": "Loading image...",
+    "files.preview.loadingPdf": "Loading PDF...",
+    "files.preview.notPreviewable": "This file type is available for download but is not previewed inline.",
+    "files.preview.loading": "Loading preview...",
+  },
+);