nolo-cli 0.1.26 → 0.1.29

package/chat/messages/types.ts

@@ -0,0 +1,176 @@
+// 文件路径: chat/messages/types.ts
+
+// ========== 角色 ==========
+export type MessageRole = "user" | "system" | "assistant" | "tool";
+
+// ========== OpenAI 风格的 content ==========
+export type OpenAIImageUrl =
+  | `http${string}`
+  | `https${string}`
+  | `data:image/${string};base64,${string}`;
+
+export interface OpenAIImageContent {
+  type: "image_url";
+  image_url: {
+    url: OpenAIImageUrl;
+    detail?: "low" | "high" | "auto";
+  };
+  google_native?: {
+    inlineData: {
+      mimeType: string;
+      data: string;
+    };
+    thoughtSignature?: string;
+  };
+}
+
+export interface OpenAITextContent {
+  type: "text";
+  text: string;
+}
+
+export type MessageContentPart = OpenAITextContent | OpenAIImageContent;
+
+export type CompletionFinishReason = "stop" | "tool_calls" | "length" | "content_filter" | null;
+
+// ========== Token Usage ==========
+export interface CompletionUsage {
+  completion_tokens: number;
+  prompt_tokens: number;
+  total_tokens: number;
+  cost?: number; // OpenRouter extension
+  prompt_tokens_details?: Record<string, any>;
+  completion_tokens_details?: Record<string, any>;
+  cost_details?: Record<string, any>;
+}
+
+export type Content = string | MessageContentPart[];
+
+// ========== 消息级 UI 选项（Agent 菜单 / 快速回复 等） ==========
+
+export type UiOptionSource = "agent_menu" | "llm" | "system" | "tool";
+
+export interface UiOptionMeta {
+  /** 选项来源：Agent 配置 / LLM 建议 / 系统内置 / Tool 生成 */
+  source?: UiOptionSource;
+  /** 可选描述：用于 tooltip 或 hover 展示的详细说明 */
+  description?: string;
+}
+
+/**
+ * 一条消息下方的可点击选项（Agent 菜单 / quick reply / Tool 提示等）
+ * - 显示给用户的是 label
+ * - 发给 LLM 的是 userMessage（如果不写则使用 label）
+ */
+export interface UiOption {
+  /** 选项自身的稳定 ID（和 message.id 不同） */
+  id: string;
+  /** 按钮上的文案（用户可见） */
+  label: string;
+  /** 点击后要发给 LLM 的“等价人话”，不填则默认用 label */
+  userMessage?: string;
+  /** 附加元信息（目前轻量使用，后续可以扩展） */
+  meta?: UiOptionMeta;
+}
+
+// ========== Tool 调用快照 ==========
+
+export interface ToolErrorPayload {
+  type: string;
+  message: string;
+  code?: string;
+  retryable?: boolean;
+}
+
+export interface ToolPayload {
+  toolName: string;
+  status: "pending" | "running" | "succeeded" | "failed";
+  input: any;
+  rawToolCall?: any;
+
+  /**
+   * ✅ 工具输出不在 toolPayload 存储（唯一输出来源是 message.content）
+   * rawResult 不再写入；这里不保留兼容字段，按你的要求直接干掉。
+   */
+
+  error?: ToolErrorPayload;
+  toolRunId?: string;
+  startedAt?: number;
+  finishedAt?: number;
+
+  /**
+   * ✅ 持久化摘要：用于 ToolMessageItem header 展示
+   * 没有的话 UI 会 fallback 默认文案
+   */
+  summary?: string;
+
+  /**
+   * 提供给下一轮 LLM 的结构化上下文补充。
+   * 典型场景：工具真实产物（如 fileId / 可复用 URL）不能只靠 summary 传达。
+   * UI 不直接展示它，避免把 header 摘要污染成长文本。
+   */
+  llmContext?: string;
+
+  /**
+   * callAgent 子任务完成后产生的独立 dialog ID
+   * 供 UI 渲染「查看完整对话 →」跳转链接
+   */
+  subDialogId?: string;
+
+  /**
+   * 可选（未来建议）：toolVersion / executorVersion，用于严格复现
+   * toolVersion?: string;
+   */
+}
+
+// ========== Message 主类型 ==========
+
+export interface Message {
+  role: MessageRole;
+  content: Content;
+
+  thinkContent?: string;
+  image?: string;
+  images?: string[];
+
+  id: string;
+  dbKey: string;
+
+  cybotId?: string;
+  cybotKey?: string;
+  agentKey?: string;
+  agentName?: string;
+
+  isStreaming?: boolean;
+  userId?: string;
+  usage?: any;
+
+  controller?: AbortController;
+
+  // ========= Tool 扩展字段 =========
+
+  toolName?: string;
+  toolPayload?: ToolPayload;
+  parentMessageId?: string;
+  toolRunId?: string;
+  parallelSessionId?: string;
+  parallelBranchId?: string;
+  parallelLabel?: string;
+  parallelIndex?: number;
+
+  // tool_call_id：关联 assistant message 的 tool_calls[].id
+  toolCallId?: string;
+
+  // assistant message 的 tool_calls（OpenAI 标准字段名）
+  tool_calls?: Array<{
+    id: string;
+    type: "function";
+    function: {
+      name: string;
+      arguments: string;
+    };
+  }>;
+
+  // ========= 消息级 UI 选项（Agent 菜单 / quick reply） =========
+  options?: UiOption[];
+}

