npm - @gmickel/gno - Versions diffs - 2.5.1 → 2.7.0 - Mend

@gmickel/gno 2.5.1 → 2.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (160) hide show

package/README.md +60 -5
package/assets/skill/README.md +5 -1
package/assets/skill/SKILL.md +80 -4
package/assets/skill/cli-reference.md +132 -2
package/assets/skill/examples.md +30 -0
package/assets/skill/mcp-reference.md +54 -1
package/assets/skill/recipes/capture-and-file.md +6 -0
package/assets/skill/recipes/memory-file-decision.md +6 -0
package/assets/skill/recipes/memory-supersede-fact.md +5 -0
package/assets/skill/recipes/session-evidence-lookup.md +98 -0
package/assets/spa-production.json.gz +0 -0
package/browser-extension/artifacts/{gno-browser-clipper-v2.5.1.zip → gno-browser-clipper-v2.7.0.zip} +0 -0
package/browser-extension/artifacts/gno-browser-clipper-v2.7.0.zip.sha256 +1 -0
package/browser-extension/dist/manifest.json +1 -1
package/package.json +2 -1
package/spec/cli.md +449 -35
package/spec/mcp.md +234 -4
package/spec/output-schemas/ask.schema.json +1 -1
package/spec/output-schemas/capture-receipt.schema.json +4 -1
package/spec/output-schemas/doctor.schema.json +88 -0
package/spec/output-schemas/error.schema.json +11 -2
package/spec/output-schemas/get.schema.json +1 -1
package/spec/output-schemas/mcp-capture-result.schema.json +4 -2
package/spec/output-schemas/memory-remember.schema.json +10 -4
package/spec/output-schemas/multi-get.schema.json +4 -1
package/spec/output-schemas/peek.schema.json +2 -9
package/spec/output-schemas/request-status.schema.json +113 -0
package/spec/output-schemas/resident-status.schema.json +22 -0
package/spec/output-schemas/search-result.schema.json +1 -1
package/spec/output-schemas/search-results.schema.json +1 -1
package/spec/output-schemas/sessions-automation-run.schema.json +46 -0
package/spec/output-schemas/sessions-discovery.schema.json +38 -0
package/spec/output-schemas/sessions-import-receipt.schema.json +156 -0
package/spec/output-schemas/sessions-status.schema.json +432 -0
package/spec/output-schemas/status.schema.json +98 -0
package/src/cli/commands/ask.ts +14 -2
package/src/cli/commands/capture.ts +55 -96
package/src/cli/commands/daemon.ts +41 -0
package/src/cli/commands/doctor.ts +54 -20
package/src/cli/commands/embed.ts +41 -3
package/src/cli/commands/ls.ts +3 -0
package/src/cli/commands/memory.ts +12 -3
package/src/cli/commands/query.ts +5 -0
package/src/cli/commands/request-status.ts +59 -0
package/src/cli/commands/reset.ts +39 -5
package/src/cli/commands/sessions.ts +713 -0
package/src/cli/commands/shared.ts +14 -1
package/src/cli/commands/status.ts +63 -5
package/src/cli/commands/vec.ts +54 -0
package/src/cli/detach.ts +29 -1
package/src/cli/errors.ts +13 -9
package/src/cli/program.ts +441 -2
package/src/cli/session-binding.ts +49 -0
package/src/config/types.ts +8 -0
package/src/core/capture-publish.ts +239 -0
package/src/core/capture-sync.ts +12 -2
package/src/core/host-paths.ts +31 -0
package/src/core/memory-remember.ts +234 -122
package/src/core/memory-types.ts +11 -0
package/src/core/network-boundary-inventory.ts +8 -0
package/src/core/request-receipts.ts +671 -0
package/src/core/shutdown-budget.ts +6 -0
package/src/core/vector-partition-status.ts +52 -0
package/src/embed/backlog.ts +124 -18
package/src/embed/fingerprint.ts +6 -3
package/src/embed/retry.ts +66 -27
package/src/embed/variant-backlog.ts +15 -10
package/src/embed/variant-retry.ts +31 -22
package/src/index.ts +30 -2
package/src/llm/native-worker/dispatcher.ts +2 -0
package/src/llm/native-worker/embedding-identity.ts +42 -0
package/src/llm/native-worker/protocol.ts +1 -0
package/src/llm/types.ts +3 -0
package/src/mcp/context.ts +17 -0
package/src/mcp/http-egress.ts +4 -0
package/src/mcp/http-transport.ts +2 -0
package/src/mcp/resources/index.ts +6 -5
package/src/mcp/tool-descriptions-core.ts +1 -1
package/src/mcp/tools/capture.ts +87 -85
package/src/mcp/tools/index.ts +77 -4
package/src/mcp/tools/memory-remember.ts +8 -1
package/src/mcp/tools/memory-shared.ts +7 -1
package/src/mcp/tools/request-status.ts +73 -0
package/src/mcp/tools/sessions.ts +208 -0
package/src/mcp/tools/status.ts +4 -0
package/src/pipeline/hybrid.ts +37 -7
package/src/pipeline/vsearch.ts +14 -2
package/src/sdk/client.ts +180 -84
package/src/sdk/index.ts +6 -0
package/src/sdk/types.ts +54 -2
package/src/serve/capture-service.ts +98 -32
package/src/serve/config-sync.ts +3 -2
package/src/serve/embed-scheduler.ts +133 -19
package/src/serve/host-path-redaction.ts +79 -0
package/src/serve/public/app.tsx +4 -1
package/src/serve/public/components/CaptureModal.tsx +26 -8
package/src/serve/public/components/sessions/AutomationPanel.tsx +800 -0
package/src/serve/public/components/sessions/ImportReceipt.tsx +238 -0
package/src/serve/public/components/sessions/SessionSearch.tsx +286 -0
package/src/serve/public/components/sessions/SourcesPanel.tsx +541 -0
package/src/serve/public/components/sessions/api.ts +40 -0
package/src/serve/public/globals.built.css +1 -1
package/src/serve/public/hooks/use-api.ts +26 -3
package/src/serve/public/lib/request-intent.ts +77 -0
package/src/serve/public/lib/snippet.tsx +52 -0
package/src/serve/public/lib/workspace-actions.ts +12 -1
package/src/serve/public/lib/workspace-tabs.ts +2 -0
package/src/serve/public/pages/Dashboard.tsx +22 -9
package/src/serve/public/pages/DocView.tsx +25 -6
package/src/serve/public/pages/DocumentEditor.tsx +224 -104
package/src/serve/public/pages/Search.tsx +1 -41
package/src/serve/public/pages/Sessions.tsx +350 -0
package/src/serve/resident-runtime.ts +69 -4
package/src/serve/resident-status.ts +13 -1
package/src/serve/routes/api.ts +476 -147
package/src/serve/routes/sessions.ts +766 -0
package/src/serve/security.ts +9 -0
package/src/serve/server.ts +215 -10
package/src/serve/session-automation.ts +146 -0
package/src/serve/status-model.ts +16 -0
package/src/serve/status.ts +2 -0
package/src/serve/watch-reconciliation-shared.ts +3 -0
package/src/serve/watch-service-events.ts +3 -2
package/src/serve/watch-service-run-flush.ts +35 -2
package/src/serve/watch-service.ts +5 -0
package/src/sessions/archive.ts +348 -0
package/src/sessions/automation-state.ts +444 -0
package/src/sessions/automation-status.ts +239 -0
package/src/sessions/automation.ts +1169 -0
package/src/sessions/binding.ts +105 -0
package/src/sessions/claude-hook.ts +240 -0
package/src/sessions/config.ts +176 -0
package/src/sessions/format.ts +191 -0
package/src/sessions/import-child-env.ts +8 -0
package/src/sessions/import-child.ts +152 -0
package/src/sessions/parsers/claude-code.ts +259 -0
package/src/sessions/parsers/codex.ts +303 -0
package/src/sessions/parsers/hermes.ts +248 -0
package/src/sessions/parsers/openclaw.ts +496 -0
package/src/sessions/parsers/shared.ts +184 -0
package/src/sessions/sanitize.ts +222 -0
package/src/sessions/service.ts +1533 -0
package/src/sessions/setup.ts +477 -0
package/src/sessions/sources.ts +518 -0
package/src/sessions/state.ts +118 -0
package/src/sessions/types.ts +457 -0
package/src/store/migrations/031-runtime-independent-vectors.ts +29 -0
package/src/store/migrations/032-vector-runtime-callers.ts +17 -0
package/src/store/migrations/index.ts +4 -0
package/src/store/sqlite/adapter.ts +76 -16
package/src/store/sqlite/scoped-index.ts +9 -0
package/src/store/types.ts +11 -1
package/src/store/vector/lazy.ts +46 -43
package/src/store/vector/runtime-compat.ts +651 -0
package/src/store/vector/sqlite-vec.ts +20 -2
package/src/store/vector/status.ts +276 -35
package/src/store/vector/types.ts +2 -0
package/src/store/vector/variant-search.ts +71 -23
package/src/store/vector/variants.ts +49 -14
package/browser-extension/artifacts/gno-browser-clipper-v2.5.1.zip.sha256 +0 -1

