@tablestore/tablestore-agent-cli 0.2.8 → 0.2.9

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)}`,
+  );
+}

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

@@ -1,35 +1,43 @@
-import type { KnowledgeBase, CreateKBRequest, UpdateKBRequest } from "@/types/knowledge-base";
+import type {
+  KnowledgeBase,
+  CreateKBRequest,
+  UpdateKBRequest,
+} from "@/types/knowledge-base";
 import type { PaginatedData } from "@/types/api";
 import { apiGet, apiPost, apiPut, apiDelete } from "./api-client";
 
-export async function listKnowledgeBases(): Promise<PaginatedData<KnowledgeBase>> {
+export async function listKnowledgeBases(): Promise<
+  PaginatedData<KnowledgeBase>
+> {
   return apiGet<PaginatedData<KnowledgeBase>>("/api/v1/knowledge-bases");
 }
 
 export async function describeKnowledgeBase(
-  name: string
+  name: string,
 ): Promise<KnowledgeBase> {
-  return apiGet<KnowledgeBase>(`/api/v1/knowledge-bases/${encodeURIComponent(name)}`);
+  return apiGet<KnowledgeBase>(
+    `/api/v1/knowledge-bases/${encodeURIComponent(name)}`,
+  );
 }
 
 export async function createKnowledgeBase(
-  request: CreateKBRequest
+  request: CreateKBRequest,
 ): Promise<void> {
   await apiPost<Record<string, never>>("/api/v1/knowledge-bases", request);
 }
 
 export async function updateKnowledgeBase(
-  request: UpdateKBRequest
+  request: UpdateKBRequest,
 ): Promise<void> {
   const { knowledgeBaseName, ...body } = request;
   await apiPut<Record<string, never>>(
     `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}`,
-    body
+    body,
   );
 }
 
 export async function deleteKnowledgeBase(name: string): Promise<void> {
   await apiDelete<Record<string, never>>(
-    `/api/v1/knowledge-bases/${encodeURIComponent(name)}`
+    `/api/v1/knowledge-bases/${encodeURIComponent(name)}`,
   );
 }

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

@@ -7,6 +7,7 @@ import type {
   DreamActionFilter,
   DreamActionRecord,
   DreamApplyActionResult,
+  DreamDepositResult,
   DreamTask,
   DreamTaskSummary,
   MemoryRequestLog,
@@ -29,7 +30,7 @@ export type ScopedPaginatedData<T> = PaginatedData<T> & {
 
 function buildScopeQuery(
   scope: MemoryScope,
-  extra?: Record<string, number | string | undefined>
+  extra?: Record<string, number | string | undefined>,
 ): string {
   const params = new URLSearchParams();
   params.set("appId", scope.appId);
@@ -51,43 +52,45 @@ export async function listMemoryStores(): Promise<PaginatedData<MemoryStore>> {
 }
 
 export async function describeMemoryStore(
-  memoryStoreName: string
+  memoryStoreName: string,
 ): Promise<MemoryStore> {
   return apiGet<MemoryStore>(
-    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}`
+    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}`,
   );
 }
 
 export async function createMemoryStore(
-  request: CreateMemoryStoreRequest
+  request: CreateMemoryStoreRequest,
 ): Promise<void> {
   await apiPost<Record<string, never>>("/api/v1/memory/stores", request);
 }
 
 export async function updateMemoryStore(
-  request: UpdateMemoryStoreRequest
+  request: UpdateMemoryStoreRequest,
 ): Promise<void> {
   const { memoryStoreName, ...body } = request;
   await apiPut<Record<string, never>>(
     `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}`,
-    body
+    body,
   );
 }
 
-export async function deleteMemoryStore(memoryStoreName: string): Promise<void> {
+export async function deleteMemoryStore(
+  memoryStoreName: string,
+): Promise<void> {
   await apiDelete<Record<string, never>>(
-    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}`
+    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}`,
   );
 }
 
 export async function listMemoryUnits(
   memoryStoreName: string,
   scope: MemoryScope,
-  options?: { limit?: number; nextToken?: string }
+  options?: { limit?: number; nextToken?: string },
 ): Promise<ScopedPaginatedData<MemoryUnit>> {
   const query = buildScopeQuery(scope, options);
   return apiGet<ScopedPaginatedData<MemoryUnit>>(
-    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/units?${query}`
+    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/units?${query}`,
   );
 }
 
@@ -95,42 +98,40 @@ export async function addMemory(request: AddMemoryRequest): Promise<unknown> {
   const { memoryStoreName, ...body } = request;
   return apiPost(
     `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/units`,
-    body
+    body,
   );
 }
 
 export async function getMemoryUnit(
-  request: DeleteMemoryUnitRequest
+  request: DeleteMemoryUnitRequest,
 ): Promise<{ memory: MemoryUnit; memoryStoreName: string }> {
   const query = buildScopeQuery(request.scope);
   return apiGet(
-    `/api/v1/memory/stores/${encodeURIComponent(request.memoryStoreName)}/units/${encodeURIComponent(request.memoryId)}?${query}`
+    `/api/v1/memory/stores/${encodeURIComponent(request.memoryStoreName)}/units/${encodeURIComponent(request.memoryId)}?${query}`,
   );
 }
 
 export async function updateMemoryUnit(
-  request: UpdateMemoryUnitRequest
+  request: UpdateMemoryUnitRequest,
 ): Promise<{ memory: MemoryUnit; updated: boolean; memoryStoreName: string }> {
   const { memoryStoreName, memoryId, ...body } = request;
   return apiPut(
     `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/units/${encodeURIComponent(memoryId)}`,
-    body
+    body,
   );
 }
 
 export async function deleteMemoryUnit(
-  request: DeleteMemoryUnitRequest
+  request: DeleteMemoryUnitRequest,
 ): Promise<void> {
   const { memoryStoreName, memoryId, ...body } = request;
   await apiDelete<Record<string, never>>(
     `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/units/${encodeURIComponent(memoryId)}`,
-    body
+    body,
   );
 }
 
-export async function searchMemory(
-  request: SearchMemoryRequest
-): Promise<{
+export async function searchMemory(request: SearchMemoryRequest): Promise<{
   results: MemorySearchHit[];
   scope: MemoryScope;
   memoryStoreName: string;
@@ -138,29 +139,40 @@ export async function searchMemory(
   const { memoryStoreName, ...body } = request;
   return apiPost(
     `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/search`,
-    body
+    body,
   );
 }
 
 export async function listMemoryMessages(
   memoryStoreName: string,
   scope: MemoryScope,
-  options?: { limit?: number; nextToken?: string; minTimestamp?: string; maxTimestamp?: string }
+  options?: {
+    limit?: number;
+    nextToken?: string;
+    minTimestamp?: string;
+    maxTimestamp?: string;
+  },
 ): Promise<ScopedPaginatedData<SessionMessage>> {
   const query = buildScopeQuery(scope, options);
   return apiGet<ScopedPaginatedData<SessionMessage>>(
-    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/messages?${query}`
+    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/messages?${query}`,
   );
 }
 
 export async function listMemoryRequests(
   memoryStoreName: string,
   scope: MemoryScope,
-  options?: { limit?: number; nextToken?: string; operation?: string; minTimestamp?: string; maxTimestamp?: string }
+  options?: {
+    limit?: number;
+    nextToken?: string;
+    operation?: string;
+    minTimestamp?: string;
+    maxTimestamp?: string;
+  },
 ): Promise<ScopedPaginatedData<MemoryRequestLog>> {
   const query = buildScopeQuery(scope, options);
   return apiGet<ScopedPaginatedData<MemoryRequestLog>>(
-    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/requests?${query}`
+    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/requests?${query}`,
   );
 }
 
@@ -347,21 +359,25 @@ export async function listDreamActions(
   const params = new URLSearchParams();
   if (filter?.status) params.set("status", filter.status);
   if (filter?.action) params.set("action", filter.action);
-  if (filter?.sourceMemoryId) params.set("sourceMemoryId", filter.sourceMemoryId);
+  if (filter?.sourceMemoryId)
+    params.set("sourceMemoryId", filter.sourceMemoryId);
   if (filter?.orderBy) params.set("orderBy", filter.orderBy);
   if (filter?.minConfidence !== undefined)
     params.set("minConfidence", String(filter.minConfidence));
   if (filter?.maxConfidence !== undefined)
     params.set("maxConfidence", String(filter.maxConfidence));
   if (filter?.targetScope) {
-    if (filter.targetScope.appId) params.set("targetAppId", filter.targetScope.appId);
+    if (filter.targetScope.appId)
+      params.set("targetAppId", filter.targetScope.appId);
     if (filter.targetScope.tenantId)
       params.set("targetTenantId", filter.targetScope.tenantId);
     if (filter.targetScope.agentId)
       params.set("targetAgentId", filter.targetScope.agentId);
-    if (filter.targetScope.runId) params.set("targetRunId", filter.targetScope.runId);
+    if (filter.targetScope.runId)
+      params.set("targetRunId", filter.targetScope.runId);
   }
-  if (pagination?.limit !== undefined) params.set("limit", String(pagination.limit));
+  if (pagination?.limit !== undefined)
+    params.set("limit", String(pagination.limit));
   if (pagination?.nextToken) params.set("nextToken", pagination.nextToken);
 
   const qs = params.toString();
@@ -389,3 +405,22 @@ export async function applyDreamActions(
     applier ? { actionIds, applier } : { actionIds },
   );
 }
+
+// ---------------------------------------------------------------------------
+// dream-kb-sync（Phase 4）
+// ---------------------------------------------------------------------------
+
+/** 会话内沉淀：把某个 dream 抽取任务（dreamId）的产出落到目标知识库。 */
+export async function depositDreamToKb(
+  memoryStoreName: string,
+  body: {
+    dreamId: string;
+    knowledgeBaseName: string;
+    kinds?: Array<"skill" | "profile">;
+  },
+): Promise<DreamDepositResult> {
+  return apiPost<DreamDepositResult>(
+    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/dream-kb-sync`,
+    body,
+  );
+}