@tablestore/tablestore-agent-cli 0.2.7 → 0.2.9

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

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

@@ -1,13 +1,13 @@
 import { apiGet } from "./api-client";
 
 export interface OssListFolder {
-  name: string;     // basename ending with "/", e.g. "january/"
-  prefix: string;   // full prefix, e.g. "docs/2026/january/"
+  name: string; // basename ending with "/", e.g. "january/"
+  prefix: string; // full prefix, e.g. "docs/2026/january/"
 }
 
 export interface OssListFile {
-  name: string;       // basename without prefix, e.g. "spec.pdf"
-  ossKey: string;     // full key, e.g. "docs/2026/spec.pdf"
+  name: string; // basename without prefix, e.g. "spec.pdf"
+  ossKey: string; // full key, e.g. "docs/2026/spec.pdf"
   size: number;
   lastModified: string; // ISO 8601
 }
@@ -28,9 +28,9 @@ export async function listOssObjects(params: {
 }): Promise<OssListPage> {
   const q = new URLSearchParams();
   if (params.prefix) q.set("prefix", params.prefix);
-  if (params.continuationToken) q.set("continuationToken", params.continuationToken);
+  if (params.continuationToken)
+    q.set("continuationToken", params.continuationToken);
   if (params.maxResults) q.set("maxResults", String(params.maxResults));
   if (params.search) q.set("search", params.search);
   return apiGet<OssListPage>(`/api/v1/oss/list?${q.toString()}`);
 }
-

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

@@ -6,11 +6,11 @@ export interface RetrieveResponse {
 }
 
 export async function retrieve(
-  request: RetrievalRequest
+  request: RetrievalRequest,
 ): Promise<RetrieveResponse> {
   const { knowledgeBaseName, ...body } = request;
   return apiPost<RetrieveResponse>(
     `/api/v1/knowledge-bases/${encodeURIComponent(knowledgeBaseName)}/retrieve`,
-    body
+    body,
   );
 }

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

