@tablestore/tablestore-agent-cli 0.2.10 → 0.2.11

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

@@ -1,63 +1,105 @@
-import type { ChatMemoryWriteScope } from "@/components/chat/chat-config-context";
-import type { MemoryFilesSyncSummary } from "@/types/llm-chat";
-import { apiGet, apiPost } from "./api-client";
+import type {
+  CreateFileMemoryRequest,
+  DeleteFileMemoryRequest,
+  FileMemory,
+  FileMemoryVersion,
+  GetFileMemoryVersionRequest,
+  ListFileMemoriesRequest,
+  ListFileMemoriesResponse,
+  ListFileMemoryVersionsRequest,
+  ListFileMemoryVersionsResponse,
+  ReadFileMemoryRequest,
+  RenameFileMemoryRequest,
+  StatFileMemoryRequest,
+  UpdateFileMemoryRequest,
+} from "@/types/file-memory";
 
-export interface FileMemoryEntry {
-  rel: string;
-  size: number;
-  mtimeMs?: number;
+import { apiPost } from "./api-client";
+
+type FileMemoryAction =
+  | "list"
+  | "stat"
+  | "read"
+  | "create"
+  | "update"
+  | "rename"
+  | "delete"
+  | "versions-list"
+  | "versions-get";
+
+function route(memoryStoreName: string, action: FileMemoryAction): string {
+  return `/api/v1/memory/stores/${encodeURIComponent(
+    memoryStoreName,
+  )}/file-memory/${action}`;
 }
 
-export interface FileMemoryTree {
-  scopeDir: string;
-  files: FileMemoryEntry[];
+function post<TResult, TRequest>(
+  memoryStoreName: string,
+  action: FileMemoryAction,
+  request: TRequest,
+): Promise<TResult> {
+  return apiPost<TResult>(route(memoryStoreName, action), request);
 }
 
-export interface FileMemorySyncResult extends FileMemoryTree {
-  sync: MemoryFilesSyncSummary;
+export function listFileMemories(
+  memoryStoreName: string,
+  request: ListFileMemoriesRequest,
+): Promise<ListFileMemoriesResponse> {
+  return post(memoryStoreName, "list", request);
 }
 
-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();
+export function statFileMemory(
+  memoryStoreName: string,
+  request: StatFileMemoryRequest,
+): Promise<FileMemory> {
+  return post(memoryStoreName, "stat", request);
+}
+
+export function readFileMemory(
+  memoryStoreName: string,
+  request: ReadFileMemoryRequest,
+): Promise<FileMemory> {
+  return post(memoryStoreName, "read", request);
+}
+
+export function createFileMemory(
+  memoryStoreName: string,
+  request: CreateFileMemoryRequest,
+): Promise<FileMemory> {
+  return post(memoryStoreName, "create", request);
+}
+
+export function updateFileMemory(
+  memoryStoreName: string,
+  request: UpdateFileMemoryRequest,
+): Promise<FileMemory> {
+  return post(memoryStoreName, "update", request);
+}
+
+export function renameFileMemory(
+  memoryStoreName: string,
+  request: RenameFileMemoryRequest,
+): Promise<FileMemory> {
+  return post(memoryStoreName, "rename", request);
 }
 
-/** 触发一次远端→本地增量同步（AuthorizeMemoryMount + STS），返回文件树与统计。 */
-export async function syncFileMemory(
+export function deleteFileMemory(
   memoryStoreName: string,
-  scope: ChatMemoryWriteScope,
-): Promise<FileMemorySyncResult> {
-  return apiPost<FileMemorySyncResult>(
-    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/file-memory/sync`,
-    { scope },
-  );
+  request: DeleteFileMemoryRequest,
+): Promise<Record<string, never>> {
+  return post(memoryStoreName, "delete", request);
 }
 
-/** 只读本地镜像目录的文件树（不联网）。 */
-export async function getFileMemoryTree(
+export function listFileMemoryVersions(
   memoryStoreName: string,
-  scope: ChatMemoryWriteScope,
-): Promise<FileMemoryTree> {
-  return apiGet<FileMemoryTree>(
-    `/api/v1/memory/stores/${encodeURIComponent(
-      memoryStoreName,
-    )}/file-memory/tree?${scopeQuery(scope)}`,
-  );
+  request: ListFileMemoryVersionsRequest,
+): Promise<ListFileMemoryVersionsResponse> {
+  return post(memoryStoreName, "versions-list", request);
 }
 
-/** 读取镜像目录内单个文件内容。 */
-export async function getFileMemoryFile(
+export function getFileMemoryVersion(
   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)}`,
-  );
+  request: GetFileMemoryVersionRequest,
+): Promise<FileMemoryVersion> {
+  return post(memoryStoreName, "versions-get", request);
 }

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

@@ -0,0 +1,97 @@
+export interface FileMemoryScope {
+  appId: string;
+  tenantId: string;
+  agentId: string;
+  runId: string;
+}
+
+export type FileMemoryOperation = "created" | "modified" | "deleted";
+
+export interface FileMemory {
+  memoryId: string;
+  path: string;
+  content?: string;
+  contentSha256: string;
+  contentSizeBytes: number;
+  latestSeq: number;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface FileMemoryVersion {
+  memoryVersionId: string;
+  memoryId: string;
+  versionSeq: number;
+  operation: FileMemoryOperation;
+  path: string;
+  content?: string;
+  contentSha256: string;
+  contentSizeBytes: number;
+  sessionId?: string;
+  createdAt: string;
+}
+
+export interface FileMemoryScopedRequest {
+  scope: FileMemoryScope;
+}
+
+export interface ListFileMemoriesRequest extends FileMemoryScopedRequest {
+  pathPrefix?: string;
+  nextToken?: string;
+  limit?: number;
+}
+
+export interface ListFileMemoriesResponse {
+  memories: FileMemory[];
+  nextToken?: string;
+  readOnly?: boolean;
+}
+
+export interface ReadFileMemoryRequest extends FileMemoryScopedRequest {
+  path: string;
+}
+
+export type StatFileMemoryRequest = ReadFileMemoryRequest;
+
+export interface CreateFileMemoryRequest extends FileMemoryScopedRequest {
+  path: string;
+  content: string;
+  sessionId?: string;
+}
+
+export interface UpdateFileMemoryRequest extends CreateFileMemoryRequest {
+  expectedSha256?: string;
+}
+
+export interface RenameFileMemoryRequest extends FileMemoryScopedRequest {
+  fromPath: string;
+  toPath: string;
+  overwrite?: boolean;
+  expectedSha256?: string;
+  sessionId?: string;
+}
+
+export interface DeleteFileMemoryRequest extends FileMemoryScopedRequest {
+  path: string;
+  expectedSha256?: string;
+  sessionId?: string;
+}
+
+export interface ListFileMemoryVersionsRequest extends FileMemoryScopedRequest {
+  memoryId: string;
+  path?: string;
+  nextToken?: string;
+  limit?: number;
+  operation?: FileMemoryOperation;
+}
+
+export interface ListFileMemoryVersionsResponse {
+  versions: FileMemoryVersion[];
+  nextToken?: string;
+}
+
+export interface GetFileMemoryVersionRequest extends FileMemoryScopedRequest {
+  memoryId: string;
+  memoryVersionId: string;
+  versionSeq: number;
+}

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

@@ -1,5 +1,6 @@
 import type { RetrievalResult } from "./retrieval";
 import type { MemorySearchHit } from "./memory";
+import type { StorageMode } from "@/lib/memory-storage-mode";
 
 export type ChatRole = "user" | "assistant" | "system";
 
@@ -58,12 +59,23 @@ export interface ChatMessage {
   /** 服务端实际用于 SearchMemories 的查询串。命中为空时也保留，便于
    *  在未来扩展「为什么没召回」诊断面板，并作为命中卡片触发栏的副标题。 */
   memoryQuery?: string;
-  /** 文件记忆模式下本轮同步的本地镜像目录。 */
-  memoryFilesScopeDir?: string;
   /** 文件记忆模式下本轮参与检索的文件列表（相对路径 + 大小）。 */
   memoryFiles?: Array<{ rel: string; size: number }>;
-  /** 文件记忆模式下本轮的同步结果摘要（+下载 -删除 =总数 / 失败原因）。 */
-  memoryFilesSync?: MemoryFilesSyncSummary;
+  /** 文件 API 在标签页缓存中的列举、读取与 SHA 复用摘要。 */
+  memoryFilesCache?: MemoryFilesCacheSummary;
+  memoryFilesStoreName?: string;
+  memoryFilesWritable?: boolean;
+  memoryFilesScope?: {
+    appId: string;
+    tenantId: string;
+    agentId: string;
+    runId: string;
+  };
+  /** 对话后自动提炼到 filemem 的状态与落盘结果。 */
+  memorySaveStatus?: "saving" | "saved" | "unchanged" | "error";
+  memorySavePath?: string;
+  memorySaveCount?: number;
+  memorySaveError?: string;
   /** 单条用户消息对应的「逻辑轮次」标识；编辑/重发复用同一个值，
    *  以便服务端去重 fire-and-forget 写入。 */
   turnId?: string;
@@ -103,13 +115,15 @@ export interface ChatRequestBody {
   };
   /**
    * 绑定的记忆库及其完整写 scope。服务端在 SearchMemories 调用前自行派生
-   * 读 scope（把 agentId、runId 强制改为 "*"），客户端永远不发通配符。
+   * app + tenant 级读 scope（保留 appId、tenantId，把 agentId、runId 改为
+   * "*"）；文件记忆仍使用精确 scope，客户端永远不发通配符。
    *
    * @see MemoryScope in ./memory — this wire shape is deliberately stricter:
    *      all four scope fields are required (this is the *write* scope).
    */
   memory?: {
     memoryStoreName: string;
+    storageMode?: StorageMode;
     scope: {
       appId: string;
       tenantId: string;
@@ -122,19 +136,27 @@ export interface ChatRequestBody {
     turnId?: string;
     /**
      * 记忆检索模式。缺省 "search"（服务端语义检索）；"local" 启用文件记忆：
-     * 服务端先把该 scope 的 OSS 文件投影同步到本地镜像目录，再在本地做
+     * 服务端先把该 scope 的文件投影同步到本地镜像目录，再在本地做
      * 词法检索（openclaw local 模式同款）。
      */
     retrievalMode?: "search" | "local";
+    /** 浏览器标签页内存生成的有界文件元数据与词法命中。 */
+    fileContext?: {
+      files: Array<{ rel: string; size: number }>;
+      hits: Array<{ text: string; source: string; score: number }>;
+      cache: MemoryFilesCacheSummary;
+    };
   };
 }
 
-/** 文件记忆同步结果摘要，随 `memory.files` 事件下发给聊天 UI。 */
-export interface MemoryFilesSyncSummary {
+/** 文件 API 标签页缓存摘要，随 `memory.files` 事件下发给聊天 UI。 */
+export interface MemoryFilesCacheSummary {
   ok: boolean;
-  downloaded?: number;
-  deleted?: number;
-  total?: number;
+  listed: number;
+  loaded: number;
+  reused: number;
+  totalBytes: number;
+  truncated: boolean;
   error?: string;
 }
 
@@ -162,9 +184,23 @@ export type ChatStreamEvent =
   | { type: "memory.done"; hits: MemorySearchHit[] }
   | {
       type: "memory.files";
-      scopeDir: string;
       files: Array<{ rel: string; size: number }>;
-      sync: MemoryFilesSyncSummary;
+      cache: MemoryFilesCacheSummary;
+      memoryStoreName: string;
+      writable: boolean;
+      scope: {
+        appId: string;
+        tenantId: string;
+        agentId: string;
+        runId: string;
+      };
+    }
+  | { type: "memory.save.start" }
+  | {
+      type: "memory.save.done";
+      status: "saved" | "unchanged";
+      count: number;
+      path?: string;
     }
   | { type: "memory.save.skipped"; reason: string }
   | { type: "error"; code: string; message: string };

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

@@ -4,7 +4,7 @@ export interface MemoryStore {
   memoryStoreName: string;
   description?: string;
   extractInstructions?: string;
-  /** 存储模式（ots|oss+ots），创建后不可改；列表由 BFF 逐库富化，可能缺省。 */
+  /** 存储模式（ots|file+ots|filemem），创建后不可改。 */
   storageMode?: StorageMode;
   createdAt?: number | string;
   updatedAt?: number | string;
@@ -41,6 +41,13 @@ export interface MemoryUnit {
   salience?: number;
   version?: number;
   deleted?: boolean;
+  // Event time of the source message this unit describes — NOT the insert time.
+  // The server overwrites the write instant with the cited message's timestamp,
+  // but the override is conditional: with no timestamp on the cited message it
+  // falls back to the unit's own stamp, then the memcell time, then now().
+  // Dream-produced units bypass the override entirely and keep the server task
+  // time. `updated_at` is the field that is a real server write time (and only
+  // reliably so for V2-written rows). Display it as "event time", not "created".
   created_at?: string;
   updated_at?: string;
   score?: number;
@@ -82,7 +89,7 @@ export interface CreateMemoryStoreRequest {
   memoryStoreName: string;
   description?: string;
   extractInstructions?: string;
-  /** 存储模式（ots|oss+ots），创建后不可修改。缺省服务端按 ots 处理。 */
+  /** 存储模式（ots|file+ots|filemem），创建后不可修改。 */
   storageMode?: StorageMode;
 }