@tablestore/tablestore-agent-cli 0.2.7 → 0.2.9

package/dist/dashboard-runtime/dashboard/src/schemas/instance.ts

@@ -1,5 +1,17 @@
 import { z } from "zod";
 
+/**
+ * i18n note: the error messages in this module are intentionally plain English.
+ * They are locale-neutral fallbacks only ever surfaced when the *base* schema is
+ * used directly — e.g. server-side API routes parsing a request body, where no
+ * `t()` / locale is available. The interactive form never shows these strings:
+ * it rebuilds every user-facing field with translated messages via
+ * `buildConnectFormSchema(t)` / `buildEditFormSchema(t)` / `localizedNameField(t)`
+ * (see components/instance/connect-instance-form.tsx), which override the name,
+ * endpoint, and credential-pairing messages below. Do NOT translate these to a
+ * single hard-coded locale — that would leak that locale into the API layer.
+ */
+
 /**
  * Instance name constraints mirror packages/shared INSTANCE_NAME_PATTERN
  * (`^[a-z0-9-]{1,32}$`) plus the reserved "default" exclusion.
@@ -7,31 +19,81 @@ import { z } from "zod";
 const instanceNameSchema = z
   .string()
   .trim()
-  .regex(/^[a-z0-9-]{1,32}$/, "名称需为 1-32 位小写字母、数字或连字符")
-  .refine((v) => v !== "default", "名称 \"default\" 为保留字");
+  .regex(
+    /^[a-z0-9-]{1,32}$/,
+    "Name must be 1-32 lowercase letters, digits, or hyphens",
+  )
+  .refine((v) => v !== "default", 'Name "default" is reserved');
 
 const trimmedNonEmpty = (label: string, max = 512) =>
-  z.string().trim().min(1, `请输入${label}`).max(max);
+  z.string().trim().min(1, `Please enter ${label}`).max(max);
 
 const optionalTrimmed = (max = 512) =>
   z.string().trim().max(max).optional().or(z.literal(""));
 
-export const connectInstanceSchema = z.object({
+// Credential-mode rules shared by connect / update / edit schemas:
+//   1. AccessKey ID and Secret must be supplied together (or both omitted).
+//   2. At least one data-plane credential must be present — the AK/SK pair or
+//      an API Key. (Update/edit relax rule 2 to allow "keep existing".)
+const akSkPaired = (v: {
+  accessKeyId?: string;
+  accessKeySecret?: string;
+}): boolean => Boolean(v.accessKeyId) === Boolean(v.accessKeySecret);
+const AK_SK_PAIR_ERROR = {
+  message: "AccessKey ID and Secret must be provided together",
+  path: ["accessKeySecret"],
+};
+const someCredential = (v: {
+  accessKeyId?: string;
+  accessKeySecret?: string;
+  apiKey?: string;
+}): boolean => Boolean(v.accessKeyId && v.accessKeySecret) || Boolean(v.apiKey);
+const CREDENTIAL_REQUIRED_ERROR = {
+  message: "Provide at least an API Key, or AccessKey ID + Secret",
+  path: ["apiKey"],
+};
+
+/**
+ * Apply the credential-mode rules to any object schema that carries the
+ * `accessKeyId` / `accessKeySecret` / `apiKey` fields. Exposed so the
+ * interactive form can layer its own URL-shape overrides onto the base object
+ * (via `.extend`) and still inherit the exact same credential validation.
+ * The predicates read the parsed value loosely (`Record`) because the input
+ * type varies across the connect / form variants.
+ */
+export function withCredentialModeRules<S extends z.ZodTypeAny>(schema: S) {
+  return schema
+    .refine((v) => akSkPaired(v as Record<string, string>), AK_SK_PAIR_ERROR)
+    .refine(
+      (v) => someCredential(v as Record<string, string>),
+      CREDENTIAL_REQUIRED_ERROR,
+    );
+}
+
+/** Base object (no refinements) so callers can `.extend` before refining. */
+export const connectInstanceBaseSchema = z.object({
   name: instanceNameSchema,
-  accessKeyId: trimmedNonEmpty("AccessKey ID", 128),
-  accessKeySecret: trimmedNonEmpty("AccessKey Secret", 512),
+  accessKeyId: optionalTrimmed(128),
+  accessKeySecret: optionalTrimmed(512),
+  apiKey: optionalTrimmed(512),
   otsEndpoint: trimmedNonEmpty("OTS Endpoint", 256),
-  otsInstanceName: trimmedNonEmpty("OTS 实例名", 128),
+  otsInstanceName: trimmedNonEmpty("OTS instance name", 128),
   ossEndpoint: optionalTrimmed(256),
   ossBucketName: optionalTrimmed(128),
   region: optionalTrimmed(64),
   activate: z.boolean().optional(),
 });
 
