@arbidocs/react 0.5.110 → 0.5.112

package/dist/facts-search.js

@@ -0,0 +1,57 @@
+import { useCallback, useRef } from "react";
+import { useArbi } from "./useArbi.js";
+import { useSearchFacts } from "./facts.js";
+import { useArbiSessionStore, useTransientView } from "./session/session-hooks.js";
+const FACTS_SEARCH_VIEW = "facts.search";
+const EMPTY = { query: "", lastQuery: "", hits: null, workspaceId: null };
+function useFactsSearch(options = {}) {
+  const { mode = "hybrid", limit = 30 } = options;
+  const arbi = useArbi();
+  const session = useArbiSessionStore();
+  const workspaceId = options.workspaceId ?? (arbi.hasWorkspace ? arbi.getWorkspaceId() : null);
+  const [kept, setKept] = useTransientView(FACTS_SEARCH_VIEW, EMPTY);
+  const searchFacts = useSearchFacts(workspaceId);
+  const run = useRef(0);
+  const foreign = !!kept.workspaceId && !!workspaceId && kept.workspaceId !== workspaceId;
+  const state = foreign ? EMPTY : kept;
+  const patch = useCallback(
+    (next) => {
+      const current = session.getState().views.transient[FACTS_SEARCH_VIEW];
+      const base = current && current.workspaceId === workspaceId ? current : EMPTY;
+      setKept({ ...base, ...next, workspaceId });
+    },
+    [session, setKept, workspaceId]
+  );
+  const query = state.query;
+  const search = useCallback(async () => {
+    const q = query.trim();
+    if (!q) return;
+    const mine = ++run.current;
+    try {
+      const res = await searchFacts.mutateAsync({ query: q, search_mode: mode, limit });
+      if (run.current !== mine) return;
+      patch({ hits: res.facts, lastQuery: q });
+    } catch (error) {
+      if (run.current !== mine) return;
+      throw error;
+    }
+  }, [query, searchFacts, mode, limit, patch]);
+  const clear = useCallback(() => {
+    run.current++;
+    patch({ query: "", hits: null });
+  }, [patch]);
+  return {
+    query,
+    setQuery: useCallback((q) => patch({ query: q }), [patch]),
+    lastQuery: state.lastQuery,
+    hits: state.hits,
+    isSearching: searchFacts.isPending,
+    search,
+    clear
+  };
+}
+export {
+  FACTS_SEARCH_VIEW,
+  useFactsSearch
+};
+//# sourceMappingURL=facts-search.js.map

package/dist/facts-search.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/facts-search.ts"],
+  "sourcesContent": ["/**\n * The facts Smart Search: one search of a workspace's facts (never documents), with keyword and\n * meaning recall, as the agent's `search_facts` tool does. It holds the query being typed, the\n * query last searched and its hits. They are kept in the session (`views.transient`), so leaving\n * the view and coming back shows the same search, as the documents' search does.\n *\n * Requires an `ArbiHost` (with an `arbi`) and a React Query client above it.\n */\nimport { useCallback, useRef } from 'react'\nimport type { FactSearchRequest, FactSearchResponse } from '@arbidocs/sdk/browser'\nimport { useArbi } from './useArbi'\nimport { useSearchFacts } from './facts'\nimport { useArbiSessionStore, useTransientView } from './session/session-hooks'\n\n/** One hit of a facts search: a fact and its recall score. */\nexport type FactSearchHit = FactSearchResponse['facts'][number]\n\n/** The session key the search is kept under (`views.transient`). Drop it to clear the search. */\nexport const FACTS_SEARCH_VIEW = 'facts.search'\n\n/** The search kept for the session. `hits === null`: nothing searched yet. */\nexport interface FactsSearchState {\n  query: string\n  lastQuery: string\n  hits: FactSearchHit[] | null\n  /** The workspace searched (null: none searched yet). */\n  workspaceId: string | null\n}\n\nexport interface UseFactsSearchOptions {\n  /** The workspace searched (default: the open one). */\n  workspaceId?: string | null\n  /** How it recalls (default `hybrid`: keyword and meaning). */\n  mode?: FactSearchRequest['search_mode']\n  /** The most hits it returns (default 30). */\n  limit?: number\n}\n\nexport interface FactsSearch {\n  /** The query in the box. */\n  query: string\n  setQuery: (query: string) => void\n  /** The query last searched. */\n  lastQuery: string\n  /** Its hits, best first (null: nothing searched yet). */\n  hits: FactSearchHit[] | null\n  isSearching: boolean\n  /**\n   * Search the query in the box (a blank one does nothing). Rejects when the search fails. A search\n   * overtaken by a newer one is dropped quietly; the request names its workspace, so a switch while\n   * it runs cannot answer it from another.\n   */\n  search: () => Promise<void>\n  /** Back to nothing searched, with an empty box. */\n  clear: () => void\n}\n\nconst EMPTY: FactsSearchState = { query: '', lastQuery: '', hits: null, workspaceId: null }\n\n/** Search a workspace's facts and keep the search for the session. */\nexport function useFactsSearch(options: UseFactsSearchOptions = {}): FactsSearch {\n  const { mode = 'hybrid', limit = 30 } = options\n  const arbi = useArbi()\n  const session = useArbiSessionStore()\n  const workspaceId = options.workspaceId ?? (arbi.hasWorkspace ? arbi.getWorkspaceId() : null)\n  const [kept, setKept] = useTransientView<FactsSearchState>(FACTS_SEARCH_VIEW, EMPTY)\n  const searchFacts = useSearchFacts(workspaceId)\n  const run = useRef(0)\n\n  // Another workspace's search is not this one's.\n  const foreign = !!kept.workspaceId && !!workspaceId && kept.workspaceId !== workspaceId\n  const state = foreign ? EMPTY : kept\n\n  /** Merge into the search as it is now (an answer lands after other changes). */\n  const patch = useCallback(\n    (next: Partial<FactsSearchState>) => {\n      const current = session.getState().views.transient[FACTS_SEARCH_VIEW] as\n        FactsSearchState | undefined\n      const base = current && current.workspaceId === workspaceId ? current : EMPTY\n      setKept({ ...base, ...next, workspaceId })\n    },\n    [session, setKept, workspaceId]\n  )\n\n  const query = state.query\n  const search = useCallback(async () => {\n    const q = query.trim()\n    if (!q) return\n    const mine = ++run.current\n    try {\n      const res = await searchFacts.mutateAsync({ query: q, search_mode: mode, limit })\n      if (run.current !== mine) return\n      patch({ hits: res.facts, lastQuery: q })\n    } catch (error) {\n      if (run.current !== mine) return\n      throw error\n    }\n  }, [query, searchFacts, mode, limit, patch])\n\n  const clear = useCallback(() => {\n    run.current++\n    patch({ query: '', hits: null })\n  }, [patch])\n\n  return {\n    query,\n    setQuery: useCallback((q: string) => patch({ query: q }), [patch]),\n    lastQuery: state.lastQuery,\n    hits: state.hits,\n    isSearching: searchFacts.isPending,\n    search,\n    clear,\n  }\n}\n"],
+  "mappings": "AAQA,SAAS,aAAa,cAAc;AAEpC,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB,wBAAwB;AAM/C,MAAM,oBAAoB;AAuCjC,MAAM,QAA0B,EAAE,OAAO,IAAI,WAAW,IAAI,MAAM,MAAM,aAAa,KAAK;AAGnF,SAAS,eAAe,UAAiC,CAAC,GAAgB;AAC/E,QAAM,EAAE,OAAO,UAAU,QAAQ,GAAG,IAAI;AACxC,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU,oBAAoB;AACpC,QAAM,cAAc,QAAQ,gBAAgB,KAAK,eAAe,KAAK,eAAe,IAAI;AACxF,QAAM,CAAC,MAAM,OAAO,IAAI,iBAAmC,mBAAmB,KAAK;AACnF,QAAM,cAAc,eAAe,WAAW;AAC9C,QAAM,MAAM,OAAO,CAAC;AAGpB,QAAM,UAAU,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,eAAe,KAAK,gBAAgB;AAC5E,QAAM,QAAQ,UAAU,QAAQ;AAGhC,QAAM,QAAQ;AAAA,IACZ,CAAC,SAAoC;AACnC,YAAM,UAAU,QAAQ,SAAS,EAAE,MAAM,UAAU,iBAAiB;AAEpE,YAAM,OAAO,WAAW,QAAQ,gBAAgB,cAAc,UAAU;AACxE,cAAQ,EAAE,GAAG,MAAM,GAAG,MAAM,YAAY,CAAC;AAAA,IAC3C;AAAA,IACA,CAAC,SAAS,SAAS,WAAW;AAAA,EAChC;AAEA,QAAM,QAAQ,MAAM;AACpB,QAAM,SAAS,YAAY,YAAY;AACrC,UAAM,IAAI,MAAM,KAAK;AACrB,QAAI,CAAC,EAAG;AACR,UAAM,OAAO,EAAE,IAAI;AACnB,QAAI;AACF,YAAM,MAAM,MAAM,YAAY,YAAY,EAAE,OAAO,GAAG,aAAa,MAAM,MAAM,CAAC;AAChF,UAAI,IAAI,YAAY,KAAM;AAC1B,YAAM,EAAE,MAAM,IAAI,OAAO,WAAW,EAAE,CAAC;AAAA,IACzC,SAAS,OAAO;AACd,UAAI,IAAI,YAAY,KAAM;AAC1B,YAAM;AAAA,IACR;AAAA,EACF,GAAG,CAAC,OAAO,aAAa,MAAM,OAAO,KAAK,CAAC;AAE3C,QAAM,QAAQ,YAAY,MAAM;AAC9B,QAAI;AACJ,UAAM,EAAE,OAAO,IAAI,MAAM,KAAK,CAAC;AAAA,EACjC,GAAG,CAAC,KAAK,CAAC;AAEV,SAAO;AAAA,IACL;AAAA,IACA,UAAU,YAAY,CAAC,MAAc,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;AAAA,IACjE,WAAW,MAAM;AAAA,IACjB,MAAM,MAAM;AAAA,IACZ,aAAa,YAAY;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/facts.js

