@tablestore/tablestore-agent-cli 0.2.10 → 0.2.11

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

@@ -1,11 +1,13 @@
 "use client";
 
 import { memo, useCallback, useEffect, useState } from "react";
+import Link from "next/link";
 import {
   AlertCircle,
   AlertTriangle,
   BookOpen,
   Brain,
+  CheckCircle2,
   ChevronDown,
   Copy,
   FileText,
@@ -32,6 +34,7 @@ import { Textarea } from "@/components/ui/textarea";
 import { Dialog, DialogContent, DialogTitle } from "@/components/ui/dialog";
 import { ConfirmDialog } from "@/components/shared/confirm-dialog";
 import { useI18n, type TranslateFn } from "@/i18n/i18n-context";
+import { useCreateFileMemory } from "@/hooks/use-file-memory";
 import { cn, extractFileName } from "@/lib/utils";
 import { IMAGE_FALLBACK_DATA_PREFIX } from "@/lib/constants";
 import type {
@@ -40,6 +43,11 @@ import type {
   RetrievedChunk,
 } from "@/types/llm-chat";
 import type { MemorySearchHit } from "@/types/memory";
+import {
+  normalizeFileMemoryPath,
+  validateFileMemoryContent,
+  validateFileMemoryPath,
+} from "@/components/memory/file-editor";
 
 import { Markdown } from "./markdown";
 
@@ -150,6 +158,7 @@ type MessageActionsProps = {
   onResend?: () => void;
   /** Assistant-bubble specific. */
   onRegenerate?: () => void;
+  onSaveToFile?: () => void;
   /** Assistant-bubble specific: in-session deposit-to-KB actions. */
   dreamActions?: DreamDepositActions;
 };
@@ -169,6 +178,7 @@ function MessageActions({
   onEdit,
   onResend,
   onRegenerate,
+  onSaveToFile,
   dreamActions,
 }: MessageActionsProps) {
   const { t } = useI18n();
@@ -216,6 +226,15 @@ function MessageActions({
           <RotateCcw className="h-3.5 w-3.5" />
         </ActionButton>
       )}
+      {onSaveToFile && (
+        <ActionButton
+          title={t("qa.message.saveToFile")}
+          disabled={disabled}
+          onClick={onSaveToFile}
+        >
+          <FolderTree className="h-3.5 w-3.5" />
+        </ActionButton>
+      )}
       {dreamActions && (
         <>
           <ActionButton
@@ -544,6 +563,7 @@ function AssistantBlock({
   const [touched, setTouched] = useState(false);
   const [confirmDeleteOpen, setConfirmDeleteOpen] = useState(false);
   const [confirmRegenOpen, setConfirmRegenOpen] = useState(false);
+  const createFile = useCreateFileMemory();
 
   const isStreaming = message.status === "streaming";
   const hasError = message.status === "error";
@@ -596,6 +616,45 @@ function AssistantBlock({
     }
   }, [message.content, t]);
 
+  async function handleSaveToFile() {
+    if (
+      !message.memoryFilesWritable ||
+      !message.memoryFilesStoreName ||
+      !message.memoryFilesScope
+    ) {
+      return;
+    }
+    const timestamp = new Date(message.createdAt)
+      .toISOString()
+      .replace(/[:.]/g, "-");
+    const suggested = `/conversations/${timestamp}-${message.id.slice(0, 8)}.md`;
+    const input = window.prompt(t("qa.message.savePathPrompt"), suggested);
+    if (input === null) return;
+    const path = normalizeFileMemoryPath(input);
+    if (
+      validateFileMemoryPath(path) ||
+      validateFileMemoryContent(message.content)
+    ) {
+      toast.error(t("qa.message.saveToFileInvalid"));
+      return;
+    }
+    try {
+      await createFile.mutateAsync({
+        memoryStoreName: message.memoryFilesStoreName,
+        scope: message.memoryFilesScope,
+        path,
+        content: message.content,
+      });
+      toast.success(t("qa.message.savedToFile", { path }));
+    } catch (error) {
+      toast.error(
+        error instanceof Error
+          ? error.message
+          : t("qa.message.saveToFileFailed"),
+      );
+    }
+  }
+
   return (
     <div
       className="group space-y-3 text-sm leading-relaxed"
@@ -650,6 +709,8 @@ function AssistantBlock({
         <MemoryHitsBlock
           hits={message.memoryHits}
           query={message.memoryQuery}
+          memoryStoreName={message.memoryFilesStoreName}
+          scope={message.memoryFilesScope}
         />
       ) : null}
 
@@ -658,12 +719,15 @@ function AssistantBlock({
           写入后出现。 */}
       {message.memoryFiles ? (
         <MemoryFilesBlock
-          scopeDir={message.memoryFilesScopeDir}
           files={message.memoryFiles}
-          sync={message.memoryFilesSync}
+          cache={message.memoryFilesCache}
+          memoryStoreName={message.memoryFilesStoreName}
+          scope={message.memoryFilesScope}
         />
       ) : null}
 
+      <MemorySaveStatus message={message} />
+
       {/* Main content. */}
       {hasError ? (
         <div className="flex items-start gap-2 rounded-md border border-[hsl(var(--destructive))/0.3] bg-[hsl(var(--destructive))/0.05] px-3 py-2 text-[hsl(var(--destructive))]">
@@ -687,6 +751,11 @@ function AssistantBlock({
         align="left"
         disabled={busy || isStreaming}
         onCopy={handleCopy}
+        onSaveToFile={
+          message.memoryFilesWritable
+            ? () => void handleSaveToFile()
+            : undefined
+        }
         onRegenerate={() => setConfirmRegenOpen(true)}
         onDelete={() => setConfirmDeleteOpen(true)}
         dreamActions={dreamActions}
@@ -720,6 +789,81 @@ function AssistantBlock({
   );
 }
 
+function MemorySaveStatus({ message }: { message: ChatMessage }) {
+  const { t } = useI18n();
+  const status = message.memorySaveStatus;
+  if (!status) return null;
+
+  const className = cn(
+    "inline-flex max-w-full items-center gap-1.5 rounded-md border px-2 py-1 text-xs",
+    status === "error"
+      ? "border-[hsl(var(--destructive)/0.3)] bg-[hsl(var(--destructive)/0.05)] text-[hsl(var(--destructive))]"
+      : "border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.35)] text-muted-foreground",
+  );
+  if (status === "saving") {
+    return (
+      <div className={className} role="status">
+        <Loader2 className="h-3.5 w-3.5 animate-spin" />
+        {t("qa.message.memorySaving")}
+      </div>
+    );
+  }
+  if (status === "error") {
+    return (
+      <div className={className} role="status">
+        <AlertTriangle className="h-3.5 w-3.5 shrink-0" />
+        <span className="truncate">
+          {t("qa.message.memorySaveFailed", {
+            error: message.memorySaveError ?? t("common.unknownError"),
+          })}
+        </span>
+      </div>
+    );
+  }
+  if (status === "unchanged") {
+    return (
+      <div className={className} role="status">
+        <Brain className="h-3.5 w-3.5" />
+        {t("qa.message.memoryUnchanged")}
+      </div>
+    );
+  }
+
+  const content = (
+    <>
+      <CheckCircle2 className="h-3.5 w-3.5 shrink-0 text-[hsl(var(--primary))]" />
+      <span>
+        {t("qa.message.memorySaved", {
+          count: message.memorySaveCount ?? 0,
+        })}
+      </span>
+      {message.memorySavePath ? (
+        <code className="max-w-[260px] truncate font-mono text-[10px] text-[hsl(var(--primary))]">
+          {message.memorySavePath}
+        </code>
+      ) : null}
+    </>
+  );
+  return message.memorySavePath &&
+    message.memoryFilesStoreName &&
+    message.memoryFilesScope ? (
+    <Link
+      href={fileWorkspaceHref(
+        message.memoryFilesStoreName,
+        message.memoryFilesScope,
+        message.memorySavePath,
+      )}
+      className={cn(className, "hover:bg-[hsl(var(--accent))]")}
+    >
+      {content}
+    </Link>
+  ) : (
+    <div className={className} role="status">
+      {content}
+    </div>
+  );
+}
+
 /**
  * Live-ticking elapsed-seconds counter. Returns null while `start` is
  * undefined (reasoning hasn't begun); freezes when `end` is set so the
@@ -1109,6 +1253,23 @@ function ChunkCard({ chunk, index }: { chunk: RetrievedChunk; index: number }) {
   );
 }
 
+interface FileMemoryNavigationScope {
+  appId: string;
+  tenantId: string;
+  agentId: string;
+  runId: string;
+}
+
+function fileWorkspaceHref(
+  memoryStoreName: string,
+  scope: FileMemoryNavigationScope,
+  path?: string,
+): string {
+  const query = new URLSearchParams({ ...scope, view: "files" });
+  if (path) query.set("file", path);
+  return `/memory/${encodeURIComponent(memoryStoreName)}/units?${query.toString()}`;
+}
+
 /**
  * Memory evidence panel — sister component of {@link ChunksBlock}.
  *
@@ -1125,9 +1286,13 @@ function ChunkCard({ chunk, index }: { chunk: RetrievedChunk; index: number }) {
 export function MemoryHitsBlock({
   hits,
   query,
+  memoryStoreName,
+  scope,
 }: {
   hits: MemorySearchHit[];
   query?: string;
+  memoryStoreName?: string;
+  scope?: FileMemoryNavigationScope;
 }) {
   const { t } = useI18n();
   const [open, setOpen] = useState(false);
@@ -1163,6 +1328,8 @@ export function MemoryHitsBlock({
               }
               hit={hit}
               index={idx + 1}
+              memoryStoreName={memoryStoreName}
+              scope={scope}
             />
           ))}
         </div>
@@ -1174,9 +1341,13 @@ export function MemoryHitsBlock({
 function MemoryHitCard({
   hit,
   index,
+  memoryStoreName,
+  scope,
 }: {
   hit: MemorySearchHit;
   index: number;
+  memoryStoreName?: string;
+  scope?: FileMemoryNavigationScope;
 }) {
   const { t } = useI18n();
   const id = hit.unit.memcell_id;
@@ -1199,8 +1370,15 @@ function MemoryHitCard({
             {t("qa.memory.unnamedMemory")}
           </span>
         )}
-        {hit.source ? (
-          <span className="rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 text-[10px] uppercase tracking-wide text-muted-foreground">
+        {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}
@@ -1223,28 +1401,32 @@ function MemoryHitCard({
  * 字提示，本地旧副本仍在用）；展开后列出参与检索的文件相对路径与大小。
  */
 export function MemoryFilesBlock({
-  scopeDir,
   files,
-  sync,
+  cache,
+  memoryStoreName,
+  scope,
 }: {
-  scopeDir?: string;
   files: Array<{ rel: string; size: number }>;
-  sync?: {
+  cache?: {
     ok: boolean;
-    downloaded?: number;
-    deleted?: number;
-    total?: number;
+    listed: number;
+    loaded: number;
+    reused: number;
+    totalBytes: number;
+    truncated: boolean;
     error?: string;
   };
+  memoryStoreName?: string;
+  scope?: FileMemoryNavigationScope;
 }) {
   const { t } = useI18n();
   const [open, setOpen] = useState(false);
-  const summary = sync?.error
-    ? t("qa.memory.syncFailed", { error: sync.error })
-    : t("qa.memory.syncSummary", {
-        added: sync?.downloaded ?? 0,
-        deleted: sync?.deleted ?? 0,
-        total: sync?.total ?? files.length,
+  const summary = cache?.error
+    ? t("qa.memory.cacheFailed", { error: cache.error })
+    : t("qa.memory.cacheSummary", {
+        loaded: cache?.loaded ?? 0,
+        reused: cache?.reused ?? 0,
+        total: cache?.listed ?? files.length,
       });
   return (
     <Collapsible open={open} onOpenChange={setOpen}>
@@ -1258,7 +1440,7 @@ export function MemoryFilesBlock({
           <span
             className={cn(
               "max-w-[260px] truncate",
-              sync?.error
+              cache?.error
                 ? "text-[hsl(var(--destructive))]"
                 : "text-muted-foreground/70",
             )}
@@ -1275,12 +1457,9 @@ export function MemoryFilesBlock({
       </CollapsibleTrigger>
       <CollapsibleContent>
         <div className="mt-2 space-y-1 rounded-md border border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.3)] p-3">
-          {scopeDir ? (
-            <p
-              className="mb-1.5 truncate font-mono text-[10px] text-muted-foreground"
-              title={scopeDir}
-            >
-              {scopeDir}
+          {cache?.truncated ? (
+            <p className="mb-1.5 text-[10px] text-amber-700 dark:text-amber-300">
+              {t("qa.memory.cacheTruncated")}
             </p>
           ) : null}
           {files.length === 0 ? (
@@ -1288,20 +1467,35 @@ export function MemoryFilesBlock({
               {t("qa.memory.emptyFiles")}
             </p>
           ) : (
-            files.map((f) => (
-              <div
-                key={f.rel}
-                className="flex items-center gap-2 text-xs text-foreground/80"
-              >
-                <FileText className="h-3 w-3 shrink-0 text-muted-foreground" />
-                <span className="min-w-0 truncate font-mono" title={f.rel}>
-                  {f.rel}
-                </span>
-                <span className="ml-auto shrink-0 font-mono text-muted-foreground">
-                  {t("qa.memory.fileSize", { size: f.size })}
-                </span>
-              </div>
-            ))
+            files.map((f) => {
+              const content = (
+                <>
+                  <FileText className="h-3 w-3 shrink-0 text-muted-foreground" />
+                  <span className="min-w-0 truncate font-mono" title={f.rel}>
+                    {f.rel}
+                  </span>
+                  <span className="ml-auto shrink-0 font-mono text-muted-foreground">
+                    {t("qa.memory.fileSize", { size: f.size })}
+                  </span>
+                </>
+              );
+              return memoryStoreName && scope ? (
+                <Link
+                  key={f.rel}
+                  href={fileWorkspaceHref(memoryStoreName, scope, f.rel)}
+                  className="flex items-center gap-2 rounded px-1 py-0.5 text-xs text-foreground/80 hover:bg-[hsl(var(--accent))] hover:text-[hsl(var(--primary))]"
+                >
+                  {content}
+                </Link>
+              ) : (
+                <div
+                  key={f.rel}
+                  className="flex items-center gap-2 text-xs text-foreground/80"
+                >
+                  {content}
+                </div>
+              );
+            })
           )}
         </div>
       </CollapsibleContent>

package/dist/dashboard-runtime/dashboard/src/components/shared/error-state.tsx

@@ -4,6 +4,7 @@ import { ApiClientError } from "@/services/api-client";
 
 interface ErrorStateProps {
   error: Error;
+  title?: string;
   onRetry?: () => void;
 }
 
@@ -19,7 +20,7 @@ function getHint(error: Error): string | null {
   return null;
 }
 
-export function ErrorState({ error, onRetry }: ErrorStateProps) {
+export function ErrorState({ error, title, onRetry }: ErrorStateProps) {
   const hint = getHint(error);
 
   return (
@@ -32,7 +33,7 @@ export function ErrorState({ error, onRetry }: ErrorStateProps) {
         />
       </div>
       <h3 className="mb-2 text-base font-semibold text-foreground">
-        Failed to load data
+        {title ?? "Failed to load data"}
       </h3>
       <p className="mb-1 max-w-md text-sm text-muted-foreground">
         {error.message}