@tablestore/tablestore-agent-cli 0.2.10 → 0.3.1

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;
 }
 
@@ -158,15 +165,41 @@ export type DreamTaskStatus =
   | "queued"
   | "running"
   | "planning"
+  | "awaiting_plan_approval"
   | "applying"
   | "completed"
   | "completed_with_failures"
   | "failed"
   | "cancelled";
 
-export type DreamApplyMode = "proposal" | "safe_auto";
+export type DreamApplyMode = "proposal" | "safe_auto" | "plan";
+export type DreamExecutionMode = "single_loop" | "multi_loop";
 export type DreamScopeOutputMode = "preserve_scope" | "promote_scope";
 
+export interface DreamPlan {
+  summary: string;
+  deleteMemoryIds: string[];
+  approvalExpiresAt?: string;
+  approvedAt?: string;
+  approver?: string;
+  executionExpiresAt?: string;
+}
+
+export interface DreamSandboxState {
+  sandboxId?: string;
+  phase?: string;
+  status?: string;
+  startedAt?: string;
+  statusUpdatedAt?: string;
+}
+
+export interface DreamBatchState {
+  batchId?: string;
+  sequence?: number;
+  expectedActionCount?: number;
+  settled?: boolean;
+}
+
 export type DreamActionStatus = "proposed" | "applied" | "skipped" | "failed";
 export type DreamActionType =
   | "ADD"
@@ -209,6 +242,7 @@ export interface DreamTaskInputSummary {
   scopes: MemoryScope[];
   minTimestamp: number;
   maxTimestamp: number;
+  incremental?: boolean;
   sessionCount: number;
   messageCount: number;
   memoryCount: number;
@@ -228,7 +262,16 @@ export interface DreamTaskSummary {
   status: DreamTaskStatus;
   taskType: DreamTaskType;
   applyMode: DreamApplyMode;
+  executionMode: DreamExecutionMode;
   scopeOutputMode: DreamScopeOutputMode;
+  stage?: string;
+  plan?: DreamPlan;
+  sandbox?: DreamSandboxState;
+  submittedBatchCount?: number;
+  lastBatch?: DreamBatchState;
+  agentFinishedAt?: string;
+  failureCode?: string;
+  processedThroughMs?: number;
   instructions?: string;
   input: DreamTaskInputSummary;
   actions: DreamTaskActionStats;
@@ -244,7 +287,15 @@ export interface DreamTask {
   status: DreamTaskStatus;
   taskType?: DreamTaskType;
   applyMode: DreamApplyMode;
+  executionMode?: DreamExecutionMode;
   scopeOutputMode: DreamScopeOutputMode;
+  stage?: string;
+  plan?: DreamPlan;
+  sandbox?: DreamSandboxState;
+  submittedBatchCount?: number;
+  lastBatch?: DreamBatchState;
+  agentFinishedAt?: string;
+  failureCode?: string;
   clientToken?: string;
   triggerType?: string;
   expandedScopeLimit?: number;
@@ -256,6 +307,7 @@ export interface DreamTask {
   maxSessions?: number;
   maxMessages?: number;
   maxMemories?: number;
+  incremental?: boolean;
   confidenceThresholds?: Record<string, number>;
   instructions?: string;
   sessionCount?: number;
@@ -313,14 +365,16 @@ export interface DreamApplyActionResult {
 export interface CreateDreamTaskRequest {
   scopes: MemoryScope[];
   taskType?: DreamTaskType;
-  minTimestamp?: number | string;
-  maxTimestamp?: number | string;
+  executionMode?: DreamExecutionMode;
+  minTimestamp?: number;
+  maxTimestamp?: number;
   maxSessions?: number;
   maxMessages?: number;
   maxMemories?: number;
   expandedScopeLimit?: number;
   scopeOutputMode?: DreamScopeOutputMode;
   applyMode?: DreamApplyMode;
+  incremental?: boolean;
   confidenceThresholds?: Record<string, number>;
   instructions?: string;
   clientToken?: string;