@tablestore/tablestore-agent-cli 0.3.1 → 0.4.1

package/dist/dashboard-runtime/dashboard/src/components/qa/wiki-evidence-block.tsx

@@ -0,0 +1,326 @@
+"use client";
+
+import { useState } from "react";
+import Link from "next/link";
+import { BookMarked, ChevronDown } from "lucide-react";
+
+import {
+  Collapsible,
+  CollapsibleContent,
+  CollapsibleTrigger,
+} from "@/components/ui/collapsible";
+import { useI18n } from "@/i18n/i18n-context";
+import { cn } from "@/lib/utils";
+import type {
+  WikiEvidence,
+  WikiRetrievalError,
+  WikiRetrievalGroup,
+} from "@/types/llm-chat";
+
+export interface WikiEvidenceScope {
+  appId: string;
+  tenantId: string;
+  agentId: string;
+  runId: string;
+}
+
+interface WikiEvidenceBlockProps {
+  query?: string;
+  pages: WikiEvidence[];
+  groups: WikiRetrievalGroup[];
+  memoryStoreName?: string;
+  scope?: WikiEvidenceScope;
+  totalContextChars?: number;
+}
+
+export function wikiEvidenceHref(
+  memoryStoreName: string,
+  scope: WikiEvidenceScope,
+  page: Pick<WikiEvidence, "path">,
+): string {
+  const query = new URLSearchParams([
+    ["appId", scope.appId],
+    ["tenantId", scope.tenantId],
+    ["agentId", scope.agentId],
+    ["runId", scope.runId],
+  ]);
+  query.set("path", page.path);
+  return `/memory/${encodeURIComponent(memoryStoreName)}/wiki?${query.toString()}`;
+}
+
+function hasNavigationTarget(
+  memoryStoreName: string | undefined,
+  scope: WikiEvidenceScope | undefined,
+): scope is WikiEvidenceScope {
+  return Boolean(
+    memoryStoreName &&
+    scope &&
+    scope.appId &&
+    scope.tenantId &&
+    scope.agentId &&
+    scope.runId,
+  );
+}
+
+function fallbackGroups(pages: WikiEvidence[]): WikiRetrievalGroup[] {
+  const byWiki = new Map<string, WikiRetrievalGroup>();
+  for (const page of pages) {
+    const current = byWiki.get(page.wikiName);
+    if (current) {
+      current.pages.push(page);
+      continue;
+    }
+    byWiki.set(page.wikiName, {
+      wikiName: page.wikiName,
+      pages: [page],
+    });
+  }
+  return [...byWiki.values()];
+}
+
+export function resolveWikiEvidenceGroups(
+  pages: WikiEvidence[],
+  groups: WikiRetrievalGroup[],
+): WikiRetrievalGroup[] {
+  return (groups.length > 0 ? groups : fallbackGroups(pages)).filter(
+    (group) => group.pages.length > 0 || (group.errors?.length ?? 0) > 0,
+  );
+}
+
+export function wikiEvidencePageCount(groups: WikiRetrievalGroup[]): number {
+  return groups.reduce((count, group) => count + group.pages.length, 0);
+}
+
+export function WikiEvidenceBlock({
+  query,
+  pages,
+  groups,
+  memoryStoreName,
+  scope,
+  totalContextChars,
+}: WikiEvidenceBlockProps) {
+  const { t } = useI18n();
+  const [open, setOpen] = useState(false);
+  // A successful search hit that contributed no injected evidence is not UI
+  // evidence. Keep only authoritative group pages and explicit failures.
+  const renderedGroups = resolveWikiEvidenceGroups(pages, groups);
+  const pageCount = wikiEvidencePageCount(renderedGroups);
+  const title = t("qa.message.wikiReferences", { count: pageCount });
+  const triggerLabel = `${title} · ${
+    open ? t("qa.chunks.collapse") : t("qa.chunks.expand")
+  }`;
+
+  return (
+    <Collapsible open={open} onOpenChange={setOpen}>
+      <CollapsibleTrigger asChild>
+        <button
+          type="button"
+          aria-label={triggerLabel}
+          className="inline-flex max-w-full items-center gap-1.5 rounded-md px-2 py-1 text-xs text-muted-foreground transition-colors hover:bg-[hsl(var(--accent))] hover:text-foreground"
+        >
+          <BookMarked className="h-3.5 w-3.5 shrink-0" />
+          <span className="shrink-0">{title}</span>
+          {query ? (
+            <span className="max-w-[240px] truncate text-muted-foreground/70">
+              · {t("qa.message.wikiQuery", { query })}
+            </span>
+          ) : null}
+          {totalContextChars !== undefined ? (
+            <span className="shrink-0 text-muted-foreground/70">
+              ·
+              {t("qa.message.wikiTotalContextChars", {
+                count: totalContextChars,
+              })}
+            </span>
+          ) : null}
+          <ChevronDown
+            className={cn(
+              "h-3 w-3 shrink-0 transition-transform duration-200",
+              open && "rotate-180",
+            )}
+          />
+        </button>
+      </CollapsibleTrigger>
+      <CollapsibleContent>
+        <div className="mt-2">
+          <WikiEvidenceContent
+            groups={renderedGroups}
+            memoryStoreName={memoryStoreName}
+            scope={scope}
+          />
+        </div>
+      </CollapsibleContent>
+    </Collapsible>
+  );
+}
+
+export function WikiEvidenceContent({
+  groups,
+  memoryStoreName,
+  scope,
+}: {
+  groups: WikiRetrievalGroup[];
+  memoryStoreName?: string;
+  scope?: WikiEvidenceScope;
+}) {
+  return (
+    <div className="space-y-3">
+      {groups.map((group, groupIndex) => (
+        <WikiEvidenceGroup
+          key={`${group.wikiName}-${groupIndex}`}
+          group={group}
+          memoryStoreName={memoryStoreName}
+          scope={scope}
+        />
+      ))}
+    </div>
+  );
+}
+
+function WikiEvidenceGroup({
+  group,
+  memoryStoreName,
+  scope,
+}: {
+  group: WikiRetrievalGroup;
+  memoryStoreName?: string;
+  scope?: WikiEvidenceScope;
+}) {
+  return (
+    <section className="space-y-2" aria-label={group.wikiName}>
+      <div className="flex items-center gap-2 text-xs font-medium text-muted-foreground">
+        <span className="text-foreground/80">{group.wikiName}</span>
+      </div>
+      <div className="space-y-2 border-l-2 border-[hsl(var(--border))] pl-3">
+        {(group.errors ?? []).map((error, index) => (
+          <WikiEvidenceError
+            key={`${error.stage}-${error.path ?? ""}-${error.requestId ?? index}`}
+            error={error}
+            wikiName={group.wikiName}
+          />
+        ))}
+        {group.pages.map((page) => (
+          <WikiEvidenceCard
+            key={`${page.reference}-${page.path}`}
+            page={page}
+            memoryStoreName={memoryStoreName}
+            scope={scope}
+          />
+        ))}
+      </div>
+    </section>
+  );
+}
+
+function WikiEvidenceError({
+  error,
+  wikiName,
+}: {
+  error: WikiRetrievalError;
+  wikiName: string;
+}) {
+  const { t } = useI18n();
+  return (
+    <div className="rounded-md border border-amber-500/30 bg-amber-500/5 px-3 py-2 text-xs text-amber-700 dark:text-amber-300">
+      <div className="font-medium">
+        {t("qa.message.wikiUnavailable", { name: wikiName })}
+      </div>
+      <div className="mt-1 space-y-0.5 font-mono text-[11px] text-amber-700/80 dark:text-amber-300/80">
+        <div>{t("qa.message.wikiErrorCode", { code: error.code })}</div>
+        <div>
+          {t("qa.message.wikiErrorMessage", { message: error.message })}
+        </div>
+        {error.requestId ? (
+          <div>
+            {t("qa.message.wikiRequestId", { requestId: error.requestId })}
+          </div>
+        ) : null}
+        {error.httpStatus !== undefined ? (
+          <div>
+            {t("qa.message.wikiHttpStatus", {
+              httpStatus: error.httpStatus,
+            })}
+          </div>
+        ) : null}
+        <div>{t("qa.message.wikiErrorStage", { stage: error.stage })}</div>
+        {error.path ? (
+          <div>{t("qa.message.wikiErrorPath", { path: error.path })}</div>
+        ) : null}
+      </div>
+    </div>
+  );
+}
+
+function WikiEvidenceCard({
+  page,
+  memoryStoreName,
+  scope,
+}: {
+  page: WikiEvidence;
+  memoryStoreName?: string;
+  scope?: WikiEvidenceScope;
+}) {
+  const { t } = useI18n();
+  const canNavigate = hasNavigationTarget(memoryStoreName, scope);
+  const pathMetadata = canNavigate ? (
+    <Link
+      href={wikiEvidenceHref(memoryStoreName ?? "", scope, page)}
+      aria-label={`${page.reference} ${page.path}`}
+      className="min-w-0 truncate rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 font-mono text-[10px] text-[hsl(var(--primary))] hover:underline"
+    >
+      {page.path}
+    </Link>
+  ) : (
+    <span className="min-w-0 truncate rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 font-mono text-[10px] text-muted-foreground">
+      {page.path}
+    </span>
+  );
+
+  return (
+    <article className="rounded-md border border-[hsl(var(--border))] bg-[hsl(var(--muted)/0.3)] p-3">
+      <div className="flex items-center gap-2 text-xs text-muted-foreground">
+        <span className="shrink-0 font-semibold text-primary">
+          [{page.reference}]
+        </span>
+        {pathMetadata}
+        {page.title ? (
+          <span className="min-w-0 truncate font-medium text-foreground/80">
+            {page.title}
+          </span>
+        ) : null}
+        {page.type ? (
+          <span className="shrink-0 rounded bg-[hsl(var(--muted))] px-1.5 py-0.5 text-[10px] uppercase">
+            {page.type}
+          </span>
+        ) : null}
+      </div>
+      {page.description ? (
+        <p className="mt-1.5 text-xs text-foreground/80">{page.description}</p>
+      ) : null}
+      <div className="mt-2 flex flex-wrap items-center gap-x-3 gap-y-1 text-[11px] text-muted-foreground">
+        {page.score !== undefined ? (
+          <span className="font-mono">
+            {t("qa.message.wikiScore", { score: String(page.score) })}
+          </span>
+        ) : null}
+        <span>
+          {t("qa.message.wikiInjectedChars", {
+            count: page.injectedChars,
+          })}
+        </span>
+        {page.truncated ? (
+          <span className="text-amber-700 dark:text-amber-300">
+            {t("qa.message.wikiTruncated")}
+          </span>
+        ) : null}
+      </div>
+      {page.sources && page.sources.length > 0 ? (
+        <div className="mt-1.5 break-all text-[11px] text-muted-foreground">
+          {t("qa.message.wikiSources", {
+            sources: page.sources.join(", "),
+          })}
+        </div>
+      ) : null}
+    </article>
+  );
+}