package/src/serve/public/components/sessions/SourcesPanel.tsx ADDED Viewed

@@ -0,0 +1,541 @@
+import {
+  DownloadIcon,
+  EyeIcon,
+  Loader2Icon,
+  RadarIcon,
+  Trash2Icon,
+} from "lucide-react";
+import { type FormEvent, useEffect, useId, useRef, useState } from "react";
+import type {
+  SessionDiscoveryCandidate,
+  SessionImportReceipt,
+  SessionsDiscovery,
+  SessionSourceStatus,
+} from "./api";
+import { SESSION_HARNESS_LABELS } from "../../../../sessions/types";
+import { Badge } from "../ui/badge";
+import { Button } from "../ui/button";
+import { Input } from "../ui/input";
+import { sessionsApi } from "./api";
+import { ImportReceipt } from "./ImportReceipt";
+const SOURCE_ID_PATTERN = "[a-z0-9][a-z0-9_-]{0,63}";
+/** Select value for "type a collection name that does not exist yet". */
+const NEW_COLLECTION = "__new__";
+const SELECT_CLASS =
+  "h-9 w-full min-w-0 rounded-md border border-input bg-background px-2 text-sm outline-none focus-visible:ring-2 focus-visible:ring-ring/50";
+const FOCUS_RING =
+  "outline-none focus-visible:ring-2 focus-visible:ring-ring/50";
+/**
+ * Focus `ref` whenever `trigger` changes to a new truthy value after mount.
+ * Buttons disable while their request runs, which drops keyboard focus to
+ * <body>; this hands it to the region that reports the outcome instead.
+ */
+function useFocusOnChange<T>(
+  trigger: T,
+  ref: { current: HTMLElement | null }
+): void {
+  const previous = useRef(trigger);
+  useEffect(() => {
+    if (trigger && trigger !== previous.current) ref.current?.focus();
+    previous.current = trigger;
+  }, [trigger, ref]);
+}
+function formatWhen(iso: string | null): string {
+  if (!iso) return "never";
+  const date = new Date(iso);
+  return Number.isNaN(date.getTime()) ? iso : date.toLocaleString();
+}
+function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/** Parse "prefix=collection" lines into project mappings. */
+export function parseProjectLines(
+  text: string
+): Array<{ prefix: string; collection: string }> | string {
+  const mappings: Array<{ prefix: string; collection: string }> = [];
+  for (const raw of text.split("\n")) {
+    const line = raw.trim();
+    if (!line) continue;
+    const split = line.lastIndexOf("=");
+    const prefix = split > 0 ? line.slice(0, split).trim() : "";
+    const collection = split > 0 ? line.slice(split + 1).trim() : "";
+    if (!(prefix && collection)) {
+      return `Project mapping "${line}" must look like /absolute/prefix=collection`;
+    }
+    mappings.push({ prefix, collection });
+  }
+  return mappings;
+}
+interface SourceRowProps {
+  source: SessionSourceStatus;
+  localClient: boolean;
+  busy: string | null;
+  receipt: SessionImportReceipt | undefined;
+  onImport: (sourceId: string, dryRun: boolean) => void;
+  onRemove: (sourceId: string) => void;
+}
+function SourceRow({
+  source,
+  localClient,
+  busy,
+  receipt,
+  onImport,
+  onRemove,
+}: SourceRowProps) {
+  const [confirmRemove, setConfirmRemove] = useState(false);
+  const receiptRef = useRef<HTMLElement>(null);
+  useFocusOnChange(receipt, receiptRef);
+  const running = busy?.startsWith(`${source.id}:`) ?? false;
+  const { units } = source;
+  return (
+    <li className="min-w-0 space-y-3 rounded-lg border border-border/60 p-4">
+      <div className="flex flex-wrap items-start justify-between gap-3">
+        <div className="min-w-0 space-y-1">
+          <div className="flex flex-wrap items-center gap-2">
+            <h3 className="break-all font-mono font-semibold">{source.id}</h3>
+            <Badge variant="secondary">
+              {SESSION_HARNESS_LABELS[source.harness]}
+            </Badge>
+            {source.available ? (
+              <Badge variant="outline">available</Badge>
+            ) : (
+              <Badge variant="destructive">unavailable — archive kept</Badge>
+            )}
+          </div>
+          <p className="text-muted-foreground text-sm">
+            → collection{" "}
+            <span className="font-mono text-foreground">
+              {source.collection}
+            </span>{" "}
+            · last import {formatWhen(source.lastImportAt)}
+          </p>
+          <p className="text-muted-foreground text-xs">
+            Units: {units.total} total · {units.complete} complete ·{" "}
+            <span
+              className={
+                units.incomplete > 0 ? "text-amber-700 dark:text-amber-300" : ""
+              }
+            >
+              {units.incomplete} incomplete
+            </span>{" "}
+            ·{" "}
+            <span className={units.failed > 0 ? "text-destructive" : ""}>
+              {units.failed} failed
+            </span>{" "}
+            · {units.pending} pending · {source.archivedThreads} archived
+            threads
+          </p>
+        </div>
+        <div className="flex flex-wrap gap-2">
+          <Button
+            aria-label={`Preview import of ${source.id} (dry run)`}
+            disabled={busy !== null || !source.available}
+            onClick={() => onImport(source.id, true)}
+            size="sm"
+            variant="outline"
+          >
+            {busy === `${source.id}:preview` ? (
+              <Loader2Icon className="animate-spin" />
+            ) : (
+              <EyeIcon />
+            )}
+            Preview (dry run)
+          </Button>
+          <Button
+            aria-label={`Import ${source.id}`}
+            disabled={busy !== null || !source.available}
+            onClick={() => onImport(source.id, false)}
+            size="sm"
+          >
+            {busy === `${source.id}:import` ? (
+              <Loader2Icon className="animate-spin" />
+            ) : (
+              <DownloadIcon />
+            )}
+            Import
+          </Button>
+          {localClient &&
+            (confirmRemove ? (
+              <>
+                <Button
+                  disabled={running}
+                  onClick={() => onRemove(source.id)}
+                  size="sm"
+                  variant="destructive"
+                >
+                  Confirm remove
+                </Button>
+                <Button
+                  onClick={() => setConfirmRemove(false)}
+                  size="sm"
+                  variant="ghost"
+                >
+                  Cancel
+                </Button>
+              </>
+            ) : (
+              <Button
+                aria-label={`Remove source ${source.id}`}
+                disabled={busy !== null}
+                onClick={() => setConfirmRemove(true)}
+                size="sm"
+                variant="ghost"
+              >
+                <Trash2Icon />
+                Remove
+              </Button>
+            ))}
+        </div>
+      </div>
+      {confirmRemove && (
+        <p className="text-muted-foreground text-xs">
+          Removing unregisters the source. Its archived sessions stay in the
+          archive and index.
+        </p>
+      )}
+      {receipt && <ImportReceipt receipt={receipt} ref={receiptRef} />}
+    </li>
+  );
+}
+interface RegisterFormProps {
+  candidate: SessionDiscoveryCandidate;
+  archiveCollections: string[];
+  onRegistered: (sourceId: string, collection: string) => Promise<void>;
+}
+function RegisterForm({
+  candidate,
+  archiveCollections,
+  onRegistered,
+}: RegisterFormProps) {
+  const formId = useId();
+  const [id, setId] = useState(`${candidate.harness}-main`);
+  // No default: the destination collection is a privacy boundary, so the
+  // user must pick it explicitly.
+  const [collectionChoice, setCollectionChoice] = useState("");
+  const [newCollection, setNewCollection] = useState("");
+  const [projects, setProjects] = useState("");
+  const [error, setError] = useState<{ text: string } | null>(null);
+  const [saving, setSaving] = useState(false);
+  const errorRef = useRef<HTMLParagraphElement>(null);
+  useFocusOnChange(error, errorRef);
+  const creatingCollection = collectionChoice === NEW_COLLECTION;
+  const collection = creatingCollection
+    ? newCollection.trim()
+    : collectionChoice;
+  const hintId = `${formId}-collection-hint`;
+  const submit = async (event: FormEvent<HTMLFormElement>) => {
+    event.preventDefault();
+    if (!collection) {
+      setError({ text: "Choose a destination archive collection." });
+      return;
+    }
+    const mappings = parseProjectLines(projects);
+    if (typeof mappings === "string") {
+      setError({ text: mappings });
+      return;
+    }
+    setSaving(true);
+    const result = await sessionsApi("/api/sessions/sources", {
+      method: "POST",
+      body: JSON.stringify({
+        id: id.trim(),
+        harness: candidate.harness,
+        path: candidate.path,
+        collection,
+        ...(mappings.length > 0 ? { projects: mappings } : {}),
+      }),
+    });
+    setSaving(false);
+    if (result.error) {
+      setError({ text: result.error });
+      return;
+    }
+    setError(null);
+    await onRegistered(id.trim(), collection);
+  };
+  return (
+    <form
+      aria-label={`Register ${SESSION_HARNESS_LABELS[candidate.harness]} source`}
+      className="grid gap-3 sm:grid-cols-2"
+      onSubmit={(event) => void submit(event)}
+    >
+      <label className="grid gap-1 text-sm" htmlFor={`${formId}-id`}>
+        Source ID
+        <Input
+          id={`${formId}-id`}
+          onChange={(event) => setId(event.currentTarget.value)}
+          pattern={SOURCE_ID_PATTERN}
+          required
+          value={id}
+        />
+      </label>
+      <label className="grid gap-1 text-sm" htmlFor={`${formId}-collection`}>
+        Destination archive collection
+        <select
+          aria-describedby={collection ? undefined : hintId}
+          className={SELECT_CLASS}
+          id={`${formId}-collection`}
+          onChange={(event) => setCollectionChoice(event.currentTarget.value)}
+          required
+          value={collectionChoice}
+        >
+          <option disabled value="">
+            Choose a collection…
+          </option>
+          {archiveCollections.map((name) => (
+            <option key={name} value={name}>
+              {name}
+            </option>
+          ))}
+          <option value={NEW_COLLECTION}>New collection…</option>
+        </select>
+      </label>
+      {creatingCollection && (
+        <label
+          className="grid gap-1 text-sm sm:col-start-2"
+          htmlFor={`${formId}-new-collection`}
+        >
+          New collection name
+          <Input
+            id={`${formId}-new-collection`}
+            onChange={(event) => setNewCollection(event.currentTarget.value)}
+            pattern={SOURCE_ID_PATTERN}
+            required
+            value={newCollection}
+          />
+        </label>
+      )}
+      <label
+        className="grid gap-1 text-sm sm:col-span-2"
+        htmlFor={`${formId}-projects`}
+      >
+        Project mappings (optional, one per line: /absolute/prefix=collection)
+        <textarea
+          className="min-h-16 w-full min-w-0 rounded-md border border-input bg-transparent px-3 py-2 font-mono text-xs outline-none focus-visible:ring-2 focus-visible:ring-ring/50"
+          id={`${formId}-projects`}
+          onChange={(event) => setProjects(event.currentTarget.value)}
+          value={projects}
+        />
+      </label>
+      {error && (
+        <p
+          className={`break-words text-destructive text-sm sm:col-span-2 ${FOCUS_RING}`}
+          ref={errorRef}
+          role="alert"
+          tabIndex={-1}
+        >
+          {error.text}
+        </p>
+      )}
+      <div className="sm:col-span-2">
+        <Button
+          aria-describedby={collection ? undefined : hintId}
+          disabled={saving || !collection}
+          size="sm"
+          type="submit"
+        >
+          {saving && <Loader2Icon className="animate-spin" />}
+          Register source
+        </Button>
+        <span className="ml-2 text-muted-foreground text-xs">
+          Registering imports nothing.
+        </span>
+        {!collection && (
+          <p className="mt-1 text-muted-foreground text-xs" id={hintId}>
+            Choose a destination collection to register this source. Its
+            sessions become searchable only in that collection.
+          </p>
+        )}
+      </div>
+    </form>
+  );
+}
+interface SourcesPanelProps {
+  sources: SessionSourceStatus[];
+  archiveCollections: string[];
+  localClient: boolean;
+  busy: string | null;
+  receipts: Record<string, SessionImportReceipt>;
+  onImport: (sourceId: string, dryRun: boolean) => void;
+  onRemove: (sourceId: string) => void;
+  onChanged: () => Promise<void>;
+}
+export function SourcesPanel({
+  sources,
+  archiveCollections,
+  localClient,
+  busy,
+  receipts,
+  onImport,
+  onRemove,
+  onChanged,
+}: SourcesPanelProps) {
+  const [discovery, setDiscovery] = useState<SessionsDiscovery | null>(null);
+  const [discovering, setDiscovering] = useState(false);
+  const [discoverError, setDiscoverError] = useState<string | null>(null);
+  const [notice, setNotice] = useState<{ text: string } | null>(null);
+  const noticeRef = useRef<HTMLParagraphElement>(null);
+  useFocusOnChange(notice, noticeRef);
+  const discover = async () => {
+    setDiscovering(true);
+    const result = await sessionsApi<SessionsDiscovery>(
+      "/api/sessions/discover"
+    );
+    setDiscovering(false);
+    setDiscoverError(result.error);
+    setDiscovery(result.data);
+  };
+  const registered = async (sourceId: string, collection: string) => {
+    setNotice({
+      text: `Registered source ${sourceId} → collection ${collection}. Nothing was imported yet.`,
+    });
+    await onChanged();
+    await discover();
+  };
+  return (
+    <section
+      aria-labelledby="sessions-sources-heading"
+      className="min-w-0 space-y-4"
+    >
+      <div className="flex flex-wrap items-center justify-between gap-3">
+        <h2 className="font-semibold text-xl" id="sessions-sources-heading">
+          Sources
+        </h2>
+        {localClient && (
+          <Button
+            disabled={discovering}
+            onClick={() => void discover()}
+            size="sm"
+            variant="outline"
+          >
+            {discovering ? (
+              <Loader2Icon className="animate-spin" />
+            ) : (
+              <RadarIcon />
+            )}
+            Discover local sources
+          </Button>
+        )}
+      </div>
+      {sources.length === 0 ? (
+        <p className="text-muted-foreground text-sm">
+          No sources registered yet.{" "}
+          {localClient
+            ? "Discover local sources and register the ones you permit."
+            : "Sources can only be registered from a browser on this machine."}
+        </p>
+      ) : (
+        <ul className="space-y-3">
+          {sources.map((source) => (
+            <SourceRow
+              busy={busy}
+              key={source.id}
+              localClient={localClient}
+              onImport={onImport}
+              onRemove={onRemove}
+              receipt={receipts[source.id]}
+              source={source}
+            />
+          ))}
+        </ul>
+      )}
+      {notice && (
+        <p
+          className={`break-words rounded-md border border-emerald-500/40 bg-emerald-500/10 px-3 py-2 text-emerald-700 text-sm dark:text-emerald-300 ${FOCUS_RING}`}
+          ref={noticeRef}
+          role="status"
+          tabIndex={-1}
+        >
+          {notice.text}
+        </p>
+      )}
+      {discoverError && (
+        <p className="break-words text-destructive text-sm" role="alert">
+          {discoverError}
+        </p>
+      )}
+      {discovery && (
+        <div className="space-y-3 rounded-lg border border-dashed border-border/70 p-4">
+          <h3 className="font-medium">Discovered on this machine</h3>
+          <p className="text-muted-foreground text-xs">
+            Preview only: discovery reads nothing into the archive. Register a
+            source to permit manual imports from it.
+          </p>
+          {discovery.candidates.length === 0 && (
+            <p className="text-muted-foreground text-sm">
+              No supported session stores were found.
+            </p>
+          )}
+          <ul className="space-y-4">
+            {discovery.candidates.map((candidate) => (
+              <li
+                className="min-w-0 space-y-2"
+                key={`${candidate.harness}:${candidate.path}`}
+              >
+                <div className="flex flex-wrap items-center gap-2">
+                  <Badge variant="secondary">
+                    {SESSION_HARNESS_LABELS[candidate.harness]}
+                  </Badge>
+                  <span className="min-w-0 break-all font-mono text-xs">
+                    {candidate.path}
+                  </span>
+                </div>
+                <p className="text-muted-foreground text-xs">
+                  {candidate.units}
+                  {candidate.truncated ? "+" : ""} units ·{" "}
+                  {formatBytes(candidate.bytes)}
+                  {candidate.formatVersions.length > 0 &&
+                    ` · format ${candidate.formatVersions.join(", ")}`}
+                </p>
+                {candidate.registeredAs ? (
+                  <p className="text-sm">
+                    Registered as{" "}
+                    <span className="font-mono">{candidate.registeredAs}</span>
+                  </p>
+                ) : (
+                  <RegisterForm
+                    candidate={candidate}
+                    archiveCollections={archiveCollections}
+                    onRegistered={registered}
+                  />
+                )}
+              </li>
+            ))}
+          </ul>
+          {discovery.warnings.map((warning) => (
+            <p
+              className="text-amber-800 text-xs dark:text-amber-200"
+              key={warning}
+            >
+              {warning}
+            </p>
+          ))}
+        </div>
+      )}
+    </section>
+  );
+}

