@tablestore/tablestore-agent-cli 0.3.1 → 0.4.1

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/scope/page.tsx

@@ -0,0 +1,59 @@
+"use client";
+
+import { useMemo } from "react";
+import { useParams, useSearchParams } from "next/navigation";
+
+import { ScopeWorkspace } from "@/components/memory/scope-workspace";
+import { ScopeDirectoryExplorer } from "@/components/memory/scope-directory-explorer";
+import { useI18n } from "@/i18n/i18n-context";
+import { parseExactScope } from "@/lib/scope-workspace";
+
+export function ScopeWorkspaceRouteBoundary({
+  memoryStoreName,
+  search,
+}: {
+  memoryStoreName: string;
+  search: string;
+}) {
+  const { t } = useI18n();
+  const scope = useMemo(
+    () => parseExactScope(new URLSearchParams(search)),
+    [search],
+  );
+  return (
+    <div className="space-y-6">
+      {!scope ? (
+        <div
+          className="rounded-xl border border-dashed px-6 py-12 text-center"
+          data-testid="scope-workspace-invalid"
+        >
+          <h2 className="font-semibold">
+            {t("memory.scopeWorkspace.invalidTitle")}
+          </h2>
+          <p className="mt-2 text-sm text-muted-foreground">
+            {t("memory.scopeWorkspace.invalidDescription")}
+          </p>
+        </div>
+      ) : (
+        <ScopeWorkspace memoryStoreName={memoryStoreName} scope={scope} />
+      )}
+      <ScopeDirectoryExplorer
+        key={memoryStoreName}
+        memoryStoreName={memoryStoreName}
+      />
+    </div>
+  );
+}
+
+export default function ScopeWorkspacePage() {
+  const params = useParams<{ store: string }>();
+  const searchParams = useSearchParams();
+  const search = searchParams.toString();
+  const memoryStoreName = decodeURIComponent(params.store);
+  return (
+    <ScopeWorkspaceRouteBoundary
+      memoryStoreName={memoryStoreName}
+      search={search}
+    />
+  );
+}

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/search/page.tsx

@@ -1,12 +1,18 @@
 "use client";
 
-import { useMemo, useState } from "react";
+import { useEffect, useMemo, useRef, useState } from "react";
 import { useParams, useSearchParams } from "next/navigation";
 import { toast } from "sonner";
 import { useMemorySearch } from "@/hooks/use-memory-search";
-import { buildMemoryScope } from "@/lib/memory";
-import type { MemorySearchHit } from "@/types/memory";
+import { useMemoryStore } from "@/hooks/use-memory-store";
 import {
+  buildMemoryScope,
+  hasPreciseScope,
+  hasSearchableScope,
+} from "@/lib/memory";
+import type { SearchMemoryResponse } from "@/types/memory";
+import {
+  buildSearchMemoryRequest,
   MemorySearchForm,
   type MemorySearchValues,
 } from "@/components/memory/memory-search-form";
@@ -25,29 +31,66 @@ export default function MemorySearchPage() {
     [searchParamsString],
   );
   const search = useMemorySearch();
-  const [results, setResults] = useState<MemorySearchHit[] | null>(null);
+  const store = useMemoryStore(memoryStoreName);
+  // Fail closed while Store metadata is unavailable: managed-file searches
+  // reject wildcard Scopes, so an unknown Store type must not be treated as
+  // structured merely because its describe request failed.
+  const requiresExactScope =
+    !store.data ||
+    store.data.storageMode === "managed-file" ||
+    store.data.storageMode === "file+ots";
+  const scopeEligible =
+    hasSearchableScope(scope) &&
+    (!requiresExactScope || hasPreciseScope(scope));
+  const [response, setResponse] = useState<SearchMemoryResponse | null>(null);
   const [elapsedMs, setElapsedMs] = useState<number | undefined>();
