@tablestore/tablestore-agent-cli 0.2.7 → 0.2.9

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/file-memory/file/route.ts

@@ -0,0 +1,69 @@
+import { type NextRequest } from "next/server";
+
+import {
+  errorResponse,
+  handleApiError,
+  requireClients,
+  successResponse,
+} from "@/lib/server/api-helpers";
+import { readLocalMemoryFile } from "@tablestore/tablestore-agent-sdk";
+
+import { readMountScope, resolveScopeDir } from "../_helpers";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+interface RouteContext {
+  params: Promise<{ store: string }>;
+}
+
+/**
+ * GET /api/v1/memory/stores/:store/file-memory/file?appId=…&…&path=<rel>
+ *
+ * 读取本地镜像目录里的单个投影文件。`path` 为 scope 目录内的相对路径；
+ * 越界（`..`/绝对路径）回 400，文件不存在回 404。
+ */
+export async function GET(request: NextRequest, context: RouteContext) {
+  try {
+    const { store } = await context.params;
+    const auth = requireClients(request);
+    if (!("memory" in auth)) return auth;
+
+    const params = new URL(request.url).searchParams;
+    const scope = readMountScope(params);
+    if (!scope) {
+      return errorResponse("BAD_REQUEST", "appId is required", 400);
+    }
+    const rel = params.get("path") ?? "";
+    if (!rel) {
+      return errorResponse("BAD_REQUEST", "path is required", 400);
+    }
+    const { scopeDir } = resolveScopeDir(
+      auth.config.ots_instance_name ?? "",
+      store,
+      scope,
+    );
+
+    let content: string;
+    try {
+      content = readLocalMemoryFile(scopeDir, rel);
+    } catch (err) {
+      const code = (err as NodeJS.ErrnoException)?.code;
+      if (code === "ENOENT" || code === "EISDIR") {
+        return errorResponse("NOT_FOUND", `memory file not found: ${rel}`, 404);
+      }
+      // 越界路径由 readLocalMemoryFile 抛出无 errno code 的普通 Error → 400 并回传
+      // 受控 message；其余带 code 的系统级错误（EACCES/IO 等）交给 handleApiError
+      // 归为 500，避免误标 400 并泄露含服务器绝对路径的原始错误信息。
+      if (code) throw err;
+      return errorResponse(
+        "BAD_REQUEST",
+        err instanceof Error ? err.message : String(err),
+        400,
+      );
+    }
+    return successResponse({ rel, content });
+  } catch (error) {
+    return handleApiError(error);
+  }
+}

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/file-memory/sync/route.ts

@@ -0,0 +1,69 @@
+import { type NextRequest } from "next/server";
+
+import {
+  errorResponse,
+  handleApiError,
+  requireClients,
+  successResponse,
+} from "@/lib/server/api-helpers";
+import {
+  listLocalMemoryFiles,
+  syncMemoryMount,
+} from "@tablestore/tablestore-agent-sdk";
+
+import { readMountScope, resolveScopeDir } from "../_helpers";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+interface RouteContext {
+  params: Promise<{ store: string }>;
+}
+
+/**
+ * POST /api/v1/memory/stores/:store/file-memory/sync
+ *
+ * 把该 scope 的 OSS 文件投影增量同步到本地镜像目录（AuthorizeMemoryMount +
+ * STS，凭证只在 server 侧使用，不回传浏览器），返回同步统计与文件树。
+ * 同步失败不视为 HTTP 错误——本地旧副本仍可浏览，`sync.ok=false` 携带原因。
+ */
+export async function POST(request: NextRequest, context: RouteContext) {
+  try {
+    const { store } = await context.params;
+    const auth = requireClients(request);
+    if (!("memory" in auth)) return auth;
+
+    let body: Record<string, unknown>;
+    try {
+      body = (await request.json()) as Record<string, unknown>;
+    } catch {
+      return errorResponse("BAD_REQUEST", "Request body must be JSON", 400);
+    }
+    const scope = readMountScope(
+      (body?.scope ?? null) as Record<string, unknown> | null,
+    );
+    if (!scope) {
+      return errorResponse("BAD_REQUEST", "scope.appId is required", 400);
+    }
+
+    const { localRoot } = resolveScopeDir(
+      auth.config.ots_instance_name ?? "",
+      store,
+      scope,
+    );
+    const ttlSeconds =
+      typeof body?.ttlSeconds === "number" ? body.ttlSeconds : undefined;
+    const sync = await syncMemoryMount({
+      authorizeMount: (req) => auth.memory.authorizeMemoryMount(req),
+      memoryStoreName: store,
+      scope,
+      localRoot,
+      ...(ttlSeconds ? { ttlSeconds } : {}),
+    });
+    const { scopeDir, ...syncStats } = sync;
+    const files = listLocalMemoryFiles(scopeDir);
+    return successResponse({ scopeDir, sync: syncStats, files });
+  } catch (error) {
+    return handleApiError(error);
+  }
+}

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/file-memory/tree/route.ts

