@athenaintel/react 0.21.1 → 0.22.0

package/dist/collab/presence-mint.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Public-API clients for the workspace presence feed.
+ *
+ * Two endpoints, both admin-only and both under the workspace:
+ *
+ * - `POST /api/v0/workspaces/{workspaceId}/presence-token` mints a
+ *   **read-only** Keryx token for the workspace awareness room
+ *   (`<workspaceId>/awareness`) — the same per-recipient-filtered presence
+ *   feed the Olympus People page renders. The holder can receive presence and
+ *   broadcast nothing; `connectWorkspacePresence` re-mints before expiry.
+ * - `POST /api/v0/workspaces/{workspaceId}/presence/resolve` turns the opaque
+ *   ids carried in awareness contexts (asset ids, session thread ids, project
+ *   ids) into titles the caller may see. Only things the caller may open come
+ *   back; missing ids are simply absent.
+ *
+ * Wire shapes are snake_case, matching `CollabTokenResponse`.
+ */
+import { type CollabAuth } from './mint';
+/** Grant for the workspace awareness room. Always read-only (`access_type: 'r'`). */
+export interface WorkspacePresenceTokenResponse {
+    token: string;
+    access_type: 'r' | 'rw';
+    expires_at_ms: number;
+    ws_url: string;
+    org: string;
+    doc_id: string;
+    branch: string;
+}
+export interface WorkspacePresenceResolveRequest {
+    asset_ids?: string[];
+    /** Thread ids, as published in `session` awareness contexts. */
+    session_ids?: string[];
+    project_ids?: string[];
+    include_projects?: boolean;
+    include_members?: boolean;
+}
+export interface WorkspacePresenceResolvedAsset {
+    id: string;
+    title: string;
+    asset_type: string;
+}
+export interface WorkspacePresenceResolvedSession {
+    thread_id: string;
+    asset_id: string;
+    title: string;
+}
+export interface WorkspacePresenceResolvedProject {
+    id: string;
+    title: string;
+    assets: WorkspacePresenceResolvedAsset[];
+}
+export interface WorkspacePresenceResolvedMember {
+    id: string;
+    name: string;
+    email: string;
+    avatar_url: string | null;
+}
+export interface WorkspacePresenceResolveResponse {
+    assets: WorkspacePresenceResolvedAsset[];
+    sessions: WorkspacePresenceResolvedSession[];
+    projects: WorkspacePresenceResolvedProject[];
+    members: WorkspacePresenceResolvedMember[];
+}
+/**
+ * Mint a read-only token for the workspace awareness room.
+ *
+ * Rejects with `CollabTokenError` on 401 (bad credential) and 403 (admin
+ * required, roster not enabled for this workspace, or a sandbox credential
+ * that may not read presence), carrying the server's `detail`.
+ */
+export declare function mintWorkspacePresenceToken(args: {
+    auth: CollabAuth;
+    workspaceId: string;
+    signal?: AbortSignal;
+}): Promise<WorkspacePresenceTokenResponse>;
+/**
+ * Resolve awareness ids to titles. Every section of the response is always
+ * present on the returned object (an omitted section reads as empty), so
+ * callers can index without guarding. Failures reject with `CollabTokenError`
+ * — the same status + detail shape as the mint.
+ */
+export declare function resolveWorkspacePresence(args: {
+    auth: CollabAuth;
+    workspaceId: string;
+    request: WorkspacePresenceResolveRequest;
+    signal?: AbortSignal;
+}): Promise<WorkspacePresenceResolveResponse>;

package/dist/collab/presence-mint.js

@@ -0,0 +1,68 @@
+import { getCollabAuthHeaders, collabErrorFromResponse, CollabTokenError, getAthenaApiBaseUrl } from "./mint.js";
+function workspaceUrl({
+  auth,
+  workspaceId,
+  path
+}) {
+  const base = getAthenaApiBaseUrl(auth.backendUrl);
+  return `${base}/api/v0/workspaces/${encodeURIComponent(workspaceId)}/${path}`;
+}
+async function mintWorkspacePresenceToken(args) {
+  const response = await fetch(
+    workspaceUrl({ auth: args.auth, workspaceId: args.workspaceId, path: "presence-token" }),
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...getCollabAuthHeaders(args.auth)
+      },
+      body: JSON.stringify({}),
+      signal: args.signal
+    }
+  );
+  if (!response.ok) {
+    throw await collabErrorFromResponse(
+      response,
+      `Workspace presence token mint failed with status ${response.status}`
+    );
+  }
+  return await response.json();
+}
+function arrayOrEmpty(value) {
+  return Array.isArray(value) ? value : [];
+}
+async function resolveWorkspacePresence(args) {
+  const response = await fetch(
+    workspaceUrl({ auth: args.auth, workspaceId: args.workspaceId, path: "presence/resolve" }),
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...getCollabAuthHeaders(args.auth)
+      },
+      body: JSON.stringify(args.request),
+      signal: args.signal
+    }
+  );
+  if (!response.ok) {
+    throw await collabErrorFromResponse(
+      response,
+      `Workspace presence resolve failed with status ${response.status}`
+    );
+  }
+  const body = await response.json();
+  if (!body || typeof body !== "object") {
+    throw new CollabTokenError(response.status, "Workspace presence resolve returned no body");
+  }
+  return {
+    assets: arrayOrEmpty(body.assets),
+    sessions: arrayOrEmpty(body.sessions),
+    projects: arrayOrEmpty(body.projects),
+    members: arrayOrEmpty(body.members)
+  };
+}
+export {
+  mintWorkspacePresenceToken,
+  resolveWorkspacePresence
+};
+//# sourceMappingURL=presence-mint.js.map