package/dist/dashboard-runtime/dashboard/src/components/shared/copyable-id.tsx

@@ -0,0 +1,69 @@
+"use client";
+
+import { Copy } from "lucide-react";
+import { toast } from "sonner";
+
+import { useI18n } from "@/i18n/i18n-context";
+import { copyToClipboard } from "@/lib/clipboard";
+import { cn } from "@/lib/utils";
+
+interface CopyableIdProps {
+  value: string | null | undefined;
+  label?: string;
+  className?: string;
+  valueClassName?: string;
+  copyLabel?: string;
+}
+
+/** Compact, overflow-safe identifier with full-value tooltip and copy action. */
+export function CopyableId({
+  value,
+  label = "ID",
+  className,
+  valueClassName,
+  copyLabel,
+}: CopyableIdProps) {
+  const { t } = useI18n();
+  const copyable = value !== null && value !== undefined && value !== "";
+  const displayValue = copyable ? value : "-";
+  const accessibleLabel = copyLabel || label || "ID";
+
+  async function handleCopy(event: React.MouseEvent<HTMLButtonElement>) {
+    event.preventDefault();
+    event.stopPropagation();
+    try {
+      await copyToClipboard(displayValue);
+      toast.success(t("common.copied"));
+    } catch {
+      toast.error(t("common.copyFailed"));
+    }
+  }
+
+  return (
+    <div className={cn("flex min-w-0 items-center gap-1.5", className)}>
+      {label ? (
+        <span className="shrink-0 text-muted-foreground">{label}:</span>
+      ) : null}
+      <code
+        className={cn(
+          "min-w-0 flex-1 truncate font-mono text-xs text-foreground",
+          valueClassName,
+        )}
+        title={displayValue}
+      >
+        {displayValue}
+      </code>
+      {copyable ? (
+        <button
+          type="button"
+          onClick={handleCopy}
+          aria-label={`${t("common.copy")} ${accessibleLabel}`}
+          title={`${t("common.copy")} ${accessibleLabel}`}
+          className="inline-flex h-6 w-6 shrink-0 items-center justify-center rounded text-muted-foreground transition-colors hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary/30"
+        >
+          <Copy className="h-3.5 w-3.5" />
+        </button>
+      ) : null}
+    </div>
+  );
+}