@agents24/chat-react 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from "./controller";
 export * from "./context-window";
 export * from "./latest-thread-scroller";
 export * from "./message-lifecycle";
+export * from "./mcp-oauth";
 export * from "./model";
 export * from "./renderers";
 export * from "./sse";

package/dist/index.js

@@ -152,16 +152,16 @@ var STAGE_PRIORITY = {
 function numberOrNull(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
-function stagePriority(window) {
-  return STAGE_PRIORITY[window?.stage || "sent_prompt"] ?? STAGE_PRIORITY.sent_prompt;
+function stagePriority(window2) {
+  return STAGE_PRIORITY[window2?.stage || "sent_prompt"] ?? STAGE_PRIORITY.sent_prompt;
 }
-function hasRenderableContextWindow(window) {
-  const maxTokens = window?.max_tokens;
+function hasRenderableContextWindow(window2) {
+  const maxTokens = window2?.max_tokens;
   return typeof maxTokens === "number" && Number.isFinite(maxTokens) && maxTokens > 0;
 }
-function windowWeight(window) {
-  if (!window) return [0, 0];
-  return [stagePriority(window), SOURCE_PRIORITY[window.source] || 0];
+function windowWeight(window2) {
+  if (!window2) return [0, 0];
+  return [stagePriority(window2), SOURCE_PRIORITY[window2.source] || 0];
 }
 function normalizeContextCompression(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return null;
@@ -314,6 +314,22 @@ var assistantTextFromEvents = (events) => {
 };
 var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
 var optionalString = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+var HITL_ACTIONS_BY_KIND = {
+  tool_review: ["approve", "reject"],
+  mcp_auth: ["connect", "skip"],
+  user_approval: ["approve", "reject"],
+  app_data_permission: ["approve", "reject"]
+};
+var HITL_STATUSES = ["pending", "resolved", "expired", "cancelled", "invalidated"];
+function exactHitlActions(kind, value) {
+  if (!Array.isArray(value)) throw new Error("Invalid V2 HITL response block.");
+  const actions = value.map((item) => String(item));
+  const expected = HITL_ACTIONS_BY_KIND[kind];
+  if (actions.length !== expected.length || actions.some((action, index) => action !== expected[index])) {
+    throw new Error("Invalid V2 HITL response block.");
+  }
+  return actions;
+}
 var toolStateFromStatus = (status) => {
   const normalized = String(status || "").trim().toLowerCase();
   if (["failed", "error"].includes(normalized)) return "output-error";
@@ -420,17 +436,19 @@ var partsFromResponseBlocks = (blocks, fallbackText) => {
       const interruptId = optionalString(block.interruptId) || optionalString(hitl.interrupt_id);
       const hitlKind = optionalString(block.hitlKind) || optionalString(hitl.kind);
       const status = optionalString(block.status) || optionalString(hitl.status) || "pending";
-      const allowedActions = Array.isArray(hitl.allowed_actions) ? hitl.allowed_actions.filter((value) => ["approve", "reject", "connect", "skip"].includes(String(value))) : [];
-      if (!interruptId || allowedActions.length === 0 || !["tool_review", "mcp_auth", "user_approval", "app_data_permission"].includes(String(hitlKind))) {
+      if (!interruptId || !["tool_review", "mcp_auth", "user_approval", "app_data_permission"].includes(String(hitlKind)) || !HITL_STATUSES.includes(status)) {
         throw new Error("Invalid V2 HITL response block.");
       }
+      const kind = hitlKind;
+      const allowedActions = exactHitlActions(kind, hitl.allowed_actions);
       const resolution = asRecord(block.resolution);
+      const resolver = asRecord(resolution?.resolver);
       parts.push({
         id,
         type: "hitl",
         kind: "hitl",
         interruptId,
-        hitlKind,
+        hitlKind: kind,
         message: optionalString(hitl.message) || optionalString(block.text) || "Input is required to continue.",
         allowedActions,
         status,
@@ -440,7 +458,10 @@ var partsFromResponseBlocks = (blocks, fallbackText) => {
           outcome: optionalString(resolution.outcome),
           reason: optionalString(resolution.reason),
           resolvedAt: optionalString(resolution.resolved_at),
-          resolver: asRecord(resolution.resolver)
+          resolver: resolver ? {
+            principalType: optionalString(resolver.principal_type) || optionalString(resolver.principalType) || null,
+            principalId: optionalString(resolver.principal_id) || optionalString(resolver.principalId) || null
+          } : null
         } : null,
         raw: block
       });
@@ -1546,6 +1567,59 @@ function useAgents24ChatController(options) {
   ]);
 }
 
+// src/mcp-oauth.ts
+var CONNECTION_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function normalizedOrigin(value) {
+  try {
+    return new URL(value).origin;
+  } catch {
+    throw new Error("MCP authorization returned an invalid callback origin.");
+  }
+}
+function waitForMcpOauthComplete({
+  popup,
+  callbackOrigin,
+  serverId,
+  timeoutMs = 12e4
+}) {
+  if (!popup) return Promise.reject(new Error("Could not open the MCP authorization popup."));
+  const expectedOrigin = normalizedOrigin(callbackOrigin);
+  const expectedServerId = String(serverId || "").trim();
+  if (!expectedServerId) return Promise.reject(new Error("MCP authorization is missing its server identity."));
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const finish = (result) => {
+      if (settled) return;
+      settled = true;
+      window.clearTimeout(timeout);
+      window.clearInterval(closeTimer);
+      window.removeEventListener("message", onMessage);
+      if (result instanceof Error) reject(result);
+      else resolve(result);
+    };
+    const onMessage = (event) => {
+      if (event.source !== popup || event.origin !== expectedOrigin) return;
+      const data = event.data;
+      if (data?.type !== "mcp-oauth-complete" || data.server_id !== expectedServerId) return;
+      if (!data.success) {
+        finish(new Error("MCP authorization failed."));
+        return;
+      }
+      const connectionId = String(data.connection_id || "").trim();
+      if (!CONNECTION_ID_PATTERN.test(connectionId)) return;
+      finish({ connectionId });
+    };
+    const timeout = window.setTimeout(
+      () => finish(new Error("MCP authorization timed out.")),
+      Math.max(1, timeoutMs)
+    );
+    const closeTimer = window.setInterval(() => {
+      if (popup.closed) finish(new Error("MCP authorization window was closed before connecting."));
+    }, 500);
+    window.addEventListener("message", onMessage);
+  });
+}
+
 // src/renderers.tsx
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 var DefaultToolPart = ({ part }) => {
@@ -1853,6 +1927,7 @@ export {
   useMessageScroller,
   useMessageScrollerScrollable,
   useMessageScrollerVisibility,
-  useStreamingText
+  useStreamingText,
+  waitForMcpOauthComplete
 };
 //# sourceMappingURL=index.js.map