sideagent 0.3.0 → 0.5.0

package/README.md

@@ -55,6 +55,18 @@ With an agent hosted on sideagent Cloud, pass its publishable key instead of `en
 
 Pass `endpoint` as well to send the requests somewhere else, such as a proxy in front of sideagent Cloud. A malformed key, or neither prop, throws during render. `parsePublishableKey` and `publishableEndpoint` are exported from `sideagent/keys`.
 
+Signed-in users: pass `getHeaders`, which the chat calls before every request, so a login token that expires is fetched fresh each time. Pass `storageKey` (the user's ID) so the last conversation the chat remembers in `localStorage` belongs to that user; on a shared browser another user starts from their own.
+
+```tsx
+<AgentChat
+  publishableKey="pk_live_…"
+  getHeaders={async () => ({ Authorization: `Bearer ${await getToken()}` })}
+  storageKey={user.id}
+/>
+```
+
+`getHeaders` works with `endpoint` too. Its headers are merged under `headers`, which wins on a clash, so it cannot replace the publishable key. If it throws, the request is not sent and the chat shows an error.
+
 ### Docked sidebar
 
 Wrap your app in `AgentProvider` to dock the chat on the right, side by side with the app instead of over it. It takes the same props as `AgentChat`. The user drags the panel's left edge (or uses the arrow keys on it) to resize; the width is remembered. Outside `AgentProvider`, sidebar mode overlays the page.

package/dist/chunk-5H62LFNC.js

@@ -0,0 +1,10 @@
+// src/server/message-text.ts
+function messageText(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  return content.map((p) => p?.type === "text" && typeof p.text === "string" ? p.text : "").join("");
+}
+
+export {
+  messageText
+};

package/dist/chunk-73FXXOAR.js

@@ -0,0 +1,43 @@
+// src/keys.ts
+var PUBLISHABLE_KEY_HEADER = "x-sideagent-key";
+var AGENT_ID = /^agt_[a-z0-9]{16}$/;
+var HOST = /^[a-z0-9.-]+(:\d+)?$/i;
+var LOOPBACK = /^(localhost|127\.0\.0\.1)(:\d+)?$/i;
+function b64url(s) {
+  let bin = "";
+  for (const b of new TextEncoder().encode(s)) bin += String.fromCharCode(b);
+  return btoa(bin).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function fromB64url(s) {
+  const bin = atob(s.replace(/-/g, "+").replace(/_/g, "/"));
+  return new TextDecoder("utf-8", { fatal: true }).decode(Uint8Array.from(bin, (c) => c.charCodeAt(0)));
+}
+function publishableKey(environment, host, agentId) {
+  return `pk_${environment}_${b64url(`${host}$${agentId}`)}`;
+}
+function parsePublishableKey(key) {
+  const m = /^pk_(test|live)_([A-Za-z0-9_-]+)$/.exec(key);
+  if (!m) return null;
+  let decoded;
+  try {
+    decoded = fromB64url(m[2]);
+  } catch {
+    return null;
+  }
+  const at = decoded.lastIndexOf("$");
+  if (at <= 0) return null;
+  const host = decoded.slice(0, at);
+  const agentId = decoded.slice(at + 1);
+  if (!AGENT_ID.test(agentId) || !HOST.test(host)) return null;
+  return { environment: m[1], host, agentId };
+}
+function publishableEndpoint({ host, agentId }) {
+  return `${LOOPBACK.test(host) ? "http" : "https"}://${host}/v1/agents/${agentId}`;
+}
+
+export {
+  PUBLISHABLE_KEY_HEADER,
+  publishableKey,
+  parsePublishableKey,
+  publishableEndpoint
+};

package/dist/index.d.ts

@@ -32,8 +32,10 @@ interface AgentHooks {
 
 type AgentChatMode = "floating" | "sidebar";
 interface AgentChatProps {
-    /** URL of your sideagent endpoint, e.g. "/api/agent". */
-    endpoint: string;
+    /** URL of your sideagent endpoint, e.g. "/api/agent". With `publishableKey`, overrides the URL the key names. */
+    endpoint?: string;
+    /** sideagent Cloud publishable key (`pk_live_…`). Requests go to the agent it names and carry it. */
+    publishableKey?: string;
     /** Starting layout. The user can switch; their choice is remembered. */
     mode?: AgentChatMode;
     title?: string;
@@ -47,6 +49,17 @@ interface AgentChatProps {
     /** Use "include" when the endpoint is on another origin and relies on cookies. */
     credentials?: RequestCredentials;
     headers?: Record<string, string>;
+    /**
+     * Called before every request; its headers are added to `headers` (which wins on a clash). Use it for a
+     * login token that expires, e.g. `Authorization: Bearer <token>` from your login SDK. If it throws, the
+     * request is not sent and the chat shows an error.
+     */
+    getHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+    /**
+     * Scopes what the chat remembers in localStorage (the last conversation) to one user, e.g. their user ID.
+     * Changing it starts over with that user's last conversation.
+     */
+    storageKey?: string;
     defaultOpen?: boolean;
     /** Custom result views per operationId. Anything not listed gets the built-in table / fields view. */
     resultRenderers?: Record<string, (e: {
@@ -59,24 +72,31 @@ interface AgentChatProps {
     /** Set false to hide the layout switcher. */
     allowModeSwitch?: boolean;
 }
-interface AgentControls {
-    open: boolean;
-    setOpen: (open: boolean) => void;
-}
-/** Open or close the assistant from anywhere under `AgentProvider`. */
-declare function useAgent(): AgentControls;
+
+/** The panel shell: open/close, floating or docked layout, resize, history and session loading. */
+declare function AgentChat(props: AgentChatProps): react.JSX.Element;
+
 /** Lays the app and a docked sidebar chat side by side, and shares open state via `useAgent`. Takes the same props as AgentChat. */
 declare function AgentProvider({ children, className, style, ...chat }: AgentChatProps & {
     children: ReactNode;
     className?: string;
     style?: CSSProperties;
 }): react.JSX.Element;
-declare function AgentChat(props: AgentChatProps): react.JSX.Element;
 
+interface AgentControls {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+}
+/** Open or close the assistant from anywhere under `AgentProvider`. */
+declare function useAgent(): AgentControls;
+
+type GetHeaders = () => Record<string, string> | Promise<Record<string, string>>;
 interface TransportOptions {
     endpoint: string;
     credentials?: RequestCredentials;
     headers?: Record<string, string>;
+    /** Called before every request, e.g. for a fresh login token. `headers` wins on a clash. */
+    getHeaders?: GetHeaders;
     signal?: AbortSignal;
 }
 /** POSTs a chat request and yields the server's SSE events. */