+  const resultsPaneRef = useRef<HTMLDivElement>(null);
+  const searchContextKey = JSON.stringify([
+    memoryStoreName,
+    scope.appId,
+    scope.tenantId ?? "",
+    scope.agentId ?? "",
+    scope.runId ?? "",
+  ]);
+  const latestSearchContextRef = useRef(searchContextKey);
+  const latestSearchRequestRef = useRef(0);
+
+  useEffect(() => {
+    latestSearchContextRef.current = searchContextKey;
+    latestSearchRequestRef.current += 1;
+    setResponse(null);
+    setElapsedMs(undefined);
+  }, [searchContextKey]);
 
   async function handleSubmit(values: MemorySearchValues) {
+    const submittedContextKey = searchContextKey;
+    const requestId = latestSearchRequestRef.current + 1;
+    latestSearchRequestRef.current = requestId;
     const startTime = Date.now();
+    setResponse(null);
+    setElapsedMs(undefined);
     try {
-      const response = await search.mutateAsync({
-        memoryStoreName,
-        query: values.query,
-        scope: values.scope,
-        topK: values.topK,
-        enableRerank: values.enableRerank,
-        // Only forward the threshold when the user opts in (> 0); the server
-        // treats 0 as "no filter", and omitting it keeps the request
-        // byte-compatible with servers that predate the minSimilarity field.
-        ...(values.minSimilarity > 0
-          ? { minSimilarity: values.minSimilarity }
-          : {}),
-        metadata: values.metadata,
+      const response = await search.mutateAsync(
+        buildSearchMemoryRequest(memoryStoreName, values),
+      );
+      if (
+        latestSearchContextRef.current !== submittedContextKey ||
+        latestSearchRequestRef.current !== requestId
+      ) {
+        return;
+      }
+      setResponse({
+        ...response,
+        results: response.results ?? [],
+        fileResults: response.fileResults ?? [],
+        evidence: response.evidence ?? [],
       });
-      setResults(response.results ?? []);
       setElapsedMs(Date.now() - startTime);
+      requestAnimationFrame(() => {
+        resultsPaneRef.current?.scrollTo({ top: 0, behavior: "smooth" });
+      });
     } catch (error) {
+      if (latestSearchRequestRef.current !== requestId) return;
       toast.error(
         error instanceof Error ? error.message : t("memory.search.failed"),
       );
@@ -60,13 +103,26 @@ export default function MemorySearchPage() {
       aside={
         <MemorySearchForm
           scope={scope}
-          isLoading={search.isPending}
+          requiresExactScope={requiresExactScope}
+          isLoading={search.isPending || store.isPending}
           onSubmit={handleSubmit}
         />
       }
     >
-      <div className="min-h-0 flex-1 overflow-y-auto px-7 py-5 max-md:px-4">
-        <MemorySearchResults results={results} elapsedMs={elapsedMs} />
+      <div
+        ref={resultsPaneRef}
+        className="min-h-0 flex-1 overflow-y-auto px-7 py-5 max-md:px-4"
+      >
+        <MemorySearchResults
+          response={response}
+          elapsedMs={elapsedMs}
+          scopeBlocked={!store.isPending && !scopeEligible}
+          onChooseScope={() =>
+            document
+              .getElementById("memory-scope-bar")
+              ?.scrollIntoView({ behavior: "smooth", block: "center" })
+          }
+        />
       </div>
     </WorkbenchLayout>
   );

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/settings/page.tsx

@@ -4,7 +4,10 @@ import { useParams } from "next/navigation";
 import { Skeleton } from "@/components/ui/skeleton";
 import { useMemoryStore } from "@/hooks/use-memory-store";
 import { MemorySettingsForm } from "@/components/memory/memory-settings-form";
-import { storageModeLabel } from "@/lib/memory-storage-mode";
+import {
+  resolveMemoryStoreTypeContract,
+  storageModeLabel,
+} from "@/lib/memory-storage-mode";
 import { formatDateTime } from "@/lib/format-datetime";
 import { useI18n } from "@/i18n/i18n-context";
 
@@ -31,9 +34,14 @@ export default function MemorySettingsPage() {
     );
   }
 
+  const storeType = resolveMemoryStoreTypeContract(memoryStore);
+
   return (
     <div className="grid gap-6 xl:grid-cols-[minmax(0,1fr)_320px]">
-      <MemorySettingsForm memoryStore={memoryStore} />
+      <MemorySettingsForm
+        key={memoryStore.memoryStoreName}
+        memoryStore={memoryStore}
+      />
 
       <aside className="space-y-6">
         <section className="rounded-lg border border-[hsl(var(--border))] bg-[hsl(var(--card))] p-5 shadow-sm">
@@ -48,6 +56,14 @@ export default function MemorySettingsPage() {
                 memoryStore.storageMode ?? "ots"
               }）`}
             />
+            <ReadOnlyField
+              label={t("memory.settings.inputType")}
+              value={storeType.inputType}
+            />
+            <ReadOnlyField
+              label={t("memory.settings.outputTypes")}
+              value={storeType.outputTypes.join(" + ")}
+            />
             <ReadOnlyField
               label={t("memory.settings.otsInstance")}
               value={memoryStore.otsInstance ?? "-"}

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/units/page.tsx

@@ -13,6 +13,13 @@ import {
 import { toast } from "sonner";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
 import { PageHeader } from "@/components/layout/page-header";
 import { ConfirmDialog } from "@/components/shared/confirm-dialog";
 import { RefreshButton } from "@/components/shared/refresh-button";
@@ -26,7 +33,11 @@ import {
 import { useMemoryUnits } from "@/hooks/use-memory-units";
 import { useDeleteMemoryUnit } from "@/hooks/use-delete-memory-unit";
 import { useMemoryStore } from "@/hooks/use-memory-store";
-import { buildMemoryScope, hasWildcardScope } from "@/lib/memory";
+import {
+  buildMemoryScope,
+  hasPreciseScope,
+  hasWildcardScope,
+} from "@/lib/memory";
 import { storageModeCapabilities } from "@/lib/memory-storage-mode";
 import {
   applyFileScopeToSearchParams,
@@ -49,6 +60,10 @@ import { FileScopeOnboarding } from "@/components/memory/file-scope-onboarding";
 import { apiGet } from "@/services/api-client";
 import { useI18n } from "@/i18n/i18n-context";
 import { useDataScopeKey } from "@/providers/runtime-context-provider";
+import {
+  shouldRefreshUnitsAfterAdd,
+  type MemoryUnitsViewMode,
+} from "@/lib/memory-units-view";
 
 export default function MemoryUnitsPage() {
   const { t } = useI18n();
@@ -75,7 +90,7 @@ export default function MemoryUnitsPage() {
   const writableFileMemory = capabilities.writableFiles;
   const requestedView = searchParams.get("view");
   const requestedFile = searchParams.get("file");
-  const [viewMode, setViewMode] = useState<"units" | "files">(
+  const [viewMode, setViewMode] = useState<MemoryUnitsViewMode>(
     requestedView === "files" ? "files" : "units",
   );
   useEffect(() => {
@@ -144,7 +159,7 @@ export default function MemoryUnitsPage() {
     tokenStack: string[];
     currentToken?: string;
   }>({ scopeKey, tokenStack: [] });
-  const [pageSize] = useState(20);
+  const [pageSize, setPageSize] = useState(20);
   const [searchId, setSearchId] = useState("");
   const [searchedUnit, setSearchedUnit] = useState<MemoryUnit | null>(null);
   const [searching, setSearching] = useState(false);
@@ -247,8 +262,8 @@ export default function MemoryUnitsPage() {
       toast.error(t("memory.units.searchIdRequired"));
       return;
     }
-    if (!scope.appId) {
-      toast.error(t("memory.units.preciseScopeRequired"));
+    if (!hasPreciseScope(scope)) {
+      toast.error(t("memory.units.idSearchPreciseScopeRequired"));
       return;
     }
     setSearching(true);
@@ -309,41 +324,41 @@ export default function MemoryUnitsPage() {
           {fileMemory && capabilities.structured && (
             <UnitsViewToggle viewMode={viewMode} onChange={setViewMode} t={t} />
           )}
-          {viewMode === "units" && (
-            <>
-              <RefreshButton
-                loading={unitsQuery.isRefetching}
-                onClick={() => {
-                  unitsQuery.refetch();
-                  clearSearch();
-                }}
-              />
-              {wildcard ? (
-                <TooltipProvider delayDuration={200}>
-                  <Tooltip>
-                    <TooltipTrigger asChild>
-                      <span tabIndex={0} className="inline-flex">
-                        <Button disabled className="pointer-events-none">
-                          <Plus className="mr-2 h-4 w-4" />
-                          {t("memory.units.addMemory")}
-                        </Button>
-                      </span>
-                    </TooltipTrigger>
-                    <TooltipContent side="bottom" className="max-w-[240px]">
-                      <p>{t("memory.units.addWildcardHint")}</p>
-                    </TooltipContent>
-                  </Tooltip>
-                </TooltipProvider>
-              ) : (
-                <Button
-                  onClick={() => setAddDialogState({ scopeKey, open: true })}
-                >
-                  <Plus className="mr-2 h-4 w-4" />
-                  {t("memory.units.addMemory")}
-                </Button>
-              )}
-            </>
-          )}
+          {viewMode === "units" ? (
+            <RefreshButton
+              loading={unitsQuery.isRefetching}
+              onClick={() => {
+                unitsQuery.refetch();
+                clearSearch();
+              }}
+            />
+          ) : null}
+          {capabilities.acceptsMessages ? (
+            wildcard ? (
+              <TooltipProvider delayDuration={200}>
+                <Tooltip>
+                  <TooltipTrigger asChild>
+                    <span tabIndex={0} className="inline-flex">
+                      <Button disabled className="pointer-events-none">
+                        <Plus className="mr-2 h-4 w-4" />
+                        {t("memory.units.addMemory")}
+                      </Button>
+                    </span>
+                  </TooltipTrigger>
+                  <TooltipContent side="bottom" className="max-w-[240px]">
+                    <p>{t("memory.units.addWildcardHint")}</p>
+                  </TooltipContent>
+                </Tooltip>
+              </TooltipProvider>
+            ) : (
+              <Button
+                onClick={() => setAddDialogState({ scopeKey, open: true })}
+              >
+                <Plus className="mr-2 h-4 w-4" />
+                {t("memory.units.addMemory")}
+              </Button>
+            )
+          ) : null}
         </div>
       </PageHeader>
 
@@ -378,7 +393,7 @@ export default function MemoryUnitsPage() {
             />
             <Button
               onClick={handleSearchById}
-              disabled={searching || !scope.appId}
+              disabled={searching || !hasPreciseScope(scope)}
             >
               <Search className="mr-1.5 h-4 w-4" />
               {searching ? t("memory.units.querying") : t("memory.units.query")}
@@ -408,11 +423,35 @@ export default function MemoryUnitsPage() {
           />
 
           {!searchedUnit && (
-            <div className="flex items-center justify-between py-2">
+            <div className="flex flex-wrap items-center justify-between gap-3 py-2">
               <span className="text-sm text-muted-foreground">
-                {t("memory.units.page", { page: tokenStack.length + 1 })}
+                {t("memory.units.pagination", {
+                  page: tokenStack.length + 1,
+                  total: unitsQuery.data?.totalCount ?? units.length,
+                })}
               </span>
-              <div className="flex items-center gap-4">
+              <div className="flex items-center gap-3">
+                <Select
+                  value={String(pageSize)}
+                  onValueChange={(value) => {
+                    setPageSize(Number(value));
+                    setPagination({ scopeKey, tokenStack: [] });
+                  }}
+                >
+                  <SelectTrigger
+                    className="h-8 w-[112px]"
+                    aria-label={t("memory.units.pageSize")}
+                  >
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    {[10, 20, 50].map((size) => (
+                      <SelectItem key={size} value={String(size)}>
+                        {t("memory.units.pageSizeValue", { size })}
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
                 <Button
                   variant="outline"
                   size="sm"
@@ -465,11 +504,14 @@ export default function MemoryUnitsPage() {
       <MemoryAddDialog
         memoryStoreName={memoryStoreName}
         scope={scope}
+        projectsToFiles={capabilities.files}
         open={showAddDialog}
         onOpenChange={(open) => setAddDialogState({ scopeKey, open })}
         onSuccess={() => {
-          unitsQuery.refetch();
           clearSearch();
+          if (shouldRefreshUnitsAfterAdd(viewMode)) {
+            void unitsQuery.refetch();
+          }
         }}
       />
       <MemoryUnitDetailPanel
@@ -512,8 +554,8 @@ function UnitsViewToggle({
   onChange,
   t,
 }: {
-  viewMode: "units" | "files";
-  onChange: (mode: "units" | "files") => void;
+  viewMode: MemoryUnitsViewMode;
+  onChange: (mode: MemoryUnitsViewMode) => void;
   t: ReturnType<typeof useI18n>["t"];
 }) {
   const options: Array<{

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/wiki/page.tsx

@@ -0,0 +1,157 @@
+"use client";
+
+import { useMemo } from "react";
+import { useParams, useRouter, useSearchParams } from "next/navigation";
+import { BookOpen } from "lucide-react";
+
+import { ScopeCombobox } from "@/components/memory/scope-combobox";
+import { readWikiDetailTab, WikiDetail } from "@/components/wiki/wiki-detail";
+import { useI18n } from "@/i18n/i18n-context";
+import type { MemoryScope } from "@/types/memory";
+import type { WikiScope } from "@/types/wiki";
+
+export interface WikiDetailRoute {
+  scope: WikiScope;
+  runContext?: string;
+  path?: string;
+}
+
+function readConcrete(value: string | null): string | null {
+  const normalized = value?.trim() ?? "";
+  return normalized && normalized !== "*" ? normalized : null;
+}
+
+export function toWikiAgentScope(scope: MemoryScope): WikiScope | null {
+  const appId = readConcrete(scope.appId);
+  const tenantId = readConcrete(scope.tenantId ?? null);
+  const agentId = readConcrete(scope.agentId ?? null);
+  return appId && tenantId && agentId ? { appId, tenantId, agentId } : null;
+}
+
+export function readWikiDetailRoute(
+  params: URLSearchParams,
+): WikiDetailRoute | null {
+  const scope = toWikiAgentScope({
+    appId: params.get("appId") ?? "",
+    tenantId: params.get("tenantId") ?? undefined,
+    agentId: params.get("agentId") ?? undefined,
+  });
+  if (!scope) return null;
+  const path = params.get("path")?.trim() || undefined;
+  const runContext = readConcrete(params.get("runId")) ?? undefined;
+  return {
+    scope,
+    ...(runContext ? { runContext } : {}),
+    ...(path ? { path } : {}),
+  };
+}
+
+function scopeParams(scope: WikiScope, runContext?: string): URLSearchParams {
+  return new URLSearchParams([
+    ["appId", scope.appId],
+    ["tenantId", scope.tenantId],
+    ["agentId", scope.agentId],
+    ["runId", runContext ?? "*"],
+  ]);
+}
+
+export function buildWikiPageHref(
+  memoryStoreName: string,
+  scope: WikiScope,
+  path?: string,
+  runContext?: string,
+): string {
+  const params = scopeParams(scope, runContext);
+  if (path) params.set("path", path);
+  return `/memory/${encodeURIComponent(memoryStoreName)}/wiki?${params.toString()}`;
+}
+
+export function replaceWikiPageRoute(
+  replace: (href: string) => void,
+  memoryStoreName: string,
+  scope: WikiScope,
+  path: string,
+  runContext?: string,
+): void {
+  replace(buildWikiPageHref(memoryStoreName, scope, path, runContext));
+}
+
+export default function WikiPage() {
+  const { t } = useI18n();
+  const params = useParams<{ store: string }>();
+  const router = useRouter();
+  const searchParams = useSearchParams();
+  const search = searchParams.toString();
+  const route = useMemo(
+    () => readWikiDetailRoute(new URLSearchParams(search)),
+    [search],
+  );
+  const memoryStoreName = decodeURIComponent(params.store);
+  const browserScope = useMemo<MemoryScope>(
+    () => ({
+      appId: searchParams.get("appId") ?? "*",
+      tenantId: searchParams.get("tenantId") ?? "*",
+      agentId: searchParams.get("agentId") ?? "*",
+      runId: searchParams.get("runId") ?? "*",
+    }),
+    [searchParams],
+  );
+
+  return (
+    <div className="space-y-4">
+      <div className="flex items-center justify-between gap-3">
+        <div>
+          <h2 className="text-lg font-semibold">{t("wiki.list.title")}</h2>
+          <p className="text-xs text-muted-foreground">
+            {t("wiki.list.description")}
+          </p>
+        </div>
+      </div>
+
+      {route ? (
+        <WikiDetail
+          memoryStoreName={memoryStoreName}
+          scope={route.scope}
+          runContext={route.runContext}
+          initialTab={readWikiDetailTab(searchParams.get("tab"))}
+          selectedPagePath={route.path}
+          onOpenPage={(path) =>
+            replaceWikiPageRoute(
+              (href) => router.replace(href),
+              memoryStoreName,
+              route.scope,
+              path,
+              route.runContext,
+            )
+          }
+        />
+      ) : (
+        <div className="rounded-xl border border-dashed border-[hsl(var(--border))] px-6 py-12 text-center">
+          <BookOpen className="mx-auto mb-3 h-9 w-9 text-muted-foreground" />
+          <h2 className="font-semibold">{t("wiki.list.agentScopeTitle")}</h2>
+          <p className="mx-auto mt-2 max-w-xl text-sm text-muted-foreground">
+            {t("wiki.list.agentScopeRequired")}
+          </p>
+          <div className="mx-auto mt-4 flex max-w-md flex-col items-center gap-2">
+            <span className="text-xs font-medium text-muted-foreground">
+              {t("wiki.list.chooseAgent")}
+            </span>
+            <ScopeCombobox
+              memoryStoreName={memoryStoreName}
+              currentScope={browserScope}
+              maxLevel="agent"
+              placeholder={t("wiki.list.chooseAgent")}
+              onPick={(selected) => {
+                const wikiScope = toWikiAgentScope(selected);
+                if (!wikiScope) return;
+                router.replace(
+                  buildWikiPageHref(memoryStoreName, wikiScope, undefined, "*"),
+                );
+              }}
+            />
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/app/api/v1/llm/chat/file-memory-curator.ts

@@ -228,10 +228,7 @@ export async function extractDurableMemories(input: {
       },
     );
     if (!response.ok) {
-      const body = await response.text().catch(() => "");
-      throw new Error(
-        `memory curator ${response.status}: ${body.slice(0, 200) || response.statusText}`,
-      );
+      throw new Error(`memory curator request failed (${response.status})`);
     }
     const json = (await response.json()) as {
       choices?: Array<{ message?: { content?: string } }>;

package/dist/dashboard-runtime/dashboard/src/app/api/v1/llm/chat/file-memory-helpers.ts

@@ -1,16 +1,16 @@
-export interface BrowserFileMemoryPromptHit {
+export interface FileMemoryPromptHit {
   text: string;
   source: string;
   score: number;
 }
 
-/** Format bounded browser-provided file evidence for the model prompt. */
-export function formatFileMemoryBlock(
-  hits: BrowserFileMemoryPromptHit[],
-): string {
+export type BrowserFileMemoryPromptHit = FileMemoryPromptHit;
+
+/** Format bounded Chat BFF file evidence for the model prompt. */
+export function formatFileMemoryBlock(hits: FileMemoryPromptHit[]): string {
   const header = [
     "## TableStore File Memory",
-    "The following evidence was read from this conversation's exact-scope file memory through the JSON file API.",
+    "The following evidence was read from this conversation's exact-scope file memory through the JSON Item API and a bounded in-process SHA cache.",
     "Treat source paths as citations; do not assume access to any server-local mount.",
   ].join("\n");
   if (!hits.length) return `\n\n${header}`;