@tablestore/tablestore-agent-cli 0.2.8 → 0.2.10

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/error.tsx

@@ -4,6 +4,7 @@ import { useEffect } from "react";
 import { AlertTriangle, RefreshCw } from "lucide-react";
 
 import { Button } from "@/components/ui/button";
+import { useI18n } from "@/i18n/i18n-context";
 
 /**
  * Error boundary scoped to the `/memory` route subtree. Catches failures
@@ -18,6 +19,7 @@ export default function MemoryError({
   error: Error & { digest?: string };
   reset: () => void;
 }) {
+  const { t } = useI18n();
   useEffect(() => {
     console.error("Memory route error:", error);
   }, [error]);
@@ -29,15 +31,15 @@ export default function MemoryError({
       </div>
       <div className="space-y-2 max-w-md">
         <h2 className="text-xl font-semibold tracking-tight text-foreground">
-          记忆库加载失败
+          {t("memory.list.errorTitle")}
         </h2>
         <p className="text-sm text-muted-foreground break-words">
-          {error.message || "无法获取记忆库列表，请稍后重试。"}
+          {error.message || t("memory.list.errorDescription")}
         </p>
       </div>
       <Button onClick={reset}>
         <RefreshCw className="mr-2 h-4 w-4" aria-hidden="true" />
-        重试
+        {t("common.retry")}
       </Button>
     </div>
   );

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/page.tsx

@@ -1,22 +1,24 @@
-'use client';
+"use client";
 
 import Link from "next/link";
 import { Plus } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { PageHeader } from "@/components/layout/page-header";
 import { MemoryStoreList } from "@/components/memory/memory-store-list";
+import { useI18n } from "@/i18n/i18n-context";
 
 export default function MemoryPage() {
+  const { t } = useI18n();
   return (
     <div className="space-y-6">
       <PageHeader
-        title="记忆库"
-        description="管理智能体的长期记忆、检索记忆单元并观测请求记录"
+        title={t("memory.list.title")}
+        description={t("memory.list.description")}
       >
         <Button asChild>
           <Link href="/memory/create">
             <Plus className="mr-2 h-4 w-4" />
-            创建记忆库
+            {t("memory.list.create")}
           </Link>
         </Button>
       </PageHeader>

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/projects/error.tsx

@@ -4,6 +4,7 @@ import { useEffect } from "react";
 import { AlertTriangle, RefreshCw } from "lucide-react";
 
 import { Button } from "@/components/ui/button";
+import { useI18n } from "@/i18n/i18n-context";
 
 /**
  * Error boundary scoped to the `/projects` route subtree. Surfaces
@@ -17,6 +18,8 @@ export default function ProjectsError({
   error: Error & { digest?: string };
   reset: () => void;
 }) {
+  const { t } = useI18n();
+
   useEffect(() => {
     console.error("Projects route error:", error);
   }, [error]);
@@ -28,15 +31,15 @@ export default function ProjectsError({
       </div>
       <div className="space-y-2 max-w-md">
         <h2 className="text-xl font-semibold tracking-tight text-foreground">
-          项目列表加载失败
+          {t("projects.errorTitle")}
         </h2>
         <p className="text-sm text-muted-foreground break-words">
-          {error.message || "无法获取项目列表，请稍后重试。"}
+          {error.message || t("projects.errorDescription")}
         </p>
       </div>
       <Button onClick={reset}>
         <RefreshCw className="mr-2 h-4 w-4" aria-hidden="true" />
-        重试
+        {t("common.retry")}
       </Button>
     </div>
   );

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/projects/page.tsx

@@ -26,9 +26,11 @@ import {
   useInstances,
   useSwitchInstance,
 } from "@/hooks/use-instances";
+import { useI18n } from "@/i18n/i18n-context";
 
 export default function ProjectsPage() {
   const router = useRouter();
+  const { t } = useI18n();
   const { data, isLoading } = useInstances();
   const switchMutation = useSwitchInstance();
   const deleteMutation = useDeleteInstance();
@@ -55,11 +57,13 @@ export default function ProjectsPage() {
     const result = await exportMutation.mutateAsync(name);
     try {
       await navigator.clipboard.writeText(result.token);
-      toast.success(`已复制 ${name} 的 Token`);
+      toast.success(t("projects.exportSuccess", { name }));
     } catch {
       // navigator.clipboard can fail on insecure origins; show the token so
       // the user can copy manually.
-      toast.message("请手动复制 Token", { description: result.token });
+      toast.message(t("projects.exportManualTitle"), {
+        description: result.token,
+      });
     }
   }
 
@@ -73,12 +77,12 @@ export default function ProjectsPage() {
   return (
     <div className="space-y-6">
       <PageHeader
-        title="项目管理"
-        description="连接、切换与管理多个项目"
+        title={t("projects.title")}
+        description={t("projects.description")}
       >
         <Button onClick={() => setConnectOpen(true)}>
           <Plus className="mr-2 h-4 w-4" />
-          创建新项目
+          {t("projects.newProject")}
         </Button>
       </PageHeader>
 
@@ -95,12 +99,12 @@ export default function ProjectsPage() {
       ) : instances.length === 0 ? (
         <EmptyState
           icon={Database}
-          title="还没有项目"
-          description="创建你的第一个项目，解锁多环境切换"
+          title={t("projects.emptyTitle")}
+          description={t("projects.emptyDescription")}
           action={
             <Button onClick={() => setConnectOpen(true)}>
               <Plus className="mr-2 h-4 w-4" />
-              创建新项目
+              {t("projects.newProject")}
             </Button>
           }
         />
@@ -149,22 +153,23 @@ export default function ProjectsPage() {
       >
         <DialogContent>
           <DialogHeader>
-            <DialogTitle>删除项目</DialogTitle>
+            <DialogTitle>{t("projects.deleteTitle")}</DialogTitle>
             <DialogDescription>
-              确定要删除项目 &quot;{deleteTarget}&quot;
-              吗？此操作只影响本地配置，不会删除云端资源。
+              {t("projects.deleteConfirm", { name: deleteTarget ?? "" })}
             </DialogDescription>
           </DialogHeader>
           <DialogFooter>
             <Button variant="outline" onClick={() => setDeleteTarget(null)}>
-              取消
+              {t("common.cancel")}
             </Button>
             <Button
               variant="destructive"
               disabled={deleteMutation.isPending}
               onClick={handleConfirmDelete}
             >
-              {deleteMutation.isPending ? "删除中..." : "确认删除"}
+              {deleteMutation.isPending
+                ? t("common.deleting")
+                : t("common.confirmDelete")}
             </Button>
           </DialogFooter>
         </DialogContent>

package/dist/dashboard-runtime/dashboard/src/app/api/v1/api-keys/[id]/custom-policy/route.ts

@@ -62,9 +62,7 @@ interface PolicyDocument {
   Statement: PolicyStatement[];
 }
 
-function statementToRule(
-  statement: PolicyStatement,
-): {
+function statementToRule(statement: PolicyStatement): {
   resourceType: ResourceType;
   resourceName: string;
   scope?: MemoryStoreScope;

package/dist/dashboard-runtime/dashboard/src/app/api/v1/api-keys/[id]/effective-permissions/route.ts

@@ -102,20 +102,35 @@ export async function GET(request: NextRequest, _ctx: RouteContext) {
       ),
     ]);
 
-    const kbNames: string[] = kbResult.items.map(
-      (kb) => String((kb as Record<string, unknown>).knowledgeBaseName ?? ""),
-    ).filter(Boolean);
-    const memNames: string[] = memResult.items.map(
-      (ms) => String((ms as Record<string, unknown>).memoryStoreName ?? ""),
-    ).filter(Boolean);
-
-    const permMap = new Map<string, { read: boolean; write: boolean; manage: boolean }>();
+    const kbNames: string[] = kbResult.items
+      .map((kb) =>
+        String((kb as Record<string, unknown>).knowledgeBaseName ?? ""),
+      )
+      .filter(Boolean);
+    const memNames: string[] = memResult.items
+      .map((ms) =>
+        String((ms as Record<string, unknown>).memoryStoreName ?? ""),
+      )
+      .filter(Boolean);
+
+    const permMap = new Map<
+      string,
+      { read: boolean; write: boolean; manage: boolean }
+    >();
 
     for (const name of kbNames) {
-      permMap.set(`knowledgebase:${name}`, { read: false, write: false, manage: false });
+      permMap.set(`knowledgebase:${name}`, {
+        read: false,
+        write: false,
+        manage: false,
+      });
     }
     for (const name of memNames) {
-      permMap.set(`memorystore:${name}`, { read: false, write: false, manage: false });
+      permMap.set(`memorystore:${name}`, {
+        read: false,
+        write: false,
+        manage: false,
+      });
     }
 
     for (const policy of policies) {
@@ -162,18 +177,31 @@ export async function GET(request: NextRequest, _ctx: RouteContext) {
             const [resType, resName] = key.split(":") as [ResourceType, string];
 
             const matches = stmtResources.some((r) =>
-              arnMatchesResource(r, region, accountId, instanceName, resType, resName),
+              arnMatchesResource(
+                r,
+                region,
+                accountId,
+                instanceName,
+                resType,
+                resName,
+              ),
             );
             if (!matches) continue;
 
             if (resType === "knowledgebase") {
-              if (actionsMatchGroup(stmtActions, KB_READ_ACTIONS)) perm.read = true;
-              if (actionsMatchGroup(stmtActions, KB_WRITE_ACTIONS)) perm.write = true;
-              if (actionsMatchGroup(stmtActions, KB_MANAGE_ACTIONS)) perm.manage = true;
+              if (actionsMatchGroup(stmtActions, KB_READ_ACTIONS))
+                perm.read = true;
+              if (actionsMatchGroup(stmtActions, KB_WRITE_ACTIONS))
+                perm.write = true;
+              if (actionsMatchGroup(stmtActions, KB_MANAGE_ACTIONS))
+                perm.manage = true;
             } else {
-              if (actionsMatchGroup(stmtActions, MEM_READ_ACTIONS)) perm.read = true;
-              if (actionsMatchGroup(stmtActions, MEM_WRITE_ACTIONS)) perm.write = true;
-              if (actionsMatchGroup(stmtActions, MEM_MANAGE_ACTIONS)) perm.manage = true;
+              if (actionsMatchGroup(stmtActions, MEM_READ_ACTIONS))
+                perm.read = true;
+              if (actionsMatchGroup(stmtActions, MEM_WRITE_ACTIONS))
+                perm.write = true;
+              if (actionsMatchGroup(stmtActions, MEM_MANAGE_ACTIONS))
+                perm.manage = true;
             }
           }
         }

package/dist/dashboard-runtime/dashboard/src/app/api/v1/api-keys/[id]/policies/route.ts

@@ -23,14 +23,6 @@ interface RouteContext {
   params: Promise<{ id: string }>;
 }
 
-function formatValidationError(
-  issues: { path: (string | number)[]; message: string }[],
-): string {
-  return issues
-    .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
-    .join("; ");
-}
-
 export async function GET(request: NextRequest, _ctx: RouteContext) {
   ensureApiLogContext(request);
   try {

package/dist/dashboard-runtime/dashboard/src/app/api/v1/api-keys/[id]/route.ts

@@ -39,7 +39,9 @@ interface RouteContext {
 function formatValidationError(
   issues: { path: (string | number)[]; message: string }[],
 ): string {
-  return issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ");
+  return issues
+    .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+    .join("; ");
 }
 
 export async function PATCH(request: NextRequest, ctx: RouteContext) {

package/dist/dashboard-runtime/dashboard/src/app/api/v1/api-keys/filter-by-permission/route.ts

@@ -10,10 +10,7 @@ import {
   requireClients,
   successResponse,
 } from "@/lib/server/api-helpers";
-import {
-  getImsClient,
-  listServiceCredentials,
-} from "@/lib/server/ims-client";
+import { getImsClient, listServiceCredentials } from "@/lib/server/ims-client";
 import {
   extractAccountId,
   extractUserName,
@@ -74,9 +71,13 @@ export async function GET(request: NextRequest) {
     const auth = requireClients(request);
     if (auth instanceof NextResponse) return auth;
 
-    const resourceType = request.nextUrl.searchParams.get("resourceType") as ResourceType | null;
+    const resourceType = request.nextUrl.searchParams.get(
+      "resourceType",
+    ) as ResourceType | null;
     const resourceName = request.nextUrl.searchParams.get("resourceName");
-    const operationGroup = request.nextUrl.searchParams.get("operationGroup") as OperationGroup | null;
+    const operationGroup = request.nextUrl.searchParams.get(
+      "operationGroup",
+    ) as OperationGroup | null;
 
     if (!resourceType || !resourceName || !operationGroup) {
       return errorResponse(
@@ -103,18 +104,28 @@ export async function GET(request: NextRequest) {
       status: string;
     }[] = [];
 
-    const userPoliciesCache = new Map<string, Awaited<ReturnType<typeof listPoliciesForUser>>>();
+    const userPoliciesCache = new Map<
+      string,
+      Awaited<ReturnType<typeof listPoliciesForUser>>
+    >();
     const policyDocCache = new Map<string, PolicyDocument | null>();
 
-    async function getPolicyDoc(policyName: string): Promise<PolicyDocument | null> {
-      if (policyDocCache.has(policyName)) return policyDocCache.get(policyName)!;
+    async function getPolicyDoc(
+      policyName: string,
+    ): Promise<PolicyDocument | null> {
+      if (policyDocCache.has(policyName))
+        return policyDocCache.get(policyName)!;
       try {
         const policyInfo = await getPolicy(ramClient, policyName);
         if (!policyInfo) {
           policyDocCache.set(policyName, null);
           return null;
         }
-        const docStr = await getPolicyVersion(ramClient, policyName, policyInfo.defaultVersion);
+        const docStr = await getPolicyVersion(
+          ramClient,
+          policyName,
+          policyInfo.defaultVersion,
+        );
         const doc = JSON.parse(docStr) as PolicyDocument;
         policyDocCache.set(policyName, doc);
         return doc;

package/dist/dashboard-runtime/dashboard/src/app/api/v1/api-keys/route.ts

@@ -67,11 +67,15 @@ export async function POST(request: NextRequest) {
     if (auth instanceof NextResponse) return auth;
 
     const raw = await request.json().catch(() => null);
-    const body = raw && typeof raw === "object" ? raw as Record<string, unknown> : {};
+    const body =
+      raw && typeof raw === "object" ? (raw as Record<string, unknown>) : {};
     const credentialAgeDays =
-      typeof body.credentialAgeDays === "number" ? body.credentialAgeDays : undefined;
+      typeof body.credentialAgeDays === "number"
+        ? body.credentialAgeDays
+        : undefined;
     const userCredentialName =
-      typeof body.serviceCredentialName === "string" && body.serviceCredentialName.trim()
+      typeof body.serviceCredentialName === "string" &&
+      body.serviceCredentialName.trim()
         ? (body.serviceCredentialName as string).trim()
         : undefined;
 
@@ -81,7 +85,11 @@ export async function POST(request: NextRequest) {
     try {
       accountId = await getAccountId(auth.config);
     } catch {
-      return errorResponse("INTERNAL_ERROR", "无法获取账号 ID，请检查 AK/SK 配置。", 500);
+      return errorResponse(
+        "INTERNAL_ERROR",
+        "无法获取账号 ID，请检查 AK/SK 配置。",
+        500,
+      );
     }
 
     const suffix = Math.random().toString(36).slice(2, 8);
@@ -92,7 +100,10 @@ export async function POST(request: NextRequest) {
       const created = await createImsUser(client, ramUserName, accountId);
       userPrincipalName = created.userPrincipalName;
     } catch (imsErr) {
-      const record = imsErr && typeof imsErr === "object" ? imsErr as Record<string, unknown> : {};
+      const record =
+        imsErr && typeof imsErr === "object"
+          ? (imsErr as Record<string, unknown>)
+          : {};
       const code = typeof record.code === "string" ? record.code : "";
       if (code === "EntityAlreadyExists.User") {
         return errorResponse("CONFLICT", "RAM 用户名冲突，请重试。", 409);
@@ -108,7 +119,10 @@ export async function POST(request: NextRequest) {
     try {
       const serviceCredentialName =
         userCredentialName ??
-        "ots_apikey_" + Date.now().toString(36) + "_" + Math.random().toString(36).slice(2, 6);
+        "ots_apikey_" +
+          Date.now().toString(36) +
+          "_" +
+          Math.random().toString(36).slice(2, 6);
 
       const apiKey = await createServiceCredential(client, {
         serviceCredentialName,

package/dist/dashboard-runtime/dashboard/src/app/api/v1/instances/[name]/route.ts

@@ -132,8 +132,7 @@ export async function PUT(request: NextRequest, context: RouteContext) {
         access_key_secret: updated.access_key_secret,
         api_key: updated.api_key,
         ots_endpoint: updated.ots_endpoint || ots.ots_endpoint,
-        ots_instance_name:
-          updated.ots_instance_name || ots.ots_instance_name,
+        ots_instance_name: updated.ots_instance_name || ots.ots_instance_name,
         oss_endpoint: updated.oss_endpoint || oss.oss_endpoint,
         oss_bucket_name: updated.oss_bucket_name || oss.oss_bucket_name,
         region: updated.region || ots.region || oss.region,
@@ -171,8 +170,9 @@ export async function DELETE(_request: NextRequest, context: RouteContext) {
     const { name } = await context.params;
     const wasActive = getActiveInstanceName() === name;
     removeInstance(name);
-    const requestActiveInstance =
-      _request.cookies.get(ACTIVE_INSTANCE_COOKIE_NAME)?.value;
+    const requestActiveInstance = _request.cookies.get(
+      ACTIVE_INSTANCE_COOKIE_NAME,
+    )?.value;
     let shouldClearActiveCookie = wasActive;
     if (requestActiveInstance) {
       try {
@@ -187,7 +187,9 @@ export async function DELETE(_request: NextRequest, context: RouteContext) {
       setActiveInstance(null);
       clearClientCache();
     }
-    const response = successResponse({ activeInstance: getActiveInstanceName() });
+    const response = successResponse({
+      activeInstance: getActiveInstanceName(),
+    });
     if (shouldClearActiveCookie) {
       clearActiveInstanceCookie(response);
       clearTokenSourceCookie(response);

package/dist/dashboard-runtime/dashboard/src/app/api/v1/instances/[name]/use/route.ts

@@ -70,8 +70,7 @@ export async function POST(_request: NextRequest, context: RouteContext) {
       ots_instance_name: detail.ots_instance_name || ots.ots_instance_name,
       oss_endpoint: detail.oss_endpoint || oss.oss_endpoint,
       oss_bucket_name: detail.oss_bucket_name || oss.oss_bucket_name,
-      region:
-        detail.region || ots.region || oss.region,
+      region: detail.region || ots.region || oss.region,
     });
     response.cookies.set({
       name: SESSION_COOKIE_NAME,

package/dist/dashboard-runtime/dashboard/src/app/api/v1/instances/route.ts

@@ -32,10 +32,7 @@ import {
   connectInstanceSchema,
   importInstanceSchema,
 } from "@/schemas/instance";
-import type {
-  InstanceActionResult,
-  InstanceSummary,
-} from "@/types/instance";
+import type { InstanceActionResult, InstanceSummary } from "@/types/instance";
 
 /**
  * GET /api/v1/instances
@@ -84,7 +81,9 @@ export async function POST(request: NextRequest) {
 
     const { name, fields, activate } = created;
 
-    if (listInstances().some((r) => r.name === name && !r.is_default_fallback)) {
+    if (
+      listInstances().some((r) => r.name === name && !r.is_default_fallback)
+    ) {
       return errorResponse(
         "CONFLICT",
         `Instance "${name}" already exists.`,

package/dist/dashboard-runtime/dashboard/src/app/api/v1/knowledge-bases/[name]/chunks/route.ts

@@ -37,7 +37,10 @@ export async function PUT(request: NextRequest, context: RouteContext) {
 
     const { knowledgeBaseName: _ignored, ...safeBody } = body;
     void _ignored;
-    const resp = await kb.updateChunks({ ...safeBody, knowledgeBaseName: name });
+    const resp = await kb.updateChunks({
+      ...safeBody,
+      knowledgeBaseName: name,
+    });
     return forwardResponse(resp);
   } catch (error) {
     return handleApiError(error);

package/dist/dashboard-runtime/dashboard/src/app/api/v1/knowledge-bases/[name]/documents/[docId]/route.ts

@@ -92,7 +92,11 @@ export async function PUT(request: NextRequest, context: RouteContext) {
       });
     }
 
-    const { knowledgeBaseName: _ignoredName, docId: _ignoredDocId, ...rest } = body;
+    const {
+      knowledgeBaseName: _ignoredName,
+      docId: _ignoredDocId,
+      ...rest
+    } = body;
     void _ignoredName;
     void _ignoredDocId;
 

package/dist/dashboard-runtime/dashboard/src/app/api/v1/knowledge-bases/[name]/documents/route.ts

@@ -105,7 +105,10 @@ export async function POST(request: NextRequest, context: RouteContext) {
         ? documents.map((doc) => {
             if (doc && typeof doc === "object" && "ossKey" in doc) {
               const item = doc as Record<string, unknown>;
-              return { ...item, ossKey: normalizeDocumentOssKey(item.ossKey, bucket) };
+              return {
+                ...item,
+                ossKey: normalizeDocumentOssKey(item.ossKey, bucket),
+              };
             }
             return doc;
           })
@@ -143,7 +146,10 @@ export async function DELETE(request: NextRequest, context: RouteContext) {
 
     const { knowledgeBaseName: _ignoredDel, ...safeBody } = body;
     void _ignoredDel;
-    const resp = await kb.deleteDocuments({ ...safeBody, knowledgeBaseName: name });
+    const resp = await kb.deleteDocuments({
+      ...safeBody,
+      knowledgeBaseName: name,
+    });
     return forwardResponse(resp);
   } catch (error) {
     return handleApiError(error);

package/dist/dashboard-runtime/dashboard/src/app/api/v1/knowledge-bases/[name]/documents/upload/route.ts

@@ -35,7 +35,10 @@ export const dynamic = "force-dynamic";
 // and catch runaway inputs; it can be overridden via env.
 const DEFAULT_MAX_SINGLE_FILE_BYTES = 110 * 1024 * 1024;
 
-function parsePositiveEnvBytes(raw: string | undefined, fallback: number): number {
+function parsePositiveEnvBytes(
+  raw: string | undefined,
+  fallback: number,
+): number {
   if (!raw) return fallback;
   const parsed = Number(raw);
   return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
@@ -81,7 +84,9 @@ export async function POST(request: NextRequest, context: RouteContext) {
     }
 
     const formData = await request.formData();
-    const files = formData.getAll("files").filter((f): f is File => f instanceof File);
+    const files = formData
+      .getAll("files")
+      .filter((f): f is File => f instanceof File);
     if (files.length === 0) {
       return forwardResponse({
         code: "BAD_REQUEST",

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

@@ -0,0 +1,93 @@
+import {
+  defaultFileMemoryRoot,
+  listLocalMemoryFiles,
+  searchLocalMemories,
+  syncMemoryMount,
+  type LocalMemoryHit,
+  type MountScope,
+} from "@tablestore/tablestore-agent-sdk";
+import type { MemoryClient } from "@tablestore/tablestore-agent-sdk";
+
+import type { MemoryFilesSyncSummary } from "@/types/llm-chat";
+
+/**
+ * 文件记忆（openclaw local 模式同款）的单轮检索结果。
+ * `hits` 供注入与 memory.done 事件；`files`/`sync` 供 memory.files 事件。
+ */
+export interface FileMemoryTurnResult {
+  hits: LocalMemoryHit[];
+  scopeDir: string;
+  files: Array<{ rel: string; size: number }>;
+  sync: MemoryFilesSyncSummary;
+}
+
+/**
+ * 一轮对话的文件记忆链路：AuthorizeMemoryMount（STS）→ OSS 增量同步到本地
+ * 镜像目录 → 本地词法检索 → 收集文件树。同步失败不抛错——继续用本地
+ * 旧副本检索（openclaw 同款降级行为）。
+ */
+export async function runFileMemoryRetrieval(opts: {
+  memoryClient: MemoryClient;
+  otsInstanceName: string;
+  memoryStoreName: string;
+  scope: MountScope;
+  query: string;
+  topK: number;
+}): Promise<FileMemoryTurnResult> {
+  const localRoot = defaultFileMemoryRoot(
+    opts.otsInstanceName,
+    opts.memoryStoreName,
+  );
+  const sync = await syncMemoryMount({
+    authorizeMount: (request) =>
+      opts.memoryClient.authorizeMemoryMount(request),
+    memoryStoreName: opts.memoryStoreName,
+    scope: opts.scope,
+    localRoot,
+  });
+  const search = searchLocalMemories({
+    scopeDir: sync.scopeDir,
+    query: opts.query,
+    topK: opts.topK,
+  });
+  const files = listLocalMemoryFiles(sync.scopeDir).map((f) => ({
+    rel: f.rel,
+    size: f.size,
+  }));
+  return {
+    hits: search.results,
+    scopeDir: sync.scopeDir,
+    files,
+    sync: {
+      ok: sync.ok,
+      downloaded: sync.downloaded,
+      deleted: sync.deleted,
+      total: sync.total,
+      ...(sync.error ? { error: sync.error } : {}),
+    },
+  };
+}
+
+/**
+ * 文件记忆注入块（openclaw 同款）：固定的目录挂载通知 +（有命中时）
+ * `## TableStore Memory` 编号片段列表。返回值以 `\n\n` 开头，供
+ * `buildFinalMessages` 直接拼接到 system message 末尾。
+ */
+export function formatFileMemoryBlock(
+  scopeDir: string,
+  hits: LocalMemoryHit[],
+): string {
+  const dirNotice = [
+    "## TableStore File Memory",
+    `This conversation's long-term memory tree is mounted read-only at: ${scopeDir}`,
+    "(start at index.md; do NOT read sibling directories — they belong to other scopes)",
+  ].join("\n");
+  if (!hits.length) return `\n\n${dirNotice}`;
+  const lines = ["## TableStore Memory"];
+  hits.forEach((hit, index) => {
+    lines.push(
+      `${index + 1}. ${hit.unit.text} [score=${hit.score.toFixed(3)}, source=${hit.unit.source}]`,
+    );
+  });
+  return `\n\n${dirNotice}\n\n${lines.join("\n")}`;
+}