@tablestore/tablestore-agent-cli 0.3.1 → 0.4.0

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

@@ -173,7 +173,7 @@ export type DreamTaskStatus =
   | "cancelled";
 
 export type DreamApplyMode = "proposal" | "safe_auto" | "plan";
-export type DreamExecutionMode = "single_loop" | "multi_loop";
+export type DreamEffort = "low" | "high";
 export type DreamScopeOutputMode = "preserve_scope" | "promote_scope";
 
 export interface DreamPlan {
@@ -185,21 +185,6 @@ export interface DreamPlan {
   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"
@@ -261,16 +246,11 @@ export interface DreamTaskSummary {
   dreamId: string;
   status: DreamTaskStatus;
   taskType: DreamTaskType;
+  effort: DreamEffort;
   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;
@@ -286,16 +266,11 @@ export interface DreamTask {
   memoryStoreName: string;
   status: DreamTaskStatus;
   taskType?: DreamTaskType;
+  effort: DreamEffort;
   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;
@@ -365,7 +340,7 @@ export interface DreamApplyActionResult {
 export interface CreateDreamTaskRequest {
   scopes: MemoryScope[];
   taskType?: DreamTaskType;
-  executionMode?: DreamExecutionMode;
+  effort?: DreamEffort;
   minTimestamp?: number;
   maxTimestamp?: number;
   maxSessions?: number;

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

@@ -0,0 +1,200 @@
+import type { MemoryScope } from "./memory";
+
+export interface WikiScope {
+  appId: string;
+  tenantId: string;
+  agentId: string;
+}
+
+export type WikiStatus = "draft" | "ready" | "deleting" | "deleted";
+
+export type WikiBuildStatus =
+  | "pending"
+  | "processing"
+  | "accepting_output"
+  | "sealing"
+  | "validating"
+  | "indexing"
+  | "publishing"
+  | "ready"
+  | "failed"
+  | "conflict";
+
+export interface WikiDreamActionRef {
+  dreamId: string;
+  actionId: string;
+}
+
+export type WikiArtifactKind = "skill" | "profile";
+
+/** Browser-safe metadata for one applied Dream artifact. */
+export interface WikiDreamArtifact extends WikiDreamActionRef {
+  kind: WikiArtifactKind;
+  name: string;
+  description: string;
+  targetScope: MemoryScope;
+  appliedAt?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface WikiBuildChanges {
+  added: number;
+  modified: number;
+  deleted: number;
+  affectedPages: number;
+}
+
+export interface WikiBuildQuality {
+  sourceCoverage: number;
+  groundedPageRate: number;
+  brokenLinkCount: number;
+  orphanPageCount: number;
+  uncitedPageCount: number;
+  duplicateTitleCount: number;
+}
+
+export interface WikiBuild {
+  status: WikiBuildStatus;
+  step?: string;
+  progress?: number;
+  changes: WikiBuildChanges;
+  pageCount?: number;
+  totalBytes?: number;
+  quality?: WikiBuildQuality;
+  errorMessage?: string;
+  createdAt: string;
+  updatedAt: string;
+  finishedAt?: string;
+}
+
+export interface Wiki {
+  name: string;
+  summary?: string;
+  status: WikiStatus;
+  pageCount: number;
+  hasPendingChanges: boolean;
+  latestBuild?: WikiBuild;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface WikiPage {
+  path: string;
+  title?: string;
+  type?: string;
+  description?: string;
+  content?: string;
+  sources?: string[];
+  outgoingLinks?: string[];
+  incomingLinks?: string[];
+  incomingLinkCount?: number;
+  incomingLinksTruncated?: boolean;
+  score?: number;
+}
+
+export interface WikiRawSource {
+  path: string;
+  content?: string;
+  contentSha256: string;
+  contentSizeBytes: number;
+  latestVersionId: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface WikiSourceBatchResult {
+  results: Array<{
+    path: string;
+    ok: boolean;
+    source?: WikiRawSource;
+    error?: {
+      code: string;
+      message: string;
+      requestId?: string;
+      httpStatus?: number;
+    };
+  }>;
+}
+
+export interface WikiScopedRequest {
+  scope: WikiScope;
+}
+
+export type GetWikiRequest = WikiScopedRequest;
+
+export interface UpdateWikiRequest extends WikiScopedRequest {
+  name?: string;
+  summary?: string;
+}
+
+export interface IngestWikiRequest extends WikiScopedRequest {
+  clientToken?: string;
+  dreamActionRefs?: WikiDreamActionRef[];
+}
+
+export interface ListWikiSourcesRequest extends WikiScopedRequest {
+  limit?: number;
+  nextToken?: string;
+}
+
+export interface ListWikiSourcesResponse {
+  sources: WikiRawSource[];
+  nextToken?: string;
+}
+
+export interface ListWikiArtifactsRequest extends WikiScopedRequest {
+  kind: WikiArtifactKind;
+  limit?: number;
+  nextToken?: string;
+}
+
+export interface ListWikiArtifactsResponse {
+  memoryStoreName: string;
+  artifacts: WikiDreamArtifact[];
+  nextToken?: string;
+}
+
+export interface AddWikiSourcesRequest extends WikiScopedRequest {
+  sources: Array<{ path: string; content: string }>;
+}
+
+export interface GetWikiSourceRequest extends WikiScopedRequest {
+  path: string;
+}
+
+export interface UpdateWikiSourceRequest extends WikiScopedRequest {
+  path: string;
+  content: string;
+  expectedVersionId: string;
+}
+
+export interface DeleteWikiSourceRequest extends WikiScopedRequest {
+  path: string;
+  expectedVersionId: string;
+}
+
+export interface ListWikiPagesRequest extends WikiScopedRequest {
+  limit?: number;
+  nextToken?: string;
+}
+
+export interface ListWikiPagesResponse {
+  pages: WikiPage[];
+  nextToken?: string;
+}
+
+export interface GetWikiPageRequest extends WikiScopedRequest {
+  path: string;
+}
+
+export interface SearchWikiPagesRequest extends WikiScopedRequest {
+  query: string;
+  limit?: number;
+}
+
+export interface IngestWikiResponse {
+  status: WikiBuildStatus;
+  reused: boolean;
+  skipped: boolean;
+}