@@ -0,0 +1,69 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "./useArbi.js";
+import { arbiQueryKeys } from "./hooks.js";
+function factWorkspace(arbi, workspaceId) {
+  return workspaceId || (arbi.hasWorkspace ? arbi.getWorkspaceId() : "");
+}
+function useFacts(workspaceId, options) {
+  const arbi = useArbi();
+  const { enabled = true, ...filter } = options ?? {};
+  const workspace = factWorkspace(arbi, workspaceId);
+  return useQuery({
+    queryKey: arbiQueryKeys.factList(workspace, filter),
+    // The request names the workspace, so a switch while it runs cannot answer for another.
+    queryFn: () => arbi.facts.list({ ...filter, workspaceId: workspace }),
+    enabled: enabled && !!workspace && arbi.hasWorkspace,
+    staleTime: 3e4
+  });
+}
+function useRefreshFacts() {
+  const qc = useQueryClient();
+  return () => qc.invalidateQueries({ queryKey: arbiQueryKeys.allFacts() });
+}
+function useCreateFact(workspaceId) {
+  const arbi = useArbi();
+  const refresh = useRefreshFacts();
+  return useMutation({
+    mutationFn: (body) => arbi.facts.create(body, { workspaceId: factWorkspace(arbi, workspaceId) || void 0 }),
+    onSuccess: refresh
+  });
+}
+function useCreateFacts(workspaceId) {
+  const arbi = useArbi();
+  const refresh = useRefreshFacts();
+  return useMutation({
+    mutationFn: (body) => arbi.facts.createBatch(body, { workspaceId: factWorkspace(arbi, workspaceId) || void 0 }),
+    onSuccess: refresh
+  });
+}
+function useUpdateFact() {
+  const arbi = useArbi();
+  const refresh = useRefreshFacts();
+  return useMutation({
+    mutationFn: ({ factId, patch }) => arbi.facts.update(factId, patch),
+    onSuccess: refresh
+  });
+}
+function useDeleteFact() {
+  const arbi = useArbi();
+  const refresh = useRefreshFacts();
+  return useMutation({
+    mutationFn: (factId) => arbi.facts.delete(factId),
+    onSuccess: refresh
+  });
+}
+function useSearchFacts(workspaceId) {
+  const arbi = useArbi();
+  return useMutation({
+    mutationFn: (body) => arbi.facts.search(body, { workspaceId: factWorkspace(arbi, workspaceId) || void 0 })
+  });
+}
+export {
+  useCreateFact,
+  useCreateFacts,
+  useDeleteFact,
+  useFacts,
+  useSearchFacts,
+  useUpdateFact
+};
+//# sourceMappingURL=facts.js.map

