@tablestore/tablestore-agent-cli 0.2.11 → 0.4.0

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

@@ -216,6 +216,19 @@ export async function listMemoryStoreScopes(
  *
  * Capped at MAX_PAGES to bound worst-case fetch budget on stores with very
  * fragmented data — far past that, the suggestion list stops being useful UX.
+ *
+ * `pageSize` is 100 because that is the engine's own ceiling: asking for 200,
+ * 500 or 1000 all come back with exactly 100 items and a byte-identical
+ * nextToken. Raising it buys nothing.
+ *
+ * That matters because nextToken carries the engine's already-seen scope set
+ * (base64 JSON, ~74 bytes per scope) and we hand it back in the query string,
+ * so deep paging eventually blows Node's 16KB `maxHeaderSize` and the request
+ * 431s at somewhere past ~200 scopes. We can't page around it from here — the
+ * real fix is moving the token off the URL — so we degrade instead of
+ * exploding: a page that fails after we already have results returns those
+ * results marked `truncated`, which the UI renders as "first N only" rather
+ * than an error that throws the whole list away.
  */
 export async function listAllMemoryStoreScopes(
   memoryStoreName: string,
@@ -230,10 +243,18 @@ export async function listAllMemoryStoreScopes(
   let truncated = false;
 
   for (let page = 0; page < maxPages; page++) {
-    const data = await listMemoryStoreScopes(memoryStoreName, scope, {
-      limit: pageSize,
-      nextToken,
-    });
+    let data: Awaited<ReturnType<typeof listMemoryStoreScopes>>;
+    try {
+      data = await listMemoryStoreScopes(memoryStoreName, scope, {
+        limit: pageSize,
+        nextToken,
+      });
+    } catch (error) {
+      // Nothing to show yet — let the caller surface a real error state.
+      if (items.length === 0) throw error;
+      truncated = true;
+      break;
+    }
     for (const s of data.items) {
       const key = `${s.appId ?? ""}|${s.tenantId ?? ""}|${s.agentId ?? ""}|${s.runId ?? ""}`;
       if (seen.has(key)) continue;
@@ -402,7 +423,26 @@ export async function applyDreamActions(
 }> {
   return apiPost(
     `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/dream-tasks/${encodeURIComponent(dreamId)}/actions/apply`,
-    applier ? { actionIds, applier } : { actionIds },
+    applier
+      ? { mode: "actions", actionIds, applier }
+      : { mode: "actions", actionIds },
+  );
+}
+
+export async function approveDreamPlan(
+  memoryStoreName: string,
+  dreamId: string,
+  approver: string,
+): Promise<{
+  memoryStoreName: string;
+  dreamId: string;
+  status: string;
+  approvedAt?: string;
+  executionExpiresAt?: string;
+}> {
+  return apiPost(
+    `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/dream-tasks/${encodeURIComponent(dreamId)}/actions/apply`,
+    { mode: "plan", approver },
   );
 }
 

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

@@ -0,0 +1,145 @@
+import type {
+  AddWikiSourcesRequest,
+  DeleteWikiSourceRequest,
+  GetWikiPageRequest,
+  GetWikiSourceRequest,
+  IngestWikiRequest,
+  IngestWikiResponse,
+  ListWikiArtifactsRequest,
+  ListWikiArtifactsResponse,
+  ListWikiPagesRequest,
+  ListWikiPagesResponse,
+  ListWikiSourcesRequest,
+  ListWikiSourcesResponse,
+  SearchWikiPagesRequest,
+  UpdateWikiRequest,
+  UpdateWikiSourceRequest,
+  Wiki,
+  WikiPage,
+  WikiRawSource,
+  WikiScope,
+  WikiSourceBatchResult,
+} from "@/types/wiki";
+
+import { apiDelete, apiGet, apiPatch, apiPost, apiPut } from "./api-client";
+
+function wikisRoute(memoryStoreName: string): string {
+  return `/api/v1/memory/stores/${encodeURIComponent(memoryStoreName)}/wikis`;
+}
+
+export function buildWikiQuery(
+  scope: WikiScope,
+  extra: Record<string, number | string | undefined> = {},
+): string {
+  const params = new URLSearchParams();
+  params.set("appId", scope.appId);
+  params.set("tenantId", scope.tenantId);
+  params.set("agentId", scope.agentId);
+  for (const [key, value] of Object.entries(extra)) {
+    if (value !== undefined) params.set(key, String(value));
+  }
+  return params.toString();
+}
+
+export function getWiki(
+  memoryStoreName: string,
+  scope: WikiScope,
+): Promise<Wiki> {
+  return apiGet<Wiki>(
+    `${wikisRoute(memoryStoreName)}?${buildWikiQuery(scope)}`,
+  );
+}
+
+export function updateWiki(
+  memoryStoreName: string,
+  request: UpdateWikiRequest,
+): Promise<Wiki> {
+  return apiPatch<Wiki>(wikisRoute(memoryStoreName), request);
+}
+
+export function ingestWiki(
+  memoryStoreName: string,
+  request: IngestWikiRequest,
+): Promise<IngestWikiResponse> {
+  return apiPost(`${wikisRoute(memoryStoreName)}/ingest`, request);
+}
+
+export function listWikiSources(
+  memoryStoreName: string,
+  request: ListWikiSourcesRequest,
+): Promise<ListWikiSourcesResponse> {
+  const query = buildWikiQuery(request.scope, {
+    limit: request.limit,
+    nextToken: request.nextToken,
+  });
+  return apiGet(`${wikisRoute(memoryStoreName)}/sources?${query}`);
+}
+
+export function listWikiArtifacts(
+  memoryStoreName: string,
+  request: ListWikiArtifactsRequest,
+): Promise<ListWikiArtifactsResponse> {
+  const query = buildWikiQuery(request.scope, {
+    kind: request.kind,
+    limit: request.limit,
+    nextToken: request.nextToken,
+  });
+  return apiGet(`${wikisRoute(memoryStoreName)}/artifacts?${query}`);
+}
+
+export function addWikiSources(
+  memoryStoreName: string,
+  request: AddWikiSourcesRequest,
+): Promise<WikiSourceBatchResult> {
+  return apiPost(`${wikisRoute(memoryStoreName)}/sources`, request);
+}
+
+export function getWikiSource(
+  memoryStoreName: string,
+  request: GetWikiSourceRequest,
+): Promise<WikiRawSource> {
+  const query = buildWikiQuery(request.scope, { path: request.path });
+  return apiGet(`${wikisRoute(memoryStoreName)}/source?${query}`);
+}
+
+export function updateWikiSource(
+  memoryStoreName: string,
+  request: UpdateWikiSourceRequest,
+): Promise<WikiRawSource> {
+  return apiPut(`${wikisRoute(memoryStoreName)}/source`, request);
+}
+
+export function deleteWikiSource(
+  memoryStoreName: string,
+  request: DeleteWikiSourceRequest,
+): Promise<{ path: string; deleted: true }> {
+  return apiDelete(`${wikisRoute(memoryStoreName)}/source`, request);
+}
+
+export function listWikiPages(
+  memoryStoreName: string,
+  request: ListWikiPagesRequest,
+): Promise<ListWikiPagesResponse> {
+  const query = buildWikiQuery(request.scope, {
+    limit: request.limit,
+    nextToken: request.nextToken,
+  });
+  return apiGet(`${wikisRoute(memoryStoreName)}/pages?${query}`);
+}
+
+export function getWikiPage(
+  memoryStoreName: string,
+  request: GetWikiPageRequest,
+): Promise<WikiPage> {
+  const query = buildWikiQuery(request.scope, {
+    path: request.path,
+  });
+  return apiGet(`${wikisRoute(memoryStoreName)}/page?${query}`);
+}
+
+export function searchWikiPages(
+  memoryStoreName: string,
+  request: SearchWikiPagesRequest,
+): Promise<{ pages: WikiPage[] }> {
+  return apiPost(`${wikisRoute(memoryStoreName)}/search`, request);
+}

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

@@ -5,93 +5,146 @@ export interface FileMemoryScope {
   runId: string;
 }
 
-export type FileMemoryOperation = "created" | "modified" | "deleted";
+export type ItemView = "basic" | "full";
+export type ItemOperation = "created" | "modified" | "deleted";
 
-export interface FileMemory {
-  memoryId: string;
+export interface ItemActor {
+  actorType: string;
+  actorId: string;
+}
+
+export interface ItemPrecondition {
+  expectedVersionId: string;
+}
+
+export interface FileMemoryItem {
+  type: "memoryfile";
+  itemId: string;
+  scope: FileMemoryScope;
   path: string;
   content?: string;
   contentSha256: string;
   contentSizeBytes: number;
   latestSeq: number;
+  latestVersionId: string;
   createdAt: string;
   updatedAt: string;
 }
 
-export interface FileMemoryVersion {
-  memoryVersionId: string;
-  memoryId: string;
-  versionSeq: number;
-  operation: FileMemoryOperation;
+export interface FileMemoryPrefix {
+  type: "memoryfile_prefix";
+  scope: FileMemoryScope;
+  path: string;
+}
+
+export type FileMemoryListEntry = FileMemoryItem | FileMemoryPrefix;
+
+export interface FileMemoryItemVersion {
+  type: "memoryfile";
+  versionId: string;
+  itemId: string;
+  scope: FileMemoryScope;
+  operation: ItemOperation;
   path: string;
   content?: string;
   contentSha256: string;
   contentSizeBytes: number;
-  sessionId?: string;
+  createdBy?: ItemActor;
   createdAt: string;
+  redacted?: boolean;
+  redactedAt?: string;
+  redactedBy?: ItemActor;
 }
 
-export interface FileMemoryScopedRequest {
+export interface ItemScopedRequest {
   scope: FileMemoryScope;
 }
 
-export interface ListFileMemoriesRequest extends FileMemoryScopedRequest {
+export interface AddItemRequest extends ItemScopedRequest {
+  path: string;
+  content: string;
+  sessionId?: string;
+  view?: ItemView;
+}
+
+export interface ListItemsRequest extends ItemScopedRequest {
   pathPrefix?: string;
-  nextToken?: string;
+  depth?: 0 | 1;
+  view?: ItemView;
   limit?: number;
+  nextToken?: string;
 }
 
-export interface ListFileMemoriesResponse {
-  memories: FileMemory[];
+export interface ListItemsResponse {
+  type: "memoryfile";
+  items: FileMemoryListEntry[];
   nextToken?: string;
   readOnly?: boolean;
 }
 
-export interface ReadFileMemoryRequest extends FileMemoryScopedRequest {
-  path: string;
+export interface GetItemRequest extends ItemScopedRequest {
+  itemId?: string;
+  path?: string;
+  view?: ItemView;
 }
 
-export type StatFileMemoryRequest = ReadFileMemoryRequest;
+export interface UpdateItemRequest extends ItemScopedRequest {
+  itemId: string;
+  content?: string;
+  path?: string;
+  overwrite?: boolean;
+  precondition?: ItemPrecondition;
+  sessionId?: string;
+  view?: ItemView;
+}
 
-export interface CreateFileMemoryRequest extends FileMemoryScopedRequest {
-  path: string;
-  content: string;
+export interface DeleteItemRequest extends ItemScopedRequest {
+  itemId?: string;
+  path?: string;
+  pathPrefix?: string;
+  precondition?: ItemPrecondition;
   sessionId?: string;
 }
 
-export interface UpdateFileMemoryRequest extends CreateFileMemoryRequest {
-  expectedSha256?: string;
+export interface DeleteItemSingleResponse {
+  type: "memoryfile";
+  itemId: string;
+  deleted: true;
 }
 
-export interface RenameFileMemoryRequest extends FileMemoryScopedRequest {
-  fromPath: string;
-  toPath: string;
-  overwrite?: boolean;
-  expectedSha256?: string;
-  sessionId?: string;
+export interface DeleteItemRangedResponse {
+  type: "memoryfile";
+  taskId: string;
+  status: "pending";
 }
 
-export interface DeleteFileMemoryRequest extends FileMemoryScopedRequest {
-  path: string;
-  expectedSha256?: string;
+export type DeleteItemResponse =
+  DeleteItemSingleResponse | DeleteItemRangedResponse;
+
+export interface ListItemVersionsRequest extends ItemScopedRequest {
+  itemId?: string;
   sessionId?: string;
+  apiKeyId?: string;
+  createdAtGte?: string;
+  createdAtLte?: string;
+  operation?: ItemOperation;
+  view?: ItemView;
+  limit?: number;
+  nextToken?: string;
 }
 
-export interface ListFileMemoryVersionsRequest extends FileMemoryScopedRequest {
-  memoryId: string;
-  path?: string;
+export interface ListItemVersionsResponse {
+  type: "memoryfile";
+  versions: FileMemoryItemVersion[];
   nextToken?: string;
-  limit?: number;
-  operation?: FileMemoryOperation;
 }
 
-export interface ListFileMemoryVersionsResponse {
-  versions: FileMemoryVersion[];
-  nextToken?: string;
+export interface GetItemVersionRequest extends ItemScopedRequest {
+  versionId: string;
+  view?: ItemView;
 }
 
-export interface GetFileMemoryVersionRequest extends FileMemoryScopedRequest {
-  memoryId: string;
-  memoryVersionId: string;
-  versionSeq: number;
+export interface RedactItemVersionRequest extends ItemScopedRequest {
+  versionId: string;
+  sessionId?: string;
 }

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

@@ -74,3 +74,20 @@ export interface InstanceActionResult {
   activeInstance: string | null;
   instance: InstanceSummary;
 }
+
+export type InstanceConnectivityReason =
+  "timeout" | "dns" | "connection" | "tls" | "network";
+
+export interface InstanceConnectivity {
+  configured: boolean;
+  reachable: boolean | null;
+  checkedAt: string;
+  latencyMs?: number;
+  httpStatus?: number;
+  reason?: InstanceConnectivityReason;
+  message?: string;
+}
+
+export interface InstanceConnectivityOverview {
+  items: Record<string, InstanceConnectivity>;
+}

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

@@ -20,6 +20,37 @@ export interface RetrievalGroup {
   error?: string;
 }
 
+export interface RetrievalFailure {
+  code: string;
+  message: string;
+  requestId?: string;
+  httpStatus?: number;
+}
+
+export interface WikiRetrievalError extends RetrievalFailure {
+  stage: "validate" | "search" | "read" | "budget";
+  path?: string;
+}
+
+export interface WikiEvidence {
+  reference: `W${number}`;
+  wikiName: string;
+  path: string;
+  title?: string;
+  type?: string;
+  description?: string;
+  score?: number;
+  sources?: string[];
+  truncated: boolean;
+  injectedChars: number;
+}
+
+export interface WikiRetrievalGroup {
+  wikiName: string;
+  pages: WikiEvidence[];
+  errors?: WikiRetrievalError[];
+}
+
 export interface ChatMessage {
   id: string;
   role: ChatRole;
@@ -59,9 +90,23 @@ export interface ChatMessage {
   /** 服务端实际用于 SearchMemories 的查询串。命中为空时也保留，便于
    *  在未来扩展「为什么没召回」诊断面板，并作为命中卡片触发栏的副标题。 */
   memoryQuery?: string;
+  /** Wiki retrieval metadata only. Wiki page bodies must never be persisted. */
+  wikiQuery?: string;
+  wikiCount?: number;
+  wikiRetrievalDone?: boolean;
+  wikiEvidence?: WikiEvidence[];
+  wikiRetrievalGroups?: WikiRetrievalGroup[];
+  wikiTotalContextChars?: number;
+  wikiMemoryStoreName?: string;
+  wikiScope?: {
+    appId: string;
+    tenantId: string;
+    agentId: string;
+    runId: string;
+  };
   /** 文件记忆模式下本轮参与检索的文件列表（相对路径 + 大小）。 */
-  memoryFiles?: Array<{ rel: string; size: number }>;
-  /** 文件 API 在标签页缓存中的列举、读取与 SHA 复用摘要。 */
+  memoryFiles?: Array<{ rel: string; size: number; sha256?: string }>;
+  /** Chat BFF 进程内有界缓存的列举、读取与 SHA 复用摘要。 */
   memoryFilesCache?: MemoryFilesCacheSummary;
   memoryFilesStoreName?: string;
   memoryFilesWritable?: boolean;
@@ -136,20 +181,30 @@ export interface ChatRequestBody {
     turnId?: string;
     /**
      * 记忆检索模式。缺省 "search"（服务端语义检索）；"local" 启用文件记忆：
-     * 服务端先把该 scope 的文件投影同步到本地镜像目录，再在本地做
-     * 词法检索（openclaw local 模式同款）。
+     * Chat BFF 通过 JSON Item API 读取 exact scope，并在进程内有界
+     * SHA cache 上做词法检索；不会创建服务端本地镜像。
      */
     retrievalMode?: "search" | "local";
-    /** 浏览器标签页内存生成的有界文件元数据与词法命中。 */
+    /** 旧客户端兼容字段；server local 模式不信任也不消费其正文。 */
     fileContext?: {
-      files: Array<{ rel: string; size: number }>;
+      files: Array<{ rel: string; size: number; sha256?: string }>;
       hits: Array<{ text: string; source: string; score: number }>;
       cache: MemoryFilesCacheSummary;
     };
   };
+  wiki?: {
+    memoryStoreName: string;
+    scope: {
+      appId: string;
+      tenantId: string;
+      agentId: string;
+      runId: string;
+    };
+    topK: number;
+  };
 }
 
-/** 文件 API 标签页缓存摘要，随 `memory.files` 事件下发给聊天 UI。 */
+/** Chat BFF 文件缓存摘要，随 `memory.files` 事件下发给聊天 UI。 */
 export interface MemoryFilesCacheSummary {
   ok: boolean;
   listed: number;
@@ -181,10 +236,18 @@ export type ChatStreamEvent =
       usage?: { promptTokens?: number; completionTokens?: number };
     }
   | { type: "memory.start"; query: string }
-  | { type: "memory.done"; hits: MemorySearchHit[] }
+  | { type: "memory.done"; hits: MemorySearchHit[]; error?: RetrievalFailure }
+  | { type: "wiki.start"; query: string; wikiCount: number }
+  | {
+      type: "wiki.done";
+      query: string;
+      pages: WikiEvidence[];
+      byWiki: WikiRetrievalGroup[];
+      totalContextChars: number;
+    }
   | {
       type: "memory.files";
-      files: Array<{ rel: string; size: number }>;
+      files: Array<{ rel: string; size: number; sha256?: string }>;
       cache: MemoryFilesCacheSummary;
       memoryStoreName: string;
       writable: boolean;

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

@@ -165,15 +165,26 @@ 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 DreamEffort = "low" | "high";
 export type DreamScopeOutputMode = "preserve_scope" | "promote_scope";
 
+export interface DreamPlan {
+  summary: string;
+  deleteMemoryIds: string[];
+  approvalExpiresAt?: string;
+  approvedAt?: string;
+  approver?: string;
+  executionExpiresAt?: string;
+}
+
 export type DreamActionStatus = "proposed" | "applied" | "skipped" | "failed";
 export type DreamActionType =
   | "ADD"
@@ -216,6 +227,7 @@ export interface DreamTaskInputSummary {
   scopes: MemoryScope[];
   minTimestamp: number;
   maxTimestamp: number;
+  incremental?: boolean;
   sessionCount: number;
   messageCount: number;
   memoryCount: number;
@@ -234,8 +246,12 @@ export interface DreamTaskSummary {
   dreamId: string;
   status: DreamTaskStatus;
   taskType: DreamTaskType;
+  effort: DreamEffort;
   applyMode: DreamApplyMode;
   scopeOutputMode: DreamScopeOutputMode;
+  stage?: string;
+  plan?: DreamPlan;
+  processedThroughMs?: number;
   instructions?: string;
   input: DreamTaskInputSummary;
   actions: DreamTaskActionStats;
@@ -250,8 +266,11 @@ export interface DreamTask {
   memoryStoreName: string;
   status: DreamTaskStatus;
   taskType?: DreamTaskType;
+  effort: DreamEffort;
   applyMode: DreamApplyMode;
   scopeOutputMode: DreamScopeOutputMode;
+  stage?: string;
+  plan?: DreamPlan;
   clientToken?: string;
   triggerType?: string;
   expandedScopeLimit?: number;
@@ -263,6 +282,7 @@ export interface DreamTask {
   maxSessions?: number;
   maxMessages?: number;
   maxMemories?: number;
+  incremental?: boolean;
   confidenceThresholds?: Record<string, number>;
   instructions?: string;
   sessionCount?: number;
@@ -320,14 +340,16 @@ export interface DreamApplyActionResult {
 export interface CreateDreamTaskRequest {
   scopes: MemoryScope[];
   taskType?: DreamTaskType;
-  minTimestamp?: number | string;
-  maxTimestamp?: number | string;
+  effort?: DreamEffort;
+  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;