package/dist/collab/presence-mint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-mint.js","sources":["../../src/collab/presence-mint.ts"],"sourcesContent":["/**\n * Public-API clients for the workspace presence feed.\n *\n * Two endpoints, both admin-only and both under the workspace:\n *\n * - `POST /api/v0/workspaces/{workspaceId}/presence-token` mints a\n *   **read-only** Keryx token for the workspace awareness room\n *   (`<workspaceId>/awareness`) — the same per-recipient-filtered presence\n *   feed the Olympus People page renders. The holder can receive presence and\n *   broadcast nothing; `connectWorkspacePresence` re-mints before expiry.\n * - `POST /api/v0/workspaces/{workspaceId}/presence/resolve` turns the opaque\n *   ids carried in awareness contexts (asset ids, session thread ids, project\n *   ids) into titles the caller may see. Only things the caller may open come\n *   back; missing ids are simply absent.\n *\n * Wire shapes are snake_case, matching `CollabTokenResponse`.\n */\n\nimport {\n  type CollabAuth,\n  CollabTokenError,\n  collabErrorFromResponse,\n  getAthenaApiBaseUrl,\n  getCollabAuthHeaders,\n} from './mint';\n\n/** Grant for the workspace awareness room. Always read-only (`access_type: 'r'`). */\nexport interface WorkspacePresenceTokenResponse {\n  token: string;\n  access_type: 'r' | 'rw';\n  expires_at_ms: number;\n  ws_url: string;\n  org: string;\n  doc_id: string;\n  branch: string;\n}\n\nexport interface WorkspacePresenceResolveRequest {\n  asset_ids?: string[];\n  /** Thread ids, as published in `session` awareness contexts. */\n  session_ids?: string[];\n  project_ids?: string[];\n  include_projects?: boolean;\n  include_members?: boolean;\n}\n\nexport interface WorkspacePresenceResolvedAsset {\n  id: string;\n  title: string;\n  asset_type: string;\n}\n\nexport interface WorkspacePresenceResolvedSession {\n  thread_id: string;\n  asset_id: string;\n  title: string;\n}\n\nexport interface WorkspacePresenceResolvedProject {\n  id: string;\n  title: string;\n  assets: WorkspacePresenceResolvedAsset[];\n}\n\nexport interface WorkspacePresenceResolvedMember {\n  id: string;\n  name: string;\n  email: string;\n  avatar_url: string | null;\n}\n\nexport interface WorkspacePresenceResolveResponse {\n  assets: WorkspacePresenceResolvedAsset[];\n  sessions: WorkspacePresenceResolvedSession[];\n  projects: WorkspacePresenceResolvedProject[];\n  members: WorkspacePresenceResolvedMember[];\n}\n\nfunction workspaceUrl({\n  auth,\n  workspaceId,\n  path,\n}: {\n  auth: CollabAuth;\n  workspaceId: string;\n  path: string;\n}): string {\n  const base = getAthenaApiBaseUrl(auth.backendUrl);\n  return `${base}/api/v0/workspaces/${encodeURIComponent(workspaceId)}/${path}`;\n}\n\n/**\n * Mint a read-only token for the workspace awareness room.\n *\n * Rejects with `CollabTokenError` on 401 (bad credential) and 403 (admin\n * required, roster not enabled for this workspace, or a sandbox credential\n * that may not read presence), carrying the server's `detail`.\n */\nexport async function mintWorkspacePresenceToken(args: {\n  auth: CollabAuth;\n  workspaceId: string;\n  signal?: AbortSignal;\n}): Promise<WorkspacePresenceTokenResponse> {\n  const response = await fetch(\n    workspaceUrl({ auth: args.auth, workspaceId: args.workspaceId, path: 'presence-token' }),\n    {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        ...getCollabAuthHeaders(args.auth),\n      },\n      body: JSON.stringify({}),\n      signal: args.signal,\n    }\n  );\n  if (!response.ok) {\n    throw await collabErrorFromResponse(\n      response,\n      `Workspace presence token mint failed with status ${response.status}`\n    );\n  }\n  return (await response.json()) as WorkspacePresenceTokenResponse;\n}\n\nfunction arrayOrEmpty<T>(value: T[] | undefined | null): T[] {\n  return Array.isArray(value) ? value : [];\n}\n\n/**\n * Resolve awareness ids to titles. Every section of the response is always\n * present on the returned object (an omitted section reads as empty), so\n * callers can index without guarding. Failures reject with `CollabTokenError`\n * — the same status + detail shape as the mint.\n */\nexport async function resolveWorkspacePresence(args: {\n  auth: CollabAuth;\n  workspaceId: string;\n  request: WorkspacePresenceResolveRequest;\n  signal?: AbortSignal;\n}): Promise<WorkspacePresenceResolveResponse> {\n  const response = await fetch(\n    workspaceUrl({ auth: args.auth, workspaceId: args.workspaceId, path: 'presence/resolve' }),\n    {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        ...getCollabAuthHeaders(args.auth),\n      },\n      body: JSON.stringify(args.request),\n      signal: args.signal,\n    }\n  );\n  if (!response.ok) {\n    throw await collabErrorFromResponse(\n      response,\n      `Workspace presence resolve failed with status ${response.status}`\n    );\n  }\n  const body = (await response.json()) as Partial<WorkspacePresenceResolveResponse> | null;\n  if (!body || typeof body !== 'object') {\n    throw new CollabTokenError(response.status, 'Workspace presence resolve returned no body');\n  }\n  return {\n    assets: arrayOrEmpty(body.assets),\n    sessions: arrayOrEmpty(body.sessions),\n    projects: arrayOrEmpty(body.projects),\n    members: arrayOrEmpty(body.members),\n  };\n}\n"],"names":[],"mappings":";AA8EA,SAAS,aAAa;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AACF,GAIW;AACT,QAAM,OAAO,oBAAoB,KAAK,UAAU;AAChD,SAAO,GAAG,IAAI,sBAAsB,mBAAmB,WAAW,CAAC,IAAI,IAAI;AAC7E;AASA,eAAsB,2BAA2B,MAIL;AAC1C,QAAM,WAAW,MAAM;AAAA,IACrB,aAAa,EAAE,MAAM,KAAK,MAAM,aAAa,KAAK,aAAa,MAAM,kBAAkB;AAAA,IACvF;AAAA,MACE,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG,qBAAqB,KAAK,IAAI;AAAA,MAAA;AAAA,MAEnC,MAAM,KAAK,UAAU,EAAE;AAAA,MACvB,QAAQ,KAAK;AAAA,IAAA;AAAA,EACf;AAEF,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,MAAM;AAAA,MACV;AAAA,MACA,oDAAoD,SAAS,MAAM;AAAA,IAAA;AAAA,EAEvE;AACA,SAAQ,MAAM,SAAS,KAAA;AACzB;AAEA,SAAS,aAAgB,OAAoC;AAC3D,SAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAA;AACxC;AAQA,eAAsB,yBAAyB,MAKD;AAC5C,QAAM,WAAW,MAAM;AAAA,IACrB,aAAa,EAAE,MAAM,KAAK,MAAM,aAAa,KAAK,aAAa,MAAM,oBAAoB;AAAA,IACzF;AAAA,MACE,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG,qBAAqB,KAAK,IAAI;AAAA,MAAA;AAAA,MAEnC,MAAM,KAAK,UAAU,KAAK,OAAO;AAAA,MACjC,QAAQ,KAAK;AAAA,IAAA;AAAA,EACf;AAEF,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,MAAM;AAAA,MACV;AAAA,MACA,iDAAiD,SAAS,MAAM;AAAA,IAAA;AAAA,EAEpE;AACA,QAAM,OAAQ,MAAM,SAAS,KAAA;AAC7B,MAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,UAAM,IAAI,iBAAiB,SAAS,QAAQ,6CAA6C;AAAA,EAC3F;AACA,SAAO;AAAA,IACL,QAAQ,aAAa,KAAK,MAAM;AAAA,IAChC,UAAU,aAAa,KAAK,QAAQ;AAAA,IACpC,UAAU,aAAa,KAAK,QAAQ;AAAA,IACpC,SAAS,aAAa,KAAK,OAAO;AAAA,EAAA;AAEtC;"}