@@ -0,0 +1,44 @@
+import { type NextRequest } from "next/server";
+
+import {
+  errorResponse,
+  handleApiError,
+  requireClients,
+  successResponse,
+} from "@/lib/server/api-helpers";
+import { listLocalMemoryFiles } from "@tablestore/tablestore-agent-sdk";
+
+import { readMountScope, resolveScopeDir } from "../_helpers";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+interface RouteContext {
+  params: Promise<{ store: string }>;
+}
+
+/**
+ * GET /api/v1/memory/stores/:store/file-memory/tree?appId=…&tenantId=…&agentId=…&runId=…
+ *
+ * 只读本地镜像目录的文件树，不触发同步、不联网。目录尚不存在时返回空列表。
+ */
+export async function GET(request: NextRequest, context: RouteContext) {
+  try {
+    const { store } = await context.params;
+    const auth = requireClients(request);
+    if (!("memory" in auth)) return auth;
+
+    const scope = readMountScope(new URL(request.url).searchParams);
+    if (!scope) {
+      return errorResponse("BAD_REQUEST", "appId is required", 400);
+    }
+    const { scopeDir } = resolveScopeDir(
+      auth.config.ots_instance_name ?? "",
+      store,
+      scope,
+    );
+    return successResponse({ scopeDir, files: listLocalMemoryFiles(scopeDir) });
+  } catch (error) {
+    return handleApiError(error);
+  }
+}

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/scopes/route.ts

@@ -10,10 +10,7 @@ import {
   successResponse,
 } from "@/lib/server/api-helpers";
 
