sideagent 0.2.0 → 0.4.0

package/README.md

@@ -45,6 +45,16 @@ import { AgentChat } from "sideagent";
 />
 ```
 
+### sideagent Cloud
+
+With an agent hosted on sideagent Cloud, pass its publishable key instead of `endpoint`. The key names the agent and its host, so the chat derives the URL (`https://<host>/v1/agents/<agentId>`) and sends the key in the `x-sideagent-key` header on every request. The key is public: it is safe in the browser and proves nothing on its own.
+
+```tsx
+<AgentChat publishableKey="pk_live_…" />
+```
+
+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`.
+
 ### 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;
@@ -59,19 +61,23 @@ 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;
 
 interface TransportOptions {
     endpoint: string;