package/dist/collab/presence-react.cjs

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const AthenaContext = require("../provider/AthenaContext.cjs");
+const presenceClient = require("./presence-client.cjs");
+const presenceMint = require("./presence-mint.cjs");
+const presenceSlots = require("./presence-slots.cjs");
+const PRESENCE_DEFAULT_TICK_MS = 1e4;
+const EMPTY_SNAPSHOT = "init||0";
+const NO_HUMANS = [];
+const NO_AGENTS = [];
+function useWorkspacePresence(workspaceId, options) {
+  const config = AthenaContext.useAthenaConfig();
+  const enabled = (options == null ? void 0 : options.enabled) !== false && workspaceId !== null;
+  const tickMs = (options == null ? void 0 : options.tickMs) ?? PRESENCE_DEFAULT_TICK_MS;
+  const [entry, setEntry] = react.useState(null);
+  const handleRef = react.useRef(null);
+  react.useEffect(() => {
+    if (!enabled || workspaceId === null) {
+      setEntry(null);
+      return;
+    }
+    const next = presenceClient.connectWorkspacePresence({
+      workspaceId,
+      auth: {
+        backendUrl: config.backendUrl,
+        apiKey: config.apiKey,
+        token: config.token
+      }
+    });
+    handleRef.current = next;
+    setEntry({ workspaceId, handle: next });
+    return () => {
+      handleRef.current = null;
+      next.destroy();
+    };
+  }, [enabled, workspaceId, config.backendUrl, config.apiKey, config.token]);
+  const handle = enabled && entry !== null && entry.workspaceId === workspaceId ? entry.handle : null;
+  const subscribe = react.useMemo(() => {
+    return (onStoreChange) => {
+      if (!handle) return () => {
+      };
+      return handle.onChange(onStoreChange);
+    };
+  }, [handle]);
+  react.useSyncExternalStore(
+    subscribe,
+    () => {
+      if (!handle) return EMPTY_SNAPSHOT;
+      return `${handle.status}|${handle.accessType ?? ""}|${handle.version}`;
+    },
+    () => EMPTY_SNAPSHOT
+  );
+  const [now, setNow] = react.useState(() => Date.now());
+  react.useEffect(() => {
+    if (!enabled) return;
+    setNow(Date.now());
+    const timer = setInterval(() => {
+      setNow(Date.now());
+    }, tickMs);
+    return () => {
+      clearInterval(timer);
+    };
+  }, [enabled, tickMs]);
+  const rosterHumans = (handle == null ? void 0 : handle.humans) ?? NO_HUMANS;
+  const humans = react.useMemo(
+    () => rosterHumans.map((human) => ({
+      ...human,
+      state: presenceSlots.derivePresenceState({
+        lastIntentAt: human.lastIntentAt,
+        hidden: human.hidden,
+        manualAway: human.manualAway,
+        now
+      })
+    })),
+    [rosterHumans, now]
+  );
+  const refreshNow = react.useCallback(() => {
+    var _a;
+    return ((_a = handleRef.current) == null ? void 0 : _a.refreshNow()) ?? Promise.resolve();
+  }, []);
+  return {
+    status: handle ? handle.status : enabled ? "connecting" : "closed",
+    error: (handle == null ? void 0 : handle.error) ?? null,
+    accessType: (handle == null ? void 0 : handle.accessType) ?? null,
+    humans,
+    agents: (handle == null ? void 0 : handle.agents) ?? NO_AGENTS,
+    refreshNow
+  };
+}
+function useWorkspacePresenceResolver(workspaceId) {
+  const config = AthenaContext.useAthenaConfig();
+  const { backendUrl, apiKey, token } = config;
+  return react.useCallback(
+    (request, signal) => {
+      if (workspaceId === null) {
+        return Promise.reject(
+          new Error("[AthenaSDK] useWorkspacePresenceResolver: no workspace selected")
+        );
+      }
+      return presenceMint.resolveWorkspacePresence({
+        auth: { backendUrl, apiKey, token },
+        workspaceId,
+        request,
+        signal
+      });
+    },
+    [workspaceId, backendUrl, apiKey, token]
+  );
+}
+exports.PRESENCE_DEFAULT_TICK_MS = PRESENCE_DEFAULT_TICK_MS;
+exports.useWorkspacePresence = useWorkspacePresence;
+exports.useWorkspacePresenceResolver = useWorkspacePresenceResolver;
+//# sourceMappingURL=presence-react.cjs.map

