@tablestore/tablestore-agent-cli 0.2.10 → 0.3.1

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

@@ -0,0 +1,91 @@
+"use client";
+
+import { FileClock, Hash, HardDrive, ListOrdered } from "lucide-react";
+
+import { useI18n } from "@/i18n/i18n-context";
+import type { FileMemoryItem, FileMemoryScope } from "@/types/file-memory";
+
+import { FileVersionHistory } from "./file-version-history";
+
+function DetailRow({
+  icon,
+  label,
+  value,
+}: {
+  icon: React.ReactNode;
+  label: string;
+  value: React.ReactNode;
+}) {
+  return (
+    <div className="flex items-start gap-2 py-1.5">
+      <span className="mt-0.5 text-muted-foreground">{icon}</span>
+      <div className="min-w-0">
+        <p className="text-[10px] uppercase tracking-wide text-muted-foreground">
+          {label}
+        </p>
+        <div className="break-all text-xs">{value}</div>
+      </div>
+    </div>
+  );
+}
+
+export function FileDetailsPanel({
+  memoryStoreName,
+  scope,
+  file,
+  readOnly,
+  onRestored,
+}: {
+  memoryStoreName: string;
+  scope: FileMemoryScope;
+  file: FileMemoryItem | undefined;
+  readOnly: boolean;
+  onRestored?: (file: FileMemoryItem, content: string) => void;
+}) {
+  const { t } = useI18n();
+  if (!file) {
+    return (
+      <div className="flex h-full items-center justify-center p-5 text-center text-xs text-muted-foreground">
+        {t("memory.files.selectForDetails")}
+      </div>
+    );
+  }
+
+  return (
+    <div className="h-full min-h-0 overflow-auto p-3">
+      <h3 className="mb-2 text-xs font-semibold">
+        {t("memory.files.details")}
+      </h3>
+      <DetailRow
+        icon={<HardDrive className="h-3.5 w-3.5" />}
+        label={t("memory.files.size")}
+        value={`${file.contentSizeBytes.toLocaleString()} B`}
+      />
+      <DetailRow
+        icon={<ListOrdered className="h-3.5 w-3.5" />}
+        label={t("memory.files.latestVersion")}
+        value={file.latestVersionId}
+      />
+      <DetailRow
+        icon={<Hash className="h-3.5 w-3.5" />}
+        label="SHA-256"
+        value={
+          <span className="font-mono text-[10px]">{file.contentSha256}</span>
+        }
+      />
+      <DetailRow
+        icon={<FileClock className="h-3.5 w-3.5" />}
+        label={t("memory.files.updatedAt")}
+        value={new Date(file.updatedAt).toLocaleString()}
+      />
+
+      <FileVersionHistory
+        memoryStoreName={memoryStoreName}
+        scope={scope}
+        file={file}
+        readOnly={readOnly}
+        onRestored={onRestored}
+      />
+    </div>
+  );
+}

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