-import {
-  readPaginationFromQuery,
-  readScopeFromQuery,
-} from "../_scope";
+import { readPaginationFromQuery, readScopeFromQuery } from "../_scope";
 
 /**
  * GET /api/v1/memory/stores/:store/scopes
@@ -57,7 +54,8 @@ export async function GET(request: NextRequest, context: RouteContext) {
     return successResponse({
       items,
       totalCount: items.length,
-      nextToken: typeof data.nextToken === "string" ? data.nextToken : undefined,
+      nextToken:
+        typeof data.nextToken === "string" ? data.nextToken : undefined,
       scope: data.scope ?? scope,
       memoryStoreName: store,
     });

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/tasks/route.ts

@@ -58,7 +58,8 @@ export async function GET(request: NextRequest, context: RouteContext) {
     return successResponse({
       items,
       totalCount: items.length,
-      nextToken: typeof data.nextToken === "string" ? data.nextToken : undefined,
+      nextToken:
+        typeof data.nextToken === "string" ? data.nextToken : undefined,
       scope: data.scope ?? scope,
       memoryStoreName: store,
     });

package/dist/dashboard-runtime/dashboard/src/app/api/v1/memory/stores/[store]/units/route.ts

@@ -77,7 +77,10 @@ export async function POST(request: NextRequest, context: RouteContext) {
 
     const { memoryStoreName: _ignored, ...safeBody } = body;
     void _ignored;
-    const resp = await memory.addMemories({ ...safeBody, memoryStoreName: store });
+    const resp = await memory.addMemories({
+      ...safeBody,
+      memoryStoreName: store,
+    });
     return forwardResponse(resp);
   } catch (error) {
     return handleApiError(error);

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

@@ -22,14 +22,37 @@ export async function GET(request: NextRequest) {
     if (!("memory" in auth)) return auth;
     const { memory } = auth;
 
-    const { items, totalCount } = await paginateAll(
-      (req) => memory.listMemoryStores(req),
-      {},
-      "stores",
-      100,
-      "limit",
+    const { items, totalCount } = await paginateAll<{
+      memoryStoreName: string;
+    }>((req) => memory.listMemoryStores(req), {}, "stores", 100, "limit");
+
+    // ListMemoryStores 只返回 { memoryStoreName }。storageMode / description 只在
+    // GetMemoryStore 里有，所以这里逐库并发 describe 富化，让列表能区分「仅 API
+    // 记忆 / 支持文件记忆」。best-effort：单库 describe 失败不影响整体，该项只是
+    // 缺 storageMode（前端按 ots 处理）。
+    const enriched = await Promise.all(
+      items.map(async (item) => {
+        try {
+          const resp = await memory.getMemoryStore({
+            memoryStoreName: item.memoryStoreName,
+          });
+          if (resp.code !== "SUCCESS") return item;
+          const data = (resp.data ?? {}) as {
+            storageMode?: string;
+            description?: string;
+          };
+          return {
+            ...item,
+            ...(data.storageMode ? { storageMode: data.storageMode } : {}),
+            ...(data.description ? { description: data.description } : {}),
+          };
+        } catch {
+          return item;
+        }
+      }),
     );
-    return successResponse({ items, totalCount });
+
+    return successResponse({ items: enriched, totalCount });
   } catch (error) {
     return handleApiError(error);
   }

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

@@ -54,13 +54,19 @@ export async function GET(request: NextRequest | Request) {
       url.searchParams.get("continuationToken") ?? undefined;
     const search = url.searchParams.get("search")?.trim() ?? "";
 
-    const maxRaw = Number(url.searchParams.get("maxResults") ?? DEFAULT_PAGE_SIZE);
+    const maxRaw = Number(
+      url.searchParams.get("maxResults") ?? DEFAULT_PAGE_SIZE,
+    );
     const maxResults = Number.isFinite(maxRaw)
       ? Math.min(MAX_PAGE_SIZE, Math.max(1, Math.trunc(maxRaw)))
       : DEFAULT_PAGE_SIZE;
 
     let resp: {
-      objects?: Array<{ name: string; size: number; lastModified: Date | string }>;
+      objects?: Array<{
+        name: string;
+        size: number;
+        lastModified: Date | string;
+      }>;
       prefixes?: string[];
       nextMarker?: string | null;
       isTruncated?: boolean;
@@ -117,7 +123,9 @@ export async function GET(request: NextRequest | Request) {
       prefix,
       folders,
       files,
-      nextContinuationToken: resp.isTruncated ? resp.nextMarker ?? null : null,
+      nextContinuationToken: resp.isTruncated
+        ? (resp.nextMarker ?? null)
+        : null,
       totalEstimate: folders.length + files.length,
     });
   } catch (error) {

package/dist/dashboard-runtime/dashboard/src/app/error.tsx

@@ -1,9 +1,8 @@
-'use client';
+"use client";
 
-import { useEffect } from 'react';
-import { reportClientError } from '@/components/logging/client-error-reporter';
-
-const FRIENDLY_MESSAGE = '页面加载时出错了，您可以重试或返回上一步。';
+import { useEffect } from "react";
+import { reportClientError } from "@/components/logging/client-error-reporter";
+import { useI18n } from "@/i18n/i18n-context";
 
 export default function GlobalError({
   error,
@@ -12,13 +11,15 @@ export default function GlobalError({
   error: Error & { digest?: string };
   reset: () => void;
 }) {
+  const { t } = useI18n();
+
   useEffect(() => {
     // Always log the raw error to the console for operators; the UI shows a
     // friendlier message and tucks the raw stack inside a collapsed details
     // pane so users are not greeted with a wall of internals.
-    console.error('Global error:', error);
+    console.error("Global error:", error);
     reportClientError({
-      event: 'browser.error_boundary.global',
+      event: "browser.error_boundary.global",
       message: error.message,
       name: error.name,
       stack: error.stack,
@@ -26,15 +27,15 @@ export default function GlobalError({
     });
   }, [error]);
 
-  const isDev = process.env.NODE_ENV !== 'production';
+  const isDev = process.env.NODE_ENV !== "production";
 
   return (
     <div className="flex min-h-screen flex-col items-center justify-center gap-4 px-6">
       <h2 className="text-2xl font-semibold tracking-tight text-foreground">
-        出错了
+        {t("errors.appTitle")}
       </h2>
       <p className="max-w-md text-center text-sm text-muted-foreground">
-        {FRIENDLY_MESSAGE}
+        {t("errors.appFriendly")}
       </p>
       <div className="flex gap-2">
         <button
@@ -42,33 +43,33 @@ export default function GlobalError({
           onClick={reset}
           className="rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground shadow-sm transition-colors hover:bg-primary/90"
         >
-          重试
+          {t("errors.retry")}
         </button>
         <button
           type="button"
           onClick={() => {
-            if (typeof window !== 'undefined') window.location.href = '/';
+            if (typeof window !== "undefined") window.location.href = "/";
           }}
           className="rounded-md border border-border bg-background px-4 py-2 text-sm font-medium text-foreground shadow-sm transition-colors hover:bg-muted"
         >
-          返回首页
+          {t("errors.backHome")}
         </button>
       </div>
 
       {(isDev || error.digest) && (
         <details className="mt-4 max-w-2xl rounded-md border border-border bg-muted/40 px-4 py-3 text-xs text-muted-foreground">
           <summary className="cursor-pointer select-none font-medium">
-            技术详情
+            {t("errors.technicalDetails")}
           </summary>
           {error.digest && (
             <p className="mt-2">
-              <span className="font-medium">Digest:</span>{' '}
+              <span className="font-medium">Digest:</span>{" "}
               <code className="font-mono">{error.digest}</code>
             </p>
           )}
           {error.message && (
             <p className="mt-2">
-              <span className="font-medium">Message:</span>{' '}
+              <span className="font-medium">Message:</span>{" "}
               <code className="font-mono break-all">{error.message}</code>
             </p>
           )}

package/dist/dashboard-runtime/dashboard/src/app/globals.css

@@ -149,28 +149,28 @@
      */
     --primary-soft: 218 28% 18%; /* slightly desat to match new neutrals */
 
