@tablestore/tablestore-agent-cli 0.2.1 → 0.2.4

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/knowledge-base/[name]/layout-client.tsx

@@ -112,6 +112,12 @@ function KBDetailShell({
 }) {
   const searchParams = useSearchParams();
   const activeSubspace = useSubspaceOptional()?.subspace ?? null;
+  const isMultimodal = knowledgeBase.multimodal === true;
+  const hasCaption =
+    knowledgeBase.ingestConfiguration?.enableTableFormulaCaption === true;
+  const hasSubspace = !!knowledgeBase.subspace;
+  const tags = knowledgeBase.tags ?? [];
+  const description = knowledgeBase.description;
 
   // Carry the subspace querystring through to each menu link so
   // middle-click / copy-link continues to land on the same scope.
@@ -128,6 +134,20 @@ function KBDetailShell({
     icon: tab.icon,
   }));
 
+  const pillClass =
+    "shrink-0 text-[10px] px-1.5 py-0.5 rounded-full bg-emerald-50 text-emerald-700 border border-emerald-200";
+
+  const nameNode = knowledgeBase.knowledgeBaseName;
+
+  const hasPills = isMultimodal || hasCaption || hasSubspace;
+  const pillsNode = hasPills ? (
+    <>
+      {isMultimodal ? <span className={pillClass}>多模态</span> : null}
+      {hasCaption ? <span className={pillClass}>Caption</span> : null}
+      {hasSubspace ? <span className={pillClass}>子空间</span> : null}
+    </>
+  ) : null;
+
   return (
     <DetailLayout
       sidebar={
@@ -135,9 +155,8 @@ function KBDetailShell({
           <DetailSidebarHeader
             icon={<BookOpenText />}
             accent="primary"
-            name={knowledgeBase.knowledgeBaseName}
-            typeLabel="知识库 · KNOWLEDGE BASE"
-            description={knowledgeBase.description}
+            name={nameNode}
+            pills={pillsNode}
             actions={
               <DropdownMenu>
                 <DropdownMenuTrigger asChild>
@@ -165,36 +184,53 @@ function KBDetailShell({
             }
             extra={
               <>
-                {knowledgeBase.tags && knowledgeBase.tags.length > 0 ? (
-                  <div className="-mt-0.5 flex flex-wrap gap-1">
-                    {knowledgeBase.tags.map((tag) => (
-                      <Badge
-                        key={tag}
-                        variant="primary"
-                        className="text-[10px]"
-                      >
-                        {tag}
-                      </Badge>
-                    ))}
+                {description ? (
+                  <div className="flex items-baseline gap-1.5">
+                    <span className="shrink-0 text-[hsl(var(--muted-foreground))]">Desc:</span>
+                    <span className="line-clamp-2 text-[hsl(var(--foreground))]/80">
+                      {description}
+                    </span>
                   </div>
                 ) : null}
-                {knowledgeBase.subspace ? (
-                  <div className="space-y-1">
-                    <div className="inline-flex items-center gap-1.5 text-[hsl(var(--success))]">
-                      <span className="h-1.5 w-1.5 rounded-full bg-current" />
-                      子空间隔离已开启
+                {tags.length > 0 ? (
+                  <div className="flex items-baseline gap-1.5">
+                    <span className="shrink-0 text-[hsl(var(--muted-foreground))]">Tags:</span>
+                    <div className="flex flex-wrap gap-1">
+                      {tags.map((tag) => (
+                        <Badge
+                          key={tag}
+                          variant="primary"
+                          className="text-[10px]"
+                        >
+                          {tag}
+                        </Badge>
+                      ))}
                     </div>
-                    <SubspaceSwitcher />
                   </div>
                 ) : null}
-                {knowledgeBase.createdAt ? (
-                  <div>
-                    创建于 <RelativeTime timestamp={knowledgeBase.createdAt} />
+                {hasSubspace ? (
+                  <div className="flex items-center gap-1.5">
+                    <span className="shrink-0 text-[hsl(var(--muted-foreground))]">子空间:</span>
+                    <div className="min-w-0 flex-1">
+                      <SubspaceSwitcher />
+                    </div>
                   </div>
                 ) : null}
-                {knowledgeBase.updatedAt ? (
-                  <div>
-                    更新于 <RelativeTime timestamp={knowledgeBase.updatedAt} />
+                {(knowledgeBase.createdAt || knowledgeBase.updatedAt) ? (
+                  <div className="flex flex-wrap items-center gap-x-1.5 gap-y-0.5 text-[hsl(var(--muted-foreground))]">
+                    {knowledgeBase.createdAt ? (
+                      <span>
+                        创建 <RelativeTime timestamp={knowledgeBase.createdAt} />
+                      </span>
+                    ) : null}
+                    {knowledgeBase.createdAt && knowledgeBase.updatedAt ? (
+                      <span aria-hidden="true">·</span>
+                    ) : null}
+                    {knowledgeBase.updatedAt ? (
+                      <span>
+                        更新 <RelativeTime timestamp={knowledgeBase.updatedAt} />
+                      </span>
+                    ) : null}
                   </div>
                 ) : null}
               </>

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

@@ -27,7 +27,11 @@ export default function MemoryMessagesPage() {
   const params = useParams<{ store: string }>();
   const searchParams = useSearchParams();
   const memoryStoreName = decodeURIComponent(params.store);
-  const scope = useMemo(() => buildMemoryScope(searchParams), [searchParams.toString()]);
+  const searchParamsString = searchParams.toString();
+  const scope = useMemo(
+    () => buildMemoryScope(new URLSearchParams(searchParamsString)),
+    [searchParamsString],
+  );
 
   /* ---- Time filter state (default: last 1 day) ---- */
   const [windowMinutes, setWindowMinutes] = useState(1440);
@@ -158,7 +162,7 @@ export default function MemoryMessagesPage() {
     return (
       <div className="flex flex-col items-center justify-center rounded-xl border border-dashed py-16 text-muted-foreground">
         <MessageSquare className="mb-2 h-5 w-5" />
-        <span className="text-sm">请先在上方 Scope 区域填写 appId</span>
+        <span className="text-sm">请先在上方范围栏中填写「应用」</span>
       </div>
     );
   }
@@ -167,7 +171,7 @@ export default function MemoryMessagesPage() {
     return (
       <div className="flex flex-col items-center justify-center rounded-xl border border-dashed py-16 text-muted-foreground">
         <MessageSquare className="mb-2 h-5 w-5" />
-        <span className="text-sm">请在上方 Scope 栏中为所有字段设置具体值以查询短期记忆</span>
+        <span className="text-sm">请在上方范围栏中为所有字段设置具体值以查询短期记忆</span>
       </div>
     );
   }
@@ -196,7 +200,7 @@ export default function MemoryMessagesPage() {
         <div className="flex flex-col items-center justify-center py-20 text-muted-foreground">
           <MessageSquare className="mb-2 h-5 w-5" />
           <span className="text-sm">
-            {filters ? "该时间范围内暂无消息" : "当前 scope 下暂无消息记录"}
+            {filters ? "该时间范围内暂无消息" : "当前范围下暂无消息记录"}
           </span>
         </div>
       );

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

@@ -49,7 +49,11 @@ export default function MemoryRequestsPage() {
   const params = useParams<{ store: string }>();
   const searchParams = useSearchParams();
   const memoryStoreName = decodeURIComponent(params.store);
-  const scope = useMemo(() => buildMemoryScope(searchParams), [searchParams.toString()]);
+  const searchParamsString = searchParams.toString();
+  const scope = useMemo(
+    () => buildMemoryScope(new URLSearchParams(searchParamsString)),
+    [searchParamsString],
+  );
 
   /* ---- Time range state ---- */
   const [windowMinutes, setWindowMinutes] = useState(DEFAULT_WINDOW_MIN);
@@ -185,7 +189,7 @@ export default function MemoryRequestsPage() {
     return (
       <div className="flex flex-col items-center justify-center rounded-xl border border-dashed py-16 text-muted-foreground">
         <Search className="mb-2 h-5 w-5" />
-        <span className="text-sm">请先在上方 Scope 区域填写 appId</span>
+        <span className="text-sm">请先在上方范围栏中填写「应用」</span>
       </div>
     );
   }

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/[store]/requests/request-detail-dialog.tsx

@@ -38,13 +38,13 @@ export function RequestDetailDialog({
         </DialogHeader>
         <div className="grid gap-4 sm:grid-cols-2">
           {[
-            ["Operation", request.operation],
-            ["Request ID", request.requestId],
-            ["Target ID", request.targetId],
+            ["操作", request.operation],
+            ["请求 ID", request.requestId],
+            ["目标 ID", request.targetId],
             ["响应码", request.responseStatus],
             ["耗时", fmtDur(request.latencyMs)],
             ["时间", fmtTs(request.createdAt)],
-            ["Ingest", request.ingestStatus],
+            ["入库状态", request.ingestStatus],
           ].map(([label, value]) => (
             <div key={String(label)} className="space-y-1">
               <p className="text-xs text-muted-foreground">{String(label)}</p>
@@ -55,17 +55,17 @@ export function RequestDetailDialog({
           ))}
           {request.scope && (
             <div className="space-y-1 sm:col-span-2">
-              <p className="text-xs text-muted-foreground">Scope</p>
+              <p className="text-xs text-muted-foreground">范围</p>
               <div className="grid grid-cols-2 gap-x-4 gap-y-1 text-xs">
-                <span className="text-muted-foreground">App</span>
+                <span className="text-muted-foreground">应用</span>
                 <span className="font-mono">{request.scope.appId ?? "-"}</span>
-                <span className="text-muted-foreground">Tenant</span>
+                <span className="text-muted-foreground">租户</span>
                 <span className="font-mono">
                   {request.scope.tenantId ?? "-"}
                 </span>
-                <span className="text-muted-foreground">Agent</span>
+                <span className="text-muted-foreground">智能体</span>
                 <span className="font-mono">{request.scope.agentId ?? "-"}</span>
-                <span className="text-muted-foreground">Run</span>
+                <span className="text-muted-foreground">会话</span>
                 <span className="font-mono">{request.scope.runId ?? "-"}</span>
               </div>
             </div>

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

@@ -127,10 +127,10 @@ export function RequestsTable({
         <TableHeader>
           <TableRow>
             <TableHead className="w-[140px]">时间</TableHead>
-            <TableHead className="w-[130px]">Operation</TableHead>
+            <TableHead className="w-[130px]">操作</TableHead>
             <TableHead className="w-[70px]">状态</TableHead>
             <TableHead className="w-[80px]">耗时</TableHead>
-            <TableHead className="w-[200px]">Request ID</TableHead>
+            <TableHead className="w-[200px]">请求 ID</TableHead>
             <TableHead className="w-[60px]" />
           </TableRow>
         </TableHeader>

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

@@ -14,7 +14,11 @@ export default function MemorySearchPage() {
   const params = useParams<{ store: string }>();
   const searchParams = useSearchParams();
   const memoryStoreName = decodeURIComponent(params.store);
-  const scope = useMemo(() => buildMemoryScope(searchParams), [searchParams.toString()]);
+  const searchParamsString = searchParams.toString();
+  const scope = useMemo(
+    () => buildMemoryScope(new URLSearchParams(searchParamsString)),
+    [searchParamsString],
+  );
   const search = useMemorySearch();
   const [results, setResults] = useState<MemorySearchHit[] | null>(null);
   const [elapsedMs, setElapsedMs] = useState<number | undefined>();

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

@@ -46,26 +46,65 @@ export default function MemorySettingsPage() {
   }
 
   return (
-    <div className="max-w-2xl space-y-8">
+    <div className="grid gap-6 xl:grid-cols-[minmax(0,1fr)_320px]">
       <MemorySettingsForm memoryStore={memoryStore} />
 
-      <div className="rounded-lg border p-4">
-        <h3 className="mb-4 text-sm font-semibold">记忆库信息</h3>
-        <dl className="grid gap-3 sm:grid-cols-2">
-          <div>
-            <dt className="text-xs text-muted-foreground">OTS 实例</dt>
-            <dd className="mt-0.5 text-sm font-mono">{memoryStore.otsInstance ?? "-"}</dd>
+      <aside className="space-y-6">
+        <section className="rounded-lg border border-[hsl(var(--border))] bg-[hsl(var(--card))] p-5 shadow-sm">
+          <SettingsSectionHeader
+            title="记忆库信息"
+            description="只读元数据，由服务端维护。"
+          />
+          <div className="space-y-3">
+            <ReadOnlyField
+              label="OTS 实例"
+              value={memoryStore.otsInstance ?? "-"}
+            />
+            <ReadOnlyField
+              label="创建时间"
+              value={formatTimestamp(memoryStore.createdAt)}
+            />
+            <ReadOnlyField
+              label="更新时间"
+              value={formatTimestamp(memoryStore.updatedAt)}
+            />
+            {memoryStore.lastSeenAt && (
+              <ReadOnlyField
+                label="最近活跃"
+                value={formatTimestamp(memoryStore.lastSeenAt)}
+              />
+            )}
           </div>
-          <div>
-            <dt className="text-xs text-muted-foreground">创建时间</dt>
-            <dd className="mt-0.5 text-sm">{formatTimestamp(memoryStore.createdAt)}</dd>
-          </div>
-          <div>
-            <dt className="text-xs text-muted-foreground">更新时间</dt>
-            <dd className="mt-0.5 text-sm">{formatTimestamp(memoryStore.updatedAt)}</dd>
-          </div>
-        </dl>
-      </div>
+        </section>
+      </aside>
+    </div>
+  );
+}
+
+function SettingsSectionHeader({
+  title,
+  description,
+}: {
+  title: string;
+  description: string;
+}) {
+  return (
+    <header className="mb-4 border-b border-[hsl(var(--border-light))] pb-3">
+      <h3 className="text-[15px] font-semibold leading-tight text-[hsl(var(--foreground))]">
+        {title}
+      </h3>
+      <p className="mt-1 text-xs leading-relaxed text-[hsl(var(--muted-foreground))]">
+        {description}
+      </p>
+    </header>
+  );
+}
+
+function ReadOnlyField({ label, value }: { label: string; value: string }) {
+  return (
+    <div className="flex items-center justify-between">
+      <span className="text-sm text-muted-foreground">{label}</span>
+      <span className="text-sm font-medium">{value}</span>
     </div>
   );
 }

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

@@ -25,7 +25,11 @@ export default function MemoryUnitsPage() {
   const params = useParams<{ store: string }>();
   const searchParams = useSearchParams();
   const memoryStoreName = decodeURIComponent(params.store);
-  const scope = useMemo(() => buildMemoryScope(searchParams), [searchParams.toString()]);
+  const searchParamsString = searchParams.toString();
+  const scope = useMemo(
+    () => buildMemoryScope(new URLSearchParams(searchParamsString)),
+    [searchParamsString],
+  );
   const wildcard = hasWildcardScope(scope);
   const scopeKey = useMemo(() => 
     `${scope.appId}|${scope.tenantId ?? ""}|${scope.agentId ?? ""}|${scope.runId ?? ""}`,
@@ -87,7 +91,7 @@ export default function MemoryUnitsPage() {
       return;
     }
     if (!canOperateOnUnit(deleteUnit, scope)) {
-      toast.error("当前记忆单元缺少精确 scope，无法删除");
+      toast.error("当前记忆单元缺少精确范围，无法删除");
       return;
     }
     try {
@@ -102,11 +106,11 @@ export default function MemoryUnitsPage() {
 
   async function handleSearchById() {
     if (!searchId.trim()) {
-      toast.error("请输入 Memory ID");
+      toast.error("请输入记忆 ID");
       return;
     }
     if (!scope.appId) {
-      toast.error("请先设置精确的 Scope");
+      toast.error("请先设置精确的范围");
       return;
     }
     setSearching(true);
@@ -170,7 +174,7 @@ export default function MemoryUnitsPage() {
                   </span>
                 </TooltipTrigger>
                 <TooltipContent side="bottom" className="max-w-[240px]">
-                  <p>请在上方 Scope 栏中为所有字段设置具体值后再添加记忆</p>
+                  <p>请在上方范围栏中为所有字段设置具体值后再添加记忆</p>
                 </TooltipContent>
               </Tooltip>
             </TooltipProvider>
@@ -187,7 +191,7 @@ export default function MemoryUnitsPage() {
         <Input
           value={searchId}
           onChange={(e) => setSearchId(e.target.value)}
-          placeholder="输入 Memory ID 查询单条记忆..."
+          placeholder="输入记忆 ID 查询单条记忆..."
           className="max-w-md"
           onKeyDown={(e) => e.key === "Enter" && handleSearchById()}
         />
@@ -201,7 +205,7 @@ export default function MemoryUnitsPage() {
 
       {wildcard && !searchedUnit && (
         <p className="text-xs text-muted-foreground">
-          当前 scope 含通配符，仅支持只读查询，无法执行新增、查看详情、编辑或删除。
+          当前范围含通配符，仅支持只读查询，无法执行新增、查看详情、编辑或删除。
         </p>
       )}
 

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/create/page.tsx

@@ -18,7 +18,7 @@ export default function CreateMemoryStorePage() {
         </Link>
         <PageHeader
           title="创建记忆库"
-          description="创建一个新的 Agent Memory store"
+          description="创建一个新的智能体记忆库"
         />
       </div>
 

package/dist/dashboard-runtime/dashboard/src/app/(dashboard)/memory/page.tsx

@@ -11,7 +11,7 @@ export default function MemoryPage() {
     <div className="space-y-6">
       <PageHeader
         title="记忆库"
-        description="管理 Agent 的长期记忆、检索记忆单元并观测请求记录"
+        description="管理智能体的长期记忆、检索记忆单元并观测请求记录"
       >
         <Button asChild>
           <Link href="/memory/create">

package/dist/dashboard-runtime/dashboard/src/app/api/v1/knowledge-bases/[name]/documents/[docId]/route.ts

@@ -17,6 +17,29 @@ interface RouteContext {
   params: Promise<{ name: string; docId: string }>;
 }
 
+/**
+ * Pull the single document object out of whatever shape the upstream SDK
+ * happens to return. Observed shapes:
+ *   - the document object directly
+ *   - `[doc]` (a one-element array)
+ *   - `{ documentDetails: [doc] }` / `{ documents: [doc] }`
+ * Mirrors the unwrap the CLI's `doc-get` command performs.
+ */
+function unwrapDocument(data: unknown): unknown {
+  if (Array.isArray(data)) {
+    return data[0] ?? null;
+  }
+  if (data != null && typeof data === "object") {
+    const record = data as Record<string, unknown>;
+    const docList =
+      (record.documentDetails as unknown) ?? (record.documents as unknown);
+    if (Array.isArray(docList) && docList.length > 0) {
+      return docList[0];
+    }
+  }
+  return data;
+}
+
 export async function GET(request: NextRequest, context: RouteContext) {
   try {
     const { name, docId } = await context.params;
@@ -34,6 +57,50 @@ export async function GET(request: NextRequest, context: RouteContext) {
     if (subspace) req.subspace = subspace;
 
     const resp = await kb.getDocument(req);
+    if (resp.code === "SUCCESS") {
+      return forwardResponse({ ...resp, data: unwrapDocument(resp.data) });
+    }
+    return forwardResponse(resp);
+  } catch (error) {
+    return handleApiError(error);
+  }
+}
+
+/**
+ * PUT /api/v1/knowledge-bases/:name/documents/:docId   Update document metadata.
+ *
+ * Backend semantics on `metadata`:
+ *   omitted     → don't touch metadata
+ *   object      → overwrite-update (whole object replaced)
+ *   explicit null → clear all metadata
+ */
+export async function PUT(request: NextRequest, context: RouteContext) {
+  try {
+    const { name, docId } = await context.params;
+    const auth = requireClients(request);
+    if (!("kb" in auth)) return auth;
+    const { kb } = auth;
+
+    let body: Record<string, unknown>;
+    try {
+      body = (await request.json()) as Record<string, unknown>;
+    } catch {
+      return forwardResponse({
+        code: "BAD_REQUEST",
+        data: null,
+        message: "Request body must be JSON",
+      });
+    }
+
+    const { knowledgeBaseName: _ignoredName, docId: _ignoredDocId, ...rest } = body;
+    void _ignoredName;
+    void _ignoredDocId;
+
+    const resp = await kb.updateDocument({
+      ...rest,
+      knowledgeBaseName: name,
+      docId,
+    });
     return forwardResponse(resp);
   } catch (error) {
     return handleApiError(error);

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

@@ -0,0 +1,45 @@
+import type { MemorySearchHit } from "@/types/memory";
+
+export interface MemoryWriteScope {
+  appId: string;
+  tenantId: string;
+  agentId: string;
+  runId: string;
+}
+
+export interface MemoryReadScope {
+  appId: string;
+  tenantId: string;
+  agentId: "*";
+  runId: "*";
+}
+
+/**
+ * 把入站的「完整写 scope」派生成宽松的「读 scope」：
+ * appId / tenantId 保留，agentId / runId 强制覆盖为 "*"。
+ * 这样一个绑在 (agentId, runId) 上的会话仍能召回同 tenant 下其他
+ * agent/run 写入的记忆。
+ */
+export function deriveReadScope(writeScope: MemoryWriteScope): MemoryReadScope {
+  return {
+    appId: writeScope.appId,
+    tenantId: writeScope.tenantId,
+    agentId: "*",
+    runId: "*",
+  };
+}
+
+/**
+ * 把 memory 命中渲染成一段中文 prompt 片段，供
+ * `buildFinalMessages` 与 RAG 段拼接。零命中时返回空串，
+ * 由调用方决定是否拼接。
+ */
+export function formatMemoryBlock(hits: MemorySearchHit[]): string {
+  if (!hits.length) return "";
+  const lines = hits.map((h) => {
+    const id = h.unit.memcell_id;
+    const text = h.unit.text ?? "";
+    return id ? `- (${id}) ${text}` : `- ${text}`;
+  });
+  return `\n\n相关历史记忆（共 ${hits.length} 条）：\n${lines.join("\n")}`;
+}