@tablestore/tablestore-agent-cli 0.3.1 → 0.4.0

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/dream/[dreamId]/page.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { useState } from "react";
+import Link from "next/link";
 import { useParams, useRouter } from "next/navigation";
 import { toast } from "sonner";
 import { ArrowLeft, AlertTriangle } from "lucide-react";
@@ -26,14 +27,51 @@ import {
 } from "@/components/memory/memory-dream-plan-approval-dialog";
 import {
   DREAM_TERMINAL_STATUSES,
+  type DreamActionRecord,
   type DreamTaskStatus,
   type DreamTaskType,
   type MemoryScope,
 } from "@/types/memory";
 import { cn } from "@/lib/utils";
+import { buildScopeWorkspaceHref, toExactScope } from "@/lib/scope-workspace";
 import { useI18n } from "@/i18n/i18n-context";
 import type { MessageKey, TranslateFn } from "@/i18n/i18n-context";
 
+function isExactScope(scope: MemoryScope): scope is Required<MemoryScope> {
+  return [scope.appId, scope.tenantId, scope.agentId, scope.runId].every(
+    (value) => typeof value === "string" && value.length > 0 && value !== "*",
+  );
+}
+
+export function buildDreamArtifactWikiHref(
+  memoryStoreName: string,
+  action: DreamActionRecord,
+): string | undefined {
+  const expectedKind =
+    action.action === "EMIT_SKILL"
+      ? "skill"
+      : action.action === "EMIT_PROFILE"
+        ? "profile"
+        : undefined;
+  if (
+    action.status !== "applied" ||
+    !expectedKind ||
+    action.newExtract?.kind !== expectedKind ||
+    !isExactScope(action.targetScope)
+  ) {
+    return undefined;
+  }
+  const params = new URLSearchParams([
+    ["appId", action.targetScope.appId],
+    ["tenantId", action.targetScope.tenantId],
+    ["agentId", action.targetScope.agentId],
+    ["runId", action.targetScope.runId],
+    ["dreamId", action.dreamId],
+    ["actionId", action.actionId],
+  ]);
+  return `/memory/${encodeURIComponent(memoryStoreName)}/wiki?${params.toString()}`;
+}
+
 const STATUS_CLASS: Record<DreamTaskStatus, string> = {
   queued: "bg-info-soft text-info",
   running: "bg-info-soft text-info",
@@ -166,6 +204,9 @@ export default function DreamTaskDetailPage() {
   }
 
   const task = taskQuery.data;
+  const taskScopes = task?.input.scopes ?? [];
+  const taskScope =
+    taskScopes.length === 1 ? toExactScope(taskScopes[0]!) : null;
   const isTerminal = task && DREAM_TERMINAL_STATUSES.has(task.status);
   const isExtractTask =
     task?.taskType === "skill" || task?.taskType === "profile";
@@ -211,6 +252,14 @@ export default function DreamTaskDetailPage() {
           <ArrowLeft className="mr-1 h-3.5 w-3.5" />
           {t("memory.dream.backToTaskList")}
         </Button>
+        {taskScope ? (
+          <Button asChild variant="ghost" size="sm">
+            <Link href={buildScopeWorkspaceHref(memoryStoreName, taskScope)}>
+              <ArrowLeft className="mr-1 h-3.5 w-3.5" />
+              {t("memory.dream.backToScope")}
+            </Link>
+          </Button>
+        ) : null}
       </div>
 
       {taskQuery.isLoading ? (
@@ -255,11 +304,15 @@ export default function DreamTaskDetailPage() {
                             : t("memory.dream.applyModeProposalDetail")}
                       </span>
                       <span>·</span>
-                      <span>
-                        {t("memory.dream.executionModeDetail", {
-                          value: task.executionMode,
-                        })}
-                      </span>
+                    </>
+                  )}
+                  <span>
+                    {t("memory.dream.effortDetail", {
+                      value: task.effort,
+                    })}
+                  </span>
+                  {(!task.taskType || task.taskType === "memory") && (
+                    <>
                       <span>·</span>
                       <span>
                         {t("memory.dream.scopeOutput", {
@@ -405,71 +458,23 @@ export default function DreamTaskDetailPage() {
             </div>
           </div>
 
-          {(task.executionMode === "multi_loop" ||
-            task.stage ||
-            task.sandbox ||
-            task.submittedBatchCount !== undefined ||
-            task.failureCode) && (
+          {(task.stage ||
+            task.processedThroughMs !== undefined ||
+            task.plan?.approvedAt ||
+            task.plan?.executionExpiresAt) && (
             <div className="rounded-lg border border-[hsl(var(--border))] p-4">
               <h3 className="mb-3 text-sm font-semibold">
-                {t("memory.dream.agenticRuntimeTitle")}
+                {t("memory.dream.publicRuntimeTitle")}
               </h3>
               <dl className="grid gap-3 text-xs sm:grid-cols-2 lg:grid-cols-4">
                 <RuntimeDetail
                   label={t("memory.dream.detailStage")}
                   value={task.stage}
                 />
-                <RuntimeDetail
-                  label={t("memory.dream.detailSandboxId")}
-                  value={task.sandbox?.sandboxId}
-                />
-                <RuntimeDetail
-                  label={t("memory.dream.detailSandboxPhase")}
-                  value={task.sandbox?.phase}
-                />
-                <RuntimeDetail
-                  label={t("memory.dream.detailSandboxStatus")}
-                  value={task.sandbox?.status}
-                />
-                <RuntimeDetail
-                  label={t("memory.dream.detailSubmittedBatches")}
-                  value={task.submittedBatchCount}
-                />
-                <RuntimeDetail
-                  label={t("memory.dream.detailLastBatch")}
-                  value={
-                    task.lastBatch
-                      ? [
-                          task.lastBatch.batchId,
-                          task.lastBatch.sequence !== undefined
-                            ? `#${task.lastBatch.sequence}`
-                            : undefined,
-                          task.lastBatch.expectedActionCount !== undefined
-                            ? `${task.lastBatch.expectedActionCount} actions`
-                            : undefined,
-                          task.lastBatch.settled !== undefined
-                            ? task.lastBatch.settled
-                              ? "settled"
-                              : "pending"
-                            : undefined,
-                        ]
-                          .filter(Boolean)
-                          .join(" · ")
-                      : undefined
-                  }
-                />
-                <RuntimeDetail
-                  label={t("memory.dream.detailFailureCode")}
-                  value={task.failureCode}
-                />
                 <RuntimeDetail
                   label={t("memory.dream.detailProcessedThrough")}
                   value={task.processedThroughMs}
                 />
-                <RuntimeDetail
-                  label={t("memory.dream.detailAgentFinished")}
-                  value={task.agentFinishedAt}
-                />
                 <RuntimeDetail
                   label={t("memory.dream.detailPlanApproved")}
                   value={task.plan?.approvedAt}
@@ -532,6 +537,9 @@ export default function DreamTaskDetailPage() {
               memoryStoreName={memoryStoreName}
               dreamId={dreamId}
               taskType={task.taskType}
+              artifactWikiHref={(action) =>
+                buildDreamArtifactWikiHref(memoryStoreName, action)
+              }
             />
           </div>
 

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/dream/page.tsx

@@ -232,7 +232,9 @@ export default function DreamTasksPage() {
         </TableCell>
         <TableCell className="text-xs">
           {task.taskType && task.taskType !== "memory" ? (
-            <span className="text-muted-foreground">—</span>
+            <span className="text-muted-foreground">
+              {t("memory.dream.effortDetail", { value: task.effort })}
+            </span>
           ) : (
             <>
               {task.applyMode === "safe_auto"
@@ -240,11 +242,9 @@ export default function DreamTasksPage() {
                 : task.applyMode === "plan"
                   ? t("memory.dream.applyModePlan")
                   : t("memory.dream.applyModeProposal")}
-              {task.executionMode && (
-                <span className="ml-1 text-muted-foreground">
-                  · {task.executionMode}
-                </span>
-              )}
+              <span className="ml-1 text-muted-foreground">
+                · {t("memory.dream.effortDetail", { value: task.effort })}
+              </span>
               {task.scopeOutputMode === "promote_scope" && (
                 <span className="ml-1 text-muted-foreground">
                   · {t("memory.dream.promoted")}

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/layout.tsx

@@ -8,10 +8,12 @@ import {
 } from "next/navigation";
 import { useEffect, useState } from "react";
 import {
+  BookOpen,
   Brain,
   Database,
   FileClock,
   FolderTree,
+  LayoutDashboard,
   ListChecks,
   MessageSquare,
   MoreVertical,
@@ -40,10 +42,17 @@ import { MemoryDeleteDialog } from "@/components/memory/memory-delete-dialog";
 import { MemoryScopeBar } from "@/components/memory/memory-scope-bar";
 import { useI18n } from "@/i18n/i18n-context";
 import {
+  parseKnownStorageMode,
   resolveMemoryDetailSegment,
   storageModeCapabilities,
+  type MemoryDetailSegment,
 } from "@/lib/memory-storage-mode";
 
+const FAIL_CLOSED_DETAIL_SEGMENTS: MemoryDetailSegment[] = [
+  "units",
+  "settings",
+];
+
 export default function MemoryDetailLayout({
   children,
 }: {
@@ -51,6 +60,11 @@ export default function MemoryDetailLayout({
 }) {
   const { t } = useI18n();
   const TABS = [
+    {
+      label: t("memory.detail.tabScope"),
+      segment: "scope",
+      icon: <LayoutDashboard className="h-4 w-4" />,
+    },
     {
       label: t("memory.detail.tabUnits"),
       segment: "units",
@@ -81,6 +95,11 @@ export default function MemoryDetailLayout({
       segment: "dream",
       icon: <Sparkles className="h-4 w-4" />,
     },
+    {
+      label: t("memory.detail.tabWiki"),
+      segment: "wiki",
+      icon: <BookOpen className="h-4 w-4" />,
+    },
     {
       label: t("memory.detail.tabSettings"),
       segment: "settings",
@@ -101,14 +120,20 @@ export default function MemoryDetailLayout({
   const basePath = `/memory/${encodeURIComponent(memoryStoreName)}`;
   const requestedSegment =
     pathname.slice(basePath.length).split("/").filter(Boolean)[0] ?? "units";
-  const capabilities = storageModeCapabilities(memoryStore?.storageMode);
-  const resolvedSegment = resolveMemoryDetailSegment(
-    memoryStore?.storageMode,
-    requestedSegment,
-  );
+  const storageMode = parseKnownStorageMode(memoryStore?.storageMode);
+  const capabilities =
+    storageMode === null ? null : storageModeCapabilities(storageMode);
+  const detailSegments =
+    capabilities?.detailSegments ?? FAIL_CLOSED_DETAIL_SEGMENTS;
+  const resolvedSegment =
+    storageMode === null
+      ? detailSegments.includes(requestedSegment as MemoryDetailSegment)
+        ? (requestedSegment as MemoryDetailSegment)
+        : "units"
+      : resolveMemoryDetailSegment(storageMode, requestedSegment);
   const shouldRedirect = Boolean(
     memoryStore &&
-    !capabilities.structured &&
+    capabilities?.structured !== true &&
     requestedSegment !== resolvedSegment,
   );
 
@@ -141,8 +166,8 @@ export default function MemoryDetailLayout({
 
   if (shouldRedirect) return null;
 
-  const visibleTabs = capabilities.detailSegments.map((segment) => {
-    if (!capabilities.structured && segment === "units") {
+  const visibleTabs = detailSegments.map((segment) => {
+    if (storageMode === "filemem" && segment === "units") {
       return {
         label: t("memory.detail.tabFiles"),
         segment: "units",
@@ -212,7 +237,9 @@ export default function MemoryDetailLayout({
         }
       >
         <div className="space-y-6">
-          <MemoryScopeBar allowScopeDiscovery={capabilities.structured} />
+          <MemoryScopeBar
+            allowScopeDiscovery={capabilities?.structured === true}
+          />
           <div>{children}</div>
         </div>
       </DetailLayout>

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/scope/page.tsx

@@ -0,0 +1,51 @@
+"use client";
+
+import { useMemo } from "react";
+import { useParams, useSearchParams } from "next/navigation";
+
+import { ScopeWorkspace } from "@/components/memory/scope-workspace";
+import { useI18n } from "@/i18n/i18n-context";
+import { parseExactScope } from "@/lib/scope-workspace";
+
+export function ScopeWorkspaceRouteBoundary({
+  memoryStoreName,
+  search,
+}: {
+  memoryStoreName: string;
+  search: string;
+}) {
+  const { t } = useI18n();
+  const scope = useMemo(
+    () => parseExactScope(new URLSearchParams(search)),
+    [search],
+  );
+  if (!scope) {
+    return (
+      <div
+        className="rounded-xl border border-dashed px-6 py-12 text-center"
+        data-testid="scope-workspace-invalid"
+      >
+        <h2 className="font-semibold">
+          {t("memory.scopeWorkspace.invalidTitle")}
+        </h2>
+        <p className="mt-2 text-sm text-muted-foreground">
+          {t("memory.scopeWorkspace.invalidDescription")}
+        </p>
+      </div>
+    );
+  }
+  return <ScopeWorkspace memoryStoreName={memoryStoreName} scope={scope} />;
+}
+
+export default function ScopeWorkspacePage() {
+  const params = useParams<{ store: string }>();
+  const searchParams = useSearchParams();
+  const search = searchParams.toString();
+  const memoryStoreName = decodeURIComponent(params.store);
+  return (
+    <ScopeWorkspaceRouteBoundary
+      memoryStoreName={memoryStoreName}
+      search={search}
+    />
+  );
+}

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/wiki/page.tsx

@@ -0,0 +1,157 @@
+"use client";
+
+import { useMemo } from "react";
+import { useParams, useRouter, useSearchParams } from "next/navigation";
+import { BookOpen } from "lucide-react";
+
+import { ScopeCombobox } from "@/components/memory/scope-combobox";
+import { readWikiDetailTab, WikiDetail } from "@/components/wiki/wiki-detail";
+import { useI18n } from "@/i18n/i18n-context";
+import type { MemoryScope } from "@/types/memory";
+import type { WikiScope } from "@/types/wiki";
+
+export interface WikiDetailRoute {
+  scope: WikiScope;
+  runContext?: string;
+  path?: string;
+}
+
+function readConcrete(value: string | null): string | null {
+  const normalized = value?.trim() ?? "";
+  return normalized && normalized !== "*" ? normalized : null;
+}
+
+export function toWikiAgentScope(scope: MemoryScope): WikiScope | null {
+  const appId = readConcrete(scope.appId);
+  const tenantId = readConcrete(scope.tenantId ?? null);
+  const agentId = readConcrete(scope.agentId ?? null);
+  return appId && tenantId && agentId ? { appId, tenantId, agentId } : null;
+}
+
+export function readWikiDetailRoute(
+  params: URLSearchParams,
+): WikiDetailRoute | null {
+  const scope = toWikiAgentScope({
+    appId: params.get("appId") ?? "",
+    tenantId: params.get("tenantId") ?? undefined,
+    agentId: params.get("agentId") ?? undefined,
+  });
+  if (!scope) return null;
+  const path = params.get("path")?.trim() || undefined;
+  const runContext = readConcrete(params.get("runId")) ?? undefined;
+  return {
+    scope,
+    ...(runContext ? { runContext } : {}),
+    ...(path ? { path } : {}),
+  };
+}
+
+function scopeParams(scope: WikiScope, runContext?: string): URLSearchParams {
+  return new URLSearchParams([
+    ["appId", scope.appId],
+    ["tenantId", scope.tenantId],
+    ["agentId", scope.agentId],
+    ["runId", runContext ?? "*"],
+  ]);
+}
+
+export function buildWikiPageHref(
+  memoryStoreName: string,
+  scope: WikiScope,
+  path?: string,
+  runContext?: string,
+): string {
+  const params = scopeParams(scope, runContext);
+  if (path) params.set("path", path);
+  return `/memory/${encodeURIComponent(memoryStoreName)}/wiki?${params.toString()}`;
+}
+
+export function replaceWikiPageRoute(
+  replace: (href: string) => void,
+  memoryStoreName: string,
+  scope: WikiScope,
+  path: string,
+  runContext?: string,
+): void {
+  replace(buildWikiPageHref(memoryStoreName, scope, path, runContext));
+}
+
+export default function WikiPage() {
+  const { t } = useI18n();
+  const params = useParams<{ store: string }>();
+  const router = useRouter();
+  const searchParams = useSearchParams();
+  const search = searchParams.toString();
+  const route = useMemo(
+    () => readWikiDetailRoute(new URLSearchParams(search)),
+    [search],
+  );
+  const memoryStoreName = decodeURIComponent(params.store);
+  const browserScope = useMemo<MemoryScope>(
+    () => ({
+      appId: searchParams.get("appId") ?? "*",
+      tenantId: searchParams.get("tenantId") ?? "*",
+      agentId: searchParams.get("agentId") ?? "*",
+      runId: searchParams.get("runId") ?? "*",
+    }),
+    [searchParams],
+  );
+
+  return (
+    <div className="space-y-4">
+      <div className="flex items-center justify-between gap-3">
+        <div>
+          <h2 className="text-lg font-semibold">{t("wiki.list.title")}</h2>
+          <p className="text-xs text-muted-foreground">
+            {t("wiki.list.description")}
+          </p>
+        </div>
+      </div>
+
+      {route ? (
+        <WikiDetail
+          memoryStoreName={memoryStoreName}
+          scope={route.scope}
+          runContext={route.runContext}
+          initialTab={readWikiDetailTab(searchParams.get("tab"))}
+          selectedPagePath={route.path}
+          onOpenPage={(path) =>
+            replaceWikiPageRoute(
+              (href) => router.replace(href),
+              memoryStoreName,
+              route.scope,
+              path,
+              route.runContext,
+            )
+          }
+        />
+      ) : (
+        <div className="rounded-xl border border-dashed border-[hsl(var(--border))] px-6 py-12 text-center">
+          <BookOpen className="mx-auto mb-3 h-9 w-9 text-muted-foreground" />
+          <h2 className="font-semibold">{t("wiki.list.agentScopeTitle")}</h2>
+          <p className="mx-auto mt-2 max-w-xl text-sm text-muted-foreground">
+            {t("wiki.list.agentScopeRequired")}
+          </p>
+          <div className="mx-auto mt-4 flex max-w-md flex-col items-center gap-2">
+            <span className="text-xs font-medium text-muted-foreground">
+              {t("wiki.list.chooseAgent")}
+            </span>
+            <ScopeCombobox
+              memoryStoreName={memoryStoreName}
+              currentScope={browserScope}
+              maxLevel="agent"
+              placeholder={t("wiki.list.chooseAgent")}
+              onPick={(selected) => {
+                const wikiScope = toWikiAgentScope(selected);
+                if (!wikiScope) return;
+                router.replace(
+                  buildWikiPageHref(memoryStoreName, wikiScope, undefined, "*"),
+                );
+              }}
+            />
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/app/api/v1/llm/chat/file-memory-curator.ts

@@ -228,10 +228,7 @@ export async function extractDurableMemories(input: {
       },
     );
     if (!response.ok) {
-      const body = await response.text().catch(() => "");
-      throw new Error(
-        `memory curator ${response.status}: ${body.slice(0, 200) || response.statusText}`,
-      );
+      throw new Error(`memory curator request failed (${response.status})`);
     }
     const json = (await response.json()) as {
       choices?: Array<{ message?: { content?: string } }>;

package/dist/dashboard-runtime/dashboard/src/app/api/v1/llm/chat/file-memory-helpers.ts

@@ -1,16 +1,16 @@
-export interface BrowserFileMemoryPromptHit {
+export interface FileMemoryPromptHit {
   text: string;
   source: string;
   score: number;
 }
 
-/** Format bounded browser-provided file evidence for the model prompt. */
-export function formatFileMemoryBlock(
-  hits: BrowserFileMemoryPromptHit[],
-): string {
+export type BrowserFileMemoryPromptHit = FileMemoryPromptHit;
+
+/** Format bounded Chat BFF file evidence for the model prompt. */
+export function formatFileMemoryBlock(hits: FileMemoryPromptHit[]): string {
   const header = [
     "## TableStore File Memory",
-    "The following evidence was read from this conversation's exact-scope file memory through the JSON file API.",
+    "The following evidence was read from this conversation's exact-scope file memory through the JSON Item API and a bounded in-process SHA cache.",
     "Treat source paths as citations; do not assume access to any server-local mount.",
   ].join("\n");
   if (!hits.length) return `\n\n${header}`;

package/dist/dashboard-runtime/dashboard/src/app/api/v1/llm/chat/memory-helpers.ts

@@ -1,4 +1,5 @@
 import type { MemorySearchHit } from "@/types/memory";
+import type { RetrievalFailure } from "@/types/llm-chat";
 
 export interface MemoryWriteScope {
   appId: string;
@@ -43,3 +44,52 @@ export function formatMemoryBlock(hits: MemorySearchHit[]): string {
   });
   return `\n\n相关历史记忆（共 ${hits.length} 条）：\n${lines.join("\n")}`;
 }
+
+function optionalString(value: unknown): string | undefined {
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+
+function optionalNumber(value: unknown): number | undefined {
+  return typeof value === "number" && Number.isFinite(value)
+    ? value
+    : undefined;
+}
+
+/** Preserve bounded upstream diagnostics without leaking request payloads. */
+export function memoryRetrievalFailure(
+  value: unknown,
+  fallbackCode = "MEMORY_RETRIEVAL_FAILED",
+): RetrievalFailure {
+  const record =
+    value !== null && typeof value === "object"
+      ? (value as Record<string, unknown>)
+      : {};
+  const details =
+    record.details !== null && typeof record.details === "object"
+      ? (record.details as Record<string, unknown>)
+      : {};
+  const code =
+    optionalString(details.upstreamCode) ??
+    optionalString(record.upstreamCode) ??
+    optionalString(record.code) ??
+    fallbackCode;
+  const message =
+    optionalString(record.message) ??
+    (typeof value === "string" ? value : "Memory retrieval failed");
+  const requestId =
+    optionalString(details.upstreamRequestId) ??
+    optionalString(record.upstreamRequestId) ??
+    optionalString(record.requestId);
+  const httpStatus =
+    optionalNumber(details.upstreamStatus) ??
+    optionalNumber(record.upstreamStatus) ??
+    optionalNumber(record.httpStatus) ??
+    optionalNumber(record.status);
+
+  return {
+    code,
+    message,
+    ...(requestId === undefined ? {} : { requestId }),
+    ...(httpStatus === undefined ? {} : { httpStatus }),
+  };
+}