+export const connectInstanceSchema = withCredentialModeRules(
+  connectInstanceBaseSchema,
+);
+
 export const updateInstanceSchema = z
   .object({
     accessKeyId: optionalTrimmed(128),
     accessKeySecret: optionalTrimmed(512),
+    // Optional on update: omit/leave blank to keep the existing credential.
+    apiKey: optionalTrimmed(512),
     otsEndpoint: optionalTrimmed(256),
     otsInstanceName: optionalTrimmed(128),
     ossEndpoint: optionalTrimmed(256),
@@ -43,15 +105,20 @@ export const updateInstanceSchema = z
   // one of the pair previously sneaked past validation and later tripped a
   // generic 500 on the server side where the pair is encoded as a single
   // credential. Matching both at the schema layer surfaces the mistake in
-  // the form itself with a field-targeted message.
+  // the form itself with a field-targeted message. (No "at least one
+  // credential" rule here: a partial update may touch only OSS/region and
+  // legitimately leave both credential fields blank to keep the current one.)
   .refine(
     (v) => {
       const hasId = Boolean(v.accessKeyId && v.accessKeyId.length > 0);
-      const hasSecret = Boolean(v.accessKeySecret && v.accessKeySecret.length > 0);
+      const hasSecret = Boolean(
+        v.accessKeySecret && v.accessKeySecret.length > 0,
+      );
       return hasId === hasSecret;
     },
     {
-      message: "AccessKey ID 与 Secret 必须成对更新，要么同时填写、要么同时留空",
+      message:
+        "AccessKey ID and Secret must be updated together: fill in both or leave both blank",
       path: ["accessKeySecret"],
     },
   );
@@ -70,8 +137,10 @@ export const editInstanceFormSchema = z
     name: instanceNameSchema,
     accessKeyId: optionalTrimmed(128),
     accessKeySecret: optionalTrimmed(512),
+    // Leave blank to keep the existing API Key.
+    apiKey: optionalTrimmed(512),
     otsEndpoint: trimmedNonEmpty("OTS Endpoint", 256),
-    otsInstanceName: trimmedNonEmpty("OTS 实例名", 128),
+    otsInstanceName: trimmedNonEmpty("OTS instance name", 128),
     ossEndpoint: optionalTrimmed(256),
     ossBucketName: optionalTrimmed(128),
     region: optionalTrimmed(64),
@@ -87,7 +156,7 @@ export const editInstanceFormSchema = z
     },
     {
       message:
-        "AccessKey ID 与 Secret 必须成对更新，要么同时填写、要么同时留空",
+        "AccessKey ID and Secret must be updated together: fill in both or leave both blank",
       path: ["accessKeySecret"],
     },
   );
@@ -97,7 +166,7 @@ export const importInstanceSchema = z.object({
   // reject identical inputs; the previous 1-char floor let obvious
   // typos (e.g. a stray "a") reach the decoder which returned a
   // cryptic INVALID_TOKEN at submit time.
-  token: z.string().trim().min(10, "Token 长度不足，无法解析").max(4096),
+  token: z.string().trim().min(10, "Token is too short to be parsed").max(4096),
   name: instanceNameSchema.optional(),
   activate: z.boolean().optional(),
 });

