@tablestore/tablestore-agent-cli 0.2.10 → 0.2.11

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-scope-bar.tsx

@@ -75,7 +75,11 @@ function scopesEqual(a: MemoryScope, b: MemoryScope): boolean {
   );
 }
 
-export function MemoryScopeBar() {
+export function MemoryScopeBar({
+  allowScopeDiscovery = true,
+}: {
+  allowScopeDiscovery?: boolean;
+}) {
   const { t } = useI18n();
   const FIELDS = FIELD_KEYS.map((f) => ({
     key: f.key,
@@ -116,12 +120,12 @@ export function MemoryScopeBar() {
     setError(null);
   }, [currentScope]);
 
-  // Pull the real list of scope tuples present in this store. The engine
-  // accepts wildcard `*` for any dimension, so we always send the wildcard
-  // envelope and let it return every scope under the store. Replaces the
-  // previous "guess from the first memory unit's scope" heuristic which
-  // could only ever surface one tuple even on stores with dozens of scopes.
-  const scopeQuery = useAllMemoryStoreScopes(storeName ?? "", WILDCARD_SCOPE);
+  // Pull real scope tuples only for storage modes that expose ListMemoryScopes.
+  // Writable filemem deliberately disables this query and uses manual + local
+  // recent scopes instead; no server-discovered data is implied in that mode.
+  const scopeQuery = useAllMemoryStoreScopes(storeName ?? "", WILDCARD_SCOPE, {
+    enabled: allowScopeDiscovery,
+  });
   const knownScopes = scopeQuery.data?.items ?? [];
   const knownTruncated = scopeQuery.data?.truncated ?? false;
   const isWildcardSelected = hasWildcardScope(currentScope);
@@ -192,20 +196,22 @@ export function MemoryScopeBar() {
                 {t("memory.scopeBar.readOnly")}
               </span>
             )}
-            <ScopePicker
-              open={pickerOpen}
-              onOpenChange={setPickerOpen}
-              currentScope={currentScope}
-              knownScopes={knownScopes}
-              isLoading={scopeQuery.isLoading}
-              isFetching={scopeQuery.isFetching}
-              truncated={knownTruncated}
-              isWildcardSelected={isWildcardSelected}
-              onPickWildcard={() => pickFromList(WILDCARD_SCOPE)}
-              onPickScope={pickFromList}
-              onRefresh={() => scopeQuery.refetch()}
-              t={t}
-            />
+            {allowScopeDiscovery ? (
+              <ScopePicker
+                open={pickerOpen}
+                onOpenChange={setPickerOpen}
+                currentScope={currentScope}
+                knownScopes={knownScopes}
+                isLoading={scopeQuery.isLoading}
+                isFetching={scopeQuery.isFetching}
+                truncated={knownTruncated}
+                isWildcardSelected={isWildcardSelected}
+                onPickWildcard={() => pickFromList(WILDCARD_SCOPE)}
+                onPickScope={pickFromList}
+                onRefresh={() => scopeQuery.refetch()}
+                t={t}
+              />
+            ) : null}
             <Button
               variant="outline"
               size="sm"

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-search-form.tsx

@@ -25,6 +25,46 @@ interface MemorySearchFormProps {
   onSubmit: (values: MemorySearchValues) => void | Promise<void>;
 }
 
+interface MemorySearchValidationInput {
+  searchable: boolean;
+  query: string;
+  topK: number;
+  minSimilarity: number;
+}
+
+interface MemorySearchValidationMessages {
+  scopeRequired: string;
+  queryRequired: string;
+  topKRange: string;
+  similarityRange: string;
+}
+
+const DEFAULT_VALIDATION_MESSAGES: MemorySearchValidationMessages = {
+  scopeRequired: "请先在范围栏中设置「应用」和「租户」的具体值",
+  queryRequired: "请输入检索内容",
+  topKRange: "Top K 必须在 1 到 50 之间",
+  similarityRange: "相似度阈值必须在 0 到 1 之间",
+};
+
+export function validateSearchForm(
+  values: MemorySearchValidationInput,
+  messages: MemorySearchValidationMessages = DEFAULT_VALIDATION_MESSAGES,
+): string | null {
+  if (!values.searchable) return messages.scopeRequired;
+  if (!values.query.trim()) return messages.queryRequired;
+  if (!Number.isInteger(values.topK) || values.topK < 1 || values.topK > 50) {
+    return messages.topKRange;
+  }
+  if (
+    !Number.isFinite(values.minSimilarity) ||
+    values.minSimilarity < 0 ||
+    values.minSimilarity > 1
+  ) {
+    return messages.similarityRange;
+  }
+  return null;
+}
+
 export function MemorySearchForm({
   scope,
   isLoading,
@@ -43,20 +83,17 @@ export function MemorySearchForm({
   async function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
     event.preventDefault();
     setError(null);
-    if (!searchable) {
-      setError(t("memory.search.scopeRequired"));
-      return;
-    }
-    if (!query.trim()) {
-      setError(t("memory.search.queryRequired"));
-      return;
-    }
-    if (topK < 0 || topK > 50) {
-      setError(t("memory.search.topKRange"));
-      return;
-    }
-    if (minSimilarity < 0 || minSimilarity > 1) {
-      setError(t("memory.search.similarityRange"));
+    const validationError = validateSearchForm(
+      { searchable, query, topK, minSimilarity },
+      {
+        scopeRequired: t("memory.search.scopeRequired"),
+        queryRequired: t("memory.search.queryRequired"),
+        topKRange: t("memory.search.topKRange"),
+        similarityRange: t("memory.search.similarityRange"),
+      },
+    );
+    if (validationError) {
+      setError(validationError);
       return;
     }
 

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-search-results.tsx

@@ -33,6 +33,10 @@ export function MemorySearchResults({
   elapsedMs,
 }: MemorySearchResultsProps) {
   const { t, locale } = useI18n();
+  // `created_at` is the event time of the source message, not the write time —
+  // surface the fallback rules on hover so the line isn't read as an insert
+  // timestamp.
+  const hintCreatedAt = t("memory.search.resultCreatedAtHint");
   if (!results) {
     return (
       <EmptyState
@@ -100,7 +104,7 @@ export function MemorySearchResults({
                     scope: formatScope(hit.unit.scope),
                   })}
                 </span>
-                <span>
+                <span title={hintCreatedAt}>
                   {t("memory.search.resultCreatedAt", {
                     time: formatTimestamp(hit.unit.created_at, locale),
                   })}

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-settings-form.tsx

@@ -18,9 +18,10 @@ import {
 } from "@/components/ui/form";
 import { useUpdateMemoryStore } from "@/hooks/use-update-memory-store";
 import { useLocaleRevalidation } from "@/hooks/use-locale-revalidation";
+import { storageModeCapabilities } from "@/lib/memory-storage-mode";
 import { useI18n } from "@/i18n/i18n-context";
 import type { TranslateFn } from "@/i18n/i18n-context";
-import type { MemoryStore } from "@/types/memory";
+import type { MemoryStore, UpdateMemoryStoreRequest } from "@/types/memory";
 
 function buildUpdateMemoryStoreSchema(t: TranslateFn) {
   return z.object({
@@ -41,6 +42,25 @@ type UpdateMemoryStoreInput = z.infer<
   ReturnType<typeof buildUpdateMemoryStoreSchema>
 >;
 
+export function buildUpdateMemoryStoreRequest(
+  memoryStore: MemoryStore,
+  values: UpdateMemoryStoreInput,
+): UpdateMemoryStoreRequest {
+  const request: UpdateMemoryStoreRequest = {
+    memoryStoreName: memoryStore.memoryStoreName,
+    description: values.description?.length ? values.description : undefined,
+  };
+  if (!storageModeCapabilities(memoryStore.storageMode).supportsExtraction) {
+    return request;
+  }
+
+  const initialInstructions = memoryStore.extractInstructions ?? "";
+  const nextInstructions = values.extractInstructions ?? "";
+  return nextInstructions === initialInstructions
+    ? request
+    : { ...request, extractInstructions: nextInstructions };
+}
+
 interface MemorySettingsFormProps {
   memoryStore: MemoryStore;
 }
@@ -48,6 +68,7 @@ interface MemorySettingsFormProps {
 export function MemorySettingsForm({ memoryStore }: MemorySettingsFormProps) {
   const updateStore = useUpdateMemoryStore();
   const { t } = useI18n();
+  const capabilities = storageModeCapabilities(memoryStore.storageMode);
 
   const resolver = useMemo(
     () => zodResolver(buildUpdateMemoryStoreSchema(t)),
@@ -68,24 +89,9 @@ export function MemorySettingsForm({ memoryStore }: MemorySettingsFormProps) {
 
   async function onSubmit(values: UpdateMemoryStoreInput) {
     try {
-      // The currently-running server build may predate extractInstructions and
-      // rejects unknown JSON fields. Only include it in the PATCH when the user
-      // actually changed it, so description-only edits keep working. An empty
-      // string is a deliberate "clear" (the field uses pointer/PATCH semantics
-      // server-side once a newer build is deployed).
-      const initialInstructions = memoryStore.extractInstructions ?? "";
-      const nextInstructions = values.extractInstructions ?? "";
-      const instructionsChanged = nextInstructions !== initialInstructions;
-
-      await updateStore.mutateAsync({
-        memoryStoreName: memoryStore.memoryStoreName,
-        description: values.description?.length
-          ? values.description
-          : undefined,
-        ...(instructionsChanged
-          ? { extractInstructions: nextInstructions }
-          : {}),
-      });
+      await updateStore.mutateAsync(
+        buildUpdateMemoryStoreRequest(memoryStore, values),
+      );
       toast.success(t("memory.settings.updateSuccess"));
     } catch (error) {
       toast.error(
@@ -131,33 +137,35 @@ export function MemorySettingsForm({ memoryStore }: MemorySettingsFormProps) {
           </div>
         </section>
 
-        <section className="rounded-lg border border-[hsl(var(--border))] bg-[hsl(var(--card))] p-5 shadow-sm">
-          <SettingsSectionHeader
-            title={t("memory.settings.extractSection")}
-            description={t("memory.settings.extractSectionDesc")}
-          />
-          <FormField
-            control={form.control}
-            name="extractInstructions"
-            render={({ field }) => (
-              <FormItem>
-                <FormLabel>{t("memory.settings.extractLabel")}</FormLabel>
-                <FormControl>
-                  <Textarea
-                    placeholder={t("memory.settings.extractPlaceholder")}
-                    className="resize-none"
-                    rows={5}
-                    {...field}
-                  />
-                </FormControl>
-                <FormDescription>
-                  {t("memory.settings.extractHelp")}
-                </FormDescription>
-                <FormMessage />
-              </FormItem>
-            )}
-          />
-        </section>
+        {capabilities.supportsExtraction && (
+          <section className="rounded-lg border border-[hsl(var(--border))] bg-[hsl(var(--card))] p-5 shadow-sm">
+            <SettingsSectionHeader
+              title={t("memory.settings.extractSection")}
+              description={t("memory.settings.extractSectionDesc")}
+            />
+            <FormField
+              control={form.control}
+              name="extractInstructions"
+              render={({ field }) => (
+                <FormItem>
+                  <FormLabel>{t("memory.settings.extractLabel")}</FormLabel>
+                  <FormControl>
+                    <Textarea
+                      placeholder={t("memory.settings.extractPlaceholder")}
+                      className="resize-none"
+                      rows={5}
+                      {...field}
+                    />
+                  </FormControl>
+                  <FormDescription>
+                    {t("memory.settings.extractHelp")}
+                  </FormDescription>
+                  <FormMessage />
+                </FormItem>
+              )}
+            />
+          </section>
+        )}
 
         <div className="flex justify-end border-t border-[hsl(var(--border-light))] pt-4">
           <Button type="submit" disabled={updateStore.isPending}>

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-store-card.tsx

@@ -25,7 +25,12 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { cn } from "@/lib/utils";
-import { isFileMemory, storageModeLabel } from "@/lib/memory-storage-mode";
+import {
+  storageModeCapabilities,
+  storageModeToSelection,
+  type MemoryCardAction,
+  type MemoryCardShortcut,
+} from "@/lib/memory-storage-mode";
 import { useI18n } from "@/i18n/i18n-context";
 import type { MemoryStore } from "@/types/memory";
 
@@ -52,7 +57,77 @@ function MemoryStoreCardImpl({ memoryStore, onDelete }: MemoryStoreCardProps) {
   const { memoryStoreName } = memoryStore;
   const storePath = `/memory/${encodeURIComponent(memoryStoreName)}`;
   const basePath = `${storePath}/units`;
-  const fileMemory = isFileMemory(memoryStore.storageMode);
+  const capabilities = storageModeCapabilities(memoryStore.storageMode);
+  const storageSelection = storageModeToSelection(memoryStore.storageMode);
+  const inputLabel =
+    storageSelection.inputType === "short-term"
+      ? t("memory.create.shortTermInputLabel")
+      : t("memory.create.fileInputLabel");
+  const storageLabel = storageSelection.storageStructures
+    .map((structure) =>
+      structure === "structured"
+        ? t("memory.create.structuredStorageLabel")
+        : t("memory.create.fileStorageLabel"),
+    )
+    .join(" + ");
+  const shortcutContent = {
+    longTerm: {
+      segment: "units",
+      icon: <Database className="h-3.5 w-3.5" />,
+      label: t("memory.card.longTerm"),
+      title: t("memory.card.longTermTitle"),
+    },
+    shortTerm: {
+      segment: "messages",
+      icon: <MessageSquare className="h-3.5 w-3.5" />,
+      label: t("memory.card.shortTerm"),
+      title: t("memory.card.shortTermTitle"),
+    },
+    extract: {
+      segment: "tasks",
+      icon: <ListChecks className="h-3.5 w-3.5" />,
+      label: t("memory.card.extract"),
+      title: t("memory.card.extractTitle"),
+    },
+    consolidate: {
+      segment: "dream",
+      icon: <Sparkles className="h-3.5 w-3.5" />,
+      label: t("memory.card.consolidate"),
+      title: t("memory.card.consolidateTitle"),
+    },
+    files: {
+      segment: "units",
+      icon: <FolderTree className="h-3.5 w-3.5" />,
+      label: t("memory.detail.tabFiles"),
+      title: t("memory.detail.tabFiles"),
+    },
+  } satisfies Record<
+    MemoryCardShortcut,
+    { segment: string; icon: React.ReactNode; label: string; title: string }
+  >;
+  const actionContent = {
+    units: {
+      icon: capabilities.structured ? (
+        <TableProperties className="mr-2 h-4 w-4" />
+      ) : (
+        <FolderTree className="mr-2 h-4 w-4" />
+      ),
+      label: capabilities.structured
+        ? t("memory.detail.tabUnits")
+        : t("memory.detail.tabFiles"),
+    },
+    search: {
+      icon: <Search className="mr-2 h-4 w-4" />,
+      label: t("memory.detail.tabSearch"),
+    },
+    settings: {
+      icon: <Settings className="mr-2 h-4 w-4" />,
+      label: t("memory.detail.tabSettings"),
+    },
+  } satisfies Record<
+    MemoryCardAction,
+    { icon: React.ReactNode; label: string }
+  >;
 
   return (
     <Link href={basePath} className="no-underline">
@@ -64,22 +139,6 @@ function MemoryStoreCardImpl({ memoryStore, onDelete }: MemoryStoreCardProps) {
               <h3 className="min-w-0 truncate text-base font-semibold text-foreground">
                 {memoryStoreName}
               </h3>
-              <span
-                className={cn(
-                  "inline-flex shrink-0 items-center gap-1 rounded-full border px-1.5 py-0.5 text-[10px]",
-                  fileMemory
-                    ? "border-violet-200 bg-violet-50 text-violet-700"
-                    : "border-slate-200 bg-slate-50 text-slate-600",
-                )}
-                title={storageModeLabel(memoryStore.storageMode, t)}
-              >
-                {fileMemory ? (
-                  <FolderTree className="h-2.5 w-2.5" />
-                ) : (
-                  <Database className="h-2.5 w-2.5" />
-                )}
-                {storageModeLabel(memoryStore.storageMode, t)}
-              </span>
             </div>
 
             <div
@@ -93,24 +152,18 @@ function MemoryStoreCardImpl({ memoryStore, onDelete }: MemoryStoreCardProps) {
                   </Button>
                 </DropdownMenuTrigger>
                 <DropdownMenuContent align="end">
-                  <DropdownMenuItem
-                    onClick={() => router.push(`${storePath}/units`)}
-                  >
-                    <TableProperties className="mr-2 h-4 w-4" />
-                    {t("memory.detail.tabUnits")}
-                  </DropdownMenuItem>
-                  <DropdownMenuItem
-                    onClick={() => router.push(`${storePath}/search`)}
-                  >
-                    <Search className="mr-2 h-4 w-4" />
-                    {t("memory.detail.tabSearch")}
-                  </DropdownMenuItem>
-                  <DropdownMenuItem
-                    onClick={() => router.push(`${storePath}/settings`)}
-                  >
-                    <Settings className="mr-2 h-4 w-4" />
-                    {t("memory.detail.tabSettings")}
-                  </DropdownMenuItem>
+                  {capabilities.cardActions.map((segment) => {
+                    const content = actionContent[segment];
+                    return (
+                      <DropdownMenuItem
+                        key={segment}
+                        onClick={() => router.push(`${storePath}/${segment}`)}
+                      >
+                        {content.icon}
+                        {content.label}
+                      </DropdownMenuItem>
+                    );
+                  })}
                   <DropdownMenuItem
                     className="text-[hsl(var(--destructive))] focus:text-[hsl(var(--destructive))]"
                     onClick={() => onDelete?.(memoryStoreName)}
@@ -123,39 +176,41 @@ function MemoryStoreCardImpl({ memoryStore, onDelete }: MemoryStoreCardProps) {
             </div>
           </div>
 
+          <div className="mt-3 flex flex-wrap gap-1.5 text-[10px]">
+            <span
+              className="inline-flex rounded-full border border-slate-200 bg-slate-50 px-2 py-0.5 text-slate-600"
+              title={`${t("memory.card.inputType")}: ${inputLabel}`}
+            >
+              {t("memory.card.inputType")}: {inputLabel}
+            </span>
+            <span
+              className={cn(
+                "inline-flex rounded-full border px-2 py-0.5",
+                capabilities.files
+                  ? "border-violet-200 bg-violet-50 text-violet-700"
+                  : "border-slate-200 bg-slate-50 text-slate-600",
+              )}
+              title={`${t("memory.card.storageStructure")}: ${storageLabel}`}
+            >
+              {t("memory.card.storageStructure")}: {storageLabel}
+            </span>
+          </div>
+
           <div className="mt-auto flex items-center gap-1 pt-4 text-xs text-muted-foreground min-w-0">
-            <HintLink
-              segment="units"
-              storePath={storePath}
-              router={router}
-              icon={<Database className="h-3.5 w-3.5" />}
-              label={t("memory.card.longTerm")}
-              title={t("memory.card.longTermTitle")}
-            />
-            <HintLink
-              segment="messages"
-              storePath={storePath}
-              router={router}
-              icon={<MessageSquare className="h-3.5 w-3.5" />}
-              label={t("memory.card.shortTerm")}
-              title={t("memory.card.shortTermTitle")}
-            />
-            <HintLink
-              segment="tasks"
-              storePath={storePath}
-              router={router}
-              icon={<ListChecks className="h-3.5 w-3.5" />}
-              label={t("memory.card.extract")}
-              title={t("memory.card.extractTitle")}
-            />
-            <HintLink
-              segment="dream"
-              storePath={storePath}
-              router={router}
-              icon={<Sparkles className="h-3.5 w-3.5" />}
-              label={t("memory.card.consolidate")}
-              title={t("memory.card.consolidateTitle")}
-            />
+            {capabilities.cardShortcuts.map((shortcut) => {
+              const content = shortcutContent[shortcut];
+              return (
+                <HintLink
+                  key={shortcut}
+                  segment={content.segment}
+                  storePath={storePath}
+                  router={router}
+                  icon={content.icon}
+                  label={content.label}
+                  title={content.title}
+                />
+              );
+            })}
           </div>
         </CardContent>
       </CardInteractive>
@@ -210,6 +265,8 @@ export const MemoryStoreCard = memo(
   MemoryStoreCardImpl,
   (prev, next) =>
     prev.memoryStore === next.memoryStore ||
-    prev.memoryStore.memoryStoreName === next.memoryStore.memoryStoreName,
+    (prev.memoryStore.memoryStoreName === next.memoryStore.memoryStoreName &&
+      prev.memoryStore.storageMode === next.memoryStore.storageMode &&
+      prev.onDelete === next.onDelete),
 );
 MemoryStoreCard.displayName = "MemoryStoreCard";

package/dist/dashboard-runtime/dashboard/src/components/memory/memory-unit-table.tsx

@@ -140,6 +140,10 @@ export function MemoryUnitTable({
   onDelete,
 }: MemoryUnitTableProps) {
   const { t, locale } = useI18n();
+  // `created_at` is the event time of the source message, not the write time —
+  // surface the fallback rules on hover so the column label isn't read as an
+  // insert timestamp.
+  const hintCreatedAt = t("memory.units.tableCreatedAtHint");
   if (!units.length) {
     return (
       <div className="rounded-lg border border-dashed py-12 text-center text-sm text-muted-foreground">
@@ -163,7 +167,7 @@ export function MemoryUnitTable({
             <TableHead className="w-[120px]">
               {t("memory.units.tableVersion")}
             </TableHead>
-            <TableHead className="w-[170px]">
+            <TableHead className="w-[170px]" title={hintCreatedAt}>
               {t("memory.units.tableCreatedAt")}
             </TableHead>
             <TableHead className="w-[160px] text-right">