@arbidocs/react 0.5.111 → 0.5.112

package/dist/datasets/sources/workflows.js

@@ -0,0 +1,91 @@
+import { useMemo } from "react";
+import { useFeature } from "../../host/features.js";
+import { useArbiSessionState } from "../../session/index.js";
+import { useWorkflows } from "../../workforce.js";
+import { useNames } from "../members.js";
+import { defineRowsSource, staticFields } from "../rows-source.js";
+const DEFAULT_WORKFLOWS_SOURCE_LABELS = {
+  source: "Workflows",
+  description: "Your workflows: what starts them, how their last run ended, and when they run next.",
+  name: "Workflow",
+  trigger: "Starts",
+  triggers: {
+    manual: "By hand",
+    after: "After a task",
+    event: "On an event",
+    schedule: "On a schedule",
+    once: "Once"
+  },
+  active: "On",
+  lastRun: "Last run",
+  lastResult: "Last result",
+  results: {
+    completed: "Success",
+    success: "Success",
+    failed: "Failed",
+    running: "In progress",
+    awaiting_authorization: "Awaiting access"
+  },
+  nextRun: "Next run",
+  owner: "Owner",
+  shared: "Shared",
+  created: "Created"
+};
+function triggerOf(w) {
+  if (w.on_demand) return "manual";
+  if (w.after_conversation_ext_id) return "after";
+  if (w.event_kind) return "event";
+  if (w.rrule) return "schedule";
+  if (w.run_at) return "once";
+  return "manual";
+}
+function createWorkflowsSource(labels) {
+  const l = { ...DEFAULT_WORKFLOWS_SOURCE_LABELS, ...labels };
+  const fields = [
+    { id: "name", label: l.name, type: "string" },
+    { id: "trigger", label: l.trigger, type: "string", options: Object.values(l.triggers) },
+    { id: "active", label: l.active, type: "boolean" },
+    { id: "lastRun", label: l.lastRun, type: "date" },
+    { id: "lastResult", label: l.lastResult, type: "string" },
+    { id: "nextRun", label: l.nextRun, type: "date" },
+    { id: "owner", label: l.owner, type: "string" },
+    { id: "shared", label: l.shared, type: "boolean" },
+    { id: "created", label: l.created, type: "date" }
+  ];
+  return defineRowsSource({
+    id: "workflows",
+    scope: "workspace",
+    label: l.source,
+    description: l.description,
+    useFields: staticFields(fields),
+    useRows(_params, enabled) {
+      const on = useFeature("workflows");
+      const workspaceId = useArbiSessionState((s) => s.workspaceId);
+      const query = useWorkflows({ enabled: enabled && on });
+      const nameOf = useNames(enabled);
+      const rows = useMemo(
+        () => query.data?.filter((w) => !!workspaceId && w.workspace_ext_id === workspaceId).map((w) => {
+          const result = w.last_run_status;
+          return {
+            name: w.name,
+            trigger: l.triggers[triggerOf(w)],
+            active: w.active,
+            lastRun: w.last_fired_at ?? null,
+            lastResult: result ? l.results[result] ?? result.replaceAll("_", " ") : null,
+            nextRun: w.next_fire_at ?? null,
+            owner: nameOf(w.owner_ext_id),
+            shared: w.shared,
+            created: w.created_at
+          };
+        }),
+        [query.data, nameOf, workspaceId]
+      );
+      return { rows, isLoading: query.isLoading, error: query.error };
+    }
+  });
+}
+export {
+  DEFAULT_WORKFLOWS_SOURCE_LABELS,
+  createWorkflowsSource
+};
+//# sourceMappingURL=workflows.js.map