@@ -25,6 +25,8 @@ export interface InstanceDetail extends InstanceSummary {
   accessKeyIdMasked?: string;
   /** Masked SK (first4****last4), safe for UI display. */
   accessKeySecretMasked?: string;
+  /** Masked API Key (first4****last4), safe for UI display. */
+  apiKeyMasked?: string;
   memoryDefaults?: {
     storeName?: string;
     appId?: string;
@@ -36,8 +38,14 @@ export interface InstanceDetail extends InstanceSummary {
 
 export interface ConnectInstancePayload {
   name: string;
-  accessKeyId: string;
-  accessKeySecret: string;
+  /** AccessKey pair. Optional when an API Key is supplied instead. */
+  accessKeyId?: string;
+  accessKeySecret?: string;
+  /**
+   * Tablestore API Key (data-plane credential). Takes precedence over AK/SK.
+   * Requires otsEndpoint/otsInstanceName since it cannot auto-provision.
+   */
+  apiKey?: string;
   otsEndpoint: string;
   otsInstanceName: string;
   ossEndpoint?: string;

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

@@ -76,11 +76,7 @@ export interface KnowledgeBase {
 }
 
 export type DocumentStatus =
-  | "Pending"
-  | "Indexing"
-  | "Completed"
-  | "Deleting"
-  | "Failed";
+  "Pending" | "Indexing" | "Completed" | "Deleting" | "Failed";
 
 export interface Document {
   docId: string;
@@ -108,8 +104,8 @@ export interface Chunk {
   status: ChunkStatus;
   createdAt: number;
   updatedAt?: number;
-  imageBase64?: string;   // 多模态 KB 的图片块返回 base64 编码图片
-  caption?: string;       // 表格/公式/图片的语义描述
+  imageBase64?: string; // 多模态 KB 的图片块返回 base64 编码图片
+  caption?: string; // 表格/公式/图片的语义描述
 }
 
 export interface CreateKBRequest {

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

@@ -58,6 +58,12 @@ export interface ChatMessage {
   /** 服务端实际用于 SearchMemories 的查询串。命中为空时也保留，便于
    *  在未来扩展「为什么没召回」诊断面板，并作为命中卡片触发栏的副标题。 */
   memoryQuery?: string;
+  /** 文件记忆模式下本轮同步的本地镜像目录。 */
+  memoryFilesScopeDir?: string;
+  /** 文件记忆模式下本轮参与检索的文件列表（相对路径 + 大小）。 */
+  memoryFiles?: Array<{ rel: string; size: number }>;
+  /** 文件记忆模式下本轮的同步结果摘要（+下载 -删除 =总数 / 失败原因）。 */
+  memoryFilesSync?: MemoryFilesSyncSummary;
   /** 单条用户消息对应的「逻辑轮次」标识；编辑/重发复用同一个值，
    *  以便服务端去重 fire-and-forget 写入。 */
   turnId?: string;
@@ -114,9 +120,24 @@ export interface ChatRequestBody {
     autoSave?: boolean;
     /** 客户端每个「逻辑轮次」生成一次，用于服务端去重 fire-and-forget 写入。 */
     turnId?: string;
+    /**
+     * 记忆检索模式。缺省 "search"（服务端语义检索）；"local" 启用文件记忆：
+     * 服务端先把该 scope 的 OSS 文件投影同步到本地镜像目录，再在本地做
+     * 词法检索（openclaw local 模式同款）。
+     */
+    retrievalMode?: "search" | "local";
   };
 }
 
+/** 文件记忆同步结果摘要，随 `memory.files` 事件下发给聊天 UI。 */
+export interface MemoryFilesSyncSummary {
+  ok: boolean;
+  downloaded?: number;
+  deleted?: number;
+  total?: number;
+  error?: string;
+}
+
 /**
  * Server-sent events emitted by the chat endpoint. The transport is SSE
  * (`text/event-stream`) with each event encoded as a single `data: <json>\n\n`
@@ -139,5 +160,11 @@ export type ChatStreamEvent =
     }
   | { type: "memory.start"; query: string }
   | { type: "memory.done"; hits: MemorySearchHit[] }
+  | {
+      type: "memory.files";
+      scopeDir: string;
+      files: Array<{ rel: string; size: number }>;
+      sync: MemoryFilesSyncSummary;
+    }
   | { type: "memory.save.skipped"; reason: string }
   | { type: "error"; code: string; message: string };

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

@@ -1,7 +1,11 @@
+import type { StorageMode } from "@/lib/memory-storage-mode";
+
 export interface MemoryStore {
   memoryStoreName: string;
   description?: string;
   extractInstructions?: string;
+  /** 存储模式（ots|oss+ots），创建后不可改；列表由 BFF 逐库富化，可能缺省。 */
+  storageMode?: StorageMode;
   createdAt?: number | string;
   updatedAt?: number | string;
   lastSeenAt?: number | string;
@@ -78,6 +82,8 @@ export interface CreateMemoryStoreRequest {
   memoryStoreName: string;
   description?: string;
   extractInstructions?: string;
+  /** 存储模式（ots|oss+ots），创建后不可修改。缺省服务端按 ots 处理。 */
+  storageMode?: StorageMode;
 }
 
 export interface UpdateMemoryStoreRequest {
@@ -124,11 +130,7 @@ export interface SearchMemoryRequest {
 // ---------------------------------------------------------------------------
 
 export type MemoryTaskStatus =
-  | "queued"
-  | "running"
-  | "completed"
-  | "failed"
-  | "needs_reconcile";
+  "queued" | "running" | "completed" | "failed" | "needs_reconcile";
 
 export interface MemoryTask {
   requestId: string;
@@ -166,11 +168,16 @@ export type DreamApplyMode = "proposal" | "safe_auto";
 export type DreamScopeOutputMode = "preserve_scope" | "promote_scope";
 
 export type DreamActionStatus = "proposed" | "applied" | "skipped" | "failed";
-export type DreamActionType = "ADD" | "UPDATE" | "DELETE" | "MERGE" | "NOOP" | "EMIT_SKILL" | "EMIT_PROFILE";
+export type DreamActionType =
+  | "ADD"
+  | "UPDATE"
+  | "DELETE"
+  | "MERGE"
+  | "NOOP"
+  | "EMIT_SKILL"
+  | "EMIT_PROFILE";
 export type DreamActionListOrderBy =
-  | "created_at_asc"
-  | "created_at_desc"
-  | "confidence_desc";
+  "created_at_asc" | "created_at_desc" | "confidence_desc";
 
 export type DreamSkippedReason =
   | "stale_target_memory"
@@ -339,3 +346,16 @@ export const DREAM_TERMINAL_STATUSES: ReadonlySet<DreamTaskStatus> = new Set([
   "failed",
   "cancelled",
 ]);
+
+// ---------------------------------------------------------------------------
+// 会话内沉淀结果（与 BFF DreamDepositResult 对齐）
+// ---------------------------------------------------------------------------
+
+export interface DreamDepositResult {
+  deposited: Array<{
+    kind: "skill" | "profile";
+    fileName: string;
+    count: number;
+  }>;
+  failures: Array<{ kind: "skill" | "profile"; error: string }>;
+}

package/dist/dashboard-runtime/dashboard/tsconfig.json

@@ -1,11 +1,7 @@
 {
   "compilerOptions": {
     "target": "ES2017",
-    "lib": [
-      "dom",
-      "dom.iterable",
-      "esnext"
-    ],
+    "lib": ["dom", "dom.iterable", "esnext"],
     "allowJs": true,
     "skipLibCheck": true,
     "strict": true,
@@ -23,9 +19,7 @@
       }
     ],
     "paths": {
-      "@/*": [
-        "./src/*"
-      ]
+      "@/*": ["./src/*"]
     }
   },
   "include": [
@@ -37,7 +31,5 @@
     "out/types/**/*.ts",
     "out/dev/types/**/*.ts"
   ],
-  "exclude": [
-    "node_modules"
-  ]
+  "exclude": ["node_modules"]
 }

package/dist/dashboard-runtime/dashboard/vitest.config.mjs

@@ -13,9 +13,6 @@ export default defineConfig({
   test: {
     environment: "node",
     include: ["src/**/__tests__/**/*.test.{ts,tsx}"],
-    // llm-crypto.test.ts is written against node:test (not vitest); skip it
-    // here so the dashboard vitest run does not blow up. Run that file via
-    // `node --test` if needed.
-    exclude: ["src/lib/server/__tests__/llm-crypto.test.ts", "node_modules/**"],
+    exclude: ["node_modules/**"],
   },
 });