package/dist/facts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/facts.ts"],
+  "sourcesContent": ["/**\n * Workspace facts (notes): a workspace's list, filtered for the timeline or by tag, the writes\n * (create, batch, patch, delete) and the search. List, create and search name their workspace (the\n * one given, else the open one, captured when they are sent); patch and delete act in the fact's\n * own workspace. Every write refreshes every cached list.\n *\n * Requires an `ArbiHost` (with an `arbi`) and a React Query client above it.\n */\n\nimport { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'\nimport type {\n  CreateFactRequest,\n  CreateFactsRequest,\n  FactResponse,\n  FactSearchRequest,\n  FactSearchResponse,\n  ListFactsOptions,\n  UpdateFactRequest,\n} from '@arbidocs/sdk/browser'\nimport { useArbi } from './useArbi'\nimport { arbiQueryKeys } from './hooks'\n\n/** The workspace a fact call names: the one given, else the one open now ('' when none is). */\nfunction factWorkspace(arbi: ReturnType<typeof useArbi>, workspaceId?: string | null): string {\n  return workspaceId || (arbi.hasWorkspace ? arbi.getWorkspaceId() : '')\n}\n\n/** What a list asks for: the timeline range, or the notes carrying tags or citing a document. */\nexport type FactListFilter = Pick<\n  ListFactsOptions,\n  'from' | 'to' | 'datedOnly' | 'tagExtIds' | 'docExtId'\n>\n\n/**\n * The facts of `workspaceId` (default: the open one), newest first, or the filtered ones\n * (`datedOnly` / a range: the timeline, by date; `tagExtIds`: the notes carrying all those tags).\n */\nexport function useFacts(\n  workspaceId?: string | null,\n  options?: FactListFilter & { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  const { enabled = true, ...filter } = options ?? {}\n  const workspace = factWorkspace(arbi, workspaceId)\n  return useQuery({\n    queryKey: arbiQueryKeys.factList(workspace, filter),\n    // The request names the workspace, so a switch while it runs cannot answer for another.\n    queryFn: (): Promise<FactResponse[]> => arbi.facts.list({ ...filter, workspaceId: workspace }),\n    enabled: enabled && !!workspace && arbi.hasWorkspace,\n    staleTime: 30_000,\n  })\n}\n\n/** Refresh every cached fact list after a write. */\nfunction useRefreshFacts() {\n  const qc = useQueryClient()\n  return () => qc.invalidateQueries({ queryKey: arbiQueryKeys.allFacts() })\n}\n\n/**\n * Add a fact (by hand it is confirmed: typing it is the vouch) to `workspaceId` (the message's or\n * the page's), else to the workspace open when it is sent.\n */\nexport function useCreateFact(workspaceId?: string | null) {\n  const arbi = useArbi()\n  const refresh = useRefreshFacts()\n  return useMutation({\n    mutationFn: (body: CreateFactRequest) =>\n      arbi.facts.create(body, { workspaceId: factWorkspace(arbi, workspaceId) || undefined }),\n    onSuccess: refresh,\n  })\n}\n\n/**\n * Add several facts in one all-or-nothing request (an imported chronology, say) to `workspaceId`,\n * else to the workspace open when it is sent.\n */\nexport function useCreateFacts(workspaceId?: string | null) {\n  const arbi = useArbi()\n  const refresh = useRefreshFacts()\n  return useMutation({\n    mutationFn: (body: CreateFactsRequest) =>\n      arbi.facts.createBatch(body, { workspaceId: factWorkspace(arbi, workspaceId) || undefined }),\n    onSuccess: refresh,\n  })\n}\n\n/**\n * Patch a fact. A text edit replaces the fact (the old one is kept as history); `shared` and\n * `confirmed` change in place.\n */\nexport function useUpdateFact() {\n  const arbi = useArbi()\n  const refresh = useRefreshFacts()\n  return useMutation({\n    mutationFn: ({ factId, patch }: { factId: string; patch: UpdateFactRequest }) =>\n      arbi.facts.update(factId, patch),\n    onSuccess: refresh,\n  })\n}\n\n/** Delete a fact (only where the server allows it: a refused delete fails with its reason). */\nexport function useDeleteFact() {\n  const arbi = useArbi()\n  const refresh = useRefreshFacts()\n  return useMutation({\n    mutationFn: (factId: string) => arbi.facts.delete(factId),\n    onSuccess: refresh,\n  })\n}\n\n/**\n * Search the facts of `workspaceId` (default: the open one), hybrid by default, as the agent's fact\n * recall does. The workspace is captured when the search is sent and named on the request.\n */\nexport function useSearchFacts(workspaceId?: string | null) {\n  const arbi = useArbi()\n  return useMutation({\n    mutationFn: (body: FactSearchRequest): Promise<FactSearchResponse> =>\n      arbi.facts.search(body, { workspaceId: factWorkspace(arbi, workspaceId) || undefined }),\n  })\n}\n"],
+  "mappings": "AASA,SAAS,aAAa,UAAU,sBAAsB;AAUtD,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAG9B,SAAS,cAAc,MAAkC,aAAqC;AAC5F,SAAO,gBAAgB,KAAK,eAAe,KAAK,eAAe,IAAI;AACrE;AAYO,SAAS,SACd,aACA,SACA;AACA,QAAM,OAAO,QAAQ;AACrB,QAAM,EAAE,UAAU,MAAM,GAAG,OAAO,IAAI,WAAW,CAAC;AAClD,QAAM,YAAY,cAAc,MAAM,WAAW;AACjD,SAAO,SAAS;AAAA,IACd,UAAU,cAAc,SAAS,WAAW,MAAM;AAAA;AAAA,IAElD,SAAS,MAA+B,KAAK,MAAM,KAAK,EAAE,GAAG,QAAQ,aAAa,UAAU,CAAC;AAAA,IAC7F,SAAS,WAAW,CAAC,CAAC,aAAa,KAAK;AAAA,IACxC,WAAW;AAAA,EACb,CAAC;AACH;AAGA,SAAS,kBAAkB;AACzB,QAAM,KAAK,eAAe;AAC1B,SAAO,MAAM,GAAG,kBAAkB,EAAE,UAAU,cAAc,SAAS,EAAE,CAAC;AAC1E;AAMO,SAAS,cAAc,aAA6B;AACzD,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU,gBAAgB;AAChC,SAAO,YAAY;AAAA,IACjB,YAAY,CAAC,SACX,KAAK,MAAM,OAAO,MAAM,EAAE,aAAa,cAAc,MAAM,WAAW,KAAK,OAAU,CAAC;AAAA,IACxF,WAAW;AAAA,EACb,CAAC;AACH;AAMO,SAAS,eAAe,aAA6B;AAC1D,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU,gBAAgB;AAChC,SAAO,YAAY;AAAA,IACjB,YAAY,CAAC,SACX,KAAK,MAAM,YAAY,MAAM,EAAE,aAAa,cAAc,MAAM,WAAW,KAAK,OAAU,CAAC;AAAA,IAC7F,WAAW;AAAA,EACb,CAAC;AACH;AAMO,SAAS,gBAAgB;AAC9B,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU,gBAAgB;AAChC,SAAO,YAAY;AAAA,IACjB,YAAY,CAAC,EAAE,QAAQ,MAAM,MAC3B,KAAK,MAAM,OAAO,QAAQ,KAAK;AAAA,IACjC,WAAW;AAAA,EACb,CAAC;AACH;AAGO,SAAS,gBAAgB;AAC9B,QAAM,OAAO,QAAQ;AACrB,QAAM,UAAU,gBAAgB;AAChC,SAAO,YAAY;AAAA,IACjB,YAAY,CAAC,WAAmB,KAAK,MAAM,OAAO,MAAM;AAAA,IACxD,WAAW;AAAA,EACb,CAAC;AACH;AAMO,SAAS,eAAe,aAA6B;AAC1D,QAAM,OAAO,QAAQ;AACrB,SAAO,YAAY;AAAA,IACjB,YAAY,CAAC,SACX,KAAK,MAAM,OAAO,MAAM,EAAE,aAAa,cAAc,MAAM,WAAW,KAAK,OAAU,CAAC;AAAA,EAC1F,CAAC;AACH;",
+  "names": []
+}

package/dist/hooks.js