-    --background: 220 13% 8%;          /* was 222 47% 7%   ≈ #0d1117 */
+    --background: 220 13% 8%; /* was 222 47% 7%   ≈ #0d1117 */
     --foreground: 213 13% 92%;
 
-    --card: 220 13% 11%;               /* was 222 47% 11%  ≈ #161b22 */
+    --card: 220 13% 11%; /* was 222 47% 11%  ≈ #161b22 */
     --card-foreground: 213 13% 92%;
 
     --popover: 220 13% 11%;
     --popover-foreground: 213 13% 92%;
 
-    --secondary: 220 13% 18%;          /* was 217 19% 18% */
+    --secondary: 220 13% 18%; /* was 217 19% 18% */
     --secondary-foreground: 213 13% 92%;
 
     --muted: 220 13% 22%;
     --muted-foreground: 215 10% 65%;
 
-    --accent: 218 28% 18%;             /* hover/active tint, less blue-shift */
+    --accent: 218 28% 18%; /* hover/active tint, less blue-shift */
     --accent-foreground: 221 83% 80%;
 
     --destructive: 0 84% 65%;
     --destructive-foreground: 0 0% 100%;
 
-    --border: 220 13% 22%;             /* ≈ #21262d, GitHub border default */
+    --border: 220 13% 22%; /* ≈ #21262d, GitHub border default */
     --border-light: 220 13% 16%;
     --input: 220 13% 22%;
     --ring: 221 83% 62%;
@@ -185,7 +185,7 @@
 
     --sidebar-bg: 220 13% 9%;
     --sidebar-border: 220 13% 22%;
-    --sidebar-active-bg: 218 28% 17%;  /* slightly more chroma so active row reads */
+    --sidebar-active-bg: 218 28% 17%; /* slightly more chroma so active row reads */
     --sidebar-active-fg: 221 83% 80%;
     --sidebar-text: 213 13% 80%;
 
@@ -214,8 +214,10 @@
   }
 
   html {
-    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC",
-      "Hiragino Sans GB", "Microsoft YaHei", ui-sans-serif, system-ui, sans-serif;
+    font-family:
+      -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC",
+      "Hiragino Sans GB", "Microsoft YaHei", ui-sans-serif, system-ui,
+      sans-serif;
   }
 
   body {
@@ -226,25 +228,41 @@
     -moz-osx-font-smoothing: grayscale;
   }
 