package/dist/dashboard-runtime/dashboard/src/schemas/knowledge-base.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { KB_NAME_REGEX } from "@/lib/constants";
+import type { TranslateFn } from "@/i18n/i18n-context";
 
 const metadataFieldTypeEnum = z.enum([
   "string",
@@ -65,27 +66,47 @@ const retrievalConfigSchema = z.object({
   rerankingConfiguration: rerankingConfigSchema.optional(),
 });
 
-export const createKBSchema = z.object({
-  knowledgeBaseName: z
-    .string()
-    .min(1, "Knowledge base name is required")
-    .max(64, "Name must be at most 64 characters")
-    .regex(
-      KB_NAME_REGEX,
-      "名称必须以字母开头，仅允许字母、数字、下划线和连字符，长度 3-64 字符，不能以下划线或连字符结尾"
-    ),
-  description: z.string().max(4096).optional(),
-  subspace: z.boolean().optional(),
-  tags: z.array(z.string()).optional(),
-  metadata: z.array(metadataFieldSchema).max(200).optional(),
-  embeddingConfiguration: embeddingConfigSchema.optional(),
-  retrievalConfiguration: retrievalConfigSchema.optional(),
-  multimodal: z.boolean().optional(),
-  ingestConfiguration: z
-    .object({
-      enableTableFormulaCaption: z.boolean().optional(),
-    })
-    .optional(),
+interface KBNameMessages {
+  required: string;
+  maxLength: string;
+  pattern: string;
+}
+
+function buildCreateKBObject(messages: KBNameMessages) {
+  return z.object({
+    knowledgeBaseName: z
+      .string()
+      .min(1, messages.required)
+      .max(64, messages.maxLength)
+      .regex(KB_NAME_REGEX, messages.pattern),
+    description: z.string().max(4096).optional(),
+    subspace: z.boolean().optional(),
+    tags: z.array(z.string()).optional(),
+    metadata: z.array(metadataFieldSchema).max(200).optional(),
+    embeddingConfiguration: embeddingConfigSchema.optional(),
+    retrievalConfiguration: retrievalConfigSchema.optional(),
+    multimodal: z.boolean().optional(),
+    ingestConfiguration: z
+      .object({
+        enableTableFormulaCaption: z.boolean().optional(),
+      })
+      .optional(),
+  });
+}
+
+export function buildCreateKBSchema(t: TranslateFn) {
+  return buildCreateKBObject({
+    required: t("knowledgeBase.create.nameRequired"),
+    maxLength: t("knowledgeBase.create.nameMaxLength"),
+    pattern: t("knowledgeBase.create.namePattern"),
+  });
+}
+
+export const createKBSchema = buildCreateKBObject({
+  required: "Knowledge base name is required",
+  maxLength: "Name must be at most 64 characters",
+  pattern:
+    "Name must start with a letter; only letters, digits, underscores and hyphens are allowed, 3-64 characters, and it cannot end with an underscore or hyphen",
 });
 
 export const updateKBSchema = z.object({

package/dist/dashboard-runtime/dashboard/src/schemas/llm-chat.ts

@@ -21,9 +21,12 @@ export const chatRagSchema = z.object({
 
 // 写 scope 的四个字段必须为非空、非通配符字符串。
 // 客户端不允许显式发 `*`——通配符仅由服务端在 SearchMemories 调用前注入。
-const nonWildcardId = z.string().min(1).refine((v) => v !== "*", {
-  message: "wildcard '*' is not allowed on the wire; the server applies it",
-});
+const nonWildcardId = z
+  .string()
+  .min(1)
+  .refine((v) => v !== "*", {
+    message: "wildcard '*' is not allowed on the wire; the server applies it",
+  });
 
 export const chatMemorySchema = z.object({
   memoryStoreName: z.string().min(1),
@@ -36,6 +39,8 @@ export const chatMemorySchema = z.object({
   topK: z.number().int().min(1).max(50).optional(),
   autoSave: z.boolean().optional(),
   turnId: z.string().min(1).optional(),
+  // 缺省 "search"（语义检索）；"local" 走文件记忆（挂载同步 + 本地词法检索）。
+  retrievalMode: z.enum(["search", "local"]).optional(),
 });
 
 /**

package/dist/dashboard-runtime/dashboard/src/schemas/retrieval.ts

@@ -4,18 +4,14 @@ export const retrievalSchema = z
   .object({
     knowledgeBaseName: z.string().min(1),
     queryType: z.enum(["TEXT", "IMAGE"]).optional(),
-    query: z
-      .string()
-      .max(128, "查询内容不能超过 128 个字符"),
+    query: z.string().max(128, "查询内容不能超过 128 个字符"),
     imageInput: z.string().optional(),
     subspace: z.array(z.string()).optional(),
     topK: z.number().int().min(0).max(100).default(20).optional(),
     denseTopK: z.number().int().min(0).max(100).default(20).optional(),
     fullTextTopK: z.number().int().min(0).max(100).default(20).optional(),
     rerankTopK: z.number().int().min(0).max(200).default(20).optional(),
-    searchType: z
-      .array(z.enum(["DENSE_VECTOR", "FULL_TEXT"]))
-      .optional(),
+    searchType: z.array(z.enum(["DENSE_VECTOR", "FULL_TEXT"])).optional(),
     rerankType: z.enum(["RRF", "WEIGHT", "MODEL"]).optional(),
     // RRF parameters
     rrfK: z.number().int().min(1).optional(),

package/dist/dashboard-runtime/dashboard/src/services/api-client.ts

@@ -7,7 +7,7 @@ const DEFAULT_TIMEOUT_MS = 30_000;
 function fetchWithTimeout(
   url: string,
   options: RequestInit,
-  timeoutMs = DEFAULT_TIMEOUT_MS
+  timeoutMs = DEFAULT_TIMEOUT_MS,
 ): Promise<Response> {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -127,7 +127,7 @@ async function handleResponse<T>(response: Response): Promise<T> {
       body.message ?? "Unknown error",
       response.status,
       body.requestId,
-      traceId
+      traceId,
     );
   }
 
@@ -155,7 +155,7 @@ export async function apiGet<T>(
       method: "GET",
       headers: buildHeaders("application/json"),
       ...options,
-    })
+    }),
   );
   return handleResponse<T>(response);
 }
@@ -163,7 +163,7 @@ export async function apiGet<T>(
 export async function apiPost<T>(
   path: string,
   body?: unknown,
-  timeoutMs?: number
+  timeoutMs?: number,
 ): Promise<T> {
   const response = await requestWithClientLogging(path, () =>
     fetchWithTimeout(
@@ -174,49 +174,40 @@ export async function apiPost<T>(
         body: body !== undefined ? JSON.stringify(body) : undefined,
       },
       timeoutMs,
-    )
+    ),
   );
   return handleResponse<T>(response);
 }
 
-export async function apiPut<T>(
-  path: string,
-  body?: unknown
-): Promise<T> {
+export async function apiPut<T>(path: string, body?: unknown): Promise<T> {
   const response = await requestWithClientLogging(path, () =>
     fetchWithTimeout(buildUrl(path), {
       method: "PUT",
       headers: buildHeaders("application/json"),
       body: body !== undefined ? JSON.stringify(body) : undefined,
-    })
+    }),
   );
   return handleResponse<T>(response);
 }
 
-export async function apiDelete<T>(
-  path: string,
-  body?: unknown
-): Promise<T> {
+export async function apiDelete<T>(path: string, body?: unknown): Promise<T> {
   const response = await requestWithClientLogging(path, () =>
     fetchWithTimeout(buildUrl(path), {
       method: "DELETE",
       headers: buildHeaders("application/json"),
       body: body !== undefined ? JSON.stringify(body) : undefined,
-    })
+    }),
   );
   return handleResponse<T>(response);
 }
 
-export async function apiPatch<T>(
-  path: string,
-  body?: unknown
-): Promise<T> {
+export async function apiPatch<T>(path: string, body?: unknown): Promise<T> {
   const response = await requestWithClientLogging(path, () =>
     fetchWithTimeout(buildUrl(path), {
       method: "PATCH",
       headers: buildHeaders("application/json"),
       body: body !== undefined ? JSON.stringify(body) : undefined,
-    })
+    }),
   );
   return handleResponse<T>(response);
 }
@@ -224,14 +215,18 @@ export async function apiPatch<T>(
 export async function apiUpload<T>(
   path: string,
   formData: FormData,
-  timeoutMs?: number
+  timeoutMs?: number,
 ): Promise<T> {
   const response = await requestWithClientLogging(path, () =>
-    fetchWithTimeout(buildUrl(path), {
-      method: "POST",
-      body: formData,
-      // Do not set Content-Type — browser sets multipart boundary automatically
-    }, timeoutMs)
+    fetchWithTimeout(
+      buildUrl(path),
+      {
+        method: "POST",
+        body: formData,
+        // Do not set Content-Type — browser sets multipart boundary automatically
+      },
+      timeoutMs,
+    ),
   );
   return handleResponse<T>(response);
 }
@@ -240,15 +235,16 @@ export { ApiClientError };
 
 async function requestWithClientLogging(
   path: string,
-  fn: () => Promise<Response>
+  fn: () => Promise<Response>,
 ): Promise<Response> {
   try {
     return await fn();
   } catch (error) {
     reportClientApiError({
-      code: error instanceof DOMException && error.name === "AbortError"
-        ? "NETWORK_ERROR"
-        : "BROWSER_ERROR",
+      code:
+        error instanceof DOMException && error.name === "AbortError"
+          ? "NETWORK_ERROR"
+          : "BROWSER_ERROR",
       message: error instanceof Error ? error.message : String(error),
       status: 0,
       url: path,
@@ -261,7 +257,10 @@ async function requestWithClientLogging(
 
 function reportClientApiError(payload: Record<string, unknown>): void {
   if (typeof window === "undefined") return;
-  if (typeof payload.url === "string" && payload.url.includes("/api/v1/logs/client")) {
+  if (
+    typeof payload.url === "string" &&
+    payload.url.includes("/api/v1/logs/client")
+  ) {
     return;
   }
 
@@ -273,7 +272,7 @@ function reportClientApiError(payload: Record<string, unknown>): void {
     if (navigator.sendBeacon) {
       navigator.sendBeacon(
         "/api/v1/logs/client",
-        new Blob([body], { type: "application/json" })
+        new Blob([body], { type: "application/json" }),
       );
       return;
     }

package/dist/dashboard-runtime/dashboard/src/services/api-keys.ts

@@ -19,8 +19,10 @@ export async function createApiKey(args?: {
   credentialAgeDays?: number;
 }): Promise<CreatedApiKey> {
   const body: Record<string, unknown> = {};
-  if (args?.serviceCredentialName) body.serviceCredentialName = args.serviceCredentialName;
-  if (args?.credentialAgeDays && args.credentialAgeDays > 0) body.credentialAgeDays = args.credentialAgeDays;
+  if (args?.serviceCredentialName)
+    body.serviceCredentialName = args.serviceCredentialName;
+  if (args?.credentialAgeDays && args.credentialAgeDays > 0)
+    body.credentialAgeDays = args.credentialAgeDays;
   const data = await apiPost<{ apiKey: CreatedApiKey }>(
     "/api/v1/api-keys",
     Object.keys(body).length > 0 ? body : undefined,

package/dist/dashboard-runtime/dashboard/src/services/auth.ts

@@ -12,7 +12,7 @@ export async function getAuthStatus(): Promise<AuthStatus> {
 }
 
 export async function importToken(
-  token: string
+  token: string,
 ): Promise<{ imported: boolean }> {
   return apiPost<{ imported: boolean }>("/api/v1/auth/token", { token });
 }

package/dist/dashboard-runtime/dashboard/src/services/chunks.ts

@@ -5,7 +5,7 @@ import { apiGet, apiPut } from "./api-client";
 export async function listChunks(
   knowledgeBaseName: string,
   docId: string,
-  options?: { maxResults?: number; nextToken?: string; subspace?: string }
+  options?: { maxResults?: number; nextToken?: string; subspace?: string },
 ): Promise<PaginatedData<Chunk>> {
   const params = new URLSearchParams();
   params.set("maxResults", String(options?.maxResults ?? 20));
@@ -16,7 +16,7 @@ export async function listChunks(
     params.set("subspace", options.subspace);
   }
   return apiGet<PaginatedData<Chunk>>(
-    `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}/documents/${encodeURIComponent(docId)}/chunks?${params.toString()}`
+    `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}/documents/${encodeURIComponent(docId)}/chunks?${params.toString()}`,
   );
 }
 
@@ -40,10 +40,10 @@ export interface UpdateChunksResult {
 
 export async function updateChunks(
   knowledgeBaseName: string,
-  chunks: UpdateChunkItem[]
+  chunks: UpdateChunkItem[],
 ): Promise<UpdateChunksResult> {
   return apiPut<UpdateChunksResult>(
     `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}/chunks`,
-    { chunks }
+    { chunks },
   );
 }

package/dist/dashboard-runtime/dashboard/src/services/documents.ts

@@ -4,7 +4,7 @@ import { apiGet, apiPost, apiPut, apiDelete, apiUpload } from "./api-client";
 
 export async function listDocuments(
   knowledgeBaseName: string,
-  options?: { maxResults?: number; nextToken?: string; subspace?: string }
+  options?: { maxResults?: number; nextToken?: string; subspace?: string },
 ): Promise<PaginatedData<Document>> {
   const params = new URLSearchParams();
   params.set("maxResults", String(options?.maxResults ?? 20));
@@ -15,7 +15,7 @@ export async function listDocuments(
     params.set("subspace", options.subspace);
   }
   return apiGet<PaginatedData<Document>>(
-    `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}/documents?${params.toString()}`
+    `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}/documents?${params.toString()}`,
   );
 }
 
@@ -91,7 +91,7 @@ export async function addDocuments(
 export async function uploadDocuments(
   knowledgeBaseName: string,
   files: File[],
-  options?: { subspace?: string; metadata?: Record<string, unknown> }
+  options?: { subspace?: string; metadata?: Record<string, unknown> },
 ): Promise<{ documentDetails: DocumentOperationResult[] }> {
   const formData = new FormData();
 
@@ -109,7 +109,7 @@ export async function uploadDocuments(
 
   return apiUpload<{ documentDetails: DocumentOperationResult[] }>(
     `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}/documents/upload`,
-    formData
+    formData,
   );
 }
 
@@ -171,11 +171,9 @@ export async function uploadDocumentsBatched(
     }
 
     try {
-      const resp = await apiUpload<{ documentDetails: DocumentOperationResult[] }>(
-        uploadPath,
-        formData,
-        UPLOAD_TIMEOUT_MS,
-      );
+      const resp = await apiUpload<{
+        documentDetails: DocumentOperationResult[];
+      }>(uploadPath, formData, UPLOAD_TIMEOUT_MS);
       allResults.push(...resp.documentDetails);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -194,7 +192,9 @@ export async function uploadDocumentsBatched(
 
   // If every batch failed, throw so the caller sees a mutation error.
   if (allResults.length === 0 && allErrors.length > 0) {
-    throw new Error(`All ${allErrors.length} batch(es) failed: ${allErrors[0]}`);
+    throw new Error(
+      `All ${allErrors.length} batch(es) failed: ${allErrors[0]}`,
+    );
   }
 
   return { documentDetails: allResults };
@@ -217,7 +217,9 @@ export async function deleteDocuments(
   const url = `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}/documents`;
 
   if (documents.length <= BATCH_SIZE) {
-    const result = await apiDelete<{ documentDetails: DocumentOperationResult[] }>(url, { documents, ...rest });
+    const result = await apiDelete<{
+      documentDetails: DocumentOperationResult[];
+    }>(url, { documents, ...rest });
     onProgress?.(documents.length, documents.length);
     return result;
   }
@@ -225,7 +227,9 @@ export async function deleteDocuments(
   const allResults: DocumentOperationResult[] = [];
   for (let i = 0; i < documents.length; i += BATCH_SIZE) {
     const batch = documents.slice(i, i + BATCH_SIZE);
-    const resp = await apiDelete<{ documentDetails: DocumentOperationResult[] }>(url, { documents: batch, ...rest });
+    const resp = await apiDelete<{
+      documentDetails: DocumentOperationResult[];
+    }>(url, { documents: batch, ...rest });
     allResults.push(...resp.documentDetails);
     onProgress?.(Math.min(i + BATCH_SIZE, documents.length), documents.length);
   }

package/dist/dashboard-runtime/dashboard/src/services/file-memory.ts

@@ -0,0 +1,63 @@
+import type { ChatMemoryWriteScope } from "@/components/chat/chat-config-context";
+import type { MemoryFilesSyncSummary } from "@/types/llm-chat";
+import { apiGet, apiPost } from "./api-client";
+
+export interface FileMemoryEntry {
+  rel: string;
+  size: number;
+  mtimeMs?: number;
+}
+
+export interface FileMemoryTree {
+  scopeDir: string;
+  files: FileMemoryEntry[];
+}
+
+export interface FileMemorySyncResult extends FileMemoryTree {
+  sync: MemoryFilesSyncSummary;
+}
+
+function scopeQuery(scope: ChatMemoryWriteScope): string {
+  const params = new URLSearchParams();
+  params.set("appId", scope.appId);
+  params.set("tenantId", scope.tenantId);
+  params.set("agentId", scope.agentId);
+  params.set("runId", scope.runId);
+  return params.toString();
+}
+
+/** 触发一次远端→本地增量同步（AuthorizeMemoryMount + STS），返回文件树与统计。 */
+export async function syncFileMemory(
+  memoryStoreName: string,
+  scope: ChatMemoryWriteScope,
+): Promise<FileMemorySyncResult> {
+  return apiPost<FileMemorySyncResult>(
+    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/file-memory/sync`,
+    { scope },
+  );
+}
+
+/** 只读本地镜像目录的文件树（不联网）。 */
+export async function getFileMemoryTree(
+  memoryStoreName: string,
+  scope: ChatMemoryWriteScope,
+): Promise<FileMemoryTree> {
+  return apiGet<FileMemoryTree>(
+    `/api/v1/memory/stores/${encodeURIComponent(
+      memoryStoreName,
+    )}/file-memory/tree?${scopeQuery(scope)}`,
+  );
+}
+
+/** 读取镜像目录内单个文件内容。 */
+export async function getFileMemoryFile(
+  memoryStoreName: string,
+  scope: ChatMemoryWriteScope,
+  rel: string,
+): Promise<{ rel: string; content: string }> {
+  return apiGet<{ rel: string; content: string }>(
+    `/api/v1/memory/stores/${encodeURIComponent(
+      memoryStoreName,
+    )}/file-memory/file?${scopeQuery(scope)}&path=${encodeURIComponent(rel)}`,
+  );
+}