package/chat/messages/web/ChatDisplayContext.ts

@@ -0,0 +1,14 @@
+import { createContext, useContext } from "react";
+
+interface ChatDisplayContextValue {
+  /** When true, AppDeployCard starts collapsed (no iframe) */
+  compactDeployCards: boolean;
+}
+
+export const ChatDisplayContext = createContext<ChatDisplayContextValue>({
+  compactDeployCards: false,
+});
+
+export function useChatDisplayContext() {
+  return useContext(ChatDisplayContext);
+}

package/chat/messages/web/ToolMessageTypes.ts

@@ -0,0 +1,23 @@
+// 文件路径: chat/messages/web/ToolMessageTypes.ts
+
+export interface ToolProps {
+  rawData: any;
+  isError: boolean;
+  t: (key: string, options?: string | any) => string;
+  openPreview: (key: string, name: string) => void;
+  navigateToPage: (id: string) => void;
+}
+
+/* --- 工具函数：根据路径猜测语言，高亮用 --- */
+export function guessLanguageFromPath(
+  path: string | undefined
+): string | undefined {
+  if (!path) return undefined;
+  if (path.endsWith(".ts") || path.endsWith(".tsx")) return "typescript";
+  if (path.endsWith(".js") || path.endsWith(".jsx")) return "javascript";
+  if (path.endsWith(".json")) return "json";
+  if (path.endsWith(".css") || path.endsWith(".scss") || path.endsWith(".less"))
+    return "css";
+  if (path.endsWith(".md")) return "markdown";
+  return undefined;
+}

package/chat/messages/web/diffViewerModel.ts

