@tablestore/tablestore-agent-cli 0.3.1 → 0.4.0

package/dist/dashboard-runtime/dashboard/src/components/wiki/wiki-detail.tsx

@@ -0,0 +1,302 @@
+"use client";
+
+import { useState } from "react";
+import Link from "next/link";
+import { ArrowLeft, CircleAlert, Pencil } from "lucide-react";
+
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Skeleton } from "@/components/ui/skeleton";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
+import { useWiki } from "@/hooks/use-wikis";
+import { useWikiBuildPolling } from "@/hooks/use-wiki-build-polling";
+import { useI18n, type MessageKey } from "@/i18n/i18n-context";
+import { buildScopeWorkspaceHref } from "@/lib/scope-workspace";
+import { ApiClientError } from "@/services/api-client";
+import type { WikiScope, WikiStatus } from "@/types/wiki";
+
+import { WikiBuildPanel } from "./wiki-build-panel";
+import { WikiEditDialog } from "./wiki-edit-dialog";
+import { WikiOverview } from "./wiki-overview";
+import { WikiPagesPanel, WikiSearchPanel } from "./wiki-pages-panel";
+import { WikiSourcesPanel } from "./wiki-sources-panel";
+
+const STATUS_KEY: Record<WikiStatus, MessageKey> = {
+  draft: "wiki.status.draft",
+  ready: "wiki.status.ready",
+  deleting: "wiki.status.deleting",
+  deleted: "wiki.status.deleted",
+};
+
+export type WikiDetailTab =
+  "overview" | "sources" | "pages" | "search" | "build";
+
+export function readWikiDetailTab(
+  value: string | null | undefined,
+): WikiDetailTab | undefined {
+  return value === "overview" ||
+    value === "sources" ||
+    value === "pages" ||
+    value === "search" ||
+    value === "build"
+    ? value
+    : undefined;
+}
+
+export function selectWikiDetailPage(
+  path: string,
+  actions: {
+    setTab: (tab: "pages") => void;
+    onOpenPage: (path: string) => void;
+  },
+): void {
+  actions.setTab("pages");
+  actions.onOpenPage(path);
+}
+
+interface WikiDetailProps {
+  memoryStoreName: string;
+  scope: WikiScope;
+  runContext?: string;
+  initialTab?: WikiDetailTab;
+  selectedPagePath?: string;
+  onOpenPage: (path: string) => void;
+}
+
+export function WikiDetail({
+  memoryStoreName,
+  scope,
+  runContext,
+  initialTab,
+  selectedPagePath,
+  onOpenPage,
+}: WikiDetailProps) {
+  const { t } = useI18n();
+  const query = useWiki(memoryStoreName, scope);
+  const [tab, setTab] = useState<WikiDetailTab>(
+    selectedPagePath ? "pages" : (initialTab ?? "overview"),
+  );
+  const [editOpen, setEditOpen] = useState(false);
+  const latestBuild = query.data?.latestBuild;
+  const backToScope = runContext ? (
+    <Button asChild variant="ghost" size="sm">
+      <Link
+        href={buildScopeWorkspaceHref(memoryStoreName, {
+          ...scope,
+          runId: runContext,
+        })}
+      >
+        <ArrowLeft className="h-4 w-4" /> {t("wiki.detail.backToScope")}
+      </Link>
+    </Button>
+  ) : null;
+
+  useWikiBuildPolling(
+    latestBuild?.status,
+    async () => {
+      await query.refetch();
+    },
+    Boolean(latestBuild),
+  );
+
+  if (query.isLoading) {
+    return (
+      <div className="space-y-4">
+        {backToScope}
+        <Skeleton className="h-[520px] rounded-xl" />
+      </div>
+    );
+  }
+  if (query.error || !query.data) {
+    return (
+      <div className="space-y-4">
+        {backToScope}
+        <WikiDetailError error={query.error} />
+      </div>
+    );
+  }
+  const wiki = query.data;
+  const canReadPages = wiki.status === "ready";
+
+  function openPage(path: string) {
+    selectWikiDetailPage(path, { setTab, onOpenPage });
+  }
+
+  return (
+    <div className="space-y-4">
+      {backToScope}
+      <header className="rounded-xl border bg-muted/20 p-4">
+        <div className="mb-3 border-b pb-3">
+          <p className="text-xs font-semibold uppercase tracking-wide text-[hsl(var(--primary))]">
+            {t("wiki.detail.agentWikiTitle")}
+          </p>
+          <p className="mt-1 break-all font-mono text-xs text-muted-foreground">
+            {scope.appId} <span aria-hidden="true">&gt;</span> {scope.tenantId}{" "}
+            <span aria-hidden="true">&gt;</span> {scope.agentId}
+          </p>
+          <p className="mt-1 text-xs text-muted-foreground">
+            {t("wiki.detail.sharedRuns")}
+          </p>
+          {runContext ? (
+            <p className="mt-1 text-[11px] text-muted-foreground">
+              {t("wiki.detail.runContext", { runId: runContext })}
+            </p>
+          ) : null}
+        </div>
+        <div className="flex flex-wrap items-start justify-between gap-3">
+          <div className="min-w-0">
+            <h3 className="text-lg font-semibold">{wiki.name}</h3>
+            <p className="mt-1 text-xs text-muted-foreground">
+              {wiki.summary || t("wiki.list.noSummary")}
+            </p>
+          </div>
+          <div className="flex flex-wrap gap-2">
+            <Button
+              variant="outline"
+              size="sm"
+              onClick={() => setEditOpen(true)}
+            >
+              <Pencil className="h-4 w-4" /> {t("wiki.list.edit")}
+            </Button>
+            <Badge variant="secondary">{t(STATUS_KEY[wiki.status])}</Badge>
+            {wiki.hasPendingChanges ? (
+              <Badge variant="warning">{t("wiki.detail.dirty")}</Badge>
+            ) : null}
+          </div>
+        </div>
+        <dl className="mt-3 grid gap-x-5 gap-y-2 border-t pt-3 text-xs sm:grid-cols-3">
+          <HeaderField
+            label={t("wiki.detail.pageCount")}
+            value={wiki.pageCount}
+          />
+          <HeaderField
+            label={t("wiki.detail.createdAt")}
+            value={wiki.createdAt}
+          />
+          <HeaderField
+            label={t("wiki.detail.updatedAt")}
+            value={wiki.updatedAt}
+          />
+        </dl>
+        {latestBuild?.errorMessage &&
+        (latestBuild.status === "failed" ||
+          latestBuild.status === "conflict") ? (
+          <div className="mt-3 rounded-md border border-danger/30 bg-danger-soft p-3 text-sm text-danger">
+            <p>{latestBuild.errorMessage}</p>
+          </div>
+        ) : null}
+      </header>
+
+      <WikiEditDialog
+        memoryStoreName={memoryStoreName}
+        scope={scope}
+        wiki={wiki}
+        open={editOpen}
+        onOpenChange={setEditOpen}
+      />
+
+      <Tabs
+        className="space-y-3"
+        value={tab}
+        onValueChange={(value) => setTab(value as WikiDetailTab)}
+      >
+        <TabsList className="h-9 max-w-full justify-start overflow-x-auto">
+          {(["overview", "sources", "pages", "search", "build"] as const).map(
+            (value) => (
+              <TabsTrigger key={value} value={value}>
+                {t(`wiki.detail.tabs.${value}`)}
+              </TabsTrigger>
+            ),
+          )}
+        </TabsList>
+        <TabsContent value="overview">
+          <WikiOverview
+            memoryStoreName={memoryStoreName}
+            scope={scope}
+            enabled={canReadPages}
+          />
+        </TabsContent>
+        <TabsContent value="sources">
+          <WikiSourcesPanel memoryStoreName={memoryStoreName} scope={scope} />
+        </TabsContent>
+        <TabsContent value="pages">
+          <WikiPagesPanel
+            memoryStoreName={memoryStoreName}
+            scope={scope}
+            enabled={canReadPages}
+            selectedPagePath={selectedPagePath}
+            onOpenPage={openPage}
+          />
+        </TabsContent>
+        <TabsContent value="search">
+          <WikiSearchPanel
+            memoryStoreName={memoryStoreName}
+            scope={scope}
+            enabled={canReadPages}
+            onOpenPage={openPage}
+          />
+        </TabsContent>
+        <TabsContent value="build">
+          <WikiBuildPanel
+            memoryStoreName={memoryStoreName}
+            scope={scope}
+            build={latestBuild}
+            onBuildStarted={() => {
+              void query.refetch();
+            }}
+          />
+        </TabsContent>
+      </Tabs>
+    </div>
+  );
+}
+
+function HeaderField({
+  label,
+  value,
+}: {
+  label: string;
+  value?: string | number;
+}) {
+  return (
+    <div className="min-w-0">
+      <dt className="text-xs text-muted-foreground">{label}</dt>
+      <dd
+        className="mt-1 truncate font-mono"
+        title={value === undefined ? "-" : String(value)}
+      >
+        {value ?? "-"}
+      </dd>
+    </div>
+  );
+}
+
+function WikiDetailError({ error }: { error: Error | null }) {
+  const { t } = useI18n();
+  const apiError = error instanceof ApiClientError ? error : undefined;
+  const isScopeConflict = apiError?.status === 409;
+  return (
+    <div className="rounded-xl border border-danger/30 bg-danger-soft p-8 text-center">
+      <CircleAlert className="mx-auto h-8 w-8 text-danger" />
+      <h2 className="mt-3 font-semibold">{t("wiki.detail.loadFailed")}</h2>
+      <p className="mt-1 text-sm">
+        {isScopeConflict
+          ? t("wiki.detail.scopeConflict")
+          : (apiError?.displayMessage ??
+            error?.message ??
+            t("wiki.detail.notFound"))}
+      </p>
+      {apiError?.requestId ? (
+        <p className="mt-2 font-mono text-xs">
+          {t("wiki.detail.requestId")}: {apiError.requestId}
+        </p>
+      ) : null}
+      {apiError?.details?.upstreamRequestId ? (
+        <p className="mt-1 font-mono text-xs">
+          {t("wiki.detail.upstreamRequestId")}:{" "}
+          {apiError.details.upstreamRequestId}
+        </p>
+      ) : null}
+    </div>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/wiki/wiki-edit-dialog.tsx

@@ -0,0 +1,195 @@
+"use client";
+
+import { useState } from "react";
+import { toast } from "sonner";
+
+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 { useUpdateWiki } from "@/hooks/use-wikis";
+import { useI18n } from "@/i18n/i18n-context";
+import type { UpdateWikiRequest, Wiki, WikiScope } from "@/types/wiki";
+
+const MAX_WIKI_NAME_BYTES = 256;
+const MAX_WIKI_SUMMARY_BYTES = 4096;
+
+type WikiFieldValidationError =
+  "nameRequired" | "nameTooLong" | "summaryTooLong";
+
+function utf8Length(value: string): number {
+  return new TextEncoder().encode(value).byteLength;
+}
+
+function validateWikiFields(
+  name: string,
+  summary: string,
+): WikiFieldValidationError | null {
+  if (!name.trim()) return "nameRequired";
+  if (utf8Length(name.trim()) > MAX_WIKI_NAME_BYTES) return "nameTooLong";
+  if (utf8Length(summary) > MAX_WIKI_SUMMARY_BYTES) return "summaryTooLong";
+  return null;
+}
+
+export function buildWikiUpdateChanges(
+  wiki: Pick<Wiki, "name" | "summary">,
+  name: string,
+  summary: string,
+): Omit<UpdateWikiRequest, "scope"> {
+  const changes: Omit<UpdateWikiRequest, "scope"> = {};
+  const normalizedName = name.trim();
+  if (normalizedName !== wiki.name) changes.name = normalizedName;
+  if (summary !== (wiki.summary ?? "")) changes.summary = summary;
+  return changes;
+}
+
+export function buildWikiUpdateVariables(
+  memoryStoreName: string,
+  scope: WikiScope,
+  wiki: Pick<Wiki, "name" | "summary">,
+  name: string,
+  summary: string,
+) {
+  return {
+    memoryStoreName,
+    scope,
+    ...buildWikiUpdateChanges(wiki, name, summary),
+  };
+}
+
+interface WikiEditDialogProps {
+  memoryStoreName: string;
+  scope: WikiScope;
+  wiki: Wiki;
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+}
+
+export function WikiEditDialog({
+  memoryStoreName,
+  scope,
+  wiki,
+  open,
+  onOpenChange,
+}: WikiEditDialogProps) {
+  const { t } = useI18n();
+  const updateWiki = useUpdateWiki();
+  const [validationError, setValidationError] =
+    useState<WikiFieldValidationError | null>(null);
+
+  async function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
+    event.preventDefault();
+    if (updateWiki.isPending) return;
+    const formData = new FormData(event.currentTarget);
+    const name = String(formData.get("name") ?? "").trim();
+    const summary = String(formData.get("summary") ?? "");
+    const error = validateWikiFields(name, summary);
+    if (error) {
+      setValidationError(error);
+      return;
+    }
+    const variables = buildWikiUpdateVariables(
+      memoryStoreName,
+      scope,
+      wiki,
+      name,
+      summary,
+    );
+    if (Object.keys(variables).length === 2) {
+      onOpenChange(false);
+      return;
+    }
+
+    try {
+      await updateWiki.mutateAsync(variables);
+      toast.success(t("wiki.edit.success"));
+      onOpenChange(false);
+    } catch (error) {
+      toast.error(
+        error instanceof Error ? error.message : t("wiki.edit.failed"),
+      );
+    }
+  }
+
+  const validationMessage = validationError
+    ? t(
+        validationError === "nameRequired"
+          ? "wiki.edit.nameRequired"
+          : validationError === "nameTooLong"
+            ? "wiki.edit.nameTooLong"
+            : "wiki.edit.summaryTooLong",
+      )
+    : null;
+
+  return (
+    <Dialog
+      open={open}
+      onOpenChange={(nextOpen) => {
+        if (!nextOpen) setValidationError(null);
+        onOpenChange(nextOpen);
+      }}
+    >
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>{t("wiki.edit.title")}</DialogTitle>
+          <DialogDescription>{t("wiki.edit.description")}</DialogDescription>
+        </DialogHeader>
+        <form
+          key={`${scope.appId}:${scope.tenantId}:${scope.agentId}:${wiki.updatedAt}`}
+          onSubmit={handleSubmit}
+          className="space-y-4"
+        >
+          <div className="space-y-2">
+            <Label htmlFor="wiki-edit-name">{t("wiki.edit.name")}</Label>
+            <Input
+              id="wiki-edit-name"
+              name="name"
+              defaultValue={wiki.name}
+              disabled={updateWiki.isPending}
+              onChange={() => setValidationError(null)}
+            />
+          </div>
+          <div className="space-y-2">
+            <Label htmlFor="wiki-edit-summary">{t("wiki.edit.summary")}</Label>
+            <Textarea
+              id="wiki-edit-summary"
+              name="summary"
+              rows={4}
+              defaultValue={wiki.summary ?? ""}
+              disabled={updateWiki.isPending}
+              onChange={() => setValidationError(null)}
+            />
+          </div>
+          {validationMessage ? (
+            <p role="alert" className="text-sm text-destructive">
+              {validationMessage}
+            </p>
+          ) : null}
+          <DialogFooter>
+            <Button
+              type="button"
+              variant="outline"
+              disabled={updateWiki.isPending}
+              onClick={() => onOpenChange(false)}
+            >
+              {t("common.cancel")}
+            </Button>
+            <Button type="submit" disabled={updateWiki.isPending}>
+              {updateWiki.isPending
+                ? t("wiki.edit.submitting")
+                : t("wiki.edit.submit")}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/wiki/wiki-overview.tsx

@@ -0,0 +1,104 @@
+"use client";
+
+import { useMemo } from "react";
+
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { useWikiPages } from "@/hooks/use-wikis";
+import { useI18n } from "@/i18n/i18n-context";
+import type { WikiScope } from "@/types/wiki";
+
+export function WikiOverview({
+  memoryStoreName,
+  scope,
+  enabled,
+}: {
+  memoryStoreName: string;
+  scope: WikiScope;
+  enabled: boolean;
+}) {
+  const { t } = useI18n();
+  const query = useWikiPages(memoryStoreName, scope, {
+    limit: 100,
+    enabled,
+  });
+  const loadedPages = useMemo(
+    () => query.data?.pages.flatMap((page) => page.pages) ?? [],
+    [query.data],
+  );
+  const types = useMemo(() => {
+    const counts = new Map<string, number>();
+    for (const page of loadedPages) {
+      const type = page.type || t("wiki.overview.unknownType");
+      counts.set(type, (counts.get(type) ?? 0) + 1);
+    }
+    return [...counts.entries()].sort(([left], [right]) =>
+      left.localeCompare(right),
+    );
+  }, [loadedPages, t]);
+
+  if (!enabled) {
+    return (
+      <p className="text-sm text-muted-foreground">
+        {t("wiki.detail.noReadableBuild")}
+      </p>
+    );
+  }
+
+  if (query.isLoading) {
+    return (
+      <p className="text-sm text-muted-foreground">{t("common.loading")}</p>
+    );
+  }
+  if (query.error) {
+    return (
+      <div className="space-y-2 text-sm text-danger">
+        <p>{query.error.message}</p>
+        <Button variant="outline" size="sm" onClick={query.resetWikiPages}>
+          {t("wiki.pages.resetFromFirst")}
+        </Button>
+      </div>
+    );
+  }
+
+  return (
+    <div className="grid gap-4 lg:grid-cols-2">
+      <section className="rounded-xl border p-4">
+        <h3 className="font-semibold">{t("wiki.overview.loadedMetadata")}</h3>
+        <p className="mt-1 text-xs text-muted-foreground">
+          {t("wiki.overview.loadedMetadataHint", { count: loadedPages.length })}
+        </p>
+        <div className="mt-3 flex flex-wrap gap-2">
+          {types.length > 0 ? (
+            types.map(([type, count]) => (
+              <Badge key={type} variant="secondary">
+                {type}: {count}
+              </Badge>
+            ))
+          ) : (
+            <span className="text-sm text-muted-foreground">
+              {t("wiki.overview.noLoadedPages")}
+            </span>
+          )}
+        </div>
+      </section>
+      <section className="rounded-xl border p-4">
+        <h3 className="font-semibold">
+          {t("wiki.overview.recentLoadedPages")}
+        </h3>
+        <ul className="mt-3 space-y-2 text-sm">
+          {loadedPages.slice(0, 8).map((page) => (
+            <li key={page.path} className="truncate font-mono">
+              {page.path}
+            </li>
+          ))}
+          {loadedPages.length === 0 ? (
+            <li className="text-muted-foreground">
+              {t("wiki.overview.noLoadedPages")}
+            </li>
+          ) : null}
+        </ul>
+      </section>
+    </div>
+  );
+}