package/src/serve/public/components/sessions/api.ts ADDED Viewed

@@ -0,0 +1,40 @@
+/**
+ * Client helpers for /api/sessions/*: failures keep the stable
+ * `details.sessionsCode` so the page can branch on it (e.g. show the archive
+ * setup state for SESSIONS_NOT_CONFIGURED).
+ */
+import { apiFetch } from "../../hooks/use-api";
+export type {
+  SessionAutomationRunResult,
+  SessionAutomationStatus,
+  SessionDiscoveryCandidate,
+  SessionProfileStatus,
+  SessionHarness,
+  SessionImportReceipt,
+  SessionsDiscovery,
+  SessionSourceStatus,
+  SessionsStatus,
+  SessionUnitReceipt,
+} from "../../../../sessions/types";
+export interface SessionsApiResult<T> {
+  data: T | null;
+  error: string | null;
+  sessionsCode: string | null;
+}
+/** apiFetch plus the stable `details.sessionsCode` of a failed request. */
+export async function sessionsApi<T>(
+  endpoint: string,
+  init?: RequestInit
+): Promise<SessionsApiResult<T>> {
+  const result = await apiFetch<T>(endpoint, init);
+  const code = result.details?.sessionsCode;
+  return {
+    data: result.data,
+    error: result.error,
+    sessionsCode: typeof code === "string" ? code : null,
+  };
+}