@tablestore/tablestore-agent-cli 0.2.11 → 0.4.0

package/dist/dashboard-runtime/dashboard/src/components/chat/wiki-bind-section.tsx

@@ -0,0 +1,153 @@
+"use client";
+
+import { useEffect, useState, type ReactNode } from "react";
+import { BookOpen } from "lucide-react";
+
+import {
+  DEFAULT_WIKI_TOP_K,
+  isWikiEligibleMemoryBinding,
+  type ChatMemoryWriteScope,
+  useChatConfig,
+} from "@/components/chat/chat-config-context";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Switch } from "@/components/ui/switch";
+import { useWiki } from "@/hooks/use-wikis";
+import { useI18n } from "@/i18n/i18n-context";
+import type { Wiki } from "@/types/wiki";
+
+function isExactScope(
+  scope: ChatMemoryWriteScope | undefined,
+): scope is ChatMemoryWriteScope {
+  if (!scope) return false;
+  return [scope.appId, scope.tenantId, scope.agentId, scope.runId].every(
+    (value) => value.trim().length > 0 && value.trim() !== "*",
+  );
+}
+
+function isReadyWiki(wiki: Wiki | undefined): wiki is Wiki {
+  return wiki?.status === "ready";
+}
+
+export function clampWikiTopK(value: string, fallback: number): number {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || value.trim().length === 0) return fallback;
+  return Math.min(10, Math.max(1, Math.trunc(parsed)));
+}
+
+export function WikiBindSection() {
+  const { t } = useI18n();
+  const cfg = useChatConfig();
+  const binding = cfg.memory;
+  const knownStorageMode =
+    binding?.storageMode === "ots" ||
+    binding?.storageMode === "file+ots" ||
+    binding?.storageMode === "filemem";
+  const exactScope = isExactScope(binding?.scope) ? binding.scope : undefined;
+  const eligibleScope = isWikiEligibleMemoryBinding(binding)
+    ? exactScope
+    : undefined;
+  const query = useWiki(
+    knownStorageMode ? binding?.memoryStoreName : undefined,
+    eligibleScope,
+  );
+  const ready = Boolean(eligibleScope) && isReadyWiki(query.data);
+  const wikiEnabled = cfg.wikiEnabled && Boolean(eligibleScope);
+  const [draftTopK, setDraftTopK] = useState(String(cfg.wikiTopK));
+
+  useEffect(() => setDraftTopK(String(cfg.wikiTopK)), [cfg.wikiTopK]);
+
+  function commitTopK() {
+    const topK = clampWikiTopK(draftTopK, cfg.wikiTopK ?? DEFAULT_WIKI_TOP_K);
+    setDraftTopK(String(topK));
+    cfg.setWikiTopK(topK);
+  }
+
+  const unavailableHint = !binding
+    ? t("chat.wikiBind.requiresMemory")
+    : !knownStorageMode
+      ? t("chat.wikiBind.requiresKnownStorageMode")
+      : !exactScope
+        ? t("chat.wikiBind.requiresExactScope")
+        : query.isLoading
+          ? t("common.loading")
+          : query.error
+            ? t("chat.wikiBind.loadFailed")
+            : !query.data
+              ? t("chat.wikiBind.notFound")
+              : !ready
+                ? t("chat.wikiBind.notReady")
+                : undefined;
+
+  return (
+    <div className="space-y-3 border-t border-[hsl(var(--border-light))] pt-3">
+      <div>
+        <Label className="text-xs font-medium uppercase tracking-wider text-muted-foreground">
+          {t("chat.wikiBind.title")}
+        </Label>
+        <p className="mt-1 text-[11px] leading-relaxed text-muted-foreground">
+          {t("chat.wikiBind.description")}
+        </p>
+      </div>
+
+      {eligibleScope && query.data ? (
+        <div className="flex items-center gap-3 rounded-md border border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.3)] px-3 py-2">
+          <BookOpen className="h-3.5 w-3.5 shrink-0 text-[hsl(var(--primary))]" />
+          <div className="min-w-0 flex-1">
+            <p className="truncate text-sm font-medium">{query.data.name}</p>
+            <p className="text-[11px] text-muted-foreground">
+              {ready ? t("chat.wikiBind.ready") : t("chat.wikiBind.notReady")}
+            </p>
+          </div>
+          <Switch
+            checked={wikiEnabled}
+            disabled={!wikiEnabled && !ready}
+            onCheckedChange={(checked) => cfg.setWikiEnabled(checked && ready)}
+            aria-label={t("chat.wikiBind.toggle")}
+          />
+        </div>
+      ) : (
+        <Switch
+          checked={false}
+          disabled
+          onCheckedChange={() => undefined}
+          aria-label={t("chat.wikiBind.toggle")}
+        />
+      )}
+
+      {wikiEnabled ? (
+        <details className="rounded-md border border-[hsl(var(--border))] px-3 py-2">
+          <summary className="cursor-pointer text-xs font-medium text-muted-foreground">
+            {t("chat.wikiBind.advanced")}
+          </summary>
+          <div className="mt-2 flex items-center justify-end gap-2">
+            <Label className="text-xs text-muted-foreground">
+              {t("chat.wikiBind.topK")}
+            </Label>
+            <Input
+              type="number"
+              min={1}
+              max={10}
+              step={1}
+              className="h-8 w-16"
+              value={draftTopK}
+              onChange={(event) => setDraftTopK(event.target.value)}
+              onBlur={commitTopK}
+              aria-label={t("chat.wikiBind.topK")}
+            />
+          </div>
+        </details>
+      ) : null}
+
+      {unavailableHint ? <WikiHint>{unavailableHint}</WikiHint> : null}
+    </div>
+  );
+}
+
+function WikiHint({ children }: { children: ReactNode }) {
+  return (
+    <p className="rounded-md border border-dashed border-[hsl(var(--border))] px-3 py-2 text-xs text-muted-foreground">
+      {children}
+    </p>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/instance/instance-connectivity-dot.tsx

@@ -0,0 +1,96 @@
+"use client";
+
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipProvider,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
+import { useI18n, type TranslateFn } from "@/i18n/i18n-context";
+import { cn } from "@/lib/utils";
+import type {
+  InstanceConnectivity,
+  InstanceConnectivityReason,
+} from "@/types/instance";
+
+interface InstanceConnectivityDotProps {
+  status?: InstanceConnectivity;
+  className?: string;
+}
+
+function reasonLabel(
+  reason: InstanceConnectivityReason | undefined,
+  t: TranslateFn,
+) {
+  switch (reason) {
+    case "timeout":
+      return t("instance.connectivity.reasonTimeout");
+    case "dns":
+      return t("instance.connectivity.reasonDns");
+    case "connection":
+      return t("instance.connectivity.reasonConnection");
+    case "tls":
+      return t("instance.connectivity.reasonTls");
+    default:
+      return t("instance.connectivity.reasonNetwork");
+  }
+}
+
+function statusLabel(status: InstanceConnectivity | undefined, t: TranslateFn) {
+  if (!status) return t("instance.connectivity.checking");
+  if (!status.configured) return t("instance.connectivity.notConfigured");
+  if (status.reachable === true) {
+    return status.latencyMs === undefined
+      ? t("instance.connectivity.reachable")
+      : t("instance.connectivity.reachableLatency", {
+          latency: status.latencyMs,
+        });
+  }
+  if (status.reachable === false) {
+    const reason = reasonLabel(status.reason, t);
+    return status.message
+      ? t("instance.connectivity.unreachableDetail", {
+          reason,
+          detail: status.message,
+        })
+      : t("instance.connectivity.unreachable", { reason });
+  }
+  return t("instance.connectivity.checking");
+}
+
+function statusClass(status: InstanceConnectivity | undefined) {
+  if (!status || !status.configured || status.reachable === null) {
+    return "bg-muted-foreground/35";
+  }
+  if (status.reachable === false) return "bg-red-500";
+  return "bg-emerald-500/70";
+}
+
+export function InstanceConnectivityDot({
+  status,
+  className,
+}: InstanceConnectivityDotProps) {
+  const { t } = useI18n();
+  const label = statusLabel(status, t);
+
+  return (
+    <TooltipProvider delayDuration={250}>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <span
+            role="status"
+            aria-label={label}
+            className={cn(
+              "inline-block h-1.5 w-1.5 shrink-0 rounded-full",
+              statusClass(status),
+              className,
+            )}
+          />
+        </TooltipTrigger>
+        <TooltipContent side="top" className="max-w-[320px]">
+          {label}
+        </TooltipContent>
+      </Tooltip>
+    </TooltipProvider>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/instance/project-card.tsx

@@ -21,11 +21,13 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { cn } from "@/lib/utils";
-import type { InstanceSummary } from "@/types/instance";
+import type { InstanceConnectivity, InstanceSummary } from "@/types/instance";
 import { useI18n } from "@/i18n/i18n-context";
+import { InstanceConnectivityDot } from "./instance-connectivity-dot";
 
 interface ProjectCardProps {
   item: InstanceSummary;
+  connectivity?: InstanceConnectivity;
   isActive: boolean;
   isSwitching: boolean;
   isExporting: boolean;
@@ -38,6 +40,7 @@ interface ProjectCardProps {
 
 export function ProjectCard({
   item,
+  connectivity,
   isActive,
   isSwitching,
   isExporting,
@@ -92,6 +95,7 @@ export function ProjectCard({
             <h3 className="truncate text-base font-semibold tracking-tight text-foreground">
               {item.name}
             </h3>
+            <InstanceConnectivityDot status={connectivity} />
           </div>
 
           <div className="flex shrink-0 items-center gap-1">

package/dist/dashboard-runtime/dashboard/src/components/knowledge-base/subspace-gate.tsx

@@ -1,15 +1,21 @@
 "use client";
 
-import { useState, type KeyboardEvent } from "react";
+import { useRef, useState, type KeyboardEvent } from "react";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
 import { useSubspace } from "@/contexts/subspace-context";
 import { useI18n } from "@/i18n/i18n-context";
 
 export function SubspaceGate() {
-  const { setSubspace, history } = useSubspace();
+  const { setSubspace, history, clearHistory } = useSubspace();
   const { t } = useI18n();
   const [inputValue, setInputValue] = useState("");
+  const inputRef = useRef<HTMLInputElement>(null);
+
+  const handleClearHistory = () => {
+    inputRef.current?.focus();
+    clearHistory();
+  };
 
   const handleSubmit = () => {
     const trimmed = inputValue.trim();
@@ -36,9 +42,20 @@ export function SubspaceGate() {
 
       {history.length > 0 && (
         <div className="flex flex-col items-center gap-2">
-          <span className="text-xs font-semibold text-muted-foreground">
-            {t("knowledgeBase.subspace.recentlyUsed")}
-          </span>
+          <div className="flex items-center gap-3">
+            <span className="text-xs font-semibold text-muted-foreground">
+              {t("knowledgeBase.subspace.recentlyUsed")}
+            </span>
+            <Button
+              type="button"
+              variant="ghost"
+              size="sm"
+              onClick={handleClearHistory}
+              className="h-6 px-2 text-muted-foreground hover:text-foreground"
+            >
+              {t("knowledgeBase.subspace.clearRecent")}
+            </Button>
+          </div>
           <div className="flex gap-2 flex-wrap justify-center max-w-[600px]">
             {history.map((s, idx) => (
               <button
@@ -60,6 +77,7 @@ export function SubspaceGate() {
 
       <div className="flex gap-2 w-full max-w-[480px]">
         <Input
+          ref={inputRef}
           placeholder={t("knowledgeBase.subspace.inputPlaceholder")}
           value={inputValue}
           onChange={(e) => setInputValue(e.target.value)}

package/dist/dashboard-runtime/dashboard/src/components/knowledge-base/subspace-switcher.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useState, type KeyboardEvent } from "react";
+import { useRef, useState, type KeyboardEvent } from "react";
 import { Check, ChevronDown, X } from "lucide-react";
 import { toast } from "sonner";
 import { Button } from "@/components/ui/button";
@@ -24,11 +24,12 @@ export function SubspaceSwitcher() {
   const { t } = useI18n();
   const [open, setOpen] = useState(false);
   const [inputValue, setInputValue] = useState("");
+  const inputRef = useRef<HTMLInputElement>(null);
 
   // No provider mounted (e.g. KB list page).
   if (!ctx) return null;
 
-  const { subspace, history, setSubspace, clearSubspace } = ctx;
+  const { subspace, history, setSubspace, clearSubspace, clearHistory } = ctx;
   const hasActive = subspace !== null;
 
   const handleSubmit = () => {
@@ -55,6 +56,11 @@ export function SubspaceSwitcher() {
     setOpen(false);
   };
 
+  const handleClearHistory = () => {
+    inputRef.current?.focus();
+    clearHistory();
+  };
+
   const handleClear = () => {
     clearSubspace();
     setOpen(false);
@@ -89,6 +95,7 @@ export function SubspaceSwitcher() {
           </label>
           <div className="flex gap-1.5">
             <Input
+              ref={inputRef}
               autoFocus
               placeholder={t("knowledgeBase.subspace.inputPlaceholder")}
               value={inputValue}
@@ -109,9 +116,20 @@ export function SubspaceSwitcher() {
 
         {history.length > 0 && (
           <div className="space-y-1">
-            <span className="text-xs font-medium text-muted-foreground">
-              {t("knowledgeBase.subspace.recentlyUsed")}
-            </span>
+            <div className="flex items-center justify-between">
+              <span className="text-xs font-medium text-muted-foreground">
+                {t("knowledgeBase.subspace.recentlyUsed")}
+              </span>
+              <Button
+                type="button"
+                variant="ghost"
+                size="sm"
+                onClick={handleClearHistory}
+                className="h-6 px-2 text-muted-foreground hover:text-foreground"
+              >
+                {t("knowledgeBase.subspace.clearRecent")}
+              </Button>
+            </div>
             <div className="flex flex-col gap-0.5 max-h-[180px] overflow-y-auto">
               {history.map((s) => {
                 const active = hasActive && s === subspace;

package/dist/dashboard-runtime/dashboard/src/components/layout/instance-switcher.tsx

@@ -14,7 +14,12 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { ConnectInstanceDialog } from "@/components/instance/connect-instance-dialog";
-import { useInstances, useSwitchInstance } from "@/hooks/use-instances";
+import { InstanceConnectivityDot } from "@/components/instance/instance-connectivity-dot";
+import {
+  useInstanceConnectivity,
+  useInstances,
+  useSwitchInstance,
+} from "@/hooks/use-instances";
 import { useI18n } from "@/i18n/i18n-context";
 import { cn } from "@/lib/utils";
 
@@ -41,6 +46,7 @@ export function InstanceSwitcher() {
   const { t } = useI18n();
   const [connectOpen, setConnectOpen] = useState(false);
   const { data, isLoading } = useInstances();
+  const { data: connectivity } = useInstanceConnectivity();
   const switchMutation = useSwitchInstance();
 
   const activeName = data?.activeInstance ?? null;
@@ -81,6 +87,9 @@ export function InstanceSwitcher() {
             className="h-8 gap-1.5 px-2 text-sm text-muted-foreground hover:text-foreground"
             disabled={isLoading}
           >
+            <InstanceConnectivityDot
+              status={activeName ? connectivity?.items[activeName] : undefined}
+            />
             <span className="max-w-[140px] truncate">
               {activeName
                 ? `*${activeName}`
@@ -117,6 +126,9 @@ export function InstanceSwitcher() {
                     )}
                   />
                   <span className="flex-1 truncate">{item.name}</span>
+                  <InstanceConnectivityDot
+                    status={connectivity?.items[item.name]}
+                  />
                   {item.region && (
                     <span className="text-[11px] text-muted-foreground">
                       {item.region}

package/dist/dashboard-runtime/dashboard/src/components/layout/sidebar-instance-card.tsx

@@ -13,9 +13,15 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { ConnectInstanceDialog } from "@/components/instance/connect-instance-dialog";
-import { useInstances, useSwitchInstance } from "@/hooks/use-instances";
+import { InstanceConnectivityDot } from "@/components/instance/instance-connectivity-dot";
+import {
+  useInstanceConnectivity,
+  useInstances,
+  useSwitchInstance,
+} from "@/hooks/use-instances";
 import { useI18n } from "@/i18n/i18n-context";
 import { cn } from "@/lib/utils";
+import type { InstanceConnectivity } from "@/types/instance";
 
 function resolveSwitchTarget(pathname: string | null): string | null {
   if (!pathname) return null;
@@ -40,6 +46,7 @@ export function SidebarInstanceCard({ collapsed }: SidebarInstanceCardProps) {
   const { t } = useI18n();
   const [connectOpen, setConnectOpen] = useState(false);
   const { data, isLoading } = useInstances();
+  const { data: connectivity } = useInstanceConnectivity();
   const switchMutation = useSwitchInstance();
 
   const activeName = data?.activeInstance ?? null;
@@ -76,12 +83,18 @@ export function SidebarInstanceCard({ collapsed }: SidebarInstanceCardProps) {
                 // Circular avatar to differentiate the instance switcher
                 // from the rectangular menu items below; subtle border +
                 // card surface keeps it readable on the white sidebar.
-                "flex h-8 w-8 items-center justify-center rounded-full border border-[hsl(var(--border))] bg-[hsl(var(--card))] text-[11px] font-semibold uppercase text-[hsl(var(--foreground))] transition-colors",
+                "relative flex h-8 w-8 items-center justify-center rounded-full border border-[hsl(var(--border))] bg-[hsl(var(--card))] text-[11px] font-semibold uppercase text-[hsl(var(--foreground))] transition-colors",
                 "hover:border-[hsl(var(--primary))] hover:text-[hsl(var(--primary))]",
                 "disabled:opacity-50",
               )}
             >
               {(activeName ?? "?").charAt(0)}
+              <InstanceConnectivityDot
+                status={
+                  activeName ? connectivity?.items[activeName] : undefined
+                }
+                className="absolute bottom-0 right-0 ring-2 ring-background"
+              />
             </button>
           </DropdownMenuTrigger>
           <InstanceMenu
@@ -90,6 +103,7 @@ export function SidebarInstanceCard({ collapsed }: SidebarInstanceCardProps) {
             onSelect={handleSwitch}
             onCreate={() => setConnectOpen(true)}
             onManage={() => router.push("/projects")}
+            connectivity={connectivity?.items}
             t={t}
           />
         </DropdownMenu>
@@ -115,8 +129,15 @@ export function SidebarInstanceCard({ collapsed }: SidebarInstanceCardProps) {
               <span className="text-[11px] uppercase tracking-wider text-[hsl(var(--muted-foreground))]">
                 {t("instance.switcher.currentProjectLabel")}
               </span>
-              <span className="truncate text-sm font-semibold text-[hsl(var(--foreground))]">
-                {activeName ?? t("instance.switcher.notSelected")}
+              <span className="flex items-center gap-1.5 truncate text-sm font-semibold text-[hsl(var(--foreground))]">
+                <span className="truncate">
+                  {activeName ?? t("instance.switcher.notSelected")}
+                </span>
+                <InstanceConnectivityDot
+                  status={
+                    activeName ? connectivity?.items[activeName] : undefined
+                  }
+                />
               </span>
             </div>
             <ChevronsUpDown className="h-3.5 w-3.5 shrink-0 text-[hsl(var(--muted-foreground))]" />
@@ -128,6 +149,7 @@ export function SidebarInstanceCard({ collapsed }: SidebarInstanceCardProps) {
           onSelect={handleSwitch}
           onCreate={() => setConnectOpen(true)}
           onManage={() => router.push("/projects")}
+          connectivity={connectivity?.items}
           t={t}
         />
       </DropdownMenu>
@@ -146,6 +168,7 @@ interface InstanceMenuProps {
   onSelect: (name: string) => void;
   onCreate: () => void;
   onManage: () => void;
+  connectivity?: Record<string, InstanceConnectivity>;
   t: ReturnType<typeof useI18n>["t"];
 }
 
@@ -155,6 +178,7 @@ function InstanceMenu({
   onSelect,
   onCreate,
   onManage,
+  connectivity,
   t,
 }: InstanceMenuProps) {
   return (
@@ -185,6 +209,7 @@ function InstanceMenu({
                 )}
               />
               <span className="flex-1 truncate">{item.name}</span>
+              <InstanceConnectivityDot status={connectivity?.[item.name]} />
               {item.region && (
                 <span className="text-[11px] text-[hsl(var(--muted-foreground))]">
                   {item.region}

package/dist/dashboard-runtime/dashboard/src/components/memory/file-details-panel.tsx

@@ -3,7 +3,7 @@
 import { FileClock, Hash, HardDrive, ListOrdered } from "lucide-react";
 
 import { useI18n } from "@/i18n/i18n-context";
-import type { FileMemory, FileMemoryScope } from "@/types/file-memory";
+import type { FileMemoryItem, FileMemoryScope } from "@/types/file-memory";
 
 import { FileVersionHistory } from "./file-version-history";
 
@@ -38,9 +38,9 @@ export function FileDetailsPanel({
 }: {
   memoryStoreName: string;
   scope: FileMemoryScope;
-  file: FileMemory | undefined;
+  file: FileMemoryItem | undefined;
   readOnly: boolean;
-  onRestored?: (file: FileMemory, content: string) => void;
+  onRestored?: (file: FileMemoryItem, content: string) => void;
 }) {
   const { t } = useI18n();
   if (!file) {
@@ -64,7 +64,7 @@ export function FileDetailsPanel({
       <DetailRow
         icon={<ListOrdered className="h-3.5 w-3.5" />}
         label={t("memory.files.latestVersion")}
-        value={`v${file.latestSeq}`}
+        value={file.latestVersionId}
       />
       <DetailRow
         icon={<Hash className="h-3.5 w-3.5" />}

package/dist/dashboard-runtime/dashboard/src/components/memory/file-editor.tsx

@@ -7,7 +7,7 @@ import { Textarea } from "@/components/ui/textarea";
 import { useI18n } from "@/i18n/i18n-context";
 import { cn } from "@/lib/utils";
 
-export const MAX_FILE_PATH_BYTES = 800;
+export const MAX_FILE_PATH_BYTES = 1024;
 export const MAX_FILE_CONTENT_BYTES = 100 * 1024;
 
 export type FilePathValidationError =
@@ -15,7 +15,7 @@ export type FilePathValidationError =
 export type FileContentValidationError = "content-too-large";
 
 export function normalizeFileMemoryPath(value: string): string {
-  const trimmed = value.trim();
+  const trimmed = value.trim().normalize("NFC");
   return `/${trimmed.replace(/^\/+/, "")}`;
 }
 
@@ -24,7 +24,12 @@ export function validateFileMemoryPath(
 ): FilePathValidationError | null {
   const path = normalizeFileMemoryPath(value);
   if (path === "/") return "path-required";
-  if (path.split("/").some((segment) => segment === "..")) {
+  const segments = path.slice(1).split("/");
+  if (
+    path.includes("\\") ||
+    path.includes("\0") ||
+    segments.some((segment) => !segment || segment === "." || segment === "..")
+  ) {
     return "path-traversal";
   }
   if (new TextEncoder().encode(path).byteLength > MAX_FILE_PATH_BYTES) {
@@ -122,7 +127,7 @@ export function FileEditor({
       {conflict ? (
         <div className="flex items-start gap-2 border-b border-amber-500/30 bg-amber-500/10 px-3 py-2 text-xs text-amber-800 dark:text-amber-200">
           <AlertTriangle className="mt-0.5 h-3.5 w-3.5 shrink-0" />
-          <span>{t("memory.files.shaConflict")}</span>
+          <span>{t("memory.files.versionConflict")}</span>
         </div>
       ) : null}
       <Textarea