package/dist/datasets/sources/workflows.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/datasets/sources/workflows.ts"],
+  "sourcesContent": ["/**\n * The open workspace's workflows as a dataset: a row per workflow with what starts it, whether it\n * is on, how its last run ended and when it runs next. Reads the shared workflow list\n * (`useWorkflows`), keeping the workflows of the open workspace, so the figures match its\n * activity (a workflow's runs over time are the activity source's `workflow` entries). Nothing is\n * read while the host's `workflows` feature is off.\n */\nimport { useMemo } from 'react'\nimport type { WorkflowResponse } from '@arbidocs/sdk/browser'\nimport { useFeature } from '../../host/features'\nimport { useArbiSessionState } from '../../session'\nimport { useWorkflows } from '../../workforce'\nimport { useNames } from '../members'\nimport { defineRowsSource, staticFields } from '../rows-source'\nimport type { DataSource, DatasetField, DatasetRow } from '../types'\n\ntype Trigger = 'manual' | 'after' | 'event' | 'schedule' | 'once'\n\nexport interface WorkflowsSourceLabels {\n  source: string\n  description: string\n  name: string\n  trigger: string\n  triggers: Record<Trigger, string>\n  active: string\n  lastRun: string\n  lastResult: string\n  /** A last run status by the server's name; one not listed is shown as it comes. */\n  results: Readonly<Record<string, string>>\n  nextRun: string\n  owner: string\n  shared: string\n  created: string\n}\n\nexport const DEFAULT_WORKFLOWS_SOURCE_LABELS: WorkflowsSourceLabels = {\n  source: 'Workflows',\n  description:\n    'Your workflows: what starts them, how their last run ended, and when they run next.',\n  name: 'Workflow',\n  trigger: 'Starts',\n  triggers: {\n    manual: 'By hand',\n    after: 'After a task',\n    event: 'On an event',\n    schedule: 'On a schedule',\n    once: 'Once',\n  },\n  active: 'On',\n  lastRun: 'Last run',\n  lastResult: 'Last result',\n  results: {\n    completed: 'Success',\n    success: 'Success',\n    failed: 'Failed',\n    running: 'In progress',\n    awaiting_authorization: 'Awaiting access',\n  },\n  nextRun: 'Next run',\n  owner: 'Owner',\n  shared: 'Shared',\n  created: 'Created',\n}\n\nfunction triggerOf(w: WorkflowResponse): Trigger {\n  if (w.on_demand) return 'manual'\n  if (w.after_conversation_ext_id) return 'after'\n  if (w.event_kind) return 'event'\n  if (w.rrule) return 'schedule'\n  if (w.run_at) return 'once'\n  return 'manual'\n}\n\nexport function createWorkflowsSource(labels?: Partial<WorkflowsSourceLabels>): DataSource {\n  const l = { ...DEFAULT_WORKFLOWS_SOURCE_LABELS, ...labels }\n  const fields: DatasetField[] = [\n    { id: 'name', label: l.name, type: 'string' },\n    { id: 'trigger', label: l.trigger, type: 'string', options: Object.values(l.triggers) },\n    { id: 'active', label: l.active, type: 'boolean' },\n    { id: 'lastRun', label: l.lastRun, type: 'date' },\n    { id: 'lastResult', label: l.lastResult, type: 'string' },\n    { id: 'nextRun', label: l.nextRun, type: 'date' },\n    { id: 'owner', label: l.owner, type: 'string' },\n    { id: 'shared', label: l.shared, type: 'boolean' },\n    { id: 'created', label: l.created, type: 'date' },\n  ]\n  return defineRowsSource({\n    id: 'workflows',\n    scope: 'workspace',\n    label: l.source,\n    description: l.description,\n    useFields: staticFields(fields),\n    useRows(_params, enabled) {\n      const on = useFeature('workflows')\n      const workspaceId = useArbiSessionState((s) => s.workspaceId)\n      const query = useWorkflows({ enabled: enabled && on })\n      const nameOf = useNames(enabled)\n      const rows = useMemo(\n        () =>\n          query.data\n            ?.filter((w) => !!workspaceId && w.workspace_ext_id === workspaceId)\n            .map((w): DatasetRow => {\n              const result = w.last_run_status\n              return {\n                name: w.name,\n                trigger: l.triggers[triggerOf(w)],\n                active: w.active,\n                lastRun: w.last_fired_at ?? null,\n                lastResult: result ? (l.results[result] ?? result.replaceAll('_', ' ')) : null,\n                nextRun: w.next_fire_at ?? null,\n                owner: nameOf(w.owner_ext_id),\n                shared: w.shared,\n                created: w.created_at,\n              }\n            }),\n        [query.data, nameOf, workspaceId]\n      )\n      return { rows, isLoading: query.isLoading, error: query.error }\n    },\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/datasets/sources/workspaces.js

@@ -0,0 +1,67 @@
+import { useMemo } from "react";
+import { useProjects, useWorkspaces } from "../../hooks.js";
+import { defineRowsSource, staticFields } from "../rows-source.js";
+const DEFAULT_WORKSPACES_SOURCE_LABELS = {
+  source: "Workspaces",
+  description: "Your workspaces: their project, documents, threads, members and storage.",
+  name: "Workspace",
+  project: "Project",
+  documents: "Documents",
+  threads: "Threads",
+  members: "Members",
+  storage: "Storage (MB)",
+  created: "Created",
+  updated: "Updated",
+  shared: "Public"
+};
+function createWorkspacesSource(labels) {
+  const l = { ...DEFAULT_WORKSPACES_SOURCE_LABELS, ...labels };
+  const fields = [
+    { id: "name", label: l.name, type: "string" },
+    { id: "project", label: l.project, type: "string" },
+    { id: "documents", label: l.documents, type: "number" },
+    { id: "threads", label: l.threads, type: "number" },
+    { id: "members", label: l.members, type: "number" },
+    { id: "storage", label: l.storage, type: "number", unit: "MB" },
+    { id: "created", label: l.created, type: "date" },
+    { id: "updated", label: l.updated, type: "date" },
+    { id: "shared", label: l.shared, type: "boolean" }
+  ];
+  return defineRowsSource({
+    id: "workspaces",
+    label: l.source,
+    description: l.description,
+    useFields: staticFields(fields),
+    useRows(_params, enabled) {
+      const workspaces = useWorkspaces({ enabled });
+      const projects = useProjects({ enabled });
+      const rows = useMemo(() => {
+        const list = workspaces.data;
+        if (!list) return void 0;
+        const projectNames = new Map(
+          (projects.data ?? []).map((p) => [
+            p.external_id,
+            p.name
+          ])
+        );
+        return list.map((w) => ({
+          name: w.name,
+          project: w.project_ext_id ? projectNames.get(w.project_ext_id) ?? null : null,
+          documents: (w.shared_document_count ?? 0) + (w.private_document_count ?? 0),
+          threads: (w.shared_conversation_count ?? 0) + (w.private_conversation_count ?? 0),
+          members: w.users?.length ?? 0,
+          storage: Math.round((w.user_files_mb ?? 0) * 10) / 10,
+          created: w.created_at ?? null,
+          updated: w.updated_at ?? null,
+          shared: w.is_public ?? null
+        }));
+      }, [workspaces.data, projects.data]);
+      return { rows, isLoading: workspaces.isLoading, error: workspaces.error };
+    }
+  });
+}
+export {
+  DEFAULT_WORKSPACES_SOURCE_LABELS,
+  createWorkspacesSource
+};
+//# sourceMappingURL=workspaces.js.map

package/dist/datasets/sources/workspaces.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/datasets/sources/workspaces.ts"],
+  "sourcesContent": ["/**\n * The workspaces the user can see as a dataset: a row per workspace with its project, how many\n * documents, threads and members it has, and its stored files. Documents or storage by workspace or\n * by project are a group-by and a sum away. Reads the shared lists (`useWorkspaces`, `useProjects`).\n */\nimport { useMemo } from 'react'\nimport { useProjects, useWorkspaces } from '../../hooks'\nimport { defineRowsSource, staticFields } from '../rows-source'\nimport type { DataSource, DatasetField, DatasetRow } from '../types'\n\nexport interface WorkspacesSourceLabels {\n  source: string\n  description: string\n  name: string\n  project: string\n  documents: string\n  threads: string\n  members: string\n  storage: string\n  created: string\n  updated: string\n  shared: string\n}\n\nexport const DEFAULT_WORKSPACES_SOURCE_LABELS: WorkspacesSourceLabels = {\n  source: 'Workspaces',\n  description: 'Your workspaces: their project, documents, threads, members and storage.',\n  name: 'Workspace',\n  project: 'Project',\n  documents: 'Documents',\n  threads: 'Threads',\n  members: 'Members',\n  storage: 'Storage (MB)',\n  created: 'Created',\n  updated: 'Updated',\n  shared: 'Public',\n}\n\ninterface WorkspaceLike {\n  external_id: string\n  name: string\n  project_ext_id?: string | null\n  shared_document_count?: number | null\n  private_document_count?: number | null\n  shared_conversation_count?: number | null\n  private_conversation_count?: number | null\n  users?: unknown[] | null\n  user_files_mb?: number | null\n  created_at?: string | null\n  updated_at?: string | null\n  is_public?: boolean | null\n}\n\nexport function createWorkspacesSource(labels?: Partial<WorkspacesSourceLabels>): DataSource {\n  const l = { ...DEFAULT_WORKSPACES_SOURCE_LABELS, ...labels }\n  const fields: DatasetField[] = [\n    { id: 'name', label: l.name, type: 'string' },\n    { id: 'project', label: l.project, type: 'string' },\n    { id: 'documents', label: l.documents, type: 'number' },\n    { id: 'threads', label: l.threads, type: 'number' },\n    { id: 'members', label: l.members, type: 'number' },\n    { id: 'storage', label: l.storage, type: 'number', unit: 'MB' },\n    { id: 'created', label: l.created, type: 'date' },\n    { id: 'updated', label: l.updated, type: 'date' },\n    { id: 'shared', label: l.shared, type: 'boolean' },\n  ]\n  return defineRowsSource({\n    id: 'workspaces',\n    label: l.source,\n    description: l.description,\n    useFields: staticFields(fields),\n    useRows(_params, enabled) {\n      const workspaces = useWorkspaces({ enabled })\n      const projects = useProjects({ enabled })\n      const rows = useMemo(() => {\n        const list = workspaces.data as WorkspaceLike[] | undefined\n        if (!list) return undefined\n        const projectNames = new Map(\n          ((projects.data ?? []) as Array<{ external_id: string; name: string }>).map((p) => [\n            p.external_id,\n            p.name,\n          ])\n        )\n        return list.map((w): DatasetRow => ({\n          name: w.name,\n          project: w.project_ext_id ? (projectNames.get(w.project_ext_id) ?? null) : null,\n          documents: (w.shared_document_count ?? 0) + (w.private_document_count ?? 0),\n          threads: (w.shared_conversation_count ?? 0) + (w.private_conversation_count ?? 0),\n          members: w.users?.length ?? 0,\n          storage: Math.round((w.user_files_mb ?? 0) * 10) / 10,\n          created: w.created_at ?? null,\n          updated: w.updated_at ?? null,\n          shared: w.is_public ?? null,\n        }))\n      }, [workspaces.data, projects.data])\n      return { rows, isLoading: workspaces.isLoading, error: workspaces.error }\n    },\n  })\n}\n"],
+  "mappings": "AAKA,SAAS,eAAe;AACxB,SAAS,aAAa,qBAAqB;AAC3C,SAAS,kBAAkB,oBAAoB;AAiBxC,MAAM,mCAA2D;AAAA,EACtE,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,MAAM;AAAA,EACN,SAAS;AAAA,EACT,WAAW;AAAA,EACX,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AACV;AAiBO,SAAS,uBAAuB,QAAsD;AAC3F,QAAM,IAAI,EAAE,GAAG,kCAAkC,GAAG,OAAO;AAC3D,QAAM,SAAyB;AAAA,IAC7B,EAAE,IAAI,QAAQ,OAAO,EAAE,MAAM,MAAM,SAAS;AAAA,IAC5C,EAAE,IAAI,WAAW,OAAO,EAAE,SAAS,MAAM,SAAS;AAAA,IAClD,EAAE,IAAI,aAAa,OAAO,EAAE,WAAW,MAAM,SAAS;AAAA,IACtD,EAAE,IAAI,WAAW,OAAO,EAAE,SAAS,MAAM,SAAS;AAAA,IAClD,EAAE,IAAI,WAAW,OAAO,EAAE,SAAS,MAAM,SAAS;AAAA,IAClD,EAAE,IAAI,WAAW,OAAO,EAAE,SAAS,MAAM,UAAU,MAAM,KAAK;AAAA,IAC9D,EAAE,IAAI,WAAW,OAAO,EAAE,SAAS,MAAM,OAAO;AAAA,IAChD,EAAE,IAAI,WAAW,OAAO,EAAE,SAAS,MAAM,OAAO;AAAA,IAChD,EAAE,IAAI,UAAU,OAAO,EAAE,QAAQ,MAAM,UAAU;AAAA,EACnD;AACA,SAAO,iBAAiB;AAAA,IACtB,IAAI;AAAA,IACJ,OAAO,EAAE;AAAA,IACT,aAAa,EAAE;AAAA,IACf,WAAW,aAAa,MAAM;AAAA,IAC9B,QAAQ,SAAS,SAAS;AACxB,YAAM,aAAa,cAAc,EAAE,QAAQ,CAAC;AAC5C,YAAM,WAAW,YAAY,EAAE,QAAQ,CAAC;AACxC,YAAM,OAAO,QAAQ,MAAM;AACzB,cAAM,OAAO,WAAW;AACxB,YAAI,CAAC,KAAM,QAAO;AAClB,cAAM,eAAe,IAAI;AAAA,WACrB,SAAS,QAAQ,CAAC,GAAoD,IAAI,CAAC,MAAM;AAAA,YACjF,EAAE;AAAA,YACF,EAAE;AAAA,UACJ,CAAC;AAAA,QACH;AACA,eAAO,KAAK,IAAI,CAAC,OAAmB;AAAA,UAClC,MAAM,EAAE;AAAA,UACR,SAAS,EAAE,iBAAkB,aAAa,IAAI,EAAE,cAAc,KAAK,OAAQ;AAAA,UAC3E,YAAY,EAAE,yBAAyB,MAAM,EAAE,0BAA0B;AAAA,UACzE,UAAU,EAAE,6BAA6B,MAAM,EAAE,8BAA8B;AAAA,UAC/E,SAAS,EAAE,OAAO,UAAU;AAAA,UAC5B,SAAS,KAAK,OAAO,EAAE,iBAAiB,KAAK,EAAE,IAAI;AAAA,UACnD,SAAS,EAAE,cAAc;AAAA,UACzB,SAAS,EAAE,cAAc;AAAA,UACzB,QAAQ,EAAE,aAAa;AAAA,QACzB,EAAE;AAAA,MACJ,GAAG,CAAC,WAAW,MAAM,SAAS,IAAI,CAAC;AACnC,aAAO,EAAE,MAAM,WAAW,WAAW,WAAW,OAAO,WAAW,MAAM;AAAA,IAC1E;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/datasets/store.js

@@ -0,0 +1,194 @@
+import { useMemo } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useArbiHost } from "../host/config.js";
+import { useArbi } from "../useArbi.js";
+import { arbiQueryKeys } from "../query-keys.js";
+const ANALYTICS_CHART_VIEW = "analytics.chartDatabase";
+const MAX_DASHBOARD_SPEC_CHARS = 1e4;
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+function isPanel(v) {
+  return isObject(v) && typeof v.id === "string" && typeof v.title === "string" && isObject(v.source) && typeof v.source.id === "string" && isObject(v.chart) && typeof v.chart.type === "string";
+}
+function parseDashboardSpec(value) {
+  let parsed = value;
+  if (typeof value === "string") {
+    try {
+      parsed = JSON.parse(value);
+    } catch {
+      return null;
+    }
+  }
+  if (!isObject(parsed) || parsed.version !== 1 || typeof parsed.title !== "string") return null;
+  const panels = Array.isArray(parsed.panels) ? parsed.panels.filter(isPanel) : [];
+  return {
+    version: 1,
+    title: parsed.title,
+    ...typeof parsed.description === "string" ? { description: parsed.description } : {},
+    panels
+  };
+}
+function serializeDashboardSpec(spec, max = MAX_DASHBOARD_SPEC_CHARS) {
+  const json = JSON.stringify(spec);
+  if (json.length > max) {
+    throw new Error(
+      `This dashboard is too large to save (${json.length.toLocaleString("en-GB")} characters, at most ${max.toLocaleString("en-GB")}). Remove a panel or split it into two dashboards.`
+    );
+  }
+  return json;
+}
+function useUserDashboardStore() {
+  const arbi = useArbi();
+  const scope = arbi.isLoggedIn ? arbi.user.identity()?.externalId ?? null : null;
+  return useMemo(
+    () => ({
+      scope: scope && `user:${scope}`,
+      list: async () => (await arbi.dashboards.list()).map(({ id, json, updatedAt }) => {
+        const spec = json === null ? null : parseDashboardSpec(json);
+        return spec ? { id, spec, updatedAt } : {
+          id,
+          spec: { version: 1, title: "", panels: [] },
+          updatedAt,
+          unreadable: true
+        };
+      }),
+      async save({ id, spec }) {
+        const saved = await arbi.dashboards.save({ id, json: serializeDashboardSpec(spec) });
+        return { id: saved.id, spec, updatedAt: saved.updatedAt };
+      },
+      remove: (id) => arbi.dashboards.remove(id)
+    }),
+    [arbi, scope]
+  );
+}
+function createMemoryDashboardStore(initial = [], scope = "memory") {
+  let items = [...initial];
+  let next = items.length + 1;
+  return {
+    scope,
+    list: async () => items.map((d) => ({ ...d })),
+    save: async ({ id, spec }) => {
+      const saved = { id: id ?? `dash-${next++}`, spec, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+      items = id ? items.map((d) => d.id === id ? saved : d) : [...items, saved];
+      return saved;
+    },
+    remove: async (id) => {
+      items = items.filter((d) => d.id !== id);
+    }
+  };
+}
+const NAME_COLUMN = "Name";
+const SPEC_COLUMN = "Spec";
+function useDatabaseDashboardStore(options = {}) {
+  const arbi = useArbi();
+  const queryClient = useQueryClient();
+  const name = options.name ?? "Dashboards";
+  const workspaceId = arbi.hasWorkspace ? arbi.getWorkspaceId() : null;
+  return useMemo(() => {
+    async function find() {
+      const all = await arbi.databases.list();
+      return all.find(
+        (d) => d.editable && d.workspace_id === workspaceId && d.name === name && (d.columns ?? []).some((c) => c.name === SPEC_COLUMN)
+      );
+    }
+    function inWorkspace(read) {
+      return workspaceId ? arbi.readInWorkspace(workspaceId, read) : read();
+    }
+    async function ensure() {
+      return inWorkspace(ensureHere);
+    }
+    async function ensureHere() {
+      const found = await find();
+      if (found) return found;
+      const created = await arbi.databases.create({
+        name,
+        description: "Saved dashboards (written by the Dashboards page).",
+        columns: [
+          { name: NAME_COLUMN, type: "text" },
+          { name: SPEC_COLUMN, type: "text" }
+        ]
+      });
+      void queryClient.invalidateQueries({
+        queryKey: arbiQueryKeys.databaseList(workspaceId ?? void 0)
+      });
+      return created;
+    }
+    return {
+      scope: workspaceId,
+      list: () => inWorkspace(async () => {
+        const database = await find();
+        if (!database) return [];
+        const spec = database.columns?.find((c) => c.name === SPEC_COLUMN)?.id ?? SPEC_COLUMN;
+        const page = await arbi.databases.rows(database.id, { limit: 1e3 });
+        return page.rows.flatMap((row) => {
+          const parsed = parseDashboardSpec(row.values[spec]);
+          return parsed ? [{ id: row.id, spec: parsed, updatedAt: row.updated_at }] : [];
+        });
+      }),
+      async save({ id, spec }) {
+        const values = { [NAME_COLUMN]: spec.title, [SPEC_COLUMN]: serializeDashboardSpec(spec) };
+        const database = await ensure();
+        const row = id ? await arbi.databases.updateRow(database.id, id, values) : (await arbi.databases.addRows(database.id, [{ values }]))[0];
+        void queryClient.invalidateQueries({
+          queryKey: arbiQueryKeys.databaseRows(workspaceId ?? "", database.id)
+        });
+        return { id: row.id, spec, updatedAt: row.updated_at };
+      },
+      async remove(id) {
+        const database = await find();
+        if (!database) return;
+        await arbi.databases.deleteRows(database.id, [id]);
+        void queryClient.invalidateQueries({
+          queryKey: arbiQueryKeys.databaseRows(workspaceId ?? "", database.id)
+        });
+      }
+    };
+  }, [arbi, queryClient, name, workspaceId]);
+}
+function useDashboardStore() {
+  const { dashboards } = useArbiHost();
+  return (dashboards?.useStore ?? useUserDashboardStore)();
+}
+function useSavedDashboards(store) {
+  return useQuery({
+    queryKey: arbiQueryKeys.dashboards(store.scope ?? ""),
+    queryFn: () => store.list(),
+    enabled: store.scope !== null
+  });
+}
+function useSaveDashboard(store) {
+  const queryClient = useQueryClient();
+  const key = arbiQueryKeys.dashboards(store.scope ?? "");
+  return useMutation({
+    mutationFn: (dashboard) => store.save(dashboard),
+    onSuccess: (saved) => {
+      queryClient.setQueryData(
+        key,
+        (old = []) => old.some((d) => d.id === saved.id) ? old.map((d) => d.id === saved.id ? saved : d) : [...old, saved]
+      );
+    }
+  });
+}
+function useDeleteDashboard(store) {
+  const queryClient = useQueryClient();
+  const key = arbiQueryKeys.dashboards(store.scope ?? "");
+  return useMutation({
+    mutationFn: (id) => store.remove(id),
+    onSuccess: (_void, id) => {
+      queryClient.setQueryData(key, (old = []) => old.filter((d) => d.id !== id));
+    }
+  });
+}
+export {
+  ANALYTICS_CHART_VIEW,
+  MAX_DASHBOARD_SPEC_CHARS,
+  createMemoryDashboardStore,
+  parseDashboardSpec,
+  serializeDashboardSpec,
+  useDashboardStore,
+  useDatabaseDashboardStore,
+  useDeleteDashboard,
+  useSaveDashboard,
+  useSavedDashboards,
+  useUserDashboardStore
+};
+//# sourceMappingURL=store.js.map

package/dist/datasets/store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/datasets/store.ts"],
+  "sourcesContent": ["/**\n * Saved dashboards: where `DashboardSpec`s are kept, and the hooks that read and write them.\n *\n * Default store: the person's own (`useUserDashboardStore`, `/v1/user/dashboards`), each spec sealed\n * in the browser to their own key, so Analytics is theirs across workspaces. A host keeps them\n * elsewhere with `<ArbiHost config={{ dashboards: { useStore } }}>`, e.g. in a database of the open\n * workspace, shared with its members (`useDatabaseDashboardStore`).\n */\nimport { useMemo } from 'react'\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport { useArbiHost } from '../host/config'\nimport { useArbi } from '../useArbi'\nimport { arbiQueryKeys } from '../query-keys'\nimport type { DashboardSpec, PanelSpec } from './types'\n\n/**\n * The transient view through which a host asks Analytics to chart a database (\"Chart this\"): set it to\n * `{ id, name, workspaceId }` and open the page, which makes a dashboard on that database and clears it.\n */\nexport const ANALYTICS_CHART_VIEW = 'analytics.chartDatabase'\n\n/** A database Analytics is asked to chart. */\nexport interface AnalyticsChartRequest {\n  id: string\n  name: string\n  /** The database's workspace, so the new panels read it from anywhere. */\n  workspaceId?: string\n}\n\n/** A dashboard as stored. */\nexport interface SavedDashboard {\n  id: string\n  spec: DashboardSpec\n  updatedAt?: string\n  /** It could not be opened (sealed under another key, or not a dashboard): it can only be deleted. */\n  unreadable?: boolean\n}\n\n/** Where dashboards are kept. */\nexport interface DashboardStore {\n  /** What the saved list is cached under (the workspace it belongs to). `null`: not available. */\n  scope: string | null\n  list: () => Promise<SavedDashboard[]>\n  /** Create (no `id`) or replace a dashboard; resolves with it as stored. */\n  save: (dashboard: { id?: string; spec: DashboardSpec }) => Promise<SavedDashboard>\n  remove: (id: string) => Promise<void>\n}\n\n/** The longest spec a database text cell holds (the server's limit). */\nexport const MAX_DASHBOARD_SPEC_CHARS = 10_000\n\nconst isObject = (v: unknown): v is Record<string, unknown> =>\n  typeof v === 'object' && v !== null && !Array.isArray(v)\n\nfunction isPanel(v: unknown): v is PanelSpec {\n  return (\n    isObject(v) &&\n    typeof v.id === 'string' &&\n    typeof v.title === 'string' &&\n    isObject(v.source) &&\n    typeof v.source.id === 'string' &&\n    isObject(v.chart) &&\n    typeof v.chart.type === 'string'\n  )\n}\n\n/** A stored spec, checked: `null` when it is not a dashboard (malformed panels are dropped). */\nexport function parseDashboardSpec(value: unknown): DashboardSpec | null {\n  let parsed = value\n  if (typeof value === 'string') {\n    try {\n      parsed = JSON.parse(value)\n    } catch {\n      return null\n    }\n  }\n  if (!isObject(parsed) || parsed.version !== 1 || typeof parsed.title !== 'string') return null\n  const panels = Array.isArray(parsed.panels) ? parsed.panels.filter(isPanel) : []\n  return {\n    version: 1,\n    title: parsed.title,\n    ...(typeof parsed.description === 'string' ? { description: parsed.description } : {}),\n    panels,\n  }\n}\n\n/** A spec as JSON for storage; throws when it is longer than the store holds. */\nexport function serializeDashboardSpec(spec: DashboardSpec, max = MAX_DASHBOARD_SPEC_CHARS) {\n  const json = JSON.stringify(spec)\n  if (json.length > max) {\n    throw new Error(\n      `This dashboard is too large to save (${json.length.toLocaleString('en-GB')} characters, at most ${max.toLocaleString('en-GB')}). Remove a panel or split it into two dashboards.`\n    )\n  }\n  return json\n}\n\n/** The person's own dashboards (`arbi.dashboards`: sealed to their key); unavailable signed out. */\nexport function useUserDashboardStore(): DashboardStore {\n  const arbi = useArbi()\n  const scope = arbi.isLoggedIn ? (arbi.user.identity()?.externalId ?? null) : null\n  return useMemo(\n    () => ({\n      scope: scope && `user:${scope}`,\n      list: async () =>\n        (await arbi.dashboards.list()).map(({ id, json, updatedAt }) => {\n          const spec = json === null ? null : parseDashboardSpec(json)\n          return spec\n            ? { id, spec, updatedAt }\n            : {\n                id,\n                spec: { version: 1 as const, title: '', panels: [] },\n                updatedAt,\n                unreadable: true,\n              }\n        }),\n      async save({ id, spec }) {\n        const saved = await arbi.dashboards.save({ id, json: serializeDashboardSpec(spec) })\n        return { id: saved.id, spec, updatedAt: saved.updatedAt }\n      },\n      remove: (id) => arbi.dashboards.remove(id),\n    }),\n    [arbi, scope]\n  )\n}\n\n/** A store kept in memory (a demo, a test, a page without a workspace). */\nexport function createMemoryDashboardStore(\n  initial: readonly SavedDashboard[] = [],\n  scope = 'memory'\n): DashboardStore {\n  let items = [...initial]\n  let next = items.length + 1\n  return {\n    scope,\n    list: async () => items.map((d) => ({ ...d })),\n    save: async ({ id, spec }) => {\n      const saved = { id: id ?? `dash-${next++}`, spec, updatedAt: new Date().toISOString() }\n      items = id ? items.map((d) => (d.id === id ? saved : d)) : [...items, saved]\n      return saved\n    },\n    remove: async (id) => {\n      items = items.filter((d) => d.id !== id)\n    },\n  }\n}\n\nexport interface DatabaseDashboardStoreOptions {\n  /** The database's name. Default \"Dashboards\". */\n  name?: string\n}\n\nconst NAME_COLUMN = 'Name'\nconst SPEC_COLUMN = 'Spec'\n\n/** Dashboards kept as rows of a database of the open workspace (made on the first save). */\nexport function useDatabaseDashboardStore(\n  options: DatabaseDashboardStoreOptions = {}\n): DashboardStore {\n  const arbi = useArbi()\n  const queryClient = useQueryClient()\n  const name = options.name ?? 'Dashboards'\n  const workspaceId = arbi.hasWorkspace ? arbi.getWorkspaceId() : null\n  return useMemo(() => {\n    /** The workspace's own dashboards database, if there is one. */\n    async function find() {\n      const all = await arbi.databases.list()\n      return all.find(\n        (d) =>\n          d.editable &&\n          d.workspace_id === workspaceId &&\n          d.name === name &&\n          (d.columns ?? []).some((c) => c.name === SPEC_COLUMN)\n      )\n    }\n    /**\n     * Run `read` only while this store's workspace is the one open on the server (databases are\n     * listed and created there): a switch meanwhile drops it, so nothing is cached, or created,\n     * as another workspace's.\n     */\n    function inWorkspace<T>(read: () => Promise<T>): Promise<T> {\n      return workspaceId ? arbi.readInWorkspace(workspaceId, read) : read()\n    }\n    async function ensure() {\n      return inWorkspace(ensureHere)\n    }\n    async function ensureHere() {\n      const found = await find()\n      if (found) return found\n      const created = await arbi.databases.create({\n        name,\n        description: 'Saved dashboards (written by the Dashboards page).',\n        columns: [\n          { name: NAME_COLUMN, type: 'text' },\n          { name: SPEC_COLUMN, type: 'text' },\n        ],\n      })\n      void queryClient.invalidateQueries({\n        queryKey: arbiQueryKeys.databaseList(workspaceId ?? undefined),\n      })\n      return created\n    }\n    return {\n      scope: workspaceId,\n      list: () =>\n        inWorkspace(async () => {\n          const database = await find()\n          if (!database) return []\n          const spec = database.columns?.find((c) => c.name === SPEC_COLUMN)?.id ?? SPEC_COLUMN\n          const page = await arbi.databases.rows(database.id, { limit: 1000 })\n          return page.rows.flatMap((row) => {\n            const parsed = parseDashboardSpec(row.values[spec])\n            return parsed ? [{ id: row.id, spec: parsed, updatedAt: row.updated_at }] : []\n          })\n        }),\n      async save({ id, spec }) {\n        const values = { [NAME_COLUMN]: spec.title, [SPEC_COLUMN]: serializeDashboardSpec(spec) }\n        const database = await ensure()\n        const row = id\n          ? await arbi.databases.updateRow(database.id, id, values)\n          : (await arbi.databases.addRows(database.id, [{ values }]))[0]\n        // The database's own rows changed (it shows in Databases like any other).\n        void queryClient.invalidateQueries({\n          queryKey: arbiQueryKeys.databaseRows(workspaceId ?? '', database.id),\n        })\n        return { id: row.id, spec, updatedAt: row.updated_at }\n      },\n      async remove(id) {\n        const database = await find()\n        if (!database) return\n        await arbi.databases.deleteRows(database.id, [id])\n        void queryClient.invalidateQueries({\n          queryKey: arbiQueryKeys.databaseRows(workspaceId ?? '', database.id),\n        })\n      },\n    }\n  }, [arbi, queryClient, name, workspaceId])\n}\n\n/** The store dashboards are kept in here: the host's (`dashboards.useStore`) or a database. */\nexport function useDashboardStore(): DashboardStore {\n  const { dashboards } = useArbiHost()\n  // The host's configuration is one object for its life: the same hook runs every render.\n  return (dashboards?.useStore ?? useUserDashboardStore)()\n}\n\n/** The saved dashboards, oldest first. */\nexport function useSavedDashboards(store: DashboardStore) {\n  return useQuery({\n    queryKey: arbiQueryKeys.dashboards(store.scope ?? ''),\n    queryFn: () => store.list(),\n    enabled: store.scope !== null,\n  })\n}\n\n/** Save a dashboard (create without `id`); the saved list takes it straight away. */\nexport function useSaveDashboard(store: DashboardStore) {\n  const queryClient = useQueryClient()\n  const key = arbiQueryKeys.dashboards(store.scope ?? '')\n  return useMutation({\n    mutationFn: (dashboard: { id?: string; spec: DashboardSpec }) => store.save(dashboard),\n    onSuccess: (saved) => {\n      queryClient.setQueryData<SavedDashboard[]>(key, (old = []) =>\n        old.some((d) => d.id === saved.id)\n          ? old.map((d) => (d.id === saved.id ? saved : d))\n          : [...old, saved]\n      )\n    },\n  })\n}\n\nexport function useDeleteDashboard(store: DashboardStore) {\n  const queryClient = useQueryClient()\n  const key = arbiQueryKeys.dashboards(store.scope ?? '')\n  return useMutation({\n    mutationFn: (id: string) => store.remove(id),\n    onSuccess: (_void, id) => {\n      queryClient.setQueryData<SavedDashboard[]>(key, (old = []) => old.filter((d) => d.id !== id))\n    },\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/datasets/types.js

@@ -0,0 +1,14 @@
+const AGGREGATE_FIELDS = {
+  /** The group's label ("Open", "2026-06"). */
+  group: "group",
+  /** The group's key as grouped (a date bucket, an id), for ordering and links. */
+  key: "key",
+  /** The series' label (only with `splitBy`). */
+  series: "series",
+  /** The measured value; `null` when the group has no value to measure. */
+  value: "value"
+};
+export {
+  AGGREGATE_FIELDS
+};
+//# sourceMappingURL=types.js.map

package/dist/datasets/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/datasets/types.ts"],
+  "sourcesContent": ["/**\n * Datasets: the one shape every chart and dashboard reads, whatever the data comes from.\n *\n * Three layers, each knowing only the one below it:\n *   1. A `DataSource` adapter (AI usage, documents, threads, projects, a database, later an external\n *      feed) exposes its data as a normalized `Dataset`: typed fields and plain rows. Filtering,\n *      grouping and aggregation happen here (`aggregateDataset`, or on the server where the backend\n *      can, as a database does), never in a chart.\n *   2. A `ChartSpec` (inside a `PanelSpec`, inside a `DashboardSpec`) says what to show in terms of\n *      field ids only: the chart type, x / series / y fields, the aggregate, sort and limit. It is\n *      plain JSON, saved in dashboards and studio pages.\n *   3. A renderer (`@arbidocs/blocks/dashboards`) maps a spec plus the aggregated dataset onto the\n *      drawing component. No renderer type appears here, so the renderer stays swappable.\n */\n\n/** A field's value type. Dates are ISO strings (`2026-06-12` or a full timestamp). */\nexport type DatasetFieldType = 'string' | 'number' | 'date' | 'boolean'\n\n/** One column of a dataset. */\nexport interface DatasetField {\n  /** Stable id: what specs and rows use. */\n  id: string\n  /** What people read (a column name, \"Status\"). */\n  label: string\n  type: DatasetFieldType\n  /**\n   * The unit of a number field, which picks its formatting: `gbp` (\u00A3), `bytes`, `tokens`, or any\n   * suffix (`\"MB\"`, `\"%\"`).\n   */\n  unit?: string\n  /** The values a string field takes, when known (a select column's options), for a filter picker. */\n  options?: readonly string[]\n  /** A string field whose cell holds several values (tags, linked rows): a row counts in each. */\n  multiple?: boolean\n}\n\n/** A cell: a scalar, `null` when empty, or a list for a `multiple` field. */\nexport type DatasetValue = string | number | boolean | null | readonly string[]\n\n/** One row, keyed by field id. */\nexport type DatasetRow = Readonly<Record<string, DatasetValue | undefined>>\n\n/** A normalized dataset: typed fields and the rows. */\nexport interface Dataset {\n  fields: readonly DatasetField[]\n  rows: readonly DatasetRow[]\n  /** Rows matched before grouping (after filters). */\n  totalRows?: number\n  /** More groups existed than the query's `limit`. */\n  truncated?: boolean\n}\n\n/** How a date field is grouped. Keys: `2026-06-12`, `2026-W24`, `2026-06`, `2026-Q2`, `2026`. */\nexport type TimeBucket = 'day' | 'week' | 'month' | 'quarter' | 'year'\n\nexport type AggregateOp = 'count' | 'sum' | 'avg' | 'min' | 'max'\n\nexport type FilterOp =\n  'eq' | 'neq' | 'contains' | 'gt' | 'gte' | 'lt' | 'lte' | 'empty' | 'not_empty'\n\n/** Keep rows whose `field` satisfies `op value` (compared in the field's type). */\nexport interface DatasetFilter {\n  field: string\n  op: FilterOp\n  value?: string | number | boolean | null\n}\n\n/** How the groups are ordered: by label (dates: chronological), or by value. */\nexport type DatasetSort = 'label' | 'value-desc' | 'value-asc'\n\n/** How records are ordered: by a field (empty cells last). */\nexport interface DatasetOrder {\n  field: string\n  /** Default `asc`. */\n  direction?: 'asc' | 'desc'\n}\n\n/**\n * What to read of a source. Grouped (the default): the (filtered) rows grouped and each group\n * measured, a dataset in long form with the fields {@link AGGREGATE_FIELDS}, one row per group (and\n * series). With `records`: the matching rows themselves, ordered by `orderBy` and cut at `limit`.\n */\nexport interface DatasetQuery {\n  /** List the matching records instead of grouping them (`groupBy`, `splitBy`, `measure` unused). */\n  records?: boolean\n  /** The order of the records. */\n  orderBy?: DatasetOrder\n  filters?: readonly DatasetFilter[]\n  /** The field whose values (or date buckets) are the groups. Absent: one group, \"All\". */\n  groupBy?: string\n  /** The bucket of a date `groupBy` / `splitBy`. Default `month`. */\n  bucket?: TimeBucket\n  /** A second field: one series per value (a stacked or multi-line chart). */\n  splitBy?: string\n  /** Default: count rows. `count` with a `field` counts the rows where it is not empty. */\n  measure?: { op: AggregateOp; field?: string }\n  /** Default: dates chronological, others by value, largest first. */\n  sort?: DatasetSort\n  /** Most groups kept (by value), or records listed. Default 50 groups; every record. */\n  limit?: number\n}\n\n/** The field ids of an aggregated dataset. */\nexport const AGGREGATE_FIELDS = {\n  /** The group's label (\"Open\", \"2026-06\"). */\n  group: 'group',\n  /** The group's key as grouped (a date bucket, an id), for ordering and links. */\n  key: 'key',\n  /** The series' label (only with `splitBy`). */\n  series: 'series',\n  /** The measured value; `null` when the group has no value to measure. */\n  value: 'value',\n} as const\n\n/** A dataset (or a source's fields) as a hook reads it. */\nexport interface DatasetState {\n  dataset: Dataset | undefined\n  isLoading: boolean\n  error: unknown\n}\n\nexport interface DataSourceFieldsState {\n  fields: readonly DatasetField[]\n  isLoading: boolean\n  error: unknown\n}\n\n/** A source's parameters as saved in a panel (a database id, a period). */\nexport type DataSourceParams = Readonly<\n  Record<string, string | number | boolean | null | undefined>\n>\n\n/** A choice for a parameter (an option of a select). */\nexport interface DataSourceOption {\n  value: string\n  label: string\n  /** Other parameters set with this choice (a database's workspace, so a panel reads it anywhere). */\n  params?: DataSourceParams\n}\n\n/** A parameter the panel editor asks for, before the source's fields are known. */\nexport interface DataSourceParam {\n  id: string\n  label: string\n  /** Absent: the parameter may be left empty. */\n  required?: boolean\n  /** Shown when nothing is chosen (\"All columns\"). */\n  placeholder?: string\n  /** The choices, read live (databases of the open workspace; a database's saved views). */\n  useOptions: (params: DataSourceParams) => {\n    options: readonly DataSourceOption[]\n    isLoading: boolean\n  }\n}\n\n/**\n * A data source adapter: where a dataset comes from.\n *\n * `useFields` and `useDataset` are hooks. A caller renders them from a component keyed by the\n * source id, so switching source mounts afresh (the hooks differ between sources).\n *\n * Extension point: an external source (an HTTP/JSON API, a CSV feed, a warehouse) is one more\n * adapter. It reads its rows however it likes (its own `useQuery`) and returns them as a `Dataset`;\n * `defineRowsSource` aggregates them for it. A host lists it in `<ArbiHost config={{ dashboards:\n * { sources } }}>` and every editor, panel and studio block offers it. Fetching third-party URLs\n * from the browser is the host's decision (CORS, credentials, what a shared dashboard may reach),\n * so none is built in; data to chart today is imported into a database (CSV / spreadsheet import).\n */\nexport interface DataSource {\n  id: string\n  label: string\n  description?: string\n  /** `workspace`: it reads the open workspace's data (documents, threads\u2026), so it shows nothing until\n   *  one is open; a function decides from the panel's parameters (a database panel that does not name\n   *  its workspace). Absent: it is the person's own or names what it reads (AI usage). */\n  scope?: 'workspace' | ((params: DataSourceParams) => 'workspace' | undefined)\n  params?: readonly DataSourceParam[]\n  /** The fields a panel can use, given the parameters. */\n  useFields: (params: DataSourceParams) => DataSourceFieldsState\n  /**\n   * The dataset: grouped and measured (long form with {@link AGGREGATE_FIELDS}), or the records\n   * (`query.records`), filtered either way.\n   */\n  useDataset: (\n    params: DataSourceParams,\n    query: DatasetQuery,\n    options?: { enabled?: boolean }\n  ) => DatasetState\n}\n\n// \u2500\u2500 Specs: what a panel shows (plain JSON) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/** How a panel draws its data. `metric` is one number; `table` a table of rows or groups. */\nexport type ChartType = 'metric' | 'bar' | 'line' | 'area' | 'pie' | 'donut' | 'table'\n\n/** What to show, in terms of the dataset's field ids. Serialisable. */\nexport interface ChartSpec {\n  type: ChartType\n  /** The category or date field along the x axis (pie slices; table groups). */\n  x?: string\n  /** The bucket of a date `x`. Default `month`. */\n  bucket?: TimeBucket\n  /** A field whose values become the series (stacked bars or areas, several lines). */\n  series?: string\n  /** The number field the aggregate reads (absent: rows are counted). */\n  y?: string\n  /** Default `count`. */\n  aggregate?: AggregateOp\n  sort?: DatasetSort\n  limit?: number\n  /** Stack the series (bar, area). */\n  stacked?: boolean\n  filters?: readonly DatasetFilter[]\n  /** A table of records (no aggregate): the fields shown, in order. Absent: every field. */\n  columns?: readonly string[]\n  /** A table of records: their order. */\n  orderBy?: DatasetOrder\n}\n\n/** The source a panel reads, by registry id, with its parameters. */\nexport interface DataSourceRef {\n  id: string\n  params?: DataSourceParams\n}\n\n/** One panel of a dashboard. */\nexport interface PanelSpec {\n  id: string\n  title: string\n  description?: string\n  source: DataSourceRef\n  chart: ChartSpec\n  /** Columns of the 12-column grid it spans on a wide screen (it is full width on a phone). */\n  width?: number\n}\n\n/** A dashboard: a titled grid of panels. Plain JSON (`version` for later migrations). */\nexport interface DashboardSpec {\n  version: 1\n  title: string\n  description?: string\n  panels: readonly PanelSpec[]\n}\n"],
+  "mappings": "AAuGO,MAAM,mBAAmB;AAAA;AAAA,EAE9B,OAAO;AAAA;AAAA,EAEP,KAAK;AAAA;AAAA,EAEL,QAAQ;AAAA;AAAA,EAER,OAAO;AACT;",
+  "names": []
+}

package/dist/directmessages/ConversationList.js

@@ -0,0 +1,148 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Check, CheckCheck } from "lucide-react";
+import { Badge } from "../ui/badge.js";
+import { cn } from "../lib/utils.js";
+import { formatRelativeTime, userDisplayName, isAgentUser } from "./utils.js";
+import { DmAvatar } from "./DmAvatar.js";
+import { AgentBadge } from "../entities/AgentMarkers.js";
+function ConversationList({
+  conversations,
+  selectedPeerId,
+  onSelect,
+  classNames,
+  emptyState,
+  header,
+  className
+}) {
+  return /* @__PURE__ */ jsxs(
+    "aside",
+    {
+      className: cn(
+        "flex min-h-0 flex-col border-b border-border md:w-80 md:shrink-0 md:border-b-0 md:border-r",
+        className
+      ),
+      "data-testid": "arbi-dm-list",
+      children: [
+        header === void 0 ? /* @__PURE__ */ jsxs("div", { className: "border-b border-border px-4 py-3", children: [
+          /* @__PURE__ */ jsx("p", { className: "text-sm font-semibold text-foreground", children: "Conversations" }),
+          /* @__PURE__ */ jsxs("p", { className: "text-xs text-muted-foreground", children: [
+            conversations.length,
+            " ",
+            conversations.length === 1 ? "colleague" : "colleagues"
+          ] })
+        ] }) : header,
+        /* @__PURE__ */ jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: conversations.length === 0 ? /* @__PURE__ */ jsx("div", { className: "px-4 py-6 text-xs text-muted-foreground", children: emptyState ?? "No conversations yet." }) : /* @__PURE__ */ jsx("ul", { className: "w-full", children: conversations.map((c, i) => {
+          const { peer, lastMessage, unreadCount } = c;
+          const rowId = c.id ?? peer.external_id;
+          const newSection = c.sectionLabel && c.sectionLabel !== conversations[i - 1]?.sectionLabel;
+          const active = rowId === selectedPeerId;
+          const preview = lastMessage?.body ?? "No messages yet \u2014 say hello";
+          const unread = unreadCount > 0;
+          const body = /* @__PURE__ */ jsxs(Fragment, { children: [
+            c.leading ?? /* @__PURE__ */ jsx(DmAvatar, { user: peer }),
+            /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+              /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2", children: [
+                /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 items-center gap-1.5", children: [
+                  /* @__PURE__ */ jsx(
+                    "span",
+                    {
+                      className: cn(
+                        "truncate text-sm text-foreground",
+                        unread ? "font-bold" : "font-semibold"
+                      ),
+                      children: c.title ?? userDisplayName(peer)
+                    }
+                  ),
+                  c.badge ?? (isAgentUser(peer) ? /* @__PURE__ */ jsx(AgentBadge, {}) : null)
+                ] }),
+                c.statusLabel ? /* @__PURE__ */ jsx(
+                  Badge,
+                  {
+                    variant: "outline",
+                    className: "shrink-0 rounded-full px-2 py-0 text-xs font-medium text-muted-foreground",
+                    children: c.statusLabel
+                  }
+                ) : unreadCount > 0 ? (
+                  // Quiet by default: a filled brand pill with a shadow
+                  // shouted louder than the message it was counting.
+                  // Enough to catch the eye scanning the list, no more.
+                  /* @__PURE__ */ jsx(
+                    Badge,
+                    {
+                      variant: "accent",
+                      className: cn(
+                        "min-w-[1.125rem] justify-center rounded-full px-1 py-0 text-xs font-medium leading-[1.125rem] shadow-none",
+                        classNames?.unreadBadge
+                      ),
+                      children: unreadCount
+                    }
+                  )
+                ) : null
+              ] }),
+              /* @__PURE__ */ jsxs("div", { className: "mt-1 flex items-center gap-1.5", children: [
+                lastMessage?.isMine ? lastMessage.read ? /* @__PURE__ */ jsx(
+                  CheckCheck,
+                  {
+                    className: "size-3.5 shrink-0 text-ai-accent",
+                    "aria-label": "Read"
+                  }
+                ) : /* @__PURE__ */ jsx(
+                  Check,
+                  {
+                    className: "size-3.5 shrink-0 text-muted-foreground",
+                    "aria-label": "Sent"
+                  }
+                ) : null,
+                /* @__PURE__ */ jsx(
+                  "p",
+                  {
+                    className: cn(
+                      "min-w-0 flex-1 truncate text-xs",
+                      unread ? "font-medium text-foreground" : "text-muted-foreground"
+                    ),
+                    children: c.subtitle ?? preview
+                  }
+                ),
+                /* @__PURE__ */ jsx("span", { className: "shrink-0 text-xs text-muted-foreground", children: lastMessage ? formatRelativeTime(lastMessage.createdAt) : "" })
+              ] })
+            ] })
+          ] });
+          const rowClass = cn(
+            // Each row is its own opaque surface. Left transparent it takes
+            // the panel's colour, and the chips stop reading as cards at all
+            // — which is the whole point of them.
+            "flex w-full items-start gap-3 border-b border-border/60 bg-card px-4 py-3 text-left transition-colors",
+            c.disabled ? "cursor-default" : active ? "bg-ai-accent-soft" : "hover:bg-accent/40"
+          );
+          return /* @__PURE__ */ jsxs("li", { children: [
+            newSection && /* @__PURE__ */ jsx(
+              "p",
+              {
+                className: "bg-muted/40 px-4 py-1.5 text-xs font-medium uppercase tracking-wide text-muted-foreground",
+                "data-testid": "arbi-dm-section",
+                children: c.sectionLabel
+              }
+            ),
+            c.disabled ? /* @__PURE__ */ jsxs("div", { "data-testid": `arbi-dm-conversation-${rowId}`, className: rowClass, children: [
+              body,
+              c.trailing
+            ] }) : /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                onClick: () => onSelect(rowId),
+                "data-testid": `arbi-dm-conversation-${rowId}`,
+                className: rowClass,
+                children: body
+              }
+            )
+          ] }, rowId);
+        }) }) })
+      ]
+    }
+  );
+}
+export {
+  ConversationList
+};
+//# sourceMappingURL=ConversationList.js.map