@useago/sdk 1.0.3 → 1.0.5

package/dist/devtools.cjs

@@ -1,20 +1,28 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p,d,x=()=>({});function i(){p&&(p.textContent=JSON.stringify(x(),null,2))}function s(n,e){if(!d)return;const o=document.createElement("div");o.className=`dev-log-line dev-log-${e}`,o.textContent=`${new Date().toLocaleTimeString()}  ${n}`,d.appendChild(o),d.scrollTop=d.scrollHeight}var u="ago_dev_panel_collapsed";function c(n,e){n.classList.toggle("collapsed",e);const o=n.querySelector(".dev-toggle");o&&(o.textContent=e?"▢":"—",o.title=e?"Expand dev tools":"Collapse dev tools",o.setAttribute("aria-expanded",String(!e)));try{localStorage.setItem(u,e?"1":"0")}catch{}}function h(n){const{client:e,target:o}=n;x=()=>{const t=e.getContextSnapshot()?.entries??{};return Object.fromEntries(Object.entries(t).map(([l,{name:r,data:b}])=>[l,{name:r,data:b}]))},m();const f=typeof o=="string"?document.querySelector(o):o instanceof Element?o:document.body,a=document.createElement("aside");a.id="ago-dev-panel",(f??document.body).appendChild(a),a.innerHTML=`
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var v,x,p,h=()=>({});function s(){v&&(v.textContent=JSON.stringify(h(),null,2))}function m(e,t,d){if(!e)return;const n=document.createElement("div");n.className=`dev-log-line dev-log-${d}`,n.textContent=`${new Date().toLocaleTimeString()}  ${t}`,e.appendChild(n),e.scrollTop=e.scrollHeight}function c(e,t){m(x,e,t)}function y(e){let t;return e.type?t=e.type:e.content!==void 0?t="content":e.full_content!==void 0?t="full_content":e.status?t=`status:${e.status}`:t="event",`${t}  ${JSON.stringify(e)}`}var S="ago_dev_panel_collapsed",E="ago_dev_events_collapsed";function g(e,t,d,n){e.classList.toggle("collapsed",t);const o=e.querySelector(".dev-toggle");o&&(o.textContent=t?"▢":"—",o.title=t?`Expand ${n}`:`Collapse ${n}`,o.setAttribute("aria-expanded",String(!t)));try{localStorage.setItem(d,t?"1":"0")}catch{}}function u(e,t,d){e.querySelector(".dev-toggle")?.addEventListener("click",o=>{o.stopPropagation(),g(e,!e.classList.contains("collapsed"),t,d)}),e.addEventListener("click",()=>{e.classList.contains("collapsed")&&g(e,!1,t,d)});let n=!1;try{n=localStorage.getItem(t)==="1"}catch{}g(e,n,t,d)}function C(e){const{client:t,target:d}=e;h=()=>{const a=t.getContextSnapshot()?.entries??{};return Object.fromEntries(Object.entries(a).map(([l,{name:r,data:b}])=>[l,{name:r,data:b}]))},w();const n=typeof d=="string"?document.querySelector(d):d instanceof Element?d:document.body,o=document.createElement("aside");o.id="ago-dev-panel",o.className="ago-dev-card",(n??document.body).appendChild(o),o.innerHTML=`
     <div class="dev-head">
       <span class="dev-badge">DEV</span>
       <span class="dev-title">DEV TOOLS · client-side function state — not for production</span>
       <button type="button" class="dev-toggle" aria-label="Toggle dev tools">—</button>
     </div>
     <div class="dev-body">
-      <div class="dev-fns">Registered functions: <code>${(e.getRegisteredFunctions?.()??[]).map(t=>t.name).join(", ")||"—"}</code></div>
+      <div class="dev-fns">Registered functions: <code>${(t.getRegisteredFunctions?.()??[]).map(a=>a.name).join(", ")||"—"}</code></div>
       <div class="dev-section-label">JSON object (built by the agent)</div>
       <pre class="dev-state" id="ago-dev-state"></pre>
       <div class="dev-section-label">Function calls</div>
       <div class="dev-log" id="ago-dev-log"></div>
     </div>
-  `,p=a.querySelector("#ago-dev-state"),d=a.querySelector("#ago-dev-log"),a.querySelector(".dev-toggle")?.addEventListener("click",t=>{t.stopPropagation(),c(a,!a.classList.contains("collapsed"))}),a.addEventListener("click",()=>{a.classList.contains("collapsed")&&c(a,!1)});let g=!1;try{g=localStorage.getItem(u)==="1"}catch{}c(a,g),e.on("function:invoke",({functionName:t,arguments:l})=>{s(`→ ${t}(${JSON.stringify(l??{})})`,"invoke")}),e.on("function:result",({result:t,error:l})=>{s(l?`✗ error: ${l}`:`← ${JSON.stringify(t)}`,l?"error":"result"),i()}),e.on("context:changed",i),e.on("conversation:loaded",t=>{const l=(t.messages??[]).flatMap(r=>r.toolCalls??[]);s(`⟳ hydrated "${t.title||t.id}" — replayed ${l.length} tool call${l.length===1?"":"s"}`,"hydrate"),i()}),i()}var v="ago-dev-panel-styles";function m(){if(document.getElementById(v))return;const n=document.createElement("style");n.id=v,n.textContent=y,document.head.appendChild(n)}var y=`
-#ago-dev-panel {
+  `,v=o.querySelector("#ago-dev-state"),x=o.querySelector("#ago-dev-log"),u(o,S,"dev tools");const i=document.createElement("aside");i.id="ago-dev-events",i.className="ago-dev-card",(n??document.body).appendChild(i),i.innerHTML=`
+    <div class="dev-head">
+      <span class="dev-badge">SSE</span>
+      <span class="dev-title">SSE EVENT LOG · raw stream messages</span>
+      <button type="button" class="dev-toggle" aria-label="Toggle SSE event log">—</button>
+    </div>
+    <div class="dev-body">
+      <div class="dev-log" id="ago-dev-event-log"></div>
+    </div>
+  `,p=i.querySelector("#ago-dev-event-log"),u(i,E,"SSE event log"),t.on("stream:message",a=>{m(p,y(a),"event")}),t.on("function:invoke",({functionName:a,arguments:l})=>{c(`→ ${a}(${JSON.stringify(l??{})})`,"invoke")}),t.on("function:result",({result:a,error:l})=>{c(l?`✗ error: ${l}`:`← ${JSON.stringify(a)}`,l?"error":"result"),s()}),t.on("context:changed",s),t.on("conversation:loaded",a=>{const l=(a.messages??[]).flatMap(r=>r.toolCalls??[]);c(`⟳ hydrated "${a.title||a.id}" — replayed ${l.length} tool call${l.length===1?"":"s"}`,"hydrate"),s()}),s()}var f="ago-dev-panel-styles";function w(){if(document.getElementById(f))return;const e=document.createElement("style");e.id=f,e.textContent=L,document.head.appendChild(e)}var L=`
+.ago-dev-card {
   position: fixed;
-  top: 16px;
   right: 16px;
   width: min(360px, calc(100vw - 32px));
   max-width: calc(100vw - 32px);
@@ -33,8 +41,11 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p,d,x=()=
   font-size: 12px;
   z-index: 1000;
 }
-#ago-dev-panel .dev-head { display: flex; align-items: center; gap: 8px; }
-#ago-dev-panel .dev-toggle {
+/* The main panel pins to the top, the SSE log to the bottom, so they don't overlap. */
+#ago-dev-panel { top: 16px; }
+#ago-dev-events { bottom: 16px; }
+.ago-dev-card .dev-head { display: flex; align-items: center; gap: 8px; }
+.ago-dev-card .dev-toggle {
   margin-left: auto;
   flex: none;
   width: 22px;
@@ -50,19 +61,19 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p,d,x=()=
   line-height: 1;
   cursor: pointer;
 }
-#ago-dev-panel .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }
-#ago-dev-panel .dev-body { display: flex; flex-direction: column; gap: 8px; }
+.ago-dev-card .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }
+.ago-dev-card .dev-body { display: flex; flex-direction: column; gap: 8px; }
 