@@ -0,0 +1,144 @@
+"use client";
+
+import { useMemo } from "react";
+import { AlertTriangle, FileText, Loader2 } from "lucide-react";
+
+import { Textarea } from "@/components/ui/textarea";
+import { useI18n } from "@/i18n/i18n-context";
+import { cn } from "@/lib/utils";
+
+export const MAX_FILE_PATH_BYTES = 1024;
+export const MAX_FILE_CONTENT_BYTES = 100 * 1024;
+
+export type FilePathValidationError =
+  "path-required" | "path-traversal" | "path-too-large";
+export type FileContentValidationError = "content-too-large";
+
+export function normalizeFileMemoryPath(value: string): string {
+  const trimmed = value.trim().normalize("NFC");
+  return `/${trimmed.replace(/^\/+/, "")}`;
+}
+
+export function validateFileMemoryPath(
+  value: string,
+): FilePathValidationError | null {
+  const path = normalizeFileMemoryPath(value);
+  if (path === "/") return "path-required";
+  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) {
+    return "path-too-large";
+  }
+  return null;
+}
+
+export function validateFileMemoryContent(
+  value: string,
+): FileContentValidationError | null {
+  return new TextEncoder().encode(value).byteLength > MAX_FILE_CONTENT_BYTES
+    ? "content-too-large"
+    : null;
+}
+
+export function FileEditor({
+  path,
+  content,
+  dirty,
+  readOnly,
+  loading,
+  error,
+  conflict,
+  onChange,
+}: {
+  path: string | null;
+  content: string;
+  dirty: boolean;
+  readOnly: boolean;
+  loading: boolean;
+  error?: string;
+  conflict?: string | null;
+  onChange: (content: string) => void;
+}) {
+  const { t } = useI18n();
+  const byteLength = useMemo(
+    () => new TextEncoder().encode(content).byteLength,
+    [content],
+  );
+
+  if (!path) {
+    return (
+      <div className="flex h-full flex-col items-center justify-center gap-2 p-8 text-center text-muted-foreground">
+        <FileText className="h-9 w-9 opacity-30" />
+        <p className="text-sm">{t("memory.files.selectFile")}</p>
+      </div>
+    );
+  }
+
+  if (loading) {
+    return (
+      <div className="flex h-full items-center justify-center gap-2 text-sm text-muted-foreground">
+        <Loader2 className="h-4 w-4 animate-spin" />
+        {t("common.loading")}
+      </div>
+    );
+  }
+
+  if (error) {
+    return (
+      <div className="flex h-full items-center justify-center p-8 text-sm text-[hsl(var(--destructive))]">
+        {t("memory.files.readFailed", { error })}
+      </div>
+    );
+  }
+
+  return (
+    <div className="flex h-full min-h-0 flex-col">
+      <div className="flex items-center justify-between border-b border-[hsl(var(--border))] px-3 py-2">
+        <div className="flex min-w-0 items-center gap-2">
+          <FileText className="h-4 w-4 shrink-0 text-[hsl(var(--primary))]" />
+          <span className="truncate font-mono text-xs" title={path}>
+            {path}
+          </span>
+          {dirty ? (
+            <span className="shrink-0 rounded-full bg-amber-500/15 px-2 py-0.5 text-[10px] font-medium text-amber-700 dark:text-amber-300">
+              {t("memory.files.unsaved")}
+            </span>
+          ) : null}
+        </div>
+        <span
+          className={cn(
+            "shrink-0 text-[10px] text-muted-foreground",
+            byteLength > MAX_FILE_CONTENT_BYTES &&
+              "text-[hsl(var(--destructive))]",
+          )}
+        >
+          {t("memory.files.byteCount", {
+            count: byteLength,
+            limit: MAX_FILE_CONTENT_BYTES,
+          })}
+        </span>
+      </div>
+      {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.versionConflict")}</span>
+        </div>
+      ) : null}
+      <Textarea
+        aria-label={t("memory.files.editorLabel")}
+        value={content}
+        onChange={(event) => onChange(event.target.value)}
+        readOnly={readOnly}
+        spellCheck={false}
+        className="min-h-0 flex-1 resize-none rounded-none border-0 bg-transparent p-4 font-mono text-xs leading-5 shadow-none focus-visible:ring-0"
+        placeholder={t("memory.files.editorPlaceholder")}
+      />
+    </div>
+  );
+}

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

