@tablestore/tablestore-agent-cli 0.2.9 → 0.2.11

package/dist/dashboard-runtime/dashboard/src/components/chat/memory-bind-section.tsx

@@ -30,7 +30,12 @@ import { MemoryFilesDialog } from "@/components/chat/memory-files-dialog";
 import { ScopeCombobox } from "@/components/memory/scope-combobox";
 import { useI18n } from "@/i18n/i18n-context";
 import { cn } from "@/lib/utils";
-import { isFileMemory, resolveRetrievalMode } from "@/lib/memory-storage-mode";
+import {
+  normalizeStorageMode,
+  resolveRetrievalMode,
+  storageModeCapabilities,
+  type StorageMode,
+} from "@/lib/memory-storage-mode";
 
 /**
  * 抽屉里的「记忆库」区块。
@@ -51,12 +56,13 @@ export function MemoryBindSection() {
   const binding = cfg.memory;
   const topKId = useId();
 
-  // 绑定库是否为文件型（oss+ots）。storageMode 由列表 BFF 逐库富化；只有明确是
-  // oss+ots 才允许「文件记忆」检索模式。
   const boundStore = binding
     ? stores.find((s) => s.memoryStoreName === binding.memoryStoreName)
     : undefined;
-  const isFileStore = isFileMemory(boundStore?.storageMode);
+  const storageMode = normalizeStorageMode(boundStore?.storageMode);
+  const capabilities = storageModeCapabilities(storageMode);
+  const autoSaveAllowed =
+    capabilities.structuredAutoSave || capabilities.writableFiles;
 
   // 纠偏：绑定的库不是文件型却残留 retrievalMode=local（切换了库、或载入了旧会话）
   // 时，强制回落 search，避免对话时走文件记忆分支报错。等库列表就绪后再纠偏，
@@ -64,13 +70,23 @@ export function MemoryBindSection() {
   const currentMode = binding?.retrievalMode;
   useEffect(() => {
     if (!binding || isLoading) return;
-    const corrected = resolveRetrievalMode(currentMode, isFileStore);
-    if (currentMode === "local" && corrected !== "local") {
-      cfg.updateMemory({ retrievalMode: corrected });
+    const corrected = resolveRetrievalMode(currentMode, storageMode);
+    const patch = {
+      ...(currentMode !== corrected ? { retrievalMode: corrected } : {}),
+      ...(binding.storageMode !== storageMode ? { storageMode } : {}),
+    };
+    if (Object.keys(patch).length > 0) {
+      cfg.updateMemory(patch);
     }
     // cfg.updateMemory 稳定；仅依赖会影响判定的原始量
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [binding?.memoryStoreName, currentMode, isFileStore, isLoading]);
+  }, [
+    binding?.memoryStoreName,
+    binding?.storageMode,
+    currentMode,
+    storageMode,
+    isLoading,
+  ]);
 
   return (
     <div className="space-y-3 border-t border-[hsl(var(--border))] pt-4">
@@ -118,6 +134,7 @@ export function MemoryBindSection() {
           onBind={() =>
             cfg.setMemory({
               memoryStoreName: stores[0]?.memoryStoreName ?? "",
+              storageMode: normalizeStorageMode(stores[0]?.storageMode),
               scope: { appId: "", tenantId: "", agentId: "", runId: "" },
               autoSave: true,
               topK: 5,
@@ -129,13 +146,27 @@ export function MemoryBindSection() {
           <MemoryStoreRow
             value={binding.memoryStoreName}
             stores={stores}
-            onChange={(v) => cfg.updateMemory({ memoryStoreName: v })}
+            onChange={(v) => {
+              const nextMode = normalizeStorageMode(
+                stores.find((store) => store.memoryStoreName === v)
+                  ?.storageMode,
+              );
+              cfg.updateMemory({
+                memoryStoreName: v,
+                storageMode: nextMode,
+                retrievalMode: resolveRetrievalMode(
+                  binding.retrievalMode,
+                  nextMode,
+                ),
+              });
+            }}
             onUnbind={() => cfg.setMemory(undefined)}
           />
 
           <RetrievalModeRow
-            mode={resolveRetrievalMode(binding.retrievalMode, isFileStore)}
-            fileMemoryAllowed={isFileStore}
+            mode={resolveRetrievalMode(binding.retrievalMode, storageMode)}
+            storageMode={storageMode}
+            fileMemoryAllowed={capabilities.files}
             onChange={(m) => cfg.updateMemory({ retrievalMode: m })}
             memoryStoreName={binding.memoryStoreName}
             scope={binding.scope}
@@ -148,6 +179,8 @@ export function MemoryBindSection() {
             agentId={binding.scope.agentId}
             runId={binding.scope.runId}
             autoSave={binding.autoSave}
+            autoSaveAllowed={autoSaveAllowed}
+            fileAutoSave={capabilities.writableFiles}
             onScopeChange={(patch) => cfg.updateMemory({ scope: patch })}
             onAutoSaveChange={(v) => cfg.updateMemory({ autoSave: v })}
           />
@@ -160,18 +193,25 @@ export function MemoryBindSection() {
 /**
  * 记忆检索模式二选一 + 文件记忆入口。
  *   - 「语义检索」：服务端每轮向量检索（原行为）。
- *   - 「文件记忆」：openclaw local 模式同款——把该范围的 OSS 文件投影同步到
+ *   - 「文件记忆」：把该范围的服务端文件投影同步到
  *     本地镜像目录，在文件上做词法检索，并可「查看记忆文件」浏览目录结构。
  */
 function RetrievalModeRow(props: {
   mode: "search" | "local";
-  /** 绑定库是否为文件型（oss+ots）。非文件型时禁用「文件记忆」选项。 */
+  storageMode: StorageMode;
   fileMemoryAllowed: boolean;
   onChange: (mode: "search" | "local") => void;
   memoryStoreName: string;
   scope: { appId: string; tenantId: string; agentId: string; runId: string };
 }) {
-  const { mode, fileMemoryAllowed, onChange, memoryStoreName, scope } = props;
+  const {
+    mode,
+    storageMode,
+    fileMemoryAllowed,
+    onChange,
+    memoryStoreName,
+    scope,
+  } = props;
   const { t } = useI18n();
   const [filesOpen, setFilesOpen] = useState(false);
   const scopeComplete =
@@ -191,6 +231,7 @@ function RetrievalModeRow(props: {
       <div className="grid grid-cols-2 gap-2">
         <ModeButton
           active={mode === "search"}
+          disabled={storageMode === "filemem"}
           title={t("chat.memoryBind.modeSearchTitle")}
           desc={t("chat.memoryBind.modeSearchDesc")}
           onClick={() => onChange("search")}
@@ -200,9 +241,11 @@ function RetrievalModeRow(props: {
           disabled={!fileMemoryAllowed}
           title={t("chat.memoryBind.modeLocalTitle")}
           desc={
-            fileMemoryAllowed
-              ? t("chat.memoryBind.modeLocalDescEnabled")
-              : t("chat.memoryBind.modeLocalDescDisabled")
+            storageMode === "filemem"
+              ? t("chat.memoryBind.modeLocalDescWritable")
+              : fileMemoryAllowed
+                ? t("chat.memoryBind.modeLocalDescEnabled")
+                : t("chat.memoryBind.modeLocalDescDisabled")
           }
           onClick={() => onChange("local")}
         />
@@ -399,6 +442,8 @@ function MemoryBindingForm(props: {
   agentId: string;
   runId: string;
   autoSave: boolean;
+  autoSaveAllowed: boolean;
+  fileAutoSave: boolean;
   onScopeChange: (patch: {
     appId?: string;
     tenantId?: string;
@@ -461,11 +506,14 @@ function MemoryBindingForm(props: {
         <div className="space-y-0.5">
           <Label className="text-sm">{t("chat.memoryBind.autoSave")}</Label>
           <p className="text-xs text-muted-foreground">
-            {t("chat.memoryBind.autoSaveDesc")}
+            {props.fileAutoSave
+              ? t("chat.memoryBind.autoSaveFilememDesc")
+              : t("chat.memoryBind.autoSaveDesc")}
           </p>
         </div>
         <Switch
           checked={props.autoSave}
+          disabled={!props.autoSaveAllowed}
           onCheckedChange={props.onAutoSaveChange}
         />
       </div>

package/dist/dashboard-runtime/dashboard/src/components/chat/memory-files-dialog.tsx

@@ -28,7 +28,7 @@ export function MemoryFilesDialog(props: {
 
   return (
     <Dialog open={open} onOpenChange={onOpenChange}>
-      <DialogContent className="flex max-h-[80vh] max-w-3xl flex-col overflow-hidden">
+      <DialogContent className="flex h-[86vh] max-h-[900px] w-[95vw] max-w-[1400px] flex-col overflow-hidden">
         <DialogHeader>
           <DialogTitle className="flex items-center gap-2">
             <FolderTree className="h-4 w-4" />

package/dist/dashboard-runtime/dashboard/src/components/memory/file-details-panel.tsx

@@ -0,0 +1,91 @@
+"use client";
+
+import { FileClock, Hash, HardDrive, ListOrdered } from "lucide-react";
+
+import { useI18n } from "@/i18n/i18n-context";
+import type { FileMemory, FileMemoryScope } from "@/types/file-memory";
+
+import { FileVersionHistory } from "./file-version-history";
+
+function DetailRow({
+  icon,
+  label,
+  value,
+}: {
+  icon: React.ReactNode;
+  label: string;
+  value: React.ReactNode;
+}) {
+  return (
+    <div className="flex items-start gap-2 py-1.5">
+      <span className="mt-0.5 text-muted-foreground">{icon}</span>
+      <div className="min-w-0">
+        <p className="text-[10px] uppercase tracking-wide text-muted-foreground">
+          {label}
+        </p>
+        <div className="break-all text-xs">{value}</div>
+      </div>
+    </div>
+  );
+}
+
+export function FileDetailsPanel({
+  memoryStoreName,
+  scope,
+  file,
+  readOnly,
+  onRestored,
+}: {
+  memoryStoreName: string;
+  scope: FileMemoryScope;
+  file: FileMemory | undefined;
+  readOnly: boolean;
+  onRestored?: (file: FileMemory, content: string) => void;
+}) {
+  const { t } = useI18n();
+  if (!file) {
+    return (
+      <div className="flex h-full items-center justify-center p-5 text-center text-xs text-muted-foreground">
+        {t("memory.files.selectForDetails")}
+      </div>
+    );
+  }
+
+  return (
+    <div className="h-full min-h-0 overflow-auto p-3">
+      <h3 className="mb-2 text-xs font-semibold">
+        {t("memory.files.details")}
+      </h3>
+      <DetailRow
+        icon={<HardDrive className="h-3.5 w-3.5" />}
+        label={t("memory.files.size")}
+        value={`${file.contentSizeBytes.toLocaleString()} B`}
+      />
+      <DetailRow
+        icon={<ListOrdered className="h-3.5 w-3.5" />}
+        label={t("memory.files.latestVersion")}
+        value={`v${file.latestSeq}`}
+      />
+      <DetailRow
+        icon={<Hash className="h-3.5 w-3.5" />}
+        label="SHA-256"
+        value={
+          <span className="font-mono text-[10px]">{file.contentSha256}</span>
+        }
+      />
+      <DetailRow
+        icon={<FileClock className="h-3.5 w-3.5" />}
+        label={t("memory.files.updatedAt")}
+        value={new Date(file.updatedAt).toLocaleString()}
+      />
+
+      <FileVersionHistory
+        memoryStoreName={memoryStoreName}
+        scope={scope}
+        file={file}
+        readOnly={readOnly}
+        onRestored={onRestored}
+      />
+    </div>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/memory/file-editor.tsx

@@ -0,0 +1,139 @@
+"use client";
+
+import { useMemo } from "react";
+import { AlertTriangle, FileText, Loader2 } from "lucide-react";
+
+import { Textarea } from "@/components/ui/textarea";
+import { useI18n } from "@/i18n/i18n-context";
+import { cn } from "@/lib/utils";
+
+export const MAX_FILE_PATH_BYTES = 800;
+export const MAX_FILE_CONTENT_BYTES = 100 * 1024;
+
+export type FilePathValidationError =
+  "path-required" | "path-traversal" | "path-too-large";
+export type FileContentValidationError = "content-too-large";
+
+export function normalizeFileMemoryPath(value: string): string {
+  const trimmed = value.trim();
+  return `/${trimmed.replace(/^\/+/, "")}`;
+}
+
+export function validateFileMemoryPath(
+  value: string,
+): FilePathValidationError | null {
+  const path = normalizeFileMemoryPath(value);
+  if (path === "/") return "path-required";
+  if (path.split("/").some((segment) => segment === "..")) {
+    return "path-traversal";
+  }
+  if (new TextEncoder().encode(path).byteLength > MAX_FILE_PATH_BYTES) {
+    return "path-too-large";
+  }
+  return null;
+}
+
+export function validateFileMemoryContent(
+  value: string,
+): FileContentValidationError | null {
+  return new TextEncoder().encode(value).byteLength > MAX_FILE_CONTENT_BYTES
+    ? "content-too-large"
+    : null;
+}
+
+export function FileEditor({
+  path,
+  content,
+  dirty,
+  readOnly,
+  loading,
+  error,
+  conflict,
+  onChange,
+}: {
+  path: string | null;
+  content: string;
+  dirty: boolean;
+  readOnly: boolean;
+  loading: boolean;
+  error?: string;
+  conflict?: string | null;
+  onChange: (content: string) => void;
+}) {
+  const { t } = useI18n();
+  const byteLength = useMemo(
+    () => new TextEncoder().encode(content).byteLength,
+    [content],
+  );
+
+  if (!path) {
+    return (
+      <div className="flex h-full flex-col items-center justify-center gap-2 p-8 text-center text-muted-foreground">
+        <FileText className="h-9 w-9 opacity-30" />
+        <p className="text-sm">{t("memory.files.selectFile")}</p>
+      </div>
+    );
+  }
+
+  if (loading) {
+    return (
+      <div className="flex h-full items-center justify-center gap-2 text-sm text-muted-foreground">
+        <Loader2 className="h-4 w-4 animate-spin" />
+        {t("common.loading")}
+      </div>
+    );
+  }
+
+  if (error) {
+    return (
+      <div className="flex h-full items-center justify-center p-8 text-sm text-[hsl(var(--destructive))]">
+        {t("memory.files.readFailed", { error })}
+      </div>
+    );
+  }
+
+  return (
+    <div className="flex h-full min-h-0 flex-col">
+      <div className="flex items-center justify-between border-b border-[hsl(var(--border))] px-3 py-2">
+        <div className="flex min-w-0 items-center gap-2">
+          <FileText className="h-4 w-4 shrink-0 text-[hsl(var(--primary))]" />
+          <span className="truncate font-mono text-xs" title={path}>
+            {path}
+          </span>
+          {dirty ? (
+            <span className="shrink-0 rounded-full bg-amber-500/15 px-2 py-0.5 text-[10px] font-medium text-amber-700 dark:text-amber-300">
+              {t("memory.files.unsaved")}
+            </span>
+          ) : null}
+        </div>
+        <span
+          className={cn(
+            "shrink-0 text-[10px] text-muted-foreground",
+            byteLength > MAX_FILE_CONTENT_BYTES &&
+              "text-[hsl(var(--destructive))]",
+          )}
+        >
+          {t("memory.files.byteCount", {
+            count: byteLength,
+            limit: MAX_FILE_CONTENT_BYTES,
+          })}
+        </span>
+      </div>
+      {conflict ? (
+        <div className="flex items-start gap-2 border-b border-amber-500/30 bg-amber-500/10 px-3 py-2 text-xs text-amber-800 dark:text-amber-200">
+          <AlertTriangle className="mt-0.5 h-3.5 w-3.5 shrink-0" />
+          <span>{t("memory.files.shaConflict")}</span>
+        </div>
+      ) : null}
+      <Textarea
+        aria-label={t("memory.files.editorLabel")}
+        value={content}
+        onChange={(event) => onChange(event.target.value)}
+        readOnly={readOnly}
+        spellCheck={false}
+        className="min-h-0 flex-1 resize-none rounded-none border-0 bg-transparent p-4 font-mono text-xs leading-5 shadow-none focus-visible:ring-0"
+        placeholder={t("memory.files.editorPlaceholder")}
+      />
+    </div>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/memory/file-mutation-dialogs.tsx

@@ -0,0 +1,181 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { Loader2 } from "lucide-react";
+
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { useI18n } from "@/i18n/i18n-context";
+
+import {
+  normalizeFileMemoryPath,
+  type FileContentValidationError,
+  type FilePathValidationError,
+  validateFileMemoryContent,
+  validateFileMemoryPath,
+} from "./file-editor";
+
+export type FileMutationDialog = "create" | "rename" | "delete" | null;
+
+const VALIDATION_MESSAGE_KEYS = {
+  "path-required": "memory.files.pathRequired",
+  "path-traversal": "memory.files.pathTraversal",
+  "path-too-large": "memory.files.pathTooLarge",
+  "content-too-large": "memory.files.contentTooLarge",
+} as const;
+
+export function FileMutationDialogs({
+  mode,
+  selectedPath,
+  pending,
+  onClose,
+  onCreate,
+  onRename,
+  onDelete,
+}: {
+  mode: FileMutationDialog;
+  selectedPath: string | null;
+  pending: boolean;
+  onClose: () => void;
+  onCreate: (path: string, content: string) => Promise<void>;
+  onRename: (path: string) => Promise<void>;
+  onDelete: () => Promise<void>;
+}) {
+  const { t } = useI18n();
+  const [path, setPath] = useState("");
+  const [content, setContent] = useState("");
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    setPath(mode === "rename" ? (selectedPath ?? "") : "");
+    setContent("");
+    setError(null);
+  }, [mode, selectedPath]);
+
+  function validationMessage(
+    code: FilePathValidationError | FileContentValidationError,
+  ): string {
+    return t(VALIDATION_MESSAGE_KEYS[code]);
+  }
+
+  async function submit() {
+    setError(null);
+    try {
+      if (mode === "delete") {
+        await onDelete();
+      } else {
+        const pathError = validateFileMemoryPath(path);
+        if (pathError) {
+          setError(validationMessage(pathError));
+          return;
+        }
+        if (mode === "create") {
+          const contentError = validateFileMemoryContent(content);
+          if (contentError) {
+            setError(validationMessage(contentError));
+            return;
+          }
+          await onCreate(normalizeFileMemoryPath(path), content);
+        } else if (mode === "rename") {
+          await onRename(normalizeFileMemoryPath(path));
+        }
+      }
+      onClose();
+    } catch (submitError) {
+      setError(
+        submitError instanceof Error
+          ? submitError.message
+          : t("common.unknownError"),
+      );
+    }
+  }
+
+  const titles = {
+    create: t("memory.files.createTitle"),
+    rename: t("memory.files.renameTitle"),
+    delete: t("memory.files.deleteTitle"),
+  };
+  const submitLabels = {
+    create: t("common.create"),
+    rename: t("memory.files.rename"),
+    delete: t("common.delete"),
+  };
+  const title = mode ? titles[mode] : "";
+  const submitLabel = mode ? submitLabels[mode] : "";
+
+  return (
+    <Dialog open={mode !== null} onOpenChange={(open) => !open && onClose()}>
+      <DialogContent className="sm:max-w-lg">
+        <DialogHeader>
+          <DialogTitle>{title}</DialogTitle>
+          <DialogDescription>
+            {mode === "delete"
+              ? t("memory.files.deleteDescription", {
+                  path: selectedPath ?? "",
+                })
+              : t("memory.files.pathHelp")}
+          </DialogDescription>
+        </DialogHeader>
+
+        {mode !== "delete" ? (
+          <div className="space-y-4 py-2">
+            <div className="space-y-1.5">
+              <Label htmlFor="file-memory-path">
+                {t("memory.files.pathLabel")}
+              </Label>
+              <Input
+                id="file-memory-path"
+                autoFocus
+                value={path}
+                onChange={(event) => setPath(event.target.value)}
+                placeholder="/notes/profile.md"
+              />
+            </div>
+            {mode === "create" ? (
+              <div className="space-y-1.5">
+                <Label htmlFor="file-memory-content">
+                  {t("memory.files.initialContent")}
+                </Label>
+                <Textarea
+                  id="file-memory-content"
+                  value={content}
+                  onChange={(event) => setContent(event.target.value)}
+                  rows={8}
+                  className="font-mono text-xs"
+                />
+              </div>
+            ) : null}
+          </div>
+        ) : null}
+
+        {error ? (
+          <p className="text-xs text-[hsl(var(--destructive))]">{error}</p>
+        ) : null}
+        <DialogFooter>
+          <Button type="button" variant="outline" onClick={onClose}>
+            {t("common.cancel")}
+          </Button>
+          <Button
+            type="button"
+            variant={mode === "delete" ? "destructive" : "default"}
+            onClick={() => void submit()}
+            disabled={pending}
+          >
+            {pending ? <Loader2 className="animate-spin" /> : null}
+            {submitLabel}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}