@tablestore/tablestore-agent-cli 0.3.1 → 0.4.0

package/dist/dashboard-runtime/dashboard/src/components/qa/answer-evidence-block.tsx

@@ -0,0 +1,145 @@
+"use client";
+
+import { useState } from "react";
+import { BookMarked, Brain, ChevronDown } from "lucide-react";
+
+import {
+  Collapsible,
+  CollapsibleContent,
+  CollapsibleTrigger,
+} from "@/components/ui/collapsible";
+import { useI18n } from "@/i18n/i18n-context";
+import { cn } from "@/lib/utils";
+import type { WikiEvidence, WikiRetrievalGroup } from "@/types/llm-chat";
+import type { MemorySearchHit } from "@/types/memory";
+
+import {
+  MemoryEvidenceContent,
+  type MemoryEvidenceScope,
+} from "./memory-evidence-content";
+import {
+  resolveWikiEvidenceGroups,
+  WikiEvidenceContent,
+  wikiEvidencePageCount,
+  type WikiEvidenceScope,
+} from "./wiki-evidence-block";
+
+interface AnswerEvidenceBlockProps {
+  memoryHits?: MemorySearchHit[];
+  memoryQuery?: string;
+  memoryStoreName?: string;
+  memoryScope?: MemoryEvidenceScope;
+  wikiQuery?: string;
+  wikiEvidence?: WikiEvidence[];
+  wikiRetrievalGroups?: WikiRetrievalGroup[];
+  wikiMemoryStoreName?: string;
+  wikiScope?: WikiEvidenceScope;
+  wikiTotalContextChars?: number;
+}
+
+export function AnswerEvidenceBlock({
+  memoryHits = [],
+  memoryQuery,
+  memoryStoreName,
+  memoryScope,
+  wikiQuery,
+  wikiEvidence = [],
+  wikiRetrievalGroups = [],
+  wikiMemoryStoreName,
+  wikiScope,
+  wikiTotalContextChars,
+}: AnswerEvidenceBlockProps) {
+  const { t } = useI18n();
+  const [open, setOpen] = useState(false);
+  const renderedWikiGroups = resolveWikiEvidenceGroups(
+    wikiEvidence,
+    wikiRetrievalGroups,
+  );
+  const memoryCount = memoryHits.length;
+  // Count injected Wiki pages, not failures. Error-only groups still make the
+  // Wiki section visible so partial failure does not erase other evidence.
+  const wikiCount = wikiEvidencePageCount(renderedWikiGroups);
+  const hasMemoryEvidence = memoryCount > 0;
+  const hasWikiEvidence = renderedWikiGroups.length > 0;
+
+  if (!hasMemoryEvidence && !hasWikiEvidence) return null;
+
+  const title = t("qa.evidence.title", { memoryCount, wikiCount });
+  const triggerLabel = `${title} · ${
+    open ? t("qa.chunks.collapse") : t("qa.chunks.expand")
+  }`;
+
+  return (
+    <Collapsible open={open} onOpenChange={setOpen}>
+      <CollapsibleTrigger asChild>
+        <button
+          type="button"
+          data-testid="answer-evidence-trigger"
+          aria-label={triggerLabel}
+          className="inline-flex max-w-full items-center gap-1.5 rounded-md px-2 py-1 text-xs text-muted-foreground transition-colors hover:bg-[hsl(var(--accent))] hover:text-foreground"
+        >
+          <BookMarked className="h-3.5 w-3.5 shrink-0" />
+          <span className="truncate">{title}</span>
+          <ChevronDown
+            className={cn(
+              "h-3 w-3 shrink-0 transition-transform duration-200",
+              open && "rotate-180",
+            )}
+          />
+        </button>
+      </CollapsibleTrigger>
+      <CollapsibleContent>
+        <div className="mt-2 space-y-4">
+          {hasMemoryEvidence ? (
+            <section className="space-y-2" data-testid="answer-evidence-memory">
+              <div className="flex min-w-0 items-center gap-1.5 text-xs font-medium text-muted-foreground">
+                <Brain className="h-3.5 w-3.5 shrink-0" />
+                <span className="shrink-0">
+                  {t("qa.memory.referenceCount", { count: memoryCount })}
+                </span>
+                {memoryQuery ? (
+                  <span className="max-w-[240px] truncate text-muted-foreground/70">
+                    · {memoryQuery}
+                  </span>
+                ) : null}
+              </div>
+              <MemoryEvidenceContent
+                hits={memoryHits}
+                memoryStoreName={memoryStoreName}
+                scope={memoryScope}
+              />
+            </section>
+          ) : null}
+          {hasWikiEvidence ? (
+            <section className="space-y-2" data-testid="answer-evidence-wiki">
+              <div className="flex min-w-0 items-center gap-1.5 text-xs font-medium text-muted-foreground">
+                <BookMarked className="h-3.5 w-3.5 shrink-0" />
+                <span className="shrink-0">
+                  {t("qa.message.wikiReferences", { count: wikiCount })}
+                </span>
+                {wikiQuery ? (
+                  <span className="max-w-[240px] truncate text-muted-foreground/70">
+                    · {t("qa.message.wikiQuery", { query: wikiQuery })}
+                  </span>
+                ) : null}
+                {wikiTotalContextChars !== undefined ? (
+                  <span className="shrink-0 text-muted-foreground/70">
+                    ·
+                    {t("qa.message.wikiTotalContextChars", {
+                      count: wikiTotalContextChars,
+                    })}
+                  </span>
+                ) : null}
+              </div>
+              <WikiEvidenceContent
+                groups={renderedWikiGroups}
+                memoryStoreName={wikiMemoryStoreName}
+                scope={wikiScope}
+              />
+            </section>
+          ) : null}
+        </div>
+      </CollapsibleContent>
+    </Collapsible>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/qa/memory-evidence-content.tsx

@@ -0,0 +1,106 @@
+"use client";
+
+import Link from "next/link";
+
+import { useI18n } from "@/i18n/i18n-context";
+import type { MemorySearchHit } from "@/types/memory";
+
+export interface MemoryEvidenceScope {
+  appId: string;
+  tenantId: string;
+  agentId: string;
+  runId: string;
+}
+
+interface MemoryEvidenceContentProps {
+  hits: MemorySearchHit[];
+  memoryStoreName?: string;
+  scope?: MemoryEvidenceScope;
+}
+
+function fileWorkspaceHref(
+  memoryStoreName: string,
+  scope: MemoryEvidenceScope,
+  path: string,
+): string {
+  const query = new URLSearchParams({ ...scope, view: "files", file: path });
+  return `/memory/${encodeURIComponent(memoryStoreName)}/units?${query.toString()}`;
+}
+
+export function MemoryEvidenceContent({
+  hits,
+  memoryStoreName,
+  scope,
+}: MemoryEvidenceContentProps) {
+  return (
+    <div className="space-y-2">
+      {hits.map((hit, index) => (
+        <MemoryHitCard
+          key={
+            hit.unit.memcell_id ??
+            `${index}-${(hit.unit.text ?? "").slice(0, 16)}`
+          }
+          hit={hit}
+          index={index + 1}
+          memoryStoreName={memoryStoreName}
+          scope={scope}
+        />
+      ))}
+    </div>
+  );
+}
+
+function MemoryHitCard({
+  hit,
+  index,
+  memoryStoreName,
+  scope,
+}: {
+  hit: MemorySearchHit;
+  index: number;
+  memoryStoreName?: string;
+  scope?: MemoryEvidenceScope;
+}) {
+  const { t } = useI18n();
+  const id = hit.unit.memcell_id;
+  const score = typeof hit.score === "number" ? hit.score : undefined;
+  return (
+    <div className="rounded-md border border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.3)] p-3">
+      <div className="mb-1.5 flex items-center gap-2 text-xs text-muted-foreground">
+        <span className="inline-flex h-5 w-5 items-center justify-center rounded-full bg-[hsl(var(--primary-50))] font-semibold text-primary">
+          {index}
+        </span>
+        {id ? (
+          <span
+            className="min-w-0 truncate font-mono text-foreground/80"
+            title={id}
+          >
+            {id}
+          </span>
+        ) : (
+          <span className="text-muted-foreground/70">
+            {t("qa.memory.unnamedMemory")}
+          </span>
+        )}
+        {hit.source && memoryStoreName && scope ? (
+          <Link
+            href={fileWorkspaceHref(memoryStoreName, scope, hit.source)}
+            className="rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 font-mono text-[10px] text-[hsl(var(--primary))] hover:underline"
+          >
+            {hit.source}
+          </Link>
+        ) : hit.source ? (
+          <span className="rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 font-mono text-[10px] text-muted-foreground">
+            {hit.source}
+          </span>
+        ) : null}
+        <span className="ml-auto shrink-0 font-mono">
+          {score !== undefined ? score.toFixed(4) : "—"}
+        </span>
+      </div>
+      <p className="line-clamp-4 whitespace-pre-wrap text-xs text-foreground/80">
+        {hit.unit.text}
+      </p>
+    </div>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/qa/qa-message.tsx

@@ -50,6 +50,8 @@ import {
 } from "@/components/memory/file-editor";
 
 import { Markdown } from "./markdown";
+import { AnswerEvidenceBlock } from "./answer-evidence-block";
+import { MemoryEvidenceContent } from "./memory-evidence-content";
 
 /** Fallback for clipboard copy when navigator.clipboard is unavailable (e.g.
  *  non-HTTPS contexts). Uses the deprecated execCommand approach. */
@@ -318,6 +320,8 @@ type TurnNoticesProps = {
   rewriteError?: string;
   failedKbCount?: number;
   failedKbDetails?: Array<{ name: string; reason: string }>;
+  failedWikiCount?: number;
+  failedWikiDetails?: Array<{ name: string; reason: string }>;
 };
 
 function TurnNotices({
@@ -325,11 +329,14 @@ function TurnNotices({
   rewriteError,
   failedKbCount,
   failedKbDetails,
+  failedWikiCount,
+  failedWikiDetails,
 }: TurnNoticesProps) {
   const { t } = useI18n();
   const hasRewrite = !!rewriteFailed;
   const hasRetrieval = (failedKbCount ?? 0) > 0;
-  if (!hasRewrite && !hasRetrieval) return null;
+  const hasWikiRetrieval = (failedWikiCount ?? 0) > 0;
+  if (!hasRewrite && !hasRetrieval && !hasWikiRetrieval) return null;
 
   return (
     <div className="space-y-1.5">
@@ -349,6 +356,16 @@ function TurnNotices({
             .join("\n")}
         />
       )}
+      {hasWikiRetrieval && failedWikiDetails && (
+        <NoticeChip
+          label={t("qa.message.wikiRetrievalFailed", {
+            count: failedWikiCount ?? 0,
+          })}
+          detail={failedWikiDetails
+            .map((d) => `• ${d.name}: ${d.reason}`)
+            .join("\n")}
+        />
+      )}
     </div>
   );
 }
@@ -569,6 +586,8 @@ function AssistantBlock({
   const hasError = message.status === "error";
   const hasReasoningText = (message.reasoning?.length ?? 0) > 0;
   const hasContent = (message.content?.length ?? 0) > 0;
+  const wikiInFlight =
+    (message.wikiCount ?? 0) > 0 && message.wikiRetrievalDone !== true;
 
   // Render the pill the moment a turn is in flight, **before** any reasoning
   // chunk arrives. The server's RAG path runs query rewriting (~1-3s LLM
@@ -581,7 +600,8 @@ function AssistantBlock({
   // `content.delta` arrives — `hasContent` flipping true makes both branches
   // false (no reasoning text, content present) and the pill cleanly hands
   // off to the streaming text below.
-  const showReasoningPill = hasReasoningText || (isStreaming && !hasContent);
+  const showReasoningPill =
+    hasReasoningText || (isStreaming && (!hasContent || wikiInFlight));
 
   // Stage of the pre-reasoning phase, derived from server events that arrive
   // before the model's first token. Lets the label move through「检索意图
@@ -590,14 +610,26 @@ function AssistantBlock({
   // rewriting and retrieving.
   const intentExtracting = !!message.usingRag && !message.retrievalQuery;
   const retrievalInFlight =
-    !!message.retrievalQuery && !message.retrievedChunks;
+    !!message.retrievalQuery &&
+    !message.retrievedChunks &&
+    message.wikiRetrievalDone !== true;
 
   // Aggregate per-KB retrieval errors so the TurnNotices chip can surface
   // them without forcing the user to expand the chunks panel.
   const failedKbDetails = (message.retrievalGroups ?? [])
     .filter((g) => g.error)
     .map((g) => ({ name: g.knowledgeBaseName, reason: g.error ?? "" }));
-
+  const failedWikiGroups = (message.wikiRetrievalGroups ?? []).filter(
+    (group) => (group.errors?.length ?? 0) > 0,
+  );
+  const failedWikiDetails = failedWikiGroups.flatMap((group) =>
+    (group.errors ?? []).map((error) => ({
+      name: group.wikiName,
+      reason: `[${error.code}] ${error.message}${
+        error.requestId ? ` (${error.requestId})` : ""
+      }`,
+    })),
+  );
   const handleCopy = useCallback(() => {
     if (!message.content) return;
     try {
@@ -670,6 +702,8 @@ function AssistantBlock({
           completedAt={message.reasoningCompletedAt}
           intentExtracting={intentExtracting}
           retrievalInFlight={retrievalInFlight}
+          wikiInFlight={wikiInFlight}
+          wikiCount={message.wikiCount}
         />
       ) : null}
 
@@ -678,6 +712,8 @@ function AssistantBlock({
         rewriteError={message.queryRewriteError}
         failedKbCount={failedKbDetails.length}
         failedKbDetails={failedKbDetails}
+        failedWikiCount={failedWikiGroups.length}
+        failedWikiDetails={failedWikiDetails}
       />
 
       {/* Rewritten retrieval query — only shown when it differs from the
@@ -702,18 +738,20 @@ function AssistantBlock({
         />
       ) : null}
 
-      {/* Retrieved memory hits. Shown right under the KB chunks so both
-          evidence sources sit in the same vertical stack. The differentiator
-          is the trigger pill (Brain icon + "参考" verb), since memory hits
-          are soft prior context rather than bracketed citations. */}
-      {message.memoryHits && message.memoryHits.length > 0 ? (
-        <MemoryHitsBlock
-          hits={message.memoryHits}
-          query={message.memoryQuery}
-          memoryStoreName={message.memoryFilesStoreName}
-          scope={message.memoryFilesScope}
-        />
-      ) : null}
+      {/* Memory and Wiki share one answer-evidence entry point while keeping
+          source-specific sections and partial Wiki failures visible. */}
+      <AnswerEvidenceBlock
+        memoryHits={message.memoryHits}
+        memoryQuery={message.memoryQuery}
+        memoryStoreName={message.memoryFilesStoreName}
+        memoryScope={message.memoryFilesScope}
+        wikiQuery={message.wikiQuery}
+        wikiEvidence={message.wikiEvidence}
+        wikiRetrievalGroups={message.wikiRetrievalGroups}
+        wikiMemoryStoreName={message.wikiMemoryStoreName}
+        wikiScope={message.wikiScope}
+        wikiTotalContextChars={message.wikiTotalContextChars}
+      />
 
       {/* 文件记忆本轮同步摘要（openclaw local 模式的可视化）：展示镜像目录、
           文件树与本轮 +下载 -删除 统计。仅文件记忆模式下 memory.files 事件
@@ -905,6 +943,8 @@ function ReasoningBlock({
   completedAt,
   intentExtracting,
   retrievalInFlight,
+  wikiInFlight,
+  wikiCount,
 }: {
   reasoning: string;
   streaming: boolean;
@@ -912,6 +952,8 @@ function ReasoningBlock({
   completedAt?: number;
   intentExtracting?: boolean;
   retrievalInFlight?: boolean;
+  wikiInFlight?: boolean;
+  wikiCount?: number;
 }) {
   const { t } = useI18n();
   // Collapse by default; let the user opt in explicitly. Avoids the
@@ -941,6 +983,10 @@ function ReasoningBlock({
   let activeLabel = t("qa.reasoning.thinking");
   if (hasReasoningText) {
     activeLabel = t("qa.reasoning.deepThinking");
+  } else if (wikiInFlight) {
+    activeLabel = t("qa.message.retrievingWikis", {
+      count: wikiCount ?? 0,
+    });
   } else if (retrievalInFlight) {
     activeLabel = t("qa.reasoning.retrieving");
   } else if (intentExtracting) {
@@ -1320,80 +1366,18 @@ export function MemoryHitsBlock({
         </button>
       </CollapsibleTrigger>
       <CollapsibleContent>
-        <div className="mt-2 space-y-2">
-          {hits.map((hit, idx) => (
-            <MemoryHitCard
-              key={
-                hit.unit.memcell_id ??
-                `${idx}-${(hit.unit.text ?? "").slice(0, 16)}`
-              }
-              hit={hit}
-              index={idx + 1}
-              memoryStoreName={memoryStoreName}
-              scope={scope}
-            />
-          ))}
+        <div className="mt-2">
+          <MemoryEvidenceContent
+            hits={hits}
+            memoryStoreName={memoryStoreName}
+            scope={scope}
+          />
         </div>
       </CollapsibleContent>
     </Collapsible>
   );
 }
 
-function MemoryHitCard({
-  hit,
-  index,
-  memoryStoreName,
-  scope,
-}: {
-  hit: MemorySearchHit;
-  index: number;
-  memoryStoreName?: string;
-  scope?: FileMemoryNavigationScope;
-}) {
-  const { t } = useI18n();
-  const id = hit.unit.memcell_id;
-  const score = typeof hit.score === "number" ? hit.score : undefined;
-  return (
-    <div className="rounded-md border border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.3)] p-3">
-      <div className="mb-1.5 flex items-center gap-2 text-xs text-muted-foreground">
-        <span className="inline-flex h-5 w-5 items-center justify-center rounded-full bg-[hsl(var(--primary-50))] font-semibold text-primary">
-          {index}
-        </span>
-        {id ? (
-          <span
-            className="min-w-0 truncate font-mono text-foreground/80"
-            title={id}
-          >
-            {id}
-          </span>
-        ) : (
-          <span className="text-muted-foreground/70">
-            {t("qa.memory.unnamedMemory")}
-          </span>
-        )}
-        {hit.source && memoryStoreName && scope ? (
-          <Link
-            href={fileWorkspaceHref(memoryStoreName, scope, hit.source)}
-            className="rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 font-mono text-[10px] text-[hsl(var(--primary))] hover:underline"
-          >
-            {hit.source}
-          </Link>
-        ) : hit.source ? (
-          <span className="rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 font-mono text-[10px] text-muted-foreground">
-            {hit.source}
-          </span>
-        ) : null}
-        <span className="ml-auto shrink-0 font-mono">
-          {score !== undefined ? score.toFixed(4) : "—"}
-        </span>
-      </div>
-      <p className="line-clamp-4 whitespace-pre-wrap text-xs text-foreground/80">
-        {hit.unit.text}
-      </p>
-    </div>
-  );
-}
-
 /**
  * 文件记忆本轮同步摘要（openclaw local 模式的可视化）。
  *