@@ -0,0 +1,61 @@
+export type DiffPart = {
+  value: string;
+  added?: boolean;
+  removed?: boolean;
+};
+
+export type DiffRowKind = "context" | "added" | "removed";
+
+export type DiffRow = {
+  id: string;
+  kind: DiffRowKind;
+  content: string;
+  oldLine: number | null;
+  newLine: number | null;
+};
+
+export function buildDiffRows(parts: DiffPart[]): DiffRow[] {
+  const rows: DiffRow[] = [];
+  let oldLine = 1;
+  let newLine = 1;
+
+  parts.forEach((part, partIndex) => {
+    const kind: DiffRowKind = part.added
+      ? "added"
+      : part.removed
+        ? "removed"
+        : "context";
+    const lines = part.value.split("\n");
+
+    lines.forEach((line, lineIndex) => {
+      if (lineIndex === lines.length - 1 && line === "") return;
+
+      const row: DiffRow = {
+        id: `${partIndex}-${lineIndex}`,
+        kind,
+        content: line,
+        oldLine: kind === "added" ? null : oldLine,
+        newLine: kind === "removed" ? null : newLine,
+      };
+
+      rows.push(row);
+
+      if (kind !== "added") oldLine += 1;
+      if (kind !== "removed") newLine += 1;
+    });
+  });
+
+  return rows;
+}
+
+export function summarizeDiffRows(rows: DiffRow[]) {
+  let added = 0;
+  let removed = 0;
+
+  for (const row of rows) {
+    if (row.kind === "added") added += 1;
+    if (row.kind === "removed") removed += 1;
+  }
+
+  return { added, removed };
+}

package/chat/messages/web/groupToolEntries.ts

@@ -0,0 +1,44 @@
+export type GroupedRenderEntry =
+  | { type: "single"; key: string; message: any }
+  | { type: "parallel-group"; key: string; sessionId: string; messages: any[] }
+  | { type: "tool-group"; key: string; messages: any[] };
+
+export function groupConsecutiveToolEntries(
+  entries: GroupedRenderEntry[]
+): GroupedRenderEntry[] {
+  const result: GroupedRenderEntry[] = [];
+  let buffer: any[] = [];
+
+  const flush = () => {
+    if (buffer.length === 0) return;
+    if (buffer.length === 1) {
+      const message = buffer[0];
+      result.push({
+        type: "single",
+        key: message.id ?? message.dbKey ?? message.tool_call_id ?? "tool-single",
+        message,
+      });
+    } else {
+      const key = buffer
+        .map((m) => m.id ?? m.dbKey ?? m.tool_call_id ?? "")
+        .join("-");
+      result.push({
+        type: "tool-group",
+        key: `tool-group-${key}`,
+        messages: buffer,
+      });
+    }
+    buffer = [];
+  };
+
+  for (const entry of entries) {
+    if (entry.type === "single" && entry.message.role === "tool") {
+      buffer.push(entry.message);
+    } else {
+      flush();
+      result.push(entry);
+    }
+  }
+  flush();
+  return result;
+}

package/chat/messages/web/groupToolMessages.ts

@@ -0,0 +1,35 @@
+// 把消息列表中连续的 role === "tool" 消息折叠成 group，供只读/分享页使用
+export type GroupedVisibleMessage =
+  | { type: "message"; message: any }
+  | { type: "tool-group"; messages: any[]; key: string };
+
+export function groupConsecutiveToolMessages(
+  messages: any[]
+): GroupedVisibleMessage[] {
+  const result: GroupedVisibleMessage[] = [];
+  let buffer: any[] = [];
+
+  const flush = () => {
+    if (buffer.length === 0) return;
+    if (buffer.length === 1) {
+      result.push({ type: "message", message: buffer[0] });
+    } else {
+      const key = buffer
+        .map((m) => m.id ?? m.dbKey ?? m.tool_call_id ?? "")
+        .join("-");
+      result.push({ type: "tool-group", messages: buffer, key });
+    }
+    buffer = [];
+  };
+
+  for (const msg of messages) {
+    if (msg && msg.role === "tool") {
+      buffer.push(msg);
+    } else {
+      flush();
+      result.push({ type: "message", message: msg });
+    }
+  }
+  flush();
+  return result;
+}

package/chat/messages/web/inlineReactArtifactParser.ts