@@ -0,0 +1,320 @@
+import { useEffect, useMemo, useRef } from "react";
+import { useInfiniteQuery, useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { useArbi } from "./useArbi.js";
+import { useArbiSessionStore } from "./session/index.js";
+import { isUsageMetered } from "./usage-metered.js";
+import { parseVersionRef } from "./artifacts/versions.js";
+import { arbiQueryKeys, arbiMutationKeys } from "./query-keys.js";
+import { arbiQueryKeys as arbiQueryKeys2 } from "./query-keys.js";
+function useWorkspaces(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.workspaces(),
+    queryFn: () => arbi.workspaces.list(),
+    enabled: (options?.enabled ?? true) && arbi.isLoggedIn
+  });
+}
+function useDocumentVersionList(docId, options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.documentVersions(docId ?? ""),
+    queryFn: () => arbi.documents.versions(docId),
+    enabled: (options?.enabled ?? true) && !!docId && arbi.hasWorkspace
+  });
+}
+function useConversations(workspaceId, options) {
+  const arbi = useArbi();
+  const live = options?.live === true;
+  return useQuery({
+    queryKey: arbiQueryKeys2.conversations(workspaceId ?? ""),
+    // The request names the workspace, so a switch while it runs cannot answer for another.
+    queryFn: () => arbi.conversations.list({ workspaceId }),
+    enabled: (options?.enabled ?? true) && !!workspaceId && arbi.hasWorkspace,
+    placeholderData: (previous) => previous,
+    ...live ? {
+      refetchInterval: (query) => query.state.data?.some((conversation) => conversation.status === "generating") ? 3e3 : 15e3
+    } : { staleTime: Infinity, refetchOnMount: false, refetchOnReconnect: false }
+  });
+}
+function useBuiltinCommands() {
+  const arbi = useArbi();
+  const query = useQuery({
+    queryKey: arbiQueryKeys2.assistantCommands(),
+    queryFn: () => arbi.assistant.commands(),
+    staleTime: 30 * 1e3,
+    enabled: arbi.isLoggedIn
+  });
+  const commands = useMemo(() => query.data ?? [], [query.data]);
+  return { commands, isLoading: query.isLoading };
+}
+function useMessageDetails(messageId, options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.messageDetails(messageId ?? ""),
+    queryFn: () => arbi.conversations.getMessage(messageId),
+    enabled: (options?.enabled ?? true) && !!messageId && arbi.isLoggedIn
+  });
+}
+function useConversationThreads(conversationId, options) {
+  const arbi = useArbi();
+  const session = useArbiSessionStore();
+  return useQuery({
+    queryKey: arbiQueryKeys2.conversationThreads(conversationId ?? ""),
+    queryFn: () => arbi.conversations.getThreads(conversationId),
+    enabled: (options?.enabled ?? true) && !!conversationId && arbi.hasWorkspace,
+    staleTime: 2 * 60 * 1e3,
+    refetchOnWindowFocus: () => session.getState().generating[conversationId ?? ""]?.isGenerating ? false : "always",
+    refetchInterval: options?.live ? 3e3 : false
+  });
+}
+const tagListKey = (query) => [
+  query.kind ? `kind:${query.kind}` : "",
+  query.parentId ? `parent:${query.parentId}` : "",
+  query.ids?.length ? `ids:${query.ids.join(",")}` : "",
+  query.include?.length ? `include:${query.include.join(",")}` : "",
+  query.linksLimit !== void 0 ? `links:${query.linksLimit}` : ""
+].filter(Boolean).join("|");
+function useTags(workspaceId, options) {
+  const arbi = useArbi();
+  const { enabled, ...query } = options ?? {};
+  const workspace = workspaceId ?? (arbi.hasWorkspace ? arbi.getWorkspaceId() : "");
+  const key = tagListKey(query);
+  return useQuery({
+    queryKey: key ? arbiQueryKeys2.tagList(workspace, key) : arbiQueryKeys2.tags(workspace),
+    // The request names the workspace (opened for this session first when it is not the current
+    // one), so another workspace's tags can be listed and a switch cannot answer for it. The
+    // current workspace's list is also read under the switch guard.
+    queryFn: () => {
+      const list = () => arbi.tags.list({ ...key ? query : {}, workspaceId: workspace });
+      return workspace === arbi.getWorkspaceId() ? arbi.readInWorkspace(workspace, list) : list();
+    },
+    enabled: (enabled ?? true) && !!workspace && arbi.hasWorkspace && (query.ids === void 0 || query.ids.length > 0),
+    ...key ? {} : { staleTime: Infinity }
+  });
+}
+function useThumbnails(docIds, options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.thumbnails(docIds),
+    queryFn: () => arbi.documents.getThumbnails(docIds),
+    enabled: (options?.enabled ?? true) && docIds.length > 0 && arbi.hasWorkspace,
+    staleTime: 5 * 6e4
+  });
+}
+function useParsedDocument(docId, stage = "final", options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.parsedDoc(docId ?? "", stage),
+    queryFn: () => {
+      const { docId: id, version } = parseVersionRef(docId);
+      return arbi.documents.getParsedContent(
+        id,
+        stage,
+        version ?? void 0
+      );
+    },
+    enabled: (options?.enabled ?? true) && !!docId && arbi.hasWorkspace
+  });
+}
+function useAssistantQuery() {
+  const arbi = useArbi();
+  return useMutation({
+    mutationFn: ({ request, handlers }) => arbi.assistant.ask(request, handlers)
+  });
+}
+function useAgents(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.agents(),
+    queryFn: () => arbi.agents.list(),
+    enabled: (options?.enabled ?? true) && arbi.isLoggedIn
+  });
+}
+function useDeleteAgents() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({ agentExtIds }) => arbi.agents.delete(agentExtIds),
+    onSuccess: (_result, { agentExtIds }) => {
+      for (const id of agentExtIds) {
+        qc.removeQueries({ queryKey: arbiQueryKeys2.agentConfig(id) });
+        qc.removeQueries({ queryKey: arbiQueryKeys2.agentWorkspaces(id) });
+      }
+      return Promise.all([
+        qc.invalidateQueries({ queryKey: arbiQueryKeys2.agents() }),
+        qc.invalidateQueries({ queryKey: arbiQueryKeys2.workflows() }),
+        qc.invalidateQueries({ queryKey: arbiQueryKeys2.allConversations() }),
+        qc.invalidateQueries({ queryKey: arbiQueryKeys2.configs() })
+      ]);
+    }
+  });
+}
+function useHealth(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.health(),
+    queryFn: () => arbi.health.check(),
+    enabled: options?.enabled
+  });
+}
+function useAvailableModels(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.availableModels(),
+    queryFn: () => arbi.health.models(),
+    staleTime: Infinity,
+    enabled: (options?.enabled ?? true) && arbi.isLoggedIn
+  });
+}
+function useConfigs(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.configVersions(),
+    queryFn: () => arbi.agentConfig.list(),
+    enabled: options?.enabled ?? arbi.isLoggedIn
+  });
+}
+function useConfig(configId, options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.config(configId ?? ""),
+    queryFn: () => arbi.agentConfig.get(configId),
+    staleTime: 10 * 60 * 1e3,
+    enabled: (options?.enabled ?? true) && !!configId && arbi.isLoggedIn
+  });
+}
+function useActivity(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.activity(),
+    queryFn: () => arbi.dm.listActivity({ limit: options?.limit, offset: options?.offset }),
+    enabled: options?.enabled ?? arbi.isLoggedIn
+  });
+}
+function useWorkspaceActivity(workspaceId, options) {
+  const arbi = useArbi();
+  return useInfiniteQuery({
+    queryKey: arbiQueryKeys2.workspaceActivity(workspaceId ?? "", options?.limit),
+    queryFn: async ({ pageParam }) => {
+      await options?.beforeFetch?.();
+      return arbi.workspaces.activity(workspaceId, {
+        cursor: pageParam,
+        limit: options?.limit
+      });
+    },
+    initialPageParam: null,
+    getNextPageParam: (page) => page.next_cursor ?? void 0,
+    enabled: (options?.enabled ?? true) && !!workspaceId && arbi.isLoggedIn
+  });
+}
+function useProjects(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.projects(),
+    queryFn: () => arbi.projects.list(),
+    enabled: options?.enabled ?? arbi.isLoggedIn
+  });
+}
+function useProjectUsage(projectExtId, monthsBack = 0, options) {
+  const arbi = useArbi();
+  const usage = useQuery({
+    queryKey: arbiQueryKeys2.projectUsage(projectExtId ?? "", monthsBack),
+    queryFn: () => arbi.projects.usage(projectExtId, monthsBack),
+    enabled: (options?.enabled ?? true) && !!projectExtId && arbi.isLoggedIn
+  });
+  const projects = useProjects({ enabled: !!projectExtId && (options?.enabled ?? true) });
+  const subscription = projects.data?.find((p) => p.external_id === projectExtId)?.subscription;
+  const metered = usage.data ? isUsageMetered(usage.data, subscription) : void 0;
+  return { ...usage, metered };
+}
+function useProjectInvoices(projectExtId, options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.projectInvoices(projectExtId ?? ""),
+    queryFn: () => arbi.projects.invoices(projectExtId),
+    enabled: (options?.enabled ?? true) && !!projectExtId && arbi.isLoggedIn
+  });
+}
+function useCurrentUser(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.currentUser(),
+    queryFn: () => arbi.user.me(),
+    enabled: options?.enabled ?? arbi.isLoggedIn,
+    refetchOnWindowFocus: true,
+    staleTime: 3e4
+  });
+}
+function useFirmPool(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.firmPool(),
+    queryFn: () => arbi.firm.pool(),
+    enabled: (options?.enabled ?? true) && arbi.isLoggedIn,
+    retry: false,
+    refetchOnWindowFocus: true,
+    staleTime: 6e4
+  });
+}
+function useBoxRole(options = {}) {
+  const { data, isError } = useFirmPool(options);
+  const isBox = !isError && !!data?.has_pool;
+  return { isBox, isBoxAdmin: isBox && !!data?.can_top_up };
+}
+const PROJECT_CREATION_DENIED_REASON = "Only members of your firm can create projects and workspaces.";
+function useCanCreateProjects() {
+  const user = useCurrentUser();
+  const { data: workspaces } = useWorkspaces({ enabled: user.isSuccess });
+  const membership = workspaces?.map((w) => w.external_id).join(",");
+  const { refetch } = user;
+  const seen = useRef(void 0);
+  useEffect(() => {
+    if (membership === void 0 || membership === seen.current) return;
+    const first = seen.current === void 0;
+    seen.current = membership;
+    if (!first) void refetch();
+  }, [membership, refetch]);
+  return user.data?.can_create_projects;
+}
+function useUserUsageToday(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys2.userUsageToday(),
+    queryFn: () => arbi.user.usageToday(),
+    enabled: (options?.enabled ?? true) && arbi.isLoggedIn,
+    refetchOnWindowFocus: true,
+    refetchOnMount: "always",
+    staleTime: 15e3
+  });
+}
+export {
+  PROJECT_CREATION_DENIED_REASON,
+  arbiMutationKeys,
+  arbiQueryKeys,
+  useActivity,
+  useAgents,
+  useAssistantQuery,
+  useAvailableModels,
+  useBoxRole,
+  useBuiltinCommands,
+  useCanCreateProjects,
+  useConfig,
+  useConfigs,
+  useConversationThreads,
+  useConversations,
+  useCurrentUser,
+  useDeleteAgents,
+  useDocumentVersionList,
+  useHealth,
+  useMessageDetails,
+  useParsedDocument,
+  useProjectInvoices,
+  useProjectUsage,
+  useProjects,
+  useTags,
+  useThumbnails,
+  useUserUsageToday,
+  useWorkspaceActivity,
+  useWorkspaces
+};
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/hooks.ts"],
+  "sourcesContent": ["/**\n * React Query hooks that use the Arbi instance from context.\n */\n\nimport { useEffect, useMemo, useRef } from 'react'\nimport { useInfiniteQuery, useQuery, useMutation, useQueryClient } from '@tanstack/react-query'\nimport {\n  type AskHandlers,\n  type AskRequest,\n  type SSEStreamResult,\n  type TagListQuery,\n  type ThreadsResponse,\n} from '@arbidocs/sdk/browser'\nimport { useArbi } from './useArbi'\nimport { useArbiSessionStore } from './session'\nimport type { ParsedDocument } from './documents/parsed-types'\nimport { isUsageMetered } from './usage-metered'\nimport { parseVersionRef } from './artifacts/versions'\n\n// \u2500\u2500 Query keys \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n// The one key factory (every query and mutation key of the packages and the app): ./query-keys.\nexport { arbiQueryKeys, arbiMutationKeys } from './query-keys'\nimport { arbiQueryKeys } from './query-keys'\n\n// \u2500\u2500 Hooks \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/** List the logged-in user's workspaces. */\nexport function useWorkspaces(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.workspaces(),\n    queryFn: () => arbi.workspaces.list(),\n    enabled: (options?.enabled ?? true) && arbi.isLoggedIn,\n  })\n}\n\n/** Every version of the document `docId`, oldest first (`is_current` marks the current one). */\nexport function useDocumentVersionList(\n  docId: string | null | undefined,\n  options?: { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.documentVersions(docId ?? ''),\n    queryFn: () => arbi.documents.versions(docId as string),\n    enabled: (options?.enabled ?? true) && !!docId && arbi.hasWorkspace,\n  })\n}\n\n/**\n * A workspace's conversations (threads and tasks). The list is kept current by its writers and the\n * workspace's events (`conversation-list`), so it is not re-read on every mount; `live` re-reads it\n * on a timer instead, faster while something is generating, for a view that follows runs by itself.\n */\nexport function useConversations(\n  workspaceId: string | undefined,\n  options?: { enabled?: boolean; live?: boolean }\n) {\n  const arbi = useArbi()\n  const live = options?.live === true\n  return useQuery({\n    queryKey: arbiQueryKeys.conversations(workspaceId ?? ''),\n    // The request names the workspace, so a switch while it runs cannot answer for another.\n    queryFn: () => arbi.conversations.list({ workspaceId: workspaceId as string }),\n    enabled: (options?.enabled ?? true) && !!workspaceId && arbi.hasWorkspace,\n    placeholderData: (previous) => previous,\n    ...(live\n      ? {\n          refetchInterval: (query: { state: { data?: Array<{ status?: string | null }> } }) =>\n            query.state.data?.some((conversation) => conversation.status === 'generating')\n              ? 3000\n              : 15000,\n        }\n      : { staleTime: Infinity, refetchOnMount: false, refetchOnReconnect: false }),\n  })\n}\n\n/** The backend's built-in slash commands (`/compact`, `/goal`, \u2026), for a slash menu. */\nexport function useBuiltinCommands() {\n  const arbi = useArbi()\n  const query = useQuery({\n    queryKey: arbiQueryKeys.assistantCommands(),\n    queryFn: () => arbi.assistant.commands(),\n    staleTime: 30 * 1000,\n    enabled: arbi.isLoggedIn,\n  })\n  // Stable identity so a menu's merge and filter memos do not rerun every render.\n  const commands = useMemo(() => query.data ?? [], [query.data])\n  return { commands, isLoading: query.isLoading }\n}\n\n/** One stored message with everything the server keeps on it (its trace and metadata). */\nexport function useMessageDetails(\n  messageId: string | null | undefined,\n  options?: { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.messageDetails(messageId ?? ''),\n    queryFn: () => arbi.conversations.getMessage(messageId as string),\n    enabled: (options?.enabled ?? true) && !!messageId && arbi.isLoggedIn,\n  })\n}\n\n/**\n * A conversation's stored threads (each with its message history, citations data included). The\n * chat engine and the conversation's events keep the cache current, so it is re-read only when\n * stale (2 minutes) or when the page is shown again while this tab is not streaming the\n * conversation (a turn sent from another tab never reaches this one's socket). A conversation with\n * no messages yet (a new to-do, a workflow's task before its run) comes back with no threads. A 404\n * is a conversation this user cannot see (gone, or in a workspace they left): an error, never cached\n * as an empty conversation to write into. `live` re-reads it every few seconds.\n */\nexport function useConversationThreads(\n  conversationId: string | undefined,\n  options?: { enabled?: boolean; live?: boolean }\n) {\n  const arbi = useArbi()\n  const session = useArbiSessionStore()\n  return useQuery({\n    queryKey: arbiQueryKeys.conversationThreads(conversationId ?? ''),\n    queryFn: (): Promise<ThreadsResponse> =>\n      arbi.conversations.getThreads(conversationId as string),\n    enabled: (options?.enabled ?? true) && !!conversationId && arbi.hasWorkspace,\n    staleTime: 2 * 60 * 1000,\n    refetchOnWindowFocus: () =>\n      session.getState().generating[conversationId ?? '']?.isGenerating ? false : 'always',\n    refetchInterval: options?.live ? 3000 : false,\n  })\n}\n\n/** A tag list query as a stable cache key ('' for every tag). */\nconst tagListKey = (query: TagListQuery): string =>\n  [\n    query.kind ? `kind:${query.kind}` : '',\n    query.parentId ? `parent:${query.parentId}` : '',\n    query.ids?.length ? `ids:${query.ids.join(',')}` : '',\n    query.include?.length ? `include:${query.include.join(',')}` : '',\n    query.linksLimit !== undefined ? `links:${query.linksLimit}` : '',\n  ]\n    .filter(Boolean)\n    .join('|')\n\n/**\n * List tags in a workspace (default: the open one) \u2014 all of them, or filtered: `{ kind: 'issue',\n * include: ['links'] }` is every issue with its documents, facts and threads (a table's rows; its\n * columns come from `useTagKindSchema`). `ids: []` asks for nothing.\n *\n * The whole list is read once and then kept current in place: the tag writes patch it\n * (`patchWorkspaceTags`), and an invalidation of the workspace's tags (a WebSocket event, a host\n * refresh) re-reads it. It is never re-read just for being mounted or the window being focused.\n */\nexport function useTags(\n  workspaceId?: string | null,\n  options?: TagListQuery & { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  const { enabled, ...query } = options ?? {}\n  const workspace = workspaceId ?? (arbi.hasWorkspace ? arbi.getWorkspaceId() : '')\n  const key = tagListKey(query)\n  return useQuery({\n    queryKey: key ? arbiQueryKeys.tagList(workspace, key) : arbiQueryKeys.tags(workspace),\n    // The request names the workspace (opened for this session first when it is not the current\n    // one), so another workspace's tags can be listed and a switch cannot answer for it. The\n    // current workspace's list is also read under the switch guard.\n    queryFn: () => {\n      const list = () => arbi.tags.list({ ...(key ? query : {}), workspaceId: workspace })\n      return workspace === arbi.getWorkspaceId() ? arbi.readInWorkspace(workspace, list) : list()\n    },\n    enabled:\n      (enabled ?? true) &&\n      !!workspace &&\n      arbi.hasWorkspace &&\n      (query.ids === undefined || query.ids.length > 0),\n    ...(key ? {} : { staleTime: Infinity }),\n  })\n}\n\n/**\n * Batch-fetch first-page thumbnails for a set of documents. Returns a map of\n * doc external id \u2192 `data:image/webp` URI (or `null` when no thumbnail exists).\n * Cached for a few minutes since thumbnails are effectively immutable per doc.\n */\nexport function useThumbnails(docIds: string[], options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.thumbnails(docIds),\n    queryFn: () => arbi.documents.getThumbnails(docIds),\n    enabled: (options?.enabled ?? true) && docIds.length > 0 && arbi.hasWorkspace,\n    staleTime: 5 * 60_000,\n  })\n}\n\n/**\n * Fetch a document's parsed content (chunks grouped by page) for the review\n * viewer. `stage` defaults to `final` (fully processed); `marker`/`subchunk`\n * expose earlier pipeline stages. `docId` may be a version reference (`doc-\u2026@v2`).\n */\nexport function useParsedDocument(\n  docId: string | undefined,\n  stage: string = 'final',\n  options?: { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.parsedDoc(docId ?? '', stage),\n    queryFn: () => {\n      // A version reference (`doc-\u2026@v2`) reads that version's parse.\n      const { docId: id, version } = parseVersionRef(docId as string)\n      return arbi.documents.getParsedContent(\n        id,\n        stage,\n        version ?? undefined\n      ) as unknown as Promise<ParsedDocument>\n    },\n    enabled: (options?.enabled ?? true) && !!docId && arbi.hasWorkspace,\n  })\n}\n\n/**\n * Ask the assistant (`arbi.assistant.ask`) as a mutation: one streaming turn, its frames to\n * `handlers`, resolving with the accumulated result.\n */\nexport function useAssistantQuery() {\n  const arbi = useArbi()\n  return useMutation<SSEStreamResult, Error, { request: AskRequest; handlers?: AskHandlers }>({\n    mutationFn: ({ request, handlers }) => arbi.assistant.ask(request, handlers),\n  })\n}\n\n/** List agents owned by the current user. */\nexport function useAgents(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.agents(),\n    queryFn: () => arbi.agents.list(),\n    enabled: (options?.enabled ?? true) && arbi.isLoggedIn,\n  })\n}\n\n/**\n * Delete agents. Returns a mutation. Refreshes the agent list, the workflow list and the conversation list\n * (a deleted agent's workflows and work go with it), and drops the deleted agents' own config and workspace queries.\n */\nexport function useDeleteAgents() {\n  const arbi = useArbi()\n  const qc = useQueryClient()\n  return useMutation<unknown, Error, { agentExtIds: string[] }>({\n    mutationFn: ({ agentExtIds }) => arbi.agents.delete(agentExtIds),\n    onSuccess: (_result, { agentExtIds }) => {\n      for (const id of agentExtIds) {\n        qc.removeQueries({ queryKey: arbiQueryKeys.agentConfig(id) })\n        qc.removeQueries({ queryKey: arbiQueryKeys.agentWorkspaces(id) })\n      }\n      return Promise.all([\n        qc.invalidateQueries({ queryKey: arbiQueryKeys.agents() }),\n        qc.invalidateQueries({ queryKey: arbiQueryKeys.workflows() }),\n        qc.invalidateQueries({ queryKey: arbiQueryKeys.allConversations() }),\n        qc.invalidateQueries({ queryKey: arbiQueryKeys.configs() }),\n      ])\n    },\n  })\n}\n\n/** Authorize a delegated session (generates claim code). Returns a mutation. */\n\n/** Check backend health. */\nexport function useHealth(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.health(),\n    queryFn: () => arbi.health.check(),\n    enabled: options?.enabled,\n  })\n}\n\n/**\n * The deployment's models with their tags (`Standard`, `Premium`), providers and per-token costs,\n * and the default premium model. Static per deployment: read once.\n */\nexport function useAvailableModels(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.availableModels(),\n    queryFn: () => arbi.health.models(),\n    staleTime: Infinity,\n    enabled: (options?.enabled ?? true) && arbi.isLoggedIn,\n  })\n}\n\n// \u2500\u2500 Behaviour-template configs \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/** List the caller's saved agent configurations (behaviour templates). */\nexport function useConfigs(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.configVersions(),\n    queryFn: () => arbi.agentConfig.list(),\n    enabled: options?.enabled ?? arbi.isLoggedIn,\n  })\n}\n\n/** One saved agent configuration (its models, its tools). Configs change only on a save. */\nexport function useConfig(configId: string | null | undefined, options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.config(configId ?? ''),\n    queryFn: () => arbi.agentConfig.get(configId as string),\n    staleTime: 10 * 60 * 1000,\n    enabled: (options?.enabled ?? true) && !!configId && arbi.isLoggedIn,\n  })\n}\n\n// \u2500\u2500 Activity feed \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * List the caller's durable activity feed, newest first.\n *\n * Activity entries are backend-originated, to-self log lines that are always\n * read \u2014 they are deliberately kept out of the normal notifications/DM feed and\n * never affect the unread badge, so this is a separate, opt-in query.\n */\nexport function useActivity(options?: { enabled?: boolean; limit?: number; offset?: number }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.activity(),\n    queryFn: () => arbi.dm.listActivity({ limit: options?.limit, offset: options?.offset }),\n    enabled: options?.enabled ?? arbi.isLoggedIn,\n  })\n}\n\n/**\n * A workspace's activity feed, newest first, a page at a time: thread history, people posting,\n * uploads, new versions and signatures, workflow runs. Only what the caller can see. The pages\n * are `data.pages`; `fetchNextPage` reads the next one while `hasNextPage`.\n */\nexport function useWorkspaceActivity(\n  workspaceId: string | null | undefined,\n  options?: {\n    enabled?: boolean\n    limit?: number\n    /** Runs before each page, e.g. to (re)open the workspace so titles and names decrypt. */\n    beforeFetch?: () => Promise<unknown>\n  }\n) {\n  const arbi = useArbi()\n  return useInfiniteQuery({\n    queryKey: arbiQueryKeys.workspaceActivity(workspaceId ?? '', options?.limit),\n    queryFn: async ({ pageParam }) => {\n      await options?.beforeFetch?.()\n      return arbi.workspaces.activity(workspaceId as string, {\n        cursor: pageParam,\n        limit: options?.limit,\n      })\n    },\n    initialPageParam: null as string | null,\n    getNextPageParam: (page) => page.next_cursor ?? undefined,\n    enabled: (options?.enabled ?? true) && !!workspaceId && arbi.isLoggedIn,\n  })\n}\n\n// \u2500\u2500 Projects, usage & spend \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/** List the logged-in user's projects (billing accounts). */\nexport function useProjects(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.projects(),\n    queryFn: () => arbi.projects.list(),\n    enabled: options?.enabled ?? arbi.isLoggedIn,\n  })\n}\n\n/**\n * AI usage breakdown for a project's billing period. `monthsBack` selects the period (0 =\n * current, 1 = previous month, \u2026).\n *\n * The response's `total_spend` / `spend` fields are \u00A3 of AI usage (format with `formatGbp`).\n * `metered` is `false` when the deployment does not record usage (a `dev`-plan project with all\n * zeros): show \"usage is not metered here\" instead of zeros. It is `undefined` until the usage\n * has loaded.\n */\nexport function useProjectUsage(\n  projectExtId: string | undefined,\n  monthsBack: number = 0,\n  options?: { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  const usage = useQuery({\n    queryKey: arbiQueryKeys.projectUsage(projectExtId ?? '', monthsBack),\n    queryFn: () => arbi.projects.usage(projectExtId as string, monthsBack),\n    enabled: (options?.enabled ?? true) && !!projectExtId && arbi.isLoggedIn,\n  })\n  const projects = useProjects({ enabled: !!projectExtId && (options?.enabled ?? true) })\n  const subscription = projects.data?.find((p) => p.external_id === projectExtId)?.subscription\n  const metered = usage.data ? isUsageMetered(usage.data, subscription) : undefined\n  return { ...usage, metered }\n}\n\n/** List the Stripe invoices for a project's subscription. */\nexport function useProjectInvoices(\n  projectExtId: string | undefined,\n  options?: { enabled?: boolean }\n) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.projectInvoices(projectExtId ?? ''),\n    queryFn: () => arbi.projects.invoices(projectExtId as string),\n    enabled: (options?.enabled ?? true) && !!projectExtId && arbi.isLoggedIn,\n  })\n}\n\n/**\n * The signed-in user from `GET /v1/user/me`. Refetched on window focus, so a role granted or\n * removed elsewhere shows up without a reload; invalidate `arbiQueryKeys.currentUser()` after a\n * change you made yourself.\n */\nexport function useCurrentUser(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.currentUser(),\n    queryFn: () => arbi.user.me(),\n    enabled: options?.enabled ?? arbi.isLoggedIn,\n    refetchOnWindowFocus: true,\n    staleTime: 30_000,\n  })\n}\n\n/**\n * The firm's pooled monthly \u00A3 of AI usage (Box deployments). A 403 (the caller is not a firm member\n * or Box admin) is not retried: treat an error like `has_pool: false` and show nothing.\n */\nfunction useFirmPool(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.firmPool(),\n    queryFn: () => arbi.firm.pool(),\n    enabled: (options?.enabled ?? true) && arbi.isLoggedIn,\n    retry: false,\n    refetchOnWindowFocus: true,\n    staleTime: 60_000,\n  })\n}\n\n/**\n * Whether this deployment runs under a Box licence (`isBox`) and whether the user administers it in\n * the ARBI portal (`isBoxAdmin`), from the firm pool. Anyone outside the firm gets a 403 (not\n * retried), read as no Box. The API has no Box-admin flag yet: `can_top_up` is true only for a Box\n * admin of a licence central can bill, so admins of a hand-set licence read as members for now.\n */\nexport function useBoxRole(options: { enabled?: boolean } = {}): {\n  isBox: boolean\n  isBoxAdmin: boolean\n} {\n  const { data, isError } = useFirmPool(options)\n  const isBox = !isError && !!data?.has_pool\n  return { isBox, isBoxAdmin: isBox && !!data?.can_top_up }\n}\n\n/** Why \"New project\" / \"New workspace\" is unavailable to someone who may not create them. */\nexport const PROJECT_CREATION_DENIED_REASON =\n  'Only members of your firm can create projects and workspaces.'\n\n/**\n * Whether the signed-in user may create projects and workspaces. `undefined` while the user is\n * loading: callers should neither offer nor refuse creation until it is known.\n */\nexport function useCanCreateProjects(): boolean | undefined {\n  const user = useCurrentUser()\n  // A role granted or removed in a workspace can change it: re-read when the memberships do.\n  const { data: workspaces } = useWorkspaces({ enabled: user.isSuccess })\n  const membership = workspaces?.map((w) => w.external_id).join(',')\n  const { refetch } = user\n  const seen = useRef<string | undefined>(undefined)\n  useEffect(() => {\n    if (membership === undefined || membership === seen.current) return\n    const first = seen.current === undefined\n    seen.current = membership\n    if (!first) void refetch()\n  }, [membership, refetch])\n  return user.data?.can_create_projects\n}\n\n/**\n * Today's deployment-wide AI usage (\u00A3, `used_gbp`) for the signed-in user: pair it with a project's\n * `daily_cap_per_user` for a \"\u00A3 used today\" indicator. Re-read on mount and window focus, and when\n * the host invalidates it after the user's own generation; never polled.\n */\nexport function useUserUsageToday(options?: { enabled?: boolean }) {\n  const arbi = useArbi()\n  return useQuery({\n    queryKey: arbiQueryKeys.userUsageToday(),\n    queryFn: () => arbi.user.usageToday(),\n    enabled: (options?.enabled ?? true) && arbi.isLoggedIn,\n    refetchOnWindowFocus: true,\n    refetchOnMount: 'always',\n    staleTime: 15_000,\n  })\n}\n"],
+  "mappings": "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",
+  "names": ["arbiQueryKeys"]
+}