@@ -0,0 +1,181 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { Loader2 } from "lucide-react";
+
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { useI18n } from "@/i18n/i18n-context";
+
+import {
+  normalizeFileMemoryPath,
+  type FileContentValidationError,
+  type FilePathValidationError,
+  validateFileMemoryContent,
+  validateFileMemoryPath,
+} from "./file-editor";
+
+export type FileMutationDialog = "create" | "rename" | "delete" | null;
+
+const VALIDATION_MESSAGE_KEYS = {
+  "path-required": "memory.files.pathRequired",
+  "path-traversal": "memory.files.pathTraversal",
+  "path-too-large": "memory.files.pathTooLarge",
+  "content-too-large": "memory.files.contentTooLarge",
+} as const;
+
+export function FileMutationDialogs({
+  mode,
+  selectedPath,
+  pending,
+  onClose,
+  onCreate,
+  onRename,
+  onDelete,
+}: {
+  mode: FileMutationDialog;
+  selectedPath: string | null;
+  pending: boolean;
+  onClose: () => void;
+  onCreate: (path: string, content: string) => Promise<void>;
+  onRename: (path: string) => Promise<void>;
+  onDelete: () => Promise<void>;
+}) {
+  const { t } = useI18n();
+  const [path, setPath] = useState("");
+  const [content, setContent] = useState("");
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    setPath(mode === "rename" ? (selectedPath ?? "") : "");
+    setContent("");
+    setError(null);
+  }, [mode, selectedPath]);
+
+  function validationMessage(
+    code: FilePathValidationError | FileContentValidationError,
+  ): string {
+    return t(VALIDATION_MESSAGE_KEYS[code]);
+  }
+
+  async function submit() {
+    setError(null);
+    try {
+      if (mode === "delete") {
+        await onDelete();
+      } else {
+        const pathError = validateFileMemoryPath(path);
+        if (pathError) {
+          setError(validationMessage(pathError));
+          return;
+        }
+        if (mode === "create") {
+          const contentError = validateFileMemoryContent(content);
+          if (contentError) {
+            setError(validationMessage(contentError));
+            return;
+          }
+          await onCreate(normalizeFileMemoryPath(path), content);
+        } else if (mode === "rename") {
+          await onRename(normalizeFileMemoryPath(path));
+        }
+      }
+      onClose();
+    } catch (submitError) {
+      setError(
+        submitError instanceof Error
+          ? submitError.message
+          : t("common.unknownError"),
+      );
+    }
+  }
+
+  const titles = {
+    create: t("memory.files.createTitle"),
+    rename: t("memory.files.renameTitle"),
+    delete: t("memory.files.deleteTitle"),
+  };
+  const submitLabels = {
+    create: t("common.create"),
+    rename: t("memory.files.rename"),
+    delete: t("common.delete"),
+  };
+  const title = mode ? titles[mode] : "";
+  const submitLabel = mode ? submitLabels[mode] : "";
+
+  return (
+    <Dialog open={mode !== null} onOpenChange={(open) => !open && onClose()}>
+      <DialogContent className="sm:max-w-lg">
+        <DialogHeader>
+          <DialogTitle>{title}</DialogTitle>
+          <DialogDescription>
+            {mode === "delete"
+              ? t("memory.files.deleteDescription", {
+                  path: selectedPath ?? "",
+                })
+              : t("memory.files.pathHelp")}
+          </DialogDescription>
+        </DialogHeader>
+
+        {mode !== "delete" ? (
+          <div className="space-y-4 py-2">
+            <div className="space-y-1.5">
+              <Label htmlFor="file-memory-path">
+                {t("memory.files.pathLabel")}
+              </Label>
+              <Input
+                id="file-memory-path"
+                autoFocus
+                value={path}
+                onChange={(event) => setPath(event.target.value)}
+                placeholder="/notes/profile.md"
+              />
+            </div>
+            {mode === "create" ? (
+              <div className="space-y-1.5">
+                <Label htmlFor="file-memory-content">
+                  {t("memory.files.initialContent")}
+                </Label>
+                <Textarea
+                  id="file-memory-content"
+                  value={content}
+                  onChange={(event) => setContent(event.target.value)}
+                  rows={8}
+                  className="font-mono text-xs"
+                />
+              </div>
+            ) : null}
+          </div>
+        ) : null}
+
+        {error ? (
+          <p className="text-xs text-[hsl(var(--destructive))]">{error}</p>
+        ) : null}
+        <DialogFooter>
+          <Button type="button" variant="outline" onClick={onClose}>
+            {t("common.cancel")}
+          </Button>
+          <Button
+            type="button"
+            variant={mode === "delete" ? "destructive" : "default"}
+            onClick={() => void submit()}
+            disabled={pending}
+          >
+            {pending ? <Loader2 className="animate-spin" /> : null}
+            {submitLabel}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}

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