-/* Collapsed: shrink to a small clickable widget showing only the DEV badge. */
-#ago-dev-panel.collapsed {
+/* Collapsed: shrink to a small clickable widget showing only the badge. */
+.ago-dev-card.collapsed {
   width: auto;
   cursor: pointer;
   padding: 8px 10px;
 }
-#ago-dev-panel.collapsed .dev-title,
-#ago-dev-panel.collapsed .dev-body { display: none; }
-#ago-dev-panel.collapsed .dev-toggle { margin-left: 6px; }
-#ago-dev-panel .dev-badge {
+.ago-dev-card.collapsed .dev-title,
+.ago-dev-card.collapsed .dev-body { display: none; }
+.ago-dev-card.collapsed .dev-toggle { margin-left: 6px; }
+.ago-dev-card .dev-badge {
   background: #f59e0b;
   color: #1c1206;
   font-weight: 700;
@@ -71,17 +82,17 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p,d,x=()=
   padding: 2px 6px;
   border-radius: 5px;
 }
-#ago-dev-panel .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }
-#ago-dev-panel .dev-fns { color: #7c8a99; font-size: 11px; }
-#ago-dev-panel .dev-fns code { color: #9ecbff; }
-#ago-dev-panel .dev-section-label {
+.ago-dev-card .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }
+.ago-dev-card .dev-fns { color: #7c8a99; font-size: 11px; }
+.ago-dev-card .dev-fns code { color: #9ecbff; }
+.ago-dev-card .dev-section-label {
   color: #7c8a99;
   text-transform: uppercase;
   letter-spacing: .08em;
   font-size: 10px;
   margin-top: 4px;
 }
-#ago-dev-panel .dev-state {
+.ago-dev-card .dev-state {
   margin: 0;
   padding: 8px;
   background: #060a0e;
@@ -91,7 +102,7 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p,d,x=()=
   white-space: pre;
   color: #c8e6c9;
 }
-#ago-dev-panel .dev-log {
+.ago-dev-card .dev-log {
   display: flex;
   flex-direction: column;
   gap: 2px;
@@ -101,9 +112,12 @@ Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var p,d,x=()=
   border-radius: 8px;
   padding: 6px 8px;
 }
-#ago-dev-panel .dev-log-line { white-space: pre-wrap; word-break: break-word; line-height: 1.4; }
-#ago-dev-panel .dev-log-invoke { color: #9ecbff; }
-#ago-dev-panel .dev-log-result { color: #86efac; }
-#ago-dev-panel .dev-log-error { color: #fca5a5; }
-#ago-dev-panel .dev-log-hydrate { color: #d8b4fe; }
-`;exports.initDevPanel=h;
+/* The SSE log is the events panel's only content, so give it more room. */
+#ago-dev-events .dev-log { max-height: 60vh; }
+.ago-dev-card .dev-log-line { white-space: pre-wrap; word-break: break-word; line-height: 1.4; }
+.ago-dev-card .dev-log-invoke { color: #9ecbff; }
+.ago-dev-card .dev-log-result { color: #86efac; }
+.ago-dev-card .dev-log-error { color: #fca5a5; }
+.ago-dev-card .dev-log-hydrate { color: #d8b4fe; }
+.ago-dev-card .dev-log-event { color: #7c8a99; }
+`;exports.initDevPanel=C;

package/dist/devtools.d.cts

@@ -243,6 +243,13 @@ declare interface AgoClientEvents {
         conversationId: string;
         messageId: string;
     };
+    /**
+     * Every raw SSE message parsed off the stream, before the handler interprets it
+     * into the higher-level `message:*` / `toolCall:*` / `function:*` events. Carries
+     * the chunk verbatim so debugging tools (notably the dev panel) can log the exact
+     * wire payload. Heartbeat comments are not messages and don't fire this.
+     */
+    "stream:message": SSEChunkData;
     /**
      * The main answer text is done (backend emitted `status: "DONE"`), but follow-up
      * replies may still be pending. Fires once, before `message:complete`.
@@ -542,6 +549,47 @@ declare interface SendMessageOptions {
     files?: File[];
 }
 
+/**
+ * SSE stream chunk data
+ */
+declare interface SSEChunkData {
+    content?: string;
+    full_content?: string;
+    message_id?: string;
+    status?: MessageStatus;
+    thread?: {
+        id: string;
+    };
+    agent?: {
+        id: string;
+        name: string;
+        display_name?: string;
+    };
+    knowledge_sources?: Array<{
+        knowledge_document: {
+            id: string;
+            title: string;
+            use_external_link: boolean;
+            external_link_url?: string;
+            internal_link_url?: string;
+        };
+        position: number;
+    }>;
+    tool_call_data?: boolean;
+    type?: string;
+    id?: string;
+    tool_name?: string;
+    tool_display_name?: string;
+    function_name?: string;
+    arguments?: Record<string, unknown>;
+    form_schema?: FormSchema;
+    message?: string;
+    data?: Record<string, unknown>;
+    follow_up_replies?: string[];
+    satisfaction_feedback?: unknown;
+    ask_to_talk_to_human?: boolean;
+}
+
 /**
  * Where a completed form is sent.
  * - `"https://..."` (a bare string) — shorthand for `{ via: "client", url }`: the browser

package/dist/devtools.d.ts

@@ -243,6 +243,13 @@ declare interface AgoClientEvents {
         conversationId: string;
         messageId: string;
     };
+    /**
+     * Every raw SSE message parsed off the stream, before the handler interprets it
+     * into the higher-level `message:*` / `toolCall:*` / `function:*` events. Carries
+     * the chunk verbatim so debugging tools (notably the dev panel) can log the exact
+     * wire payload. Heartbeat comments are not messages and don't fire this.
+     */
+    "stream:message": SSEChunkData;
     /**
      * The main answer text is done (backend emitted `status: "DONE"`), but follow-up
      * replies may still be pending. Fires once, before `message:complete`.
@@ -542,6 +549,47 @@ declare interface SendMessageOptions {
     files?: File[];
 }
 
+/**
+ * SSE stream chunk data
+ */
+declare interface SSEChunkData {
+    content?: string;
+    full_content?: string;
+    message_id?: string;
+    status?: MessageStatus;
+    thread?: {
+        id: string;
+    };
+    agent?: {
+        id: string;
+        name: string;
+        display_name?: string;
+    };
+    knowledge_sources?: Array<{
+        knowledge_document: {
+            id: string;
+            title: string;
+            use_external_link: boolean;
+            external_link_url?: string;
+            internal_link_url?: string;
+        };
+        position: number;
+    }>;
+    tool_call_data?: boolean;
+    type?: string;
+    id?: string;
+    tool_name?: string;
+    tool_display_name?: string;
+    function_name?: string;
+    arguments?: Record<string, unknown>;
+    form_schema?: FormSchema;
+    message?: string;
+    data?: Record<string, unknown>;
+    follow_up_replies?: string[];
+    satisfaction_feedback?: unknown;
+    ask_to_talk_to_human?: boolean;
+}
+
 /**
  * Where a completed form is sent.
  * - `"https://..."` (a bare string) — shorthand for `{ via: "client", url }`: the browser

package/dist/devtools.js

@@ -1,74 +1,96 @@
-var p, d, x = () => ({});
+var v, x, p, h = () => ({});
 function i() {
-  p && (p.textContent = JSON.stringify(x(), null, 2));
+  v && (v.textContent = JSON.stringify(h(), null, 2));
 }
-function r(n, e) {
-  if (!d) return;
-  const o = document.createElement("div");
-  o.className = `dev-log-line dev-log-${e}`, o.textContent = `${(/* @__PURE__ */ new Date()).toLocaleTimeString()}  ${n}`, d.appendChild(o), d.scrollTop = d.scrollHeight;
+function m(e, t, d) {
+  if (!e) return;
+  const n = document.createElement("div");
+  n.className = `dev-log-line dev-log-${d}`, n.textContent = `${(/* @__PURE__ */ new Date()).toLocaleTimeString()}  ${t}`, e.appendChild(n), e.scrollTop = e.scrollHeight;
 }
-var f = "ago_dev_panel_collapsed";
-function c(n, e) {
-  n.classList.toggle("collapsed", e);
-  const o = n.querySelector(".dev-toggle");
-  o && (o.textContent = e ? "▢" : "—", o.title = e ? "Expand dev tools" : "Collapse dev tools", o.setAttribute("aria-expanded", String(!e)));
+function c(e, t) {
+  m(x, e, t);
+}
+function y(e) {
+  let t;
+  return e.type ? t = e.type : e.content !== void 0 ? t = "content" : e.full_content !== void 0 ? t = "full_content" : e.status ? t = `status:${e.status}` : t = "event", `${t}  ${JSON.stringify(e)}`;
+}
+var S = "ago_dev_panel_collapsed", E = "ago_dev_events_collapsed";
+function g(e, t, d, n) {
+  e.classList.toggle("collapsed", t);
+  const o = e.querySelector(".dev-toggle");
+  o && (o.textContent = t ? "▢" : "—", o.title = t ? `Expand ${n}` : `Collapse ${n}`, o.setAttribute("aria-expanded", String(!t)));
+  try {
+    localStorage.setItem(d, t ? "1" : "0");
+  } catch {
+  }
+}
+function u(e, t, d) {
+  e.querySelector(".dev-toggle")?.addEventListener("click", (o) => {
+    o.stopPropagation(), g(e, !e.classList.contains("collapsed"), t, d);
+  }), e.addEventListener("click", () => {
+    e.classList.contains("collapsed") && g(e, !1, t, d);
+  });
+  let n = !1;
   try {
-    localStorage.setItem(f, e ? "1" : "0");
+    n = localStorage.getItem(t) === "1";
   } catch {
   }
+  g(e, n, t, d);
 }
-function y(n) {
-  const { client: e, target: o } = n;
-  x = () => {
-    const t = e.getContextSnapshot()?.entries ?? {};
-    return Object.fromEntries(Object.entries(t).map(([l, { name: s, data: h }]) => [l, {
-      name: s,
-      data: h
+function L(e) {
+  const { client: t, target: d } = e;
+  h = () => {
+    const a = t.getContextSnapshot()?.entries ?? {};
+    return Object.fromEntries(Object.entries(a).map(([l, { name: r, data: b }]) => [l, {
+      name: r,
+      data: b
     }]));
-  }, b();
-  const u = typeof o == "string" ? document.querySelector(o) : o instanceof Element ? o : document.body, a = document.createElement("aside");
-  a.id = "ago-dev-panel", (u ?? document.body).appendChild(a), a.innerHTML = `
+  }, C();
+  const n = typeof d == "string" ? document.querySelector(d) : d instanceof Element ? d : document.body, o = document.createElement("aside");
+  o.id = "ago-dev-panel", o.className = "ago-dev-card", (n ?? document.body).appendChild(o), o.innerHTML = `
     <div class="dev-head">
       <span class="dev-badge">DEV</span>
       <span class="dev-title">DEV TOOLS · client-side function state — not for production</span>
       <button type="button" class="dev-toggle" aria-label="Toggle dev tools">—</button>
     </div>
     <div class="dev-body">
-      <div class="dev-fns">Registered functions: <code>${(e.getRegisteredFunctions?.() ?? []).map((t) => t.name).join(", ") || "—"}</code></div>
+      <div class="dev-fns">Registered functions: <code>${(t.getRegisteredFunctions?.() ?? []).map((a) => a.name).join(", ") || "—"}</code></div>
       <div class="dev-section-label">JSON object (built by the agent)</div>
       <pre class="dev-state" id="ago-dev-state"></pre>
       <div class="dev-section-label">Function calls</div>
       <div class="dev-log" id="ago-dev-log"></div>
     </div>
-  `, p = a.querySelector("#ago-dev-state"), d = a.querySelector("#ago-dev-log"), a.querySelector(".dev-toggle")?.addEventListener("click", (t) => {
-    t.stopPropagation(), c(a, !a.classList.contains("collapsed"));
-  }), a.addEventListener("click", () => {
-    a.classList.contains("collapsed") && c(a, !1);
-  });
-  let g = !1;
-  try {
-    g = localStorage.getItem(f) === "1";
-  } catch {
-  }
-  c(a, g), e.on("function:invoke", ({ functionName: t, arguments: l }) => {
-    r(`→ ${t}(${JSON.stringify(l ?? {})})`, "invoke");
-  }), e.on("function:result", ({ result: t, error: l }) => {
-    r(l ? `✗ error: ${l}` : `← ${JSON.stringify(t)}`, l ? "error" : "result"), i();
-  }), e.on("context:changed", i), e.on("conversation:loaded", (t) => {
-    const l = (t.messages ?? []).flatMap((s) => s.toolCalls ?? []);
-    r(`⟳ hydrated "${t.title || t.id}" — replayed ${l.length} tool call${l.length === 1 ? "" : "s"}`, "hydrate"), i();
+  `, v = o.querySelector("#ago-dev-state"), x = o.querySelector("#ago-dev-log"), u(o, S, "dev tools");
+  const s = document.createElement("aside");
+  s.id = "ago-dev-events", s.className = "ago-dev-card", (n ?? document.body).appendChild(s), s.innerHTML = `
+    <div class="dev-head">
+      <span class="dev-badge">SSE</span>
+      <span class="dev-title">SSE EVENT LOG · raw stream messages</span>
+      <button type="button" class="dev-toggle" aria-label="Toggle SSE event log">—</button>
+    </div>
+    <div class="dev-body">
+      <div class="dev-log" id="ago-dev-event-log"></div>
+    </div>
+  `, p = s.querySelector("#ago-dev-event-log"), u(s, E, "SSE event log"), t.on("stream:message", (a) => {
+    m(p, y(a), "event");
+  }), t.on("function:invoke", ({ functionName: a, arguments: l }) => {
+    c(`→ ${a}(${JSON.stringify(l ?? {})})`, "invoke");
+  }), t.on("function:result", ({ result: a, error: l }) => {
+    c(l ? `✗ error: ${l}` : `← ${JSON.stringify(a)}`, l ? "error" : "result"), i();
+  }), t.on("context:changed", i), t.on("conversation:loaded", (a) => {
+    const l = (a.messages ?? []).flatMap((r) => r.toolCalls ?? []);
+    c(`⟳ hydrated "${a.title || a.id}" — replayed ${l.length} tool call${l.length === 1 ? "" : "s"}`, "hydrate"), i();
   }), i();
 }
-var v = "ago-dev-panel-styles";
-function b() {
-  if (document.getElementById(v)) return;
-  const n = document.createElement("style");
-  n.id = v, n.textContent = m, document.head.appendChild(n);
+var f = "ago-dev-panel-styles";
+function C() {
+  if (document.getElementById(f)) return;
+  const e = document.createElement("style");
+  e.id = f, e.textContent = w, document.head.appendChild(e);
 }
-var m = `
-#ago-dev-panel {
+var w = `
+.ago-dev-card {
   position: fixed;
-  top: 16px;
   right: 16px;
   width: min(360px, calc(100vw - 32px));
   max-width: calc(100vw - 32px);
@@ -87,8 +109,11 @@ var m = `
   font-size: 12px;
   z-index: 1000;
 }
-#ago-dev-panel .dev-head { display: flex; align-items: center; gap: 8px; }
-#ago-dev-panel .dev-toggle {
+/* The main panel pins to the top, the SSE log to the bottom, so they don't overlap. */
+#ago-dev-panel { top: 16px; }
+#ago-dev-events { bottom: 16px; }
+.ago-dev-card .dev-head { display: flex; align-items: center; gap: 8px; }
+.ago-dev-card .dev-toggle {
   margin-left: auto;
   flex: none;
   width: 22px;
@@ -104,19 +129,19 @@ var m = `
   line-height: 1;
   cursor: pointer;
 }
-#ago-dev-panel .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }
-#ago-dev-panel .dev-body { display: flex; flex-direction: column; gap: 8px; }
+.ago-dev-card .dev-toggle:hover { color: #d7e0e8; border-color: #3a4655; }
+.ago-dev-card .dev-body { display: flex; flex-direction: column; gap: 8px; }
 
-/* Collapsed: shrink to a small clickable widget showing only the DEV badge. */
-#ago-dev-panel.collapsed {
+/* Collapsed: shrink to a small clickable widget showing only the badge. */
+.ago-dev-card.collapsed {
   width: auto;
   cursor: pointer;
   padding: 8px 10px;
 }
-#ago-dev-panel.collapsed .dev-title,
-#ago-dev-panel.collapsed .dev-body { display: none; }
-#ago-dev-panel.collapsed .dev-toggle { margin-left: 6px; }
-#ago-dev-panel .dev-badge {
+.ago-dev-card.collapsed .dev-title,
+.ago-dev-card.collapsed .dev-body { display: none; }
+.ago-dev-card.collapsed .dev-toggle { margin-left: 6px; }
+.ago-dev-card .dev-badge {
   background: #f59e0b;
   color: #1c1206;
   font-weight: 700;
@@ -125,17 +150,17 @@ var m = `
   padding: 2px 6px;
   border-radius: 5px;
 }
-#ago-dev-panel .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }
-#ago-dev-panel .dev-fns { color: #7c8a99; font-size: 11px; }
-#ago-dev-panel .dev-fns code { color: #9ecbff; }
-#ago-dev-panel .dev-section-label {
+.ago-dev-card .dev-title { color: #f59e0b; font-size: 11px; line-height: 1.3; }
+.ago-dev-card .dev-fns { color: #7c8a99; font-size: 11px; }
+.ago-dev-card .dev-fns code { color: #9ecbff; }
+.ago-dev-card .dev-section-label {
   color: #7c8a99;
   text-transform: uppercase;
   letter-spacing: .08em;
   font-size: 10px;
   margin-top: 4px;
 }
-#ago-dev-panel .dev-state {
+.ago-dev-card .dev-state {
   margin: 0;
   padding: 8px;
   background: #060a0e;
@@ -145,7 +170,7 @@ var m = `
   white-space: pre;
   color: #c8e6c9;
 }
-#ago-dev-panel .dev-log {
+.ago-dev-card .dev-log {
   display: flex;
   flex-direction: column;
   gap: 2px;
@@ -155,12 +180,15 @@ var m = `
   border-radius: 8px;
   padding: 6px 8px;
 }
-#ago-dev-panel .dev-log-line { white-space: pre-wrap; word-break: break-word; line-height: 1.4; }
-#ago-dev-panel .dev-log-invoke { color: #9ecbff; }
-#ago-dev-panel .dev-log-result { color: #86efac; }
-#ago-dev-panel .dev-log-error { color: #fca5a5; }
-#ago-dev-panel .dev-log-hydrate { color: #d8b4fe; }
+/* The SSE log is the events panel's only content, so give it more room. */
+#ago-dev-events .dev-log { max-height: 60vh; }
+.ago-dev-card .dev-log-line { white-space: pre-wrap; word-break: break-word; line-height: 1.4; }
+.ago-dev-card .dev-log-invoke { color: #9ecbff; }
+.ago-dev-card .dev-log-result { color: #86efac; }
+.ago-dev-card .dev-log-error { color: #fca5a5; }
+.ago-dev-card .dev-log-hydrate { color: #d8b4fe; }
+.ago-dev-card .dev-log-event { color: #7c8a99; }
 `;
 export {
-  y as initDevPanel
+  L as initDevPanel
 };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./AgoClient-nYVPdI5x.cjs"),m=require("./createFormCollector-CQKfRjfj.cjs"),p=require("./createConversationSession-CnIchjFa.cjs"),w=require("./createMockClient-zHQ0cjUH.cjs");require("./testing.cjs");const g=require("./functions-DsmzgHjC.cjs");function h(e){return e}function E(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function S(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function y(e,o){return e.on("message:start",o),()=>e.off("message:start",o)}function v(e,o){return e.on("message:error",o),()=>e.off("message:error",o)}function b(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function F(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*M(e,o,l){const a=[];let r=null,s=!1;const c=i=>{a.push(i),r?.()},f=i=>c({type:"start",data:i}),t=i=>c({type:"chunk",data:i}),u=i=>{c({type:"complete",data:i}),s=!0,r?.()},d=i=>{c({type:"error",data:i}),s=!0,r?.()},C=i=>c({type:"toolCall",data:i});e.on("message:start",f),e.on("message:chunk",t),e.on("message:complete",u),e.on("message:error",d),e.on("toolCall:received",C),e.sendMessage(o,l).catch(()=>{s=!0,r?.()});try{for(;!s||a.length>0;)a.length>0?yield a.shift():(await new Promise(i=>{r=i}),r=null)}finally{e.off("message:start",f),e.off("message:chunk",t),e.off("message:complete",u),e.off("message:error",d),e.off("toolCall:received",C)}}function A(e){let o,l,a,r,s,c;if(typeof window<"u"&&window.AGO){const t=window.AGO;o=t.basepath,l=t.widgetId,a=t.agent||t.defaultAgent,r=t.permission,s=t.email,c=t.jwt}if(typeof document<"u"){const t=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||t("ago-base-url"),l=l||t("ago-widget-id"),a=a||t("ago-agent")||t("ago-agent-id"),r=r||t("ago-permission"),s=s||t("ago-user-email")}if(typeof document<"u"){const t=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of t)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,a=a||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,r=r||u.getAttribute("data-ago-permission")||void 0,s=s||u.getAttribute("data-ago-user-email")||void 0)}o=e?.baseUrl||o,l=e?.widgetId||l,a=e?.agent||e?.defaultAgentId||a,r=e?.permission||r,s=e?.userEmail||s,c=e?.userJwt||c;const f=e?.debug;return o?{baseUrl:o,widgetId:l,agent:a,permission:r,userEmail:s,userJwt:c,debug:f}:null}function k(e){const o=A(e);if(!o)throw new n.AgoError('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.',"config_missing_base_url");return new n.AgoClient(o)}function q(e,o){return{...e,handler:o}}exports.AgoApiError=n.AgoApiError;exports.AgoClient=n.AgoClient;exports.AgoError=n.AgoError;exports.AgoFunctionError=n.AgoFunctionError;exports.AgoNetworkError=n.AgoNetworkError;exports.AgoStreamError=n.AgoStreamError;exports.ClientContextRegistry=n.ClientContextRegistry;exports.EventEmitter=n.EventEmitter;exports.FunctionRegistry=n.FunctionRegistry;exports.SSEHandler=n.SSEHandler;exports.autoDetectConfig=A;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=k;exports.createConversationSession=p.createConversationSession;exports.createFormCollector=m.createFormCollector;exports.createMessageStream=M;exports.createMockClient=w.createMockClient;exports.createStore=m.createStore;exports.defineFunction=h;exports.deriveFormStatus=m.deriveFormStatus;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=n.isStreamNetworkError;exports.loadFormCollector=m.loadFormCollector;exports.logger=n.logger;exports.onFunctionInvoke=F;exports.onMessage=E;exports.onMessageChunk=S;exports.onMessageError=v;exports.onMessageStart=y;exports.onToolCall=b;exports.openUrl=g.openUrl;exports.scrollToElement=g.scrollToElement;exports.setLocalStorage=g.setLocalStorage;exports.setTheme=g.setTheme;exports.showConfirmDialog=g.showConfirmDialog;exports.showNotification=g.showNotification;exports.showToast=g.showToast;exports.submitForm=g.submitForm;exports.trackEvent=g.trackEvent;exports.validateConfig=n.validateConfig;exports.withHandler=q;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./AgoClient--y10UXUV.cjs"),m=require("./createFormCollector-CSG5ioym.cjs"),p=require("./createConversationSession-lJWANT6T.cjs"),w=require("./createMockClient-zHQ0cjUH.cjs");require("./testing.cjs");const g=require("./functions-DsmzgHjC.cjs");function h(e){return e}function E(e,o){return e.on("message:complete",o),()=>e.off("message:complete",o)}function S(e,o){return e.on("message:chunk",o),()=>e.off("message:chunk",o)}function y(e,o){return e.on("message:start",o),()=>e.off("message:start",o)}function v(e,o){return e.on("message:error",o),()=>e.off("message:error",o)}function b(e,o){return e.on("toolCall:received",o),()=>e.off("toolCall:received",o)}function F(e,o){return e.on("function:invoke",o),()=>e.off("function:invoke",o)}async function*M(e,o,l){const a=[];let r=null,s=!1;const c=i=>{a.push(i),r?.()},f=i=>c({type:"start",data:i}),t=i=>c({type:"chunk",data:i}),u=i=>{c({type:"complete",data:i}),s=!0,r?.()},d=i=>{c({type:"error",data:i}),s=!0,r?.()},C=i=>c({type:"toolCall",data:i});e.on("message:start",f),e.on("message:chunk",t),e.on("message:complete",u),e.on("message:error",d),e.on("toolCall:received",C),e.sendMessage(o,l).catch(()=>{s=!0,r?.()});try{for(;!s||a.length>0;)a.length>0?yield a.shift():(await new Promise(i=>{r=i}),r=null)}finally{e.off("message:start",f),e.off("message:chunk",t),e.off("message:complete",u),e.off("message:error",d),e.off("toolCall:received",C)}}function A(e){let o,l,a,r,s,c;if(typeof window<"u"&&window.AGO){const t=window.AGO;o=t.basepath,l=t.widgetId,a=t.agent||t.defaultAgent,r=t.permission,s=t.email,c=t.jwt}if(typeof document<"u"){const t=u=>document.querySelector(`meta[name="${u}"]`)?.getAttribute("content")||void 0;o=o||t("ago-base-url"),l=l||t("ago-widget-id"),a=a||t("ago-agent")||t("ago-agent-id"),r=r||t("ago-permission"),s=s||t("ago-user-email")}if(typeof document<"u"){const t=[document.body,...Array.from(document.querySelectorAll("script[data-ago-base-url]"))].filter(Boolean);for(const u of t)u&&(o=o||u.getAttribute("data-ago-base-url")||void 0,l=l||u.getAttribute("data-ago-widget-id")||void 0,a=a||u.getAttribute("data-ago-agent")||u.getAttribute("data-ago-agent-id")||void 0,r=r||u.getAttribute("data-ago-permission")||void 0,s=s||u.getAttribute("data-ago-user-email")||void 0)}o=e?.baseUrl||o,l=e?.widgetId||l,a=e?.agent||e?.defaultAgentId||a,r=e?.permission||r,s=e?.userEmail||s,c=e?.userJwt||c;const f=e?.debug;return o?{baseUrl:o,widgetId:l,agent:a,permission:r,userEmail:s,userJwt:c,debug:f}:null}function k(e){const o=A(e);if(!o)throw new n.AgoError('createAgo(): could not detect AGO configuration. Set window.AGO, add <meta name="ago-base-url">, or pass { baseUrl } explicitly.',"config_missing_base_url");return new n.AgoClient(o)}function q(e,o){return{...e,handler:o}}exports.AgoApiError=n.AgoApiError;exports.AgoClient=n.AgoClient;exports.AgoError=n.AgoError;exports.AgoFunctionError=n.AgoFunctionError;exports.AgoNetworkError=n.AgoNetworkError;exports.AgoStreamError=n.AgoStreamError;exports.ClientContextRegistry=n.ClientContextRegistry;exports.EventEmitter=n.EventEmitter;exports.FunctionRegistry=n.FunctionRegistry;exports.SSEHandler=n.SSEHandler;exports.autoDetectConfig=A;exports.copyToClipboard=g.copyToClipboard;exports.createAgo=k;exports.createConversationSession=p.createConversationSession;exports.createFormCollector=m.createFormCollector;exports.createMessageStream=M;exports.createMockClient=w.createMockClient;exports.createStore=m.createStore;exports.defineFunction=h;exports.deriveFormStatus=m.deriveFormStatus;exports.getLocalStorage=g.getLocalStorage;exports.getUserLocation=g.getUserLocation;exports.highlightElement=g.highlightElement;exports.isStreamNetworkError=n.isStreamNetworkError;exports.loadFormCollector=m.loadFormCollector;exports.logger=n.logger;exports.onFunctionInvoke=F;exports.onMessage=E;exports.onMessageChunk=S;exports.onMessageError=v;exports.onMessageStart=y;exports.onToolCall=b;exports.openUrl=g.openUrl;exports.scrollToElement=g.scrollToElement;exports.setLocalStorage=g.setLocalStorage;exports.setTheme=g.setTheme;exports.showConfirmDialog=g.showConfirmDialog;exports.showNotification=g.showNotification;exports.showToast=g.showToast;exports.submitForm=g.submitForm;exports.trackEvent=g.trackEvent;exports.validateConfig=n.validateConfig;exports.withHandler=q;

package/dist/index.d.cts

@@ -254,6 +254,13 @@ export declare interface AgoClientEvents {
         conversationId: string;
         messageId: string;
     };
+    /**
+     * Every raw SSE message parsed off the stream, before the handler interprets it
+     * into the higher-level `message:*` / `toolCall:*` / `function:*` events. Carries
+     * the chunk verbatim so debugging tools (notably the dev panel) can log the exact
+     * wire payload. Heartbeat comments are not messages and don't fire this.
+     */
+    "stream:message": SSEChunkData;
     /**
      * The main answer text is done (backend emitted `status: "DONE"`), but follow-up
      * replies may still be pending. Fires once, before `message:complete`.
@@ -1300,6 +1307,7 @@ export declare class SSEHandler {
     private followUpReplies;
     private isFirstChunk;
     private answerCompleteEmitted;
+    private firedClientFunctions;
     constructor(callbacks: SSEHandlerCallbacks);
     /**
      * Process a streaming response
@@ -1314,6 +1322,11 @@ export declare class SSEHandler {
 }
 
 declare interface SSEHandlerCallbacks {
+    /**
+     * Every raw SSE chunk parsed off the stream, fired before it's interpreted into
+     * the higher-level callbacks below. The verbatim payload, for debugging/logging.
+     */
+    onRawChunk?: (data: SSEChunkData) => void;
     onStart?: (data: {
         conversationId: string;
         messageId: string;

package/dist/index.d.ts

@@ -254,6 +254,13 @@ export declare interface AgoClientEvents {
         conversationId: string;
         messageId: string;
     };
+    /**
+     * Every raw SSE message parsed off the stream, before the handler interprets it
+     * into the higher-level `message:*` / `toolCall:*` / `function:*` events. Carries
+     * the chunk verbatim so debugging tools (notably the dev panel) can log the exact
+     * wire payload. Heartbeat comments are not messages and don't fire this.
+     */
+    "stream:message": SSEChunkData;
     /**
      * The main answer text is done (backend emitted `status: "DONE"`), but follow-up
      * replies may still be pending. Fires once, before `message:complete`.
@@ -1300,6 +1307,7 @@ export declare class SSEHandler {
     private followUpReplies;
     private isFirstChunk;
     private answerCompleteEmitted;
+    private firedClientFunctions;
     constructor(callbacks: SSEHandlerCallbacks);
     /**
      * Process a streaming response
@@ -1314,6 +1322,11 @@ export declare class SSEHandler {
 }
 
 declare interface SSEHandlerCallbacks {
+    /**
+     * Every raw SSE chunk parsed off the stream, fired before it's interpreted into
+     * the higher-level callbacks below. The verbatim payload, for debugging/logging.
+     */
+    onRawChunk?: (data: SSEChunkData) => void;
     onStart?: (data: {
         conversationId: string;
         messageId: string;

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as h, c as A, d as y, f as C, i as E, l as b, n as S, o as v, p as k, r as F, s as M, t as d, u as c } from "./AgoClient-CBLJfu90.js";
-import { i as I, n as U, r as G, t as O } from "./createFormCollector-CyD7KnjG.js";
-import { t as x } from "./createConversationSession-D3aHSSir.js";
+import { a as h, c as A, d as y, f as C, i as E, l as b, n as S, o as v, p as k, r as F, s as M, t as d, u as c } from "./AgoClient-DYdIe_R4.js";
+import { i as I, n as U, r as G, t as O } from "./createFormCollector-BUqSA2Qw.js";
+import { t as x } from "./createConversationSession-Boi0PjDU.js";
 import { t as N } from "./createMockClient-DwdxNwEn.js";
 import "./testing.js";
 import { a as H, c as J, d as R, f as j, i as B, l as P, m as $, o as z, p as K, r as Q, s as V, t as W, u as X } from "./functions-C1-5vadY.js";