@@ -0,0 +1,63 @@
+export type StreamingReactArtifact = {
+  language: "jsx" | "tsx";
+  code: string;
+  complete: boolean;
+};
+
+export type StreamingInlineReactArtifactParts = {
+  visibleText: string;
+  artifact: StreamingReactArtifact | null;
+};
+
+const REACT_FENCE_START_RE = /```(jsx|tsx)(?:[^\n`]*)?\n/gi;
+
+function isPreviewCandidate(code: string): boolean {
+  return /function\s+Example\s*\(/.test(code);
+}
+
+function compactVisibleText(text: string): string {
+  return text
+    .replace(/[ \t]+\n/g, "\n")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+}
+
+export function extractStreamingInlineReactArtifact(
+  content: string
+): StreamingInlineReactArtifactParts {
+  let visibleText = "";
+  let cursor = 0;
+  let artifact: StreamingReactArtifact | null = null;
+
+  REACT_FENCE_START_RE.lastIndex = 0;
+
+  while (true) {
+    const match = REACT_FENCE_START_RE.exec(content);
+    if (!match) break;
+
+    const language = match[1].toLowerCase() as "jsx" | "tsx";
+    const fenceStart = match.index;
+    const codeStart = REACT_FENCE_START_RE.lastIndex;
+    const closingFenceIndex = content.indexOf("```", codeStart);
+    const complete = closingFenceIndex >= 0;
+    const codeEnd = complete ? closingFenceIndex : content.length;
+    const code = content.slice(codeStart, codeEnd).trim();
+
+    visibleText += content.slice(cursor, fenceStart);
+    cursor = complete ? closingFenceIndex + 3 : content.length;
+
+    if (code && isPreviewCandidate(code)) {
+      artifact = { language, code, complete };
+    }
+
+    if (!complete) break;
+    REACT_FENCE_START_RE.lastIndex = cursor;
+  }
+
+  visibleText += content.slice(cursor);
+
+  return {
+    visibleText: compactVisibleText(visibleText),
+    artifact,
+  };
+}

package/chat/messages/web/toolDisplayName.ts

@@ -0,0 +1,22 @@
+export function resolveToolDisplayName(
+  toolName: string | undefined,
+  translate: (key: string, fallback: string) => string
+) {
+  const normalized = typeof toolName === "string" ? toolName.trim() : "";
+  if (!normalized) return translate("toolNames.tool", "Tool");
+  return translate(`toolNames.${normalized}`, normalized);
+}
+
+export function formatToolInvocationSummary(
+  messages: Array<{ toolName?: string }>,
+  translate: (key: string, fallback: string) => string
+) {
+  const counts = new Map<string, number>();
+  for (const msg of messages) {
+    const name = msg.toolName || "tool";
+    counts.set(name, (counts.get(name) || 0) + 1);
+  }
+  return Array.from(counts.entries())
+    .map(([name, count]) => `${resolveToolDisplayName(name, translate)} × ${count}`)
+    .join("、");
+}

package/chat/messages/web/useLoopStopReason.ts

@@ -0,0 +1,43 @@
+// packages/chat/messages/web/useLoopStopReason.ts
+import { useEffect, useRef, useState } from "react";
+
+export type LoopStopReason =
+  | "done"
+  | "handoff"
+  | "pending"
+  | "timeout"
+  | "aborted"
+  | "error"
+  | null;
+
+const w = typeof window !== "undefined" ? (window as any) : null;
+
+/**
+ * 轮询 window.__LOOP_STOP_REASON__，在 loop 结束后展示原因。
+ * isRunning=true 时清空上一次原因；isRunning=false 时读取最终值。
+ * 只有真正运行过（hasRun）之后停止，才去读取 reason。
+ */
+export const useLoopStopReason = (isRunning: boolean): LoopStopReason => {
+  const [reason, setReason] = useState<LoopStopReason>(null);
+  const hasRun = useRef(false);
+
+  useEffect(() => {
+    if (isRunning) {
+      hasRun.current = true;
+      setReason(null);
+      if (w) w.__LOOP_STOP_REASON__ = null;
+      return;
+    }
+    // 从未运行过（新对话），不触发任何提示
+    if (!hasRun.current) return;
+
+    // loop 刚结束，读取原因；若仍为 null 则不展示额外提示
+    const timer = setTimeout(() => {
+      const raw = w?.__LOOP_STOP_REASON__ ?? null;
+      setReason(raw);
+    }, 200);
+    return () => clearTimeout(timer);
+  }, [isRunning]);
+
+  return reason;
+};

package/chat/messages/ziweiChartDoc.ts

@@ -0,0 +1,94 @@
+import type { ZiweiChartToolResult } from "../../ai/tools/ziweiChartTool";
+
+type MaybeZiweiChartResult = Partial<ZiweiChartToolResult> & {
+  rawData?: ZiweiChartToolResult;
+};
+
+export function getZiweiChartResult(
+  rawData: unknown
+): ZiweiChartToolResult | null {
+  const candidate = rawData as MaybeZiweiChartResult | null | undefined;
+  const result = candidate?.chart ? candidate : candidate?.rawData;
+  if (!result?.chart || !result?.summary || !result?.displayData) return null;
+  return result as ZiweiChartToolResult;
+}
+
+export function buildZiweiChartDocTitle(rawData: unknown): string {
+  const result = getZiweiChartResult(rawData);
+  if (!result) return "紫微命盘";
+
+  const calendarLabel = result.input.calendarType === "lunar" ? "农历" : "阳历";
+  return `紫微命盘 · ${calendarLabel} ${result.input.dateStr} · ${result.chart.timeRange} · ${result.input.gender}`;
+}
+
+export function buildZiweiChartDocMarkdown(rawData: unknown): string {
+  const result = getZiweiChartResult(rawData);
+  if (!result) return "# 紫微命盘\n\n无法生成命盘内容。";
+
+  const mutagenSummary =
+    result.chart.mutagenByYear.length > 0
+      ? result.chart.mutagenByYear
+          .map((item) => `${item.name}化${item.mutagen}`)
+          .join("、")
+      : "无";
+
+  const quickFacts = [
+    `- 日期类型：${result.input.calendarType === "lunar" ? "农历" : "阳历"}`,
+    `- 出生日期：${result.input.dateStr}`,
+    `- 时辰：${result.chart.timeRange}`,
+    `- 性别：${result.input.gender}`,
+    `- 阳历：${result.chart.solarDate}`,
+    `- 农历：${result.chart.lunarDate}`,
+    `- 干支：${result.chart.chineseDate}`,
+    `- 生肖 / 星座：${result.chart.zodiac} / ${result.chart.sign}`,
+    `- 五行局：${result.summary.fiveElementsClass}`,
+    `- 命宫：${result.summary.mingGong}`,
+    `- 身宫：${result.summary.shenGong}`,
+    `- 命主 / 身主：${result.summary.mingZhu} / ${result.summary.shenZhu}`,
+    `- 生年四化：${mutagenSummary}`,
+  ].join("\n");
+
+  const analysisLines = [
+    `- 命宫主星：${
+      result.analysisContext.mingPalace.majorStars.map((item) => item.name).join("、") ||
+      "无"
+    }`,
+    `- 身宫主星：${
+      result.analysisContext.bodyPalace.majorStars.map((item) => item.name).join("、") ||
+      "无"
+    }`,
+    `- 空宫：${
+      result.analysisContext.emptyPalaces.length > 0
+        ? result.analysisContext.emptyPalaces.join("、")
+        : "无"
+    }`,
+  ].join("\n");
+
+  return [
+    `# ${buildZiweiChartDocTitle(result)}`,
+    "",
+    "## 命盘摘要",
+    "",
+    result.summaryText,
+    "",
+    "## 基本信息",
+    "",
+    quickFacts,
+    "",
+    "## 关键观察",
+    "",
+    analysisLines,
+    "",
+    "## ASCII 盘面快照",
+    "",
+    "```text",
+    result.gridText,
+    "```",
+    "",
+    "## 十二宫详盘",
+    "",
+    "```text",
+    result.displayData,
+    "```",
+  ].join("\n");
+}