@@ -0,0 +1,154 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { Clock3, FolderTree } from "lucide-react";
+
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { useI18n } from "@/i18n/i18n-context";
+import { normalizeExactFileMemoryScope } from "@/lib/file-scope-history";
+import type { FileMemoryScope } from "@/types/file-memory";
+
+const SCOPE_FIELDS = [
+  { key: "appId", label: "app", placeholder: "appPlaceholder" },
+  { key: "tenantId", label: "tenant", placeholder: "tenantPlaceholder" },
+  { key: "agentId", label: "agent", placeholder: "agentPlaceholder" },
+  { key: "runId", label: "run", placeholder: "runPlaceholder" },
+] as const;
+
+function editableScope(scope: Partial<FileMemoryScope>): FileMemoryScope {
+  const visible = (value: string | undefined) =>
+    value && value !== "*" ? value : "";
+  return {
+    appId: visible(scope.appId),
+    tenantId: visible(scope.tenantId),
+    agentId: visible(scope.agentId),
+    runId: visible(scope.runId),
+  };
+}
+
+export function FileScopeOnboarding({
+  initialScope,
+  recentScopes,
+  onApply,
+}: {
+  initialScope: Partial<FileMemoryScope>;
+  recentScopes: FileMemoryScope[];
+  onApply: (scope: FileMemoryScope) => void;
+}) {
+  const { t } = useI18n();
+  const [draft, setDraft] = useState(() => editableScope(initialScope));
+  const [error, setError] = useState<string | null>(null);
+  const { appId, tenantId, agentId, runId } = initialScope;
+
+  useEffect(() => {
+    setDraft(editableScope({ appId, tenantId, agentId, runId }));
+    setError(null);
+  }, [agentId, appId, runId, tenantId]);
+
+  function submit(event: React.FormEvent<HTMLFormElement>) {
+    event.preventDefault();
+    const scope = normalizeExactFileMemoryScope(draft);
+    if (!scope) {
+      setError(t("memory.files.scopeAllRequired"));
+      return;
+    }
+    setError(null);
+    onApply(scope);
+  }
+
+  return (
+    <div className="overflow-hidden rounded-xl border border-[hsl(var(--border))] bg-[hsl(var(--card))]">
+      <div className="border-b border-[hsl(var(--border))] bg-[hsl(var(--primary-soft))] px-5 py-4">
+        <div className="flex items-start gap-3">
+          <div className="flex h-10 w-10 shrink-0 items-center justify-center rounded-lg bg-[hsl(var(--primary))] text-[hsl(var(--primary-foreground))]">
+            <FolderTree className="h-5 w-5" />
+          </div>
+          <div>
+            <h2 className="font-semibold text-foreground">
+              {t("memory.files.scopeOnboardingTitle")}
+            </h2>
+            <p className="mt-1 max-w-2xl text-sm text-muted-foreground">
+              {t("memory.files.scopeOnboardingDescription")}
+            </p>
+          </div>
+        </div>
+      </div>
+
+      <form onSubmit={submit} className="space-y-5 p-5">
+        {recentScopes.length > 0 ? (
+          <section className="space-y-2">
+            <div className="flex items-center gap-2 text-xs font-medium text-muted-foreground">
+              <Clock3 className="h-3.5 w-3.5" />
+              {t("memory.files.recentScopes")}
+            </div>
+            <div className="flex flex-wrap gap-2">
+              {recentScopes.map((scope) => {
+                const label = [
+                  scope.appId,
+                  scope.tenantId,
+                  scope.agentId,
+                  scope.runId,
+                ].join(" / ");
+                return (
+                  <Button
+                    key={label}
+                    type="button"
+                    size="sm"
+                    variant="outline"
+                    title={label}
+                    onClick={() => onApply(scope)}
+                    className="max-w-full font-mono text-xs"
+                  >
+                    <span className="truncate">{label}</span>
+                  </Button>
+                );
+              })}
+            </div>
+            <p className="text-xs text-muted-foreground">
+              {t("memory.files.recentScopesLocalHint")}
+            </p>
+          </section>
+        ) : null}
+
+        <section className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
+          {SCOPE_FIELDS.map(({ key, label, placeholder }) => (
+            <div key={key} className="space-y-1.5">
+              <Label htmlFor={`file-scope-${key}`}>
+                {t(`memory.scopeField.${label}`)}
+              </Label>
+              <Input
+                id={`file-scope-${key}`}
+                value={draft[key]}
+                placeholder={t(`memory.scopeBar.${placeholder}`)}
+                onChange={(event) => {
+                  setDraft((previous) => ({
+                    ...previous,
+                    [key]: event.target.value,
+                  }));
+                  setError(null);
+                }}
+              />
+            </div>
+          ))}
+        </section>
+
+        <div className="flex flex-wrap items-center justify-between gap-3 border-t border-[hsl(var(--border))] pt-4">
+          <div className="flex items-center gap-2 text-xs text-muted-foreground">
+            <FolderTree className="h-4 w-4" />
+            {error ? (
+              <span className="text-[hsl(var(--destructive))]">{error}</span>
+            ) : (
+              t("memory.files.scopeIsolationHint")
+            )}
+          </div>
+          <Button type="submit">
+            <FolderTree className="h-4 w-4" />
+            {t("memory.files.setScopeAndEnter")}
+          </Button>
+        </div>
+      </form>
+    </div>
+  );
+}