package/dist/host/ArbiHost.js

@@ -0,0 +1,24 @@
+import { jsx } from "react/jsx-runtime";
+import { useContext, useMemo, useState } from "react";
+import { ArbiHostContext } from "./context.js";
+import { mergeHostConfig, OWN_SESSION_SLOT } from "./merge.js";
+import { configureEntityVocabulary } from "../entities/vocabulary.js";
+function ArbiHost({
+  config,
+  children
+}) {
+  const parent = useContext(ArbiHostContext);
+  const [ownSession] = useState(() => ({ current: null }));
+  const value = useMemo(() => {
+    const merged = mergeHostConfig(parent, config);
+    return merged[OWN_SESSION_SLOT] ? merged : { ...merged, [OWN_SESSION_SLOT]: ownSession };
+  }, [parent, config, ownSession]);
+  const { vocabulary } = config;
+  if (vocabulary) configureEntityVocabulary(vocabulary);
+  const Connection = config.connection?.Provider;
+  return /* @__PURE__ */ jsx(ArbiHostContext.Provider, { value, children: Connection ? /* @__PURE__ */ jsx(Connection, { children }) : children });
+}
+export {
+  ArbiHost
+};
+//# sourceMappingURL=ArbiHost.js.map

package/dist/host/ArbiHost.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/host/ArbiHost.tsx"],
+  "sourcesContent": ["/**\n * `<ArbiHost config>`: the one place a host app hands its configuration to every hook and kit.\n *\n *   <ArbiHost config={{ arbi, session, documents, calendar, mail, account, \u2026 }}>\n *     <App />\n *   </ArbiHost>\n *\n * Every field is optional and has a default (see `ArbiHostConfig`); a kit reads its domain from\n * the config (`useArbiHost().documents`, `useHost().billing` in blocks). A nested `<ArbiHost>`\n * overrides only the fields it gives and inherits the rest (`environment` field by field), for a\n * subtree that opens projects in its own tabs, say. There is no other host provider: a new domain\n * is a new optional field, never a new provider.\n *\n * SDK-free (this module, ./context, ./merge and the entity vocabulary are all it reaches), so a\n * marketing site that only sets the blocks environment does not bundle the SDK.\n */\n\nimport { useContext, useMemo, useState, type ComponentType, type ReactNode } from 'react'\nimport { ArbiHostContext } from './context'\nimport { mergeHostConfig, OWN_SESSION_SLOT } from './merge'\nimport { configureEntityVocabulary, type EntityVocabulary } from '../entities/vocabulary'\n\n/** A sign-in layer mounted inside the host (`defaultHost` in `@arbidocs/blocks/connect`). */\nexport interface ArbiHostConnection {\n  Provider: ComponentType<{ children: ReactNode }>\n}\n\nexport interface ArbiHostProps<Config extends object> {\n  config: Config\n  children?: ReactNode\n}\n\n/**\n * Provide the host configuration. Typed by the package it is imported from: `@arbidocs/react`'s\n * takes the react domains, `@arbidocs/blocks`' the blocks domains as well.\n */\nexport function ArbiHost<Config extends object>({\n  config,\n  children,\n}: ArbiHostProps<Config>): React.ReactElement {\n  const parent = useContext(ArbiHostContext)\n  // A top-level host without a session store gets its own, made on first use (useArbiSessionStore).\n  const [ownSession] = useState(() => ({ current: null as unknown }))\n  const value = useMemo(() => {\n    const merged = mergeHostConfig(parent, config)\n    return merged[OWN_SESSION_SLOT] ? merged : { ...merged, [OWN_SESSION_SLOT]: ownSession }\n  }, [parent, config, ownSession])\n  // The site's nouns are in place before any kit below renders a label.\n  const { vocabulary } = config as { vocabulary?: EntityVocabulary }\n  if (vocabulary) configureEntityVocabulary(vocabulary)\n  const Connection = (config as { connection?: ArbiHostConnection }).connection?.Provider\n  return (\n    <ArbiHostContext.Provider value={value}>\n      {Connection ? <Connection>{children}</Connection> : children}\n    </ArbiHostContext.Provider>\n  )\n}\n"],
+  "mappings": "AAqDoB;AApCpB,SAAS,YAAY,SAAS,gBAAoD;AAClF,SAAS,uBAAuB;AAChC,SAAS,iBAAiB,wBAAwB;AAClD,SAAS,iCAAwD;AAgB1D,SAAS,SAAgC;AAAA,EAC9C;AAAA,EACA;AACF,GAA8C;AAC5C,QAAM,SAAS,WAAW,eAAe;AAEzC,QAAM,CAAC,UAAU,IAAI,SAAS,OAAO,EAAE,SAAS,KAAgB,EAAE;AAClE,QAAM,QAAQ,QAAQ,MAAM;AAC1B,UAAM,SAAS,gBAAgB,QAAQ,MAAM;AAC7C,WAAO,OAAO,gBAAgB,IAAI,SAAS,EAAE,GAAG,QAAQ,CAAC,gBAAgB,GAAG,WAAW;AAAA,EACzF,GAAG,CAAC,QAAQ,QAAQ,UAAU,CAAC;AAE/B,QAAM,EAAE,WAAW,IAAI;AACvB,MAAI,WAAY,2BAA0B,UAAU;AACpD,QAAM,aAAc,OAA+C,YAAY;AAC/E,SACE,oBAAC,gBAAgB,UAAhB,EAAyB,OACvB,uBAAa,oBAAC,cAAY,UAAS,IAAgB,UACtD;AAEJ;",
+  "names": []
+}

