@tablestore/tablestore-agent-cli 0.2.8 → 0.2.9

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>
   );

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

@@ -4,6 +4,7 @@ import { useEffect } from "react";
 import { AlertTriangle } from "lucide-react";
 
 import { Button } from "@/components/ui/button";
+import { useI18n } from "@/i18n/i18n-context";
 
 /**
  * Segment-level error boundary for the onboarding flow.
@@ -21,6 +22,8 @@ export default function OnboardingError({
   error: Error & { digest?: string };
   reset: () => void;
 }) {
+  const { t } = useI18n();
+
   useEffect(() => {
     // Surface the error to the browser console so operators looking at
     // devtools see the full stack; the production overlay only shows the
@@ -35,19 +38,20 @@ export default function OnboardingError({
       </div>
       <div className="space-y-1">
         <h2 className="text-lg font-semibold tracking-tight">
-          创建项目时出错了
+          {t("onboarding.errorTitle")}
         </h2>
         <p className="text-sm text-muted-foreground">
-          {error.message || "请稍后重试，或检查浏览器控制台获取详细信息。"}
+          {error.message || t("onboarding.errorDescription")}
         </p>
         {error.digest ? (
           <p className="text-xs text-muted-foreground">
-            错误编号：<code className="font-mono">{error.digest}</code>
+            {t("onboarding.errorDigest")}
+            <code className="font-mono">{error.digest}</code>
           </p>
         ) : null}
       </div>
       <Button type="button" onClick={reset}>
-        重试
+        {t("onboarding.retry")}
       </Button>
     </div>
   );

package/dist/dashboard-runtime/dashboard/src/app/onboarding/page.tsx

@@ -4,18 +4,17 @@ import { useRouter } from "next/navigation";
 import { Sparkles } from "lucide-react";
 
 import { ConnectInstanceForm } from "@/components/instance/connect-instance-form";
-import {
-  useConnectInstance,
-  useImportInstance,
-} from "@/hooks/use-instances";
+import { useConnectInstance, useImportInstance } from "@/hooks/use-instances";
 import { isImportPayload } from "@/lib/instance-payload";
 import type {
   ConnectInstancePayload,
   ImportInstancePayload,
 } from "@/types/instance";
+import { useI18n } from "@/i18n/i18n-context";
 
 export default function OnboardingPage() {
   const router = useRouter();
+  const { t } = useI18n();
   const connect = useConnectInstance();
   const importByToken = useImportInstance();
   const busy = connect.isPending || importByToken.isPending;
@@ -38,10 +37,10 @@ export default function OnboardingPage() {
           <Sparkles className="h-6 w-6" />
         </div>
         <h1 className="text-2xl font-semibold tracking-tight">
-          欢迎使用 Agent Storage
+          {t("onboarding.title")}
         </h1>
         <p className="max-w-md text-sm text-muted-foreground">
-          创建你的第一个项目，即可开始管理知识库、记忆库与对话。
+          {t("onboarding.description")}
         </p>
       </header>
 
@@ -50,12 +49,12 @@ export default function OnboardingPage() {
           mode="create"
           onSubmit={handleSubmit}
           busy={busy}
-          submitLabel="连接并开始使用"
+          submitLabel={t("onboarding.submitLabel")}
         />
       </div>
 
       <p className="text-center text-xs text-muted-foreground">
-        随时可以通过侧边栏的实例切换器或「项目管理」页创建更多项目。
+        {t("onboarding.footer")}
       </p>
     </div>
   );