-  h1, h2 {
+  h1,
+  h2 {
     letter-spacing: -0.01em;
   }
 
-  code, pre, kbd, samp {
-    font-family: var(--font-mono), ui-monospace, SFMono-Regular, Menlo, monospace;
+  code,
+  pre,
+  kbd,
+  samp {
+    font-family:
+      var(--font-mono), ui-monospace, SFMono-Regular, Menlo, monospace;
   }
 }
 
 /* Home page motion primitives. Transform + opacity only so the browser can
    run them entirely on the compositor thread without triggering layout. */
 @keyframes home-float {
-  0%, 100% { transform: translate3d(0, 0, 0); }
-  50%      { transform: translate3d(0, -6px, 0); }
+  0%,
+  100% {
+    transform: translate3d(0, 0, 0);
+  }
+  50% {
+    transform: translate3d(0, -6px, 0);
+  }
 }
 
 @keyframes home-reveal {
-  from { opacity: 0; transform: translate3d(0, 8px, 0); }
-  to   { opacity: 1; transform: translate3d(0, 0, 0); }
+  from {
+    opacity: 0;
+    transform: translate3d(0, 8px, 0);
+  }
+  to {
+    opacity: 1;
+    transform: translate3d(0, 0, 0);
+  }
 }
 
 .animate-home-float {
@@ -267,8 +285,14 @@
    so each segmented-control switch replays the animation. A horizontal
    offset reads as a "swap" rather than a "reveal". */
 @keyframes rerank-slide {
-  from { opacity: 0; transform: translate3d(8px, 0, 0); }
-  to   { opacity: 1; transform: translate3d(0, 0, 0); }
+  from {
+    opacity: 0;
+    transform: translate3d(8px, 0, 0);
+  }
+  to {
+    opacity: 1;
+    transform: translate3d(0, 0, 0);
+  }
 }
 
 .animate-rerank-slide {
@@ -278,8 +302,12 @@
 
 /* Text shimmer used for the "deep thinking" state badge during streaming. */
 @keyframes text-shimmer {
-  0%   { background-position: 200% 0; }
-  100% { background-position: -200% 0; }
+  0% {
+    background-position: 200% 0;
+  }
+  100% {
+    background-position: -200% 0;
+  }
 }
 
 .animate-text-shimmer {
@@ -288,13 +316,25 @@
 }
 
 @keyframes thinking-aurora {
-  0%, 100% { opacity: 0.45; transform: scale(0.85); }
-  50%      { opacity: 0.85; transform: scale(1.15); }
+  0%,
+  100% {
+    opacity: 0.45;
+    transform: scale(0.85);
+  }
+  50% {
+    opacity: 0.85;
+    transform: scale(1.15);
+  }
 }
 
 @keyframes thinking-icon-breathe {
-  0%, 100% { transform: scale(1); }
-  50%      { transform: scale(1.08); }
+  0%,
+  100% {
+    transform: scale(1);
+  }
+  50% {
+    transform: scale(1.08);
+  }
 }
 
 .animate-thinking-aurora {

package/dist/dashboard-runtime/dashboard/src/app/layout.tsx

@@ -1,16 +1,17 @@
-import './globals.css';
+import "./globals.css";
 
-import type { Metadata } from 'next';
+import type { Metadata } from "next";
 
-import { inter, jetbrainsMono, plusJakarta } from '@/lib/fonts';
-import { ThemeProvider } from '@/providers/theme-provider';
-import { QueryProvider } from '@/providers/query-provider';
-import { ClientErrorReporter } from '@/components/logging/client-error-reporter';
-import { Toaster } from 'sonner';
+import { inter, jetbrainsMono, plusJakarta } from "@/lib/fonts";
+import { ThemeProvider } from "@/providers/theme-provider";
+import { QueryProvider } from "@/providers/query-provider";
+import { LocaleProvider } from "@/i18n/i18n-context";
+import { ClientErrorReporter } from "@/components/logging/client-error-reporter";
+import { Toaster } from "sonner";
 
 export const metadata: Metadata = {
-  title: 'Agent Storage',
-  description: 'A dashboard for managing Tablestore Agent Storage.',
+  title: "Agent Storage",
+  description: "A dashboard for managing Tablestore Agent Storage.",
 };
 
 export default function RootLayout({
@@ -26,11 +27,13 @@ export default function RootLayout({
     >
       <body className="min-h-screen font-sans antialiased text-foreground">
         <ThemeProvider>
-          <QueryProvider>
-            <ClientErrorReporter />
-            {children}
-            <Toaster position="top-right" richColors closeButton />
-          </QueryProvider>
+          <LocaleProvider>
+            <QueryProvider>
+              <ClientErrorReporter />
+              {children}
+              <Toaster position="top-right" richColors closeButton />
+            </QueryProvider>
+          </LocaleProvider>
         </ThemeProvider>
       </body>
     </html>

package/dist/dashboard-runtime/dashboard/src/app/not-found.tsx

@@ -1,15 +1,23 @@
-import Link from 'next/link';
+"use client";
+
+import Link from "next/link";
+import { useI18n } from "@/i18n/i18n-context";
 
 export default function NotFound() {
+  const { t } = useI18n();
   return (
     <div className="flex min-h-screen flex-col items-center justify-center gap-4">
-      <h2 className="text-2xl font-semibold tracking-tight text-foreground">页面不存在</h2>
-      <p className="text-sm text-muted-foreground">您访问的页面不存在或已被移除。</p>
+      <h2 className="text-2xl font-semibold tracking-tight text-foreground">
+        {t("errors.notFoundTitle")}
+      </h2>
+      <p className="text-sm text-muted-foreground">
+        {t("errors.notFoundDescription")}
+      </p>
       <Link
         href="/"
         className="rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground shadow-sm transition-colors hover:bg-primary/90"
       >
-        返回首页
+        {t("errors.backHome")}
       </Link>
     </div>
   );