package/dist/host/assistant-copy.js

@@ -0,0 +1,54 @@
+import { useMemo } from "react";
+import { useHostConfigRecord } from "./context.js";
+const DEFAULT_ASSISTANT_NAME = "ARBI";
+const plural = (n) => n === 1 ? "" : "s";
+function assistantCopy(name = DEFAULT_ASSISTANT_NAME) {
+  return {
+    name,
+    ask: `Ask ${name}`,
+    askAnything: `Ask ${name} anything`,
+    askAnythingPlaceholder: `Ask ${name} anything\u2026`,
+    askPlaceholder: `Ask ${name}...`,
+    askAboutDocuments: `Ask ${name} about your documents`,
+    askAboutSelection: `Ask ${name} about the selected document(s) in a new thread`,
+    isAsking: `${name} is asking`,
+    answerPlaceholder: `Type your answer to ${name} \u2014 or pick an option above`,
+    emptyThreadsComposer: `Type below to ask ${name}, bring in people, or both.`,
+    emptyThreadsNewTask: `Use New Task to ask ${name}, bring in people, or both.`,
+    draftingHint: `This thread works in the document: ${name} reads what it needs and makes its edits as tracked changes you accept or reject.`,
+    draftingAttachHint: `Attach the open document to this thread: its questions then edit the document as tracked changes. Until then, ${name} only answers.`,
+    factsInContext: (facts) => `${facts} added to this chat are always in ${name}'s context for this chat.`,
+    reviewEach: (count, scope) => `Ask one question \u2014 ${name} answers it for each of the ${count} ${scope} document${plural(count)}.`,
+    factsBudgetHint: `Facts added to this chat are always in ${name}'s context for this chat, so they share one budget. This estimates the tokens they add (\u22484 characters per token), capped at ~2,000.`,
+    noAnswerHint: `${name} finished this document without an answer for this field. The document may not say, or the request failed. Run it again to retry.`,
+    startWith: `Start with ${name}`,
+    replyWith: `Reply with ${name}`,
+    include: `Include ${name}`,
+    replyNeedsWorkspace: `Open a workspace to chat with ${name} about this email`,
+    uploadedIndexing: `Files uploaded successfully. ${name} is now indexing them in the background.`,
+    afterUpload: `After upload completes, ${name} will index files in the background.`,
+    deepResearch: {
+      description: `Send ${name} through your files and the web, and get an answer with sources`,
+      details: `${name} searches your files and the web, then answers with the sources it used. You\u2019ll see the research unfold in the chat.`
+    },
+    annotate: {
+      details: `Ask one question \u2014 ${name} answers it for every selected file and fills a new column with the answers.`,
+      placeholder: `What should ${name} read out? e.g. What currency is the penalty clause denominated in?`
+    }
+  };
+}
+function useAssistantName() {
+  const name = useHostConfigRecord().assistantName;
+  return typeof name === "string" && name.trim() || DEFAULT_ASSISTANT_NAME;
+}
+function useAssistantCopy() {
+  const name = useAssistantName();
+  return useMemo(() => assistantCopy(name), [name]);
+}
+export {
+  DEFAULT_ASSISTANT_NAME,
+  assistantCopy,
+  useAssistantCopy,
+  useAssistantName
+};
+//# sourceMappingURL=assistant-copy.js.map