package/dist/collab/presence-react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-react.cjs","sources":["../../src/collab/presence-react.ts"],"sourcesContent":["/**\n * React bindings for the workspace presence feed.\n *\n * `useWorkspacePresence(workspaceId)` opens (and owns) a\n * `connectWorkspacePresence` handle, resolving auth from the surrounding\n * `AthenaProvider` (per-viewer bearer when present, API key otherwise), and\n * re-renders on status/roster changes via `useSyncExternalStore`. Each person\n * carries a `state` on the intent ladder, recomputed against a clock that\n * ticks every `tickMs` so `active` decays to `idle` and `away` between\n * awareness events.\n *\n * `useWorkspacePresenceResolver(workspaceId)` returns the batch id→title\n * resolver bound to the same auth. It is deliberately thin: callers own\n * caching (TanStack Query is the expected home for it).\n */\n\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type WorkspacePresenceHandle,\n  type WorkspacePresenceStatus,\n  connectWorkspacePresence,\n} from './presence-client';\nimport {\n  type WorkspacePresenceResolveRequest,\n  type WorkspacePresenceResolveResponse,\n  resolveWorkspacePresence,\n} from './presence-mint';\nimport {\n  type PresenceAgent,\n  type PresenceHuman,\n  type PresenceState,\n  derivePresenceState,\n} from './presence-slots';\n\n/** Default cadence for re-deriving each person's intent state. */\nexport const PRESENCE_DEFAULT_TICK_MS = 10_000;\n\nexport interface PresenceHumanWithState extends PresenceHuman {\n  /** Where the person sits on the intent ladder as of the last tick. */\n  state: PresenceState;\n}\n\nexport interface UseWorkspacePresenceOptions {\n  /** `false` closes the feed without unmounting the caller. Default `true`. */\n  enabled?: boolean;\n  /** How often `state` is re-derived from `lastIntentAt`. Default 10 s. */\n  tickMs?: number;\n}\n\nexport interface UseWorkspacePresenceResult {\n  /** `'closed'` while disabled or without a workspace; `'connecting'` until the first mint resolves. */\n  status: WorkspacePresenceStatus;\n  error: Error | null;\n  accessType: 'r' | 'rw' | null;\n  humans: PresenceHumanWithState[];\n  agents: PresenceAgent[];\n  /** Force an early token refresh; resolves immediately when no feed is open. */\n  refreshNow: () => Promise<void>;\n}\n\nconst EMPTY_SNAPSHOT = 'init||0';\nconst NO_HUMANS: PresenceHuman[] = [];\nconst NO_AGENTS: PresenceAgent[] = [];\n\nexport function useWorkspacePresence(\n  workspaceId: string | null,\n  options?: UseWorkspacePresenceOptions\n): UseWorkspacePresenceResult {\n  const config = useAthenaConfig();\n  const enabled = options?.enabled !== false && workspaceId !== null;\n  const tickMs = options?.tickMs ?? PRESENCE_DEFAULT_TICK_MS;\n  const [entry, setEntry] = useState<{\n    workspaceId: string;\n    handle: WorkspacePresenceHandle;\n  } | null>(null);\n  const handleRef = useRef<WorkspacePresenceHandle | null>(null);\n\n  useEffect(() => {\n    if (!enabled || workspaceId === null) {\n      setEntry(null);\n      return;\n    }\n    const next = connectWorkspacePresence({\n      workspaceId,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n      },\n    });\n    handleRef.current = next;\n    setEntry({ workspaceId, handle: next });\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or credentials change; the handle re-mints on\n    // its own schedule otherwise.\n  }, [enabled, workspaceId, config.backendUrl, config.apiKey, config.token]);\n\n  // React renders with the new arguments before the effect above runs, so a\n  // handle opened for a previous workspace, or before the feed was disabled,\n  // still sits in state for that one render. Expose it only while it is the\n  // handle this render asked for; otherwise the closed / connecting empty\n  // result wins, and a disabled feed never leaks a roster.\n  const handle =\n    enabled && entry !== null && entry.workspaceId === workspaceId ? entry.handle : null;\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  // The ladder decays with wall-clock time, not with awareness events; a\n  // person who stops typing must drift to idle even when nothing arrives.\n  const [now, setNow] = useState(() => Date.now());\n  useEffect(() => {\n    if (!enabled) return;\n    setNow(Date.now());\n    const timer = setInterval(() => {\n      setNow(Date.now());\n    }, tickMs);\n    return () => {\n      clearInterval(timer);\n    };\n  }, [enabled, tickMs]);\n\n  const rosterHumans = handle?.humans ?? NO_HUMANS;\n  const humans = useMemo(\n    () =>\n      rosterHumans.map((human) => ({\n        ...human,\n        state: derivePresenceState({\n          lastIntentAt: human.lastIntentAt,\n          hidden: human.hidden,\n          manualAway: human.manualAway,\n          now,\n        }),\n      })),\n    [rosterHumans, now]\n  );\n\n  const refreshNow = useCallback(() => handleRef.current?.refreshNow() ?? Promise.resolve(), []);\n\n  return {\n    status: handle ? handle.status : enabled ? 'connecting' : 'closed',\n    error: handle?.error ?? null,\n    accessType: handle?.accessType ?? null,\n    humans,\n    agents: handle?.agents ?? NO_AGENTS,\n    refreshNow,\n  };\n}\n\nexport type WorkspacePresenceResolver = (\n  request: WorkspacePresenceResolveRequest,\n  signal?: AbortSignal\n) => Promise<WorkspacePresenceResolveResponse>;\n\n/**\n * A stable resolver bound to the provider's auth and the given workspace.\n * Rejects when called without a workspace; no caching — callers own that.\n */\nexport function useWorkspacePresenceResolver(\n  workspaceId: string | null\n): WorkspacePresenceResolver {\n  const config = useAthenaConfig();\n  const { backendUrl, apiKey, token } = config;\n  return useCallback<WorkspacePresenceResolver>(\n    (request, signal) => {\n      if (workspaceId === null) {\n        return Promise.reject(\n          new Error('[AthenaSDK] useWorkspacePresenceResolver: no workspace selected')\n        );\n      }\n      return resolveWorkspacePresence({\n        auth: { backendUrl, apiKey, token },\n        workspaceId,\n        request,\n        signal,\n      });\n    },\n    [workspaceId, backendUrl, apiKey, token]\n  );\n}\n"],"names":["useAthenaConfig","useState","useRef","useEffect","connectWorkspacePresence","useMemo","useSyncExternalStore","derivePresenceState","useCallback","resolveWorkspacePresence"],"mappings":"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"}

package/dist/collab/presence-react.d.ts

@@ -0,0 +1,47 @@
+/**
+ * React bindings for the workspace presence feed.
+ *
+ * `useWorkspacePresence(workspaceId)` opens (and owns) a
+ * `connectWorkspacePresence` handle, resolving auth from the surrounding
+ * `AthenaProvider` (per-viewer bearer when present, API key otherwise), and
+ * re-renders on status/roster changes via `useSyncExternalStore`. Each person
+ * carries a `state` on the intent ladder, recomputed against a clock that
+ * ticks every `tickMs` so `active` decays to `idle` and `away` between
+ * awareness events.
+ *
+ * `useWorkspacePresenceResolver(workspaceId)` returns the batch id→title
+ * resolver bound to the same auth. It is deliberately thin: callers own
+ * caching (TanStack Query is the expected home for it).
+ */
+import { type WorkspacePresenceStatus } from './presence-client';
+import { type WorkspacePresenceResolveRequest, type WorkspacePresenceResolveResponse } from './presence-mint';
+import { type PresenceAgent, type PresenceHuman, type PresenceState } from './presence-slots';
+/** Default cadence for re-deriving each person's intent state. */
+export declare const PRESENCE_DEFAULT_TICK_MS = 10000;
+export interface PresenceHumanWithState extends PresenceHuman {
+    /** Where the person sits on the intent ladder as of the last tick. */
+    state: PresenceState;
+}
+export interface UseWorkspacePresenceOptions {
+    /** `false` closes the feed without unmounting the caller. Default `true`. */
+    enabled?: boolean;
+    /** How often `state` is re-derived from `lastIntentAt`. Default 10 s. */
+    tickMs?: number;
+}
+export interface UseWorkspacePresenceResult {
+    /** `'closed'` while disabled or without a workspace; `'connecting'` until the first mint resolves. */
+    status: WorkspacePresenceStatus;
+    error: Error | null;
+    accessType: 'r' | 'rw' | null;
+    humans: PresenceHumanWithState[];
+    agents: PresenceAgent[];
+    /** Force an early token refresh; resolves immediately when no feed is open. */
+    refreshNow: () => Promise<void>;
+}
+export declare function useWorkspacePresence(workspaceId: string | null, options?: UseWorkspacePresenceOptions): UseWorkspacePresenceResult;
+export type WorkspacePresenceResolver = (request: WorkspacePresenceResolveRequest, signal?: AbortSignal) => Promise<WorkspacePresenceResolveResponse>;
+/**
+ * A stable resolver bound to the provider's auth and the given workspace.
+ * Rejects when called without a workspace; no caching — callers own that.
+ */
+export declare function useWorkspacePresenceResolver(workspaceId: string | null): WorkspacePresenceResolver;

package/dist/collab/presence-react.js

@@ -0,0 +1,114 @@
+import { useState, useRef, useEffect, useMemo, useSyncExternalStore, useCallback } from "react";
+import { useAthenaConfig } from "../provider/AthenaContext.js";
+import { connectWorkspacePresence } from "./presence-client.js";
+import { resolveWorkspacePresence } from "./presence-mint.js";
+import { derivePresenceState } from "./presence-slots.js";
+const PRESENCE_DEFAULT_TICK_MS = 1e4;
+const EMPTY_SNAPSHOT = "init||0";
+const NO_HUMANS = [];
+const NO_AGENTS = [];
+function useWorkspacePresence(workspaceId, options) {
+  const config = useAthenaConfig();
+  const enabled = (options == null ? void 0 : options.enabled) !== false && workspaceId !== null;
+  const tickMs = (options == null ? void 0 : options.tickMs) ?? PRESENCE_DEFAULT_TICK_MS;
+  const [entry, setEntry] = useState(null);
+  const handleRef = useRef(null);
+  useEffect(() => {
+    if (!enabled || workspaceId === null) {
+      setEntry(null);
+      return;
+    }
+    const next = connectWorkspacePresence({
+      workspaceId,
+      auth: {
+        backendUrl: config.backendUrl,
+        apiKey: config.apiKey,
+        token: config.token
+      }
+    });
+    handleRef.current = next;
+    setEntry({ workspaceId, handle: next });
+    return () => {
+      handleRef.current = null;
+      next.destroy();
+    };
+  }, [enabled, workspaceId, config.backendUrl, config.apiKey, config.token]);
+  const handle = enabled && entry !== null && entry.workspaceId === workspaceId ? entry.handle : null;
+  const subscribe = useMemo(() => {
+    return (onStoreChange) => {
+      if (!handle) return () => {
+      };
+      return handle.onChange(onStoreChange);
+    };
+  }, [handle]);
+  useSyncExternalStore(
+    subscribe,
+    () => {
+      if (!handle) return EMPTY_SNAPSHOT;
+      return `${handle.status}|${handle.accessType ?? ""}|${handle.version}`;
+    },
+    () => EMPTY_SNAPSHOT
+  );
+  const [now, setNow] = useState(() => Date.now());
+  useEffect(() => {
+    if (!enabled) return;
+    setNow(Date.now());
+    const timer = setInterval(() => {
+      setNow(Date.now());
+    }, tickMs);
+    return () => {
+      clearInterval(timer);
+    };
+  }, [enabled, tickMs]);
+  const rosterHumans = (handle == null ? void 0 : handle.humans) ?? NO_HUMANS;
+  const humans = useMemo(
+    () => rosterHumans.map((human) => ({
+      ...human,
+      state: derivePresenceState({
+        lastIntentAt: human.lastIntentAt,
+        hidden: human.hidden,
+        manualAway: human.manualAway,
+        now
+      })
+    })),
+    [rosterHumans, now]
+  );
+  const refreshNow = useCallback(() => {
+    var _a;
+    return ((_a = handleRef.current) == null ? void 0 : _a.refreshNow()) ?? Promise.resolve();
+  }, []);
+  return {
+    status: handle ? handle.status : enabled ? "connecting" : "closed",
+    error: (handle == null ? void 0 : handle.error) ?? null,
+    accessType: (handle == null ? void 0 : handle.accessType) ?? null,
+    humans,
+    agents: (handle == null ? void 0 : handle.agents) ?? NO_AGENTS,
+    refreshNow
+  };
+}
+function useWorkspacePresenceResolver(workspaceId) {
+  const config = useAthenaConfig();
+  const { backendUrl, apiKey, token } = config;
+  return useCallback(
+    (request, signal) => {
+      if (workspaceId === null) {
+        return Promise.reject(
+          new Error("[AthenaSDK] useWorkspacePresenceResolver: no workspace selected")
+        );
+      }
+      return resolveWorkspacePresence({
+        auth: { backendUrl, apiKey, token },
+        workspaceId,
+        request,
+        signal
+      });
+    },
+    [workspaceId, backendUrl, apiKey, token]
+  );
+}
+export {
+  PRESENCE_DEFAULT_TICK_MS,
+  useWorkspacePresence,
+  useWorkspacePresenceResolver
+};
+//# sourceMappingURL=presence-react.js.map

package/dist/collab/presence-react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-react.js","sources":["../../src/collab/presence-react.ts"],"sourcesContent":["/**\n * React bindings for the workspace presence feed.\n *\n * `useWorkspacePresence(workspaceId)` opens (and owns) a\n * `connectWorkspacePresence` handle, resolving auth from the surrounding\n * `AthenaProvider` (per-viewer bearer when present, API key otherwise), and\n * re-renders on status/roster changes via `useSyncExternalStore`. Each person\n * carries a `state` on the intent ladder, recomputed against a clock that\n * ticks every `tickMs` so `active` decays to `idle` and `away` between\n * awareness events.\n *\n * `useWorkspacePresenceResolver(workspaceId)` returns the batch id→title\n * resolver bound to the same auth. It is deliberately thin: callers own\n * caching (TanStack Query is the expected home for it).\n */\n\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type WorkspacePresenceHandle,\n  type WorkspacePresenceStatus,\n  connectWorkspacePresence,\n} from './presence-client';\nimport {\n  type WorkspacePresenceResolveRequest,\n  type WorkspacePresenceResolveResponse,\n  resolveWorkspacePresence,\n} from './presence-mint';\nimport {\n  type PresenceAgent,\n  type PresenceHuman,\n  type PresenceState,\n  derivePresenceState,\n} from './presence-slots';\n\n/** Default cadence for re-deriving each person's intent state. */\nexport const PRESENCE_DEFAULT_TICK_MS = 10_000;\n\nexport interface PresenceHumanWithState extends PresenceHuman {\n  /** Where the person sits on the intent ladder as of the last tick. */\n  state: PresenceState;\n}\n\nexport interface UseWorkspacePresenceOptions {\n  /** `false` closes the feed without unmounting the caller. Default `true`. */\n  enabled?: boolean;\n  /** How often `state` is re-derived from `lastIntentAt`. Default 10 s. */\n  tickMs?: number;\n}\n\nexport interface UseWorkspacePresenceResult {\n  /** `'closed'` while disabled or without a workspace; `'connecting'` until the first mint resolves. */\n  status: WorkspacePresenceStatus;\n  error: Error | null;\n  accessType: 'r' | 'rw' | null;\n  humans: PresenceHumanWithState[];\n  agents: PresenceAgent[];\n  /** Force an early token refresh; resolves immediately when no feed is open. */\n  refreshNow: () => Promise<void>;\n}\n\nconst EMPTY_SNAPSHOT = 'init||0';\nconst NO_HUMANS: PresenceHuman[] = [];\nconst NO_AGENTS: PresenceAgent[] = [];\n\nexport function useWorkspacePresence(\n  workspaceId: string | null,\n  options?: UseWorkspacePresenceOptions\n): UseWorkspacePresenceResult {\n  const config = useAthenaConfig();\n  const enabled = options?.enabled !== false && workspaceId !== null;\n  const tickMs = options?.tickMs ?? PRESENCE_DEFAULT_TICK_MS;\n  const [entry, setEntry] = useState<{\n    workspaceId: string;\n    handle: WorkspacePresenceHandle;\n  } | null>(null);\n  const handleRef = useRef<WorkspacePresenceHandle | null>(null);\n\n  useEffect(() => {\n    if (!enabled || workspaceId === null) {\n      setEntry(null);\n      return;\n    }\n    const next = connectWorkspacePresence({\n      workspaceId,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n      },\n    });\n    handleRef.current = next;\n    setEntry({ workspaceId, handle: next });\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or credentials change; the handle re-mints on\n    // its own schedule otherwise.\n  }, [enabled, workspaceId, config.backendUrl, config.apiKey, config.token]);\n\n  // React renders with the new arguments before the effect above runs, so a\n  // handle opened for a previous workspace, or before the feed was disabled,\n  // still sits in state for that one render. Expose it only while it is the\n  // handle this render asked for; otherwise the closed / connecting empty\n  // result wins, and a disabled feed never leaks a roster.\n  const handle =\n    enabled && entry !== null && entry.workspaceId === workspaceId ? entry.handle : null;\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  // The ladder decays with wall-clock time, not with awareness events; a\n  // person who stops typing must drift to idle even when nothing arrives.\n  const [now, setNow] = useState(() => Date.now());\n  useEffect(() => {\n    if (!enabled) return;\n    setNow(Date.now());\n    const timer = setInterval(() => {\n      setNow(Date.now());\n    }, tickMs);\n    return () => {\n      clearInterval(timer);\n    };\n  }, [enabled, tickMs]);\n\n  const rosterHumans = handle?.humans ?? NO_HUMANS;\n  const humans = useMemo(\n    () =>\n      rosterHumans.map((human) => ({\n        ...human,\n        state: derivePresenceState({\n          lastIntentAt: human.lastIntentAt,\n          hidden: human.hidden,\n          manualAway: human.manualAway,\n          now,\n        }),\n      })),\n    [rosterHumans, now]\n  );\n\n  const refreshNow = useCallback(() => handleRef.current?.refreshNow() ?? Promise.resolve(), []);\n\n  return {\n    status: handle ? handle.status : enabled ? 'connecting' : 'closed',\n    error: handle?.error ?? null,\n    accessType: handle?.accessType ?? null,\n    humans,\n    agents: handle?.agents ?? NO_AGENTS,\n    refreshNow,\n  };\n}\n\nexport type WorkspacePresenceResolver = (\n  request: WorkspacePresenceResolveRequest,\n  signal?: AbortSignal\n) => Promise<WorkspacePresenceResolveResponse>;\n\n/**\n * A stable resolver bound to the provider's auth and the given workspace.\n * Rejects when called without a workspace; no caching — callers own that.\n */\nexport function useWorkspacePresenceResolver(\n  workspaceId: string | null\n): WorkspacePresenceResolver {\n  const config = useAthenaConfig();\n  const { backendUrl, apiKey, token } = config;\n  return useCallback<WorkspacePresenceResolver>(\n    (request, signal) => {\n      if (workspaceId === null) {\n        return Promise.reject(\n          new Error('[AthenaSDK] useWorkspacePresenceResolver: no workspace selected')\n        );\n      }\n      return resolveWorkspacePresence({\n        auth: { backendUrl, apiKey, token },\n        workspaceId,\n        request,\n        signal,\n      });\n    },\n    [workspaceId, backendUrl, apiKey, token]\n  );\n}\n"],"names":[],"mappings":"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"}