@cadraos/sdk 0.3.11 → 0.3.13

package/dist/kanban/index.js

@@ -258,12 +258,9 @@ function useKanbanBoard(options) {
       ]);
       setBoard(nextBoard);
       setCards(cardList.cards);
-      setSelectedCard((prev) => {
-        if (!prev) return prev;
-        const next = cardList.cards.find((c) => c.id === prev.id);
-        if (!next) return prev;
-        return next.run ? next : { ...next, run: prev.run };
-      });
+      setSelectedCard(
+        (prev) => prev ? cardList.cards.find((c) => c.id === prev.id) ?? prev : prev
+      );
     } catch (err) {
       fail(err, "Failed to load board");
     } finally {
@@ -278,12 +275,9 @@ function useKanbanBoard(options) {
       ]);
       setBoard(nextBoard);
       setCards(cardList.cards);
-      setSelectedCard((prev) => {
-        if (!prev) return prev;
-        const next = cardList.cards.find((c) => c.id === prev.id);
-        if (!next) return prev;
-        return next.run ? next : { ...next, run: prev.run };
-      });
+      setSelectedCard(
+        (prev) => prev ? cardList.cards.find((c) => c.id === prev.id) ?? prev : prev
+      );
     } catch {
     }
   }, [adapter]);
@@ -304,7 +298,7 @@ function useKanbanBoard(options) {
       try {
         const full = await adapter.getCard(cardId);
         setSelectedCard(
-          (prev) => prev == null || prev.id === cardId ? full : prev
+          (prev) => prev && prev.id === cardId ? full : prev
         );
       } catch (err) {
         if (!known) fail(err, "Failed to open card");
@@ -413,27 +407,6 @@ function useKanbanBoard(options) {
     },
     [refresh]
   );
-  const deleteCard = useCallback(
-    async (cardId) => {
-      if (!adapter.deleteCard) return false;
-      setError(null);
-      const prevCards = cards;
-      const prevSelected = selectedCard;
-      setCards((prev) => prev.filter((c) => c.id !== cardId));
-      setSelectedCard((prev) => prev && prev.id === cardId ? null : prev);
-      try {
-        await adapter.deleteCard(cardId);
-        void silentRefresh();
-        return true;
-      } catch (err) {
-        setCards(prevCards);
-        setSelectedCard(prevSelected);
-        fail(err, "Failed to delete card");
-        return false;
-      }
-    },
-    [adapter, cards, selectedCard, silentRefresh, fail]
-  );
   return {
     board,
     lanes: board?.lanes ?? [],
@@ -449,7 +422,6 @@ function useKanbanBoard(options) {
     createCard,
     updateCard,
     transitionCard,
-    deleteCard,
     handleRunTerminal
   };
 }
@@ -2743,9 +2715,6 @@ function KanbanCard({
   onClick,
   selected,
   dueState,
-  draggable,
-  onDragStart,
-  onDragEnd,
   className
 }) {
   const runStatus = card.run?.status;
@@ -2774,20 +2743,10 @@ function KanbanCard({
       onClick: () => onClick?.(card),
       "aria-pressed": selected,
       "aria-busy": isWorking,
-      draggable,
-      onDragStart: draggable ? (e) => {
-        e.dataTransfer.effectAllowed = "move";
-        e.dataTransfer.setData("text/plain", card.id);
-        onDragStart?.(card);
-      } : void 0,
-      onDragEnd: draggable ? () => onDragEnd?.() : void 0,
       className: cn9(
-        // Solid card: fill + border + a faint token top-sheen (adapts to theme),
-        // matching the host's cockpit cards (work-shell v2 visual pass).
-        "relative w-full text-left rounded-xl border bg-card bg-gradient-to-b from-foreground/[0.03] to-transparent p-3 shadow-sm motion-safe:transition-shadow",
+        "relative w-full text-left rounded-lg border bg-card p-3 shadow-sm transition",
         "hover:shadow-md hover:border-primary/40",
         "focus:outline-none focus:ring-2 focus:ring-ring/50",
-        draggable && "cursor-grab active:cursor-grabbing",
         // The working card carries the SINGLE focal motion on the board (F11).
         isWorking ? "border-info/60 ring-2 ring-info/40 animate-pulse" : selected ? "border-primary/60 ring-2 ring-primary/30" : "border-border",
         className
@@ -2864,11 +2823,6 @@ function CapMeter({ count, cap, className }) {
     }
   );
 }
-var AGENT_GROUPS = [
-  { kind: "cadra", label: "Cadra agents" },
-  { kind: "remote", label: "Your own agents" },
-  { kind: "human", label: "Teammates" }
-];
 function AgentKindIcon({ kind }) {
   const common = {
     viewBox: "0 0 24 24",
@@ -2911,55 +2865,17 @@ function OnlineDot({ online }) {
     }
   );
 }
-function RemoteBadge() {
-  return /* @__PURE__ */ jsx("span", { className: "shrink-0 rounded-full border border-accent/40 bg-accent/15 px-1.5 py-px text-[10px] font-semibold leading-4 text-accent", children: "Remote" });
-}
 function LaneAgentPicker({
   selected,
   options,
   onSelect,
   canEdit = true,
   lockedReason,
-  onEditAgent,
   className
 }) {
   const [open, setOpen] = useState(false);
-  const [placement, setPlacement] = useState(null);
   const rootRef = useRef(null);
-  const triggerRef = useRef(null);
   const editable = canEdit && !!onSelect && (options?.length ?? 0) > 0;
-  const openMenu = () => {
-    const el = triggerRef.current;
-    if (el && typeof window !== "undefined") {
-      const rect = el.getBoundingClientRect();
-      const vw = window.innerWidth || 0;
-      const vh = window.innerHeight || 0;
-      const margin = 8;
-      const gap = 4;
-      const desired = 288;
-      const width = Math.max(
-        Math.min(rect.width || 224, Math.max(vw - margin * 2, 160)),
-        160
-      );
-      const left = Math.min(
-        Math.max(rect.left, margin),
-        Math.max(vw - width - margin, margin)
-      );
-      const spaceBelow = vh - rect.bottom - gap - margin;
-      const spaceAbove = rect.top - gap - margin;
-      const flipUp = spaceBelow < desired && spaceAbove > spaceBelow;
-      const maxHeight = Math.max(
-        Math.min(desired, flipUp ? spaceAbove : spaceBelow),
-        120
-      );
-      setPlacement(
-        flipUp ? { bottom: Math.max(vh - rect.top + gap, margin), left, width, maxHeight } : { top: rect.bottom + gap, left, width, maxHeight }
-      );
-    } else {
-      setPlacement(null);
-    }
-    setOpen(true);
-  };
   useEffect(() => {
     if (!open) return;
     const onDocDown = (e) => {
@@ -2993,28 +2909,14 @@ function LaneAgentPicker({
       }
     ),
     /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate text-left", children: displayLabel }),
-    kind === "remote" && /* @__PURE__ */ jsx(RemoteBadge, {}),
     /* @__PURE__ */ jsx(OnlineDot, { online: selected?.online })
   ] });
-  const grouped = AGENT_GROUPS.map((group) => ({
-    ...group,
-    items: (options ?? []).filter((opt) => (opt.kind ?? "cadra") === group.kind)
-  })).filter((group) => group.items.length > 0);
-  const menuStyle = placement ? {
-    position: "fixed",
-    top: placement.top,
-    bottom: placement.bottom,
-    left: placement.left,
-    width: placement.width,
-    maxHeight: placement.maxHeight
-  } : void 0;
   return /* @__PURE__ */ jsxs("div", { ref: rootRef, className: cn9("relative mt-2 w-full", className), children: [
     editable ? /* @__PURE__ */ jsxs(
       "button",
       {
-        ref: triggerRef,
         type: "button",
-        onClick: () => open ? setOpen(false) : openMenu(),
+        onClick: () => setOpen((o) => !o),
         "aria-haspopup": "listbox",
         "aria-expanded": open,
         "aria-label": `Assigned agent: ${displayLabel}. Change`,
@@ -3092,106 +2994,47 @@ function LaneAgentPicker({
       ),
       /* @__PURE__ */ jsx("span", { children: lockedReason })
     ] }),
-    editable && open && /* @__PURE__ */ jsxs(
-      "div",
+    editable && open && /* @__PURE__ */ jsx(
+      "ul",
       {
-        style: menuStyle,
+        role: "listbox",
+        "aria-label": "Assign an agent",
         className: cn9(
-          "flex flex-col overflow-hidden rounded-lg border border-border bg-popover shadow-lg",
-          menuStyle ? "z-50" : "absolute z-20 mt-1 max-h-64 w-full"
+          "absolute z-20 mt-1 max-h-64 w-full overflow-y-auto rounded-lg border border-border",
+          "bg-popover p-1 shadow-lg"
         ),
-        children: [
-          /* @__PURE__ */ jsx(
-            "ul",
-            {
-              role: "listbox",
-              "aria-label": "Assign an agent",
-              className: "min-h-0 flex-1 overflow-y-auto p-1",
-              children: grouped.map((group) => /* @__PURE__ */ jsxs("li", { role: "presentation", children: [
-                /* @__PURE__ */ jsx("div", { className: "px-2 pb-1 pt-2 text-[10px] font-semibold uppercase tracking-wide text-muted-foreground", children: group.label }),
-                /* @__PURE__ */ jsx("ul", { role: "group", "aria-label": group.label, children: group.items.map((opt) => {
-                  const isSelected = opt.id === selected?.id;
-                  const optKind = opt.kind ?? "cadra";
-                  return /* @__PURE__ */ jsx("li", { role: "option", "aria-selected": isSelected, children: /* @__PURE__ */ jsxs(
-                    "button",
-                    {
-                      type: "button",
-                      onClick: () => {
-                        onSelect(opt.id);
-                        setOpen(false);
-                      },
-                      className: cn9(
-                        "flex min-h-11 w-full items-center gap-1.5 rounded-md px-2 text-left text-xs font-medium",
-                        "hover:bg-muted focus:outline-none focus:ring-2 focus:ring-ring/50",
-                        isSelected ? "text-primary" : "text-foreground"
-                      ),
-                      children: [
-                        /* @__PURE__ */ jsx(
-                          "span",
-                          {
-                            className: cn9(
-                              "grid h-5 w-5 shrink-0 place-items-center rounded-full",
-                              optKind === "cadra" ? "bg-primary/15 text-primary" : "bg-secondary text-foreground"
-                            ),
-                            children: /* @__PURE__ */ jsx(AgentKindIcon, { kind: optKind })
-                          }
-                        ),
-                        /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: opt.label }),
-                        optKind === "remote" && /* @__PURE__ */ jsx(RemoteBadge, {}),
-                        /* @__PURE__ */ jsx(OnlineDot, { online: opt.online }),
-                        isSelected && /* @__PURE__ */ jsx(
-                          "svg",
-                          {
-                            viewBox: "0 0 24 24",
-                            fill: "none",
-                            stroke: "currentColor",
-                            strokeWidth: 2,
-                            strokeLinecap: "round",
-                            strokeLinejoin: "round",
-                            "aria-hidden": true,
-                            className: "h-3.5 w-3.5 shrink-0",
-                            children: /* @__PURE__ */ jsx("path", { d: "M20 6L9 17l-5-5" })
-                          }
-                        )
-                      ]
-                    }
-                  ) }, opt.id);
-                }) })
-              ] }, group.kind))
-            }
-          ),
-          onEditAgent && selected && /* @__PURE__ */ jsx("div", { className: "border-t border-border p-1", children: /* @__PURE__ */ jsxs(
+        children: options.map((opt) => {
+          const isSelected = opt.id === selected?.id;
+          return /* @__PURE__ */ jsx("li", { role: "option", "aria-selected": isSelected, children: /* @__PURE__ */ jsxs(
             "button",
             {
               type: "button",
               onClick: () => {
-                onEditAgent(selected.id);
+                onSelect(opt.id);
                 setOpen(false);
               },
               className: cn9(
-                "flex min-h-11 w-full items-center gap-1.5 rounded-md px-2 text-left text-xs font-medium text-foreground",
-                "hover:bg-muted focus:outline-none focus:ring-2 focus:ring-ring/50"
+                "flex min-h-11 w-full items-center gap-1.5 rounded-md px-2 text-left text-xs font-medium",
+                "hover:bg-muted focus:outline-none focus:ring-2 focus:ring-ring/50",
+                isSelected ? "text-primary" : "text-foreground"
               ),
               children: [
                 /* @__PURE__ */ jsx(
-                  "svg",
+                  "span",
                   {
-                    viewBox: "0 0 24 24",
-                    fill: "none",
-                    stroke: "currentColor",
-                    strokeWidth: 2,
-                    strokeLinecap: "round",
-                    strokeLinejoin: "round",
-                    "aria-hidden": true,
-                    className: "h-3.5 w-3.5 shrink-0 text-muted-foreground",
-                    children: /* @__PURE__ */ jsx("path", { d: "M17 3a2.85 2.83 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5Z" })
+                    className: cn9(
+                      "grid h-5 w-5 shrink-0 place-items-center rounded-full",
+                      (opt.kind ?? "cadra") === "cadra" ? "bg-primary/15 text-primary" : "bg-secondary text-foreground"
+                    ),
+                    children: /* @__PURE__ */ jsx(AgentKindIcon, { kind: opt.kind ?? "cadra" })
                   }
                 ),
-                "Edit this agent"
+                /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: opt.label }),
+                /* @__PURE__ */ jsx(OnlineDot, { online: opt.online })
               ]
             }
-          ) })
-        ]
+          ) }, opt.id);
+        })
       }
     )
   ] });
@@ -3216,12 +3059,6 @@ function KanbanColumn({
   count,
   agentPicker,
   canEditHandlers,
-  draggableCards,
-  dragActive,
-  dropAllowed,
-  onCardDragStart,
-  onCardDragEnd,
-  onLaneDrop,
   className
 }) {
   const headerCount = count ?? cards.length;
@@ -3232,21 +3069,9 @@ function KanbanColumn({
   return /* @__PURE__ */ jsxs(
     "div",
     {
-      onDragOver: dropAllowed ? (e) => {
-        e.preventDefault();
-        e.dataTransfer.dropEffect = "move";
-      } : void 0,
-      onDrop: dropAllowed && onLaneDrop ? (e) => {
-        e.preventDefault();
-        onLaneDrop(lane);
-      } : void 0,
       className: cn9(
-        "flex w-[85vw] max-w-sm snap-start shrink-0 flex-col rounded-xl bg-muted/40 border border-border transition sm:w-72 sm:max-w-none",
+        "flex w-[85vw] max-w-sm snap-start shrink-0 flex-col rounded-xl bg-muted/40 border border-border sm:w-72 sm:max-w-none",
         isScheduled && "border-border",
-        // MV4 drag affordance: allowed targets glow; other lanes dim so the
-        // valid drop zones read at a glance.
-        dragActive && dropAllowed && "border-primary/60 ring-2 ring-primary/40 bg-primary/5",
-        dragActive && !dropAllowed && "opacity-55",
         className
       ),
       children: [
@@ -3315,10 +3140,7 @@ function KanbanColumn({
               card,
               onClick: onCardClick,
               selected: card.id === selectedCardId,
-              dueState: dueStateFor(card, lane, now),
-              draggable: draggableCards,
-              onDragStart: onCardDragStart,
-              onDragEnd: onCardDragEnd
+              dueState: dueStateFor(card, lane, now)
             },
             card.id
           )),
@@ -3478,8 +3300,6 @@ function KanbanBoard({
   laneAgentPicker,
   scheduleStatus,
   focusCardId,
-  renderCardDrawer,
-  enableDrag,
   className
 }) {
   const {
@@ -3494,7 +3314,6 @@ function KanbanBoard({
     createCard,
     updateCard,
     transitionCard,
-    deleteCard,
     handleRunTerminal
   } = useKanbanBoard({ adapter, onError, onCardCreated, pollIntervalMs });
   const lastFocusedRef = useRef(void 0);
@@ -3539,44 +3358,6 @@ function KanbanBoard({
     (cardId, toLane) => transitionCard({ cardId, targetLane: toLane }),
     [transitionCard]
   );
-  const [dragging, setDragging] = useState(null);
-  const draggingRef = useRef(null);
-  const dropInFlightRef = useRef(null);
-  const allowedDropLanes = useMemo(() => {
-    if (!dragging || !board?.transitions) return /* @__PURE__ */ new Set();
-    return new Set(
-      board.transitions.filter((t) => t.fromLane === dragging.lane && t.manualAllowed).map((t) => t.toLane)
-    );
-  }, [dragging, board?.transitions]);
-  const handleCardDragStart = useCallback((card) => {
-    const d = { id: card.id, lane: card.lane };
-    draggingRef.current = d;
-    setDragging(d);
-  }, []);
-  const handleCardDragEnd = useCallback(() => {
-    draggingRef.current = null;
-    setDragging(null);
-  }, []);
-  const handleLaneDrop = useCallback(
-    (lane) => {
-      const cur = draggingRef.current;
-      draggingRef.current = null;
-      setDragging(null);
-      if (!cur || lane.key === cur.lane) return;
-      if (dropInFlightRef.current === cur.id) return;
-      const allowed = (board?.transitions ?? []).some(
-        (t) => t.fromLane === cur.lane && t.toLane === lane.key && t.manualAllowed
-      );
-      if (!allowed) return;
-      dropInFlightRef.current = cur.id;
-      void Promise.resolve(transitionCard({ cardId: cur.id, targetLane: lane.key })).finally(
-        () => {
-          if (dropInFlightRef.current === cur.id) dropInFlightRef.current = null;
-        }
-      );
-    },
-    [board?.transitions, transitionCard]
-  );
   const initialLaneKey = lanes.find((l) => !l.terminal)?.key ?? lanes[0]?.key;
   const selectedLane = selectedCard ? lanes.find((l) => l.key === selectedCard.lane) : void 0;
   const canAdvanceSelected = !!selectedLane && !selectedLane.terminal;
@@ -3597,32 +3378,12 @@ function KanbanBoard({
             showCreate: enableCreate && lane.key === initialLaneKey,
             count: laneCounts?.[lane.key],
             agentPicker: laneAgentPicker?.(lane),
-            canEditHandlers,
-            draggableCards: enableDrag && enableAdvance,
-            dragActive: !!dragging,
-            dropAllowed: !!dragging && dragging.lane !== lane.key && allowedDropLanes.has(lane.key),
-            onCardDragStart: handleCardDragStart,
-            onCardDragEnd: handleCardDragEnd,
-            onLaneDrop: handleLaneDrop
+            canEditHandlers
           },
           lane.id ?? lane.key
         ))
       ] }),
-      selectedCard && (renderCardDrawer ? renderCardDrawer({
-        card: selectedCard,
-        adapter,
-        lanes,
-        transitions: enableAdvance ? board?.transitions : void 0,
-        canAdvance: canAdvanceSelected,
-        onClose: closeCard,
-        onRetry: onRetryCard ? handleRetry : void 0,
-        onUpdate: enableEdit ? handleUpdate : void 0,
-        onAdvance: enableAdvance ? handleAdvance : void 0,
-        onTransition: enableAdvance ? handleTransition : void 0,
-        onDelete: adapter.deleteCard ? deleteCard : void 0,
-        onRunTerminal: handleRunTerminal,
-        onError
-      }) : /* @__PURE__ */ jsx(
+      selectedCard && /* @__PURE__ */ jsx(
         CardDrawer,
         {
           card: selectedCard,
@@ -3638,7 +3399,7 @@ function KanbanBoard({
           onRunTerminal: handleRunTerminal,
           onError
         }
-      ))
+      )
     ] })
   ] });
 }
@@ -3663,7 +3424,6 @@ function composeAdapter(source, boardConfigUuid, version, cardSource) {
     transitionCard(input) {
       return cardSource.transitionCard(input);
     },
-    ...cardSource.deleteCard ? { deleteCard: (id) => cardSource.deleteCard(id) } : {},
     ...cardSource.createRunStream ? { createRunStream: (id) => cardSource.createRunStream(id) } : {}
   };
 }
@@ -4128,7 +3888,8 @@ var SSEClient = class {
           "Authorization": this.config.authHeader,
           "X-Org-Id": String(this.config.orgId),
           "Accept": "text/event-stream",
-          "Cache-Control": "no-cache"
+          "Cache-Control": "no-cache",
+          ...this.config.lastEventId ? { "Last-Event-ID": this.config.lastEventId } : {}
         },
         signal: this.abortController.signal
       });
@@ -4344,13 +4105,167 @@ function normalizeUrl(url) {
   return url;
 }
 
+// src/streaming/poll-policy.ts
+var UNNAMED_RATE_LIMIT_WAIT_MS = 6e4;
+function asDict(value) {
+  return typeof value === "object" && value !== null ? value : null;
+}
+var RATE_LIMIT_CODES = /* @__PURE__ */ new Set([
+  "rate_limit_error",
+  "rate_limited",
+  "rate_limit_exceeded",
+  "too_many_requests"
+]);
+function isRateLimited(error) {
+  if (typeof error === "string") return /\b429\b/.test(error);
+  const err = asDict(error);
+  if (!err) return false;
+  for (const key of ["status", "statusCode", "httpStatus", "code"]) {
+    if (err[key] === 429 || err[key] === "429") return true;
+  }
+  const response = asDict(err.response);
+  if (response && (response.status === 429 || response.statusCode === 429)) return true;
+  if (typeof err.code === "string" && RATE_LIMIT_CODES.has(err.code.toLowerCase())) return true;
+  if (err.name === "RateLimitError") return true;
+  const message = typeof err.message === "string" ? err.message : "";
+  return /\b429\b/.test(message) || /rate[\s_-]?limit/i.test(message) || /too many requests/i.test(message);
+}
+function readHeader(bag, name) {
+  if (bag === null || bag === void 0) return null;
+  const getter = bag.get;
+  if (typeof getter === "function") {
+    try {
+      const value = getter.call(bag, name);
+      if (value !== null && value !== void 0) return String(value);
+    } catch {
+    }
+  }
+  const dict = asDict(bag);
+  if (!dict) return null;
+  const wanted = name.toLowerCase();
+  for (const [key, value] of Object.entries(dict)) {
+    if (key.toLowerCase() === wanted && value !== null && value !== void 0) {
+      return String(value);
+    }
+  }
+  return null;
+}
+function parseRetryAfter(raw, now) {
+  if (raw === null || raw === void 0) return null;
+  if (typeof raw === "number") {
+    return Number.isFinite(raw) && raw >= 0 ? raw * 1e3 : null;
+  }
+  if (typeof raw !== "string") return null;
+  const trimmed = raw.trim();
+  if (trimmed === "") return null;
+  if (/^\d+(\.\d+)?$/.test(trimmed)) return Number(trimmed) * 1e3;
+  const at = Date.parse(trimmed);
+  return Number.isNaN(at) ? null : Math.max(0, at - now);
+}
+function parseResetAt(raw, now) {
+  if (raw === null || raw === void 0) return null;
+  const numeric = typeof raw === "number" ? raw : typeof raw === "string" && /^\d+(\.\d+)?$/.test(raw.trim()) ? Number(raw.trim()) : null;
+  if (numeric !== null) {
+    if (!Number.isFinite(numeric) || numeric < 0) return null;
+    if (numeric > 1e11) return Math.max(0, numeric - now);
+    if (numeric > 1e9) return Math.max(0, numeric * 1e3 - now);
+    return numeric * 1e3;
+  }
+  if (typeof raw !== "string") return null;
+  const at = Date.parse(raw.trim());
+  return Number.isNaN(at) ? null : Math.max(0, at - now);
+}
+function getRetryAfterMs(error, now = Date.now()) {
+  const err = asDict(error);
+  if (!err) return null;
+  const details = asDict(err.details);
+  const response = asDict(err.response);
+  const body = asDict(err.body) ?? asDict(response?.data);
+  const bodyError = asDict(body?.error);
+  const bodyDetails = asDict(bodyError?.details) ?? asDict(body?.details);
+  for (const source of [err, details, bodyDetails]) {
+    const ms = source?.retryAfterMs;
+    if (typeof ms === "number" && Number.isFinite(ms) && ms >= 0) return ms;
+  }
+  for (const source of [err, details, bodyDetails, bodyError]) {
+    const parsed = parseRetryAfter(source?.retryAfter, now);
+    if (parsed !== null) return parsed;
+  }
+  const headerBags = [err.headers, response?.headers, details?.headers, body?.headers];
+  for (const bag of headerBags) {
+    const parsed = parseRetryAfter(readHeader(bag, "retry-after"), now);
+    if (parsed !== null) return parsed;
+  }
+  for (const source of [details, bodyDetails, err]) {
+    for (const key of ["resetAt", "reset", "rateLimitReset"]) {
+      const parsed = parseResetAt(source?.[key], now);
+      if (parsed !== null) return parsed;
+    }
+  }
+  for (const bag of headerBags) {
+    for (const header of ["x-ratelimit-reset", "ratelimit-reset"]) {
+      const parsed = parseResetAt(readHeader(bag, header), now);
+      if (parsed !== null) return parsed;
+    }
+  }
+  return null;
+}
+function getHttpStatus(error) {
+  const err = asDict(error);
+  if (!err) return null;
+  for (const key of ["status", "statusCode", "httpStatus"]) {
+    const value = err[key];
+    if (typeof value === "number" && Number.isFinite(value)) return value;
+    if (typeof value === "string" && /^\d{3}$/.test(value)) return Number(value);
+  }
+  const response = asDict(err.response);
+  for (const key of ["status", "statusCode"]) {
+    const value = response?.[key];
+    if (typeof value === "number" && Number.isFinite(value)) return value;
+  }
+  return null;
+}
+function isTerminalClientError(error) {
+  const status = getHttpStatus(error);
+  if (status === null) return false;
+  return status >= 400 && status < 500 && status !== 429 && status !== 408;
+}
+var FAILURE_GROWTH_FACTOR = 2;
+var IDLE_GROWTH_FACTOR = 1.5;
+function nextFailureDelayMs(currentMs, maxMs) {
+  return Math.min(Math.max(currentMs, 1) * FAILURE_GROWTH_FACTOR, maxMs);
+}
+function nextIdleDelayMs(currentMs, maxMs) {
+  return Math.min(Math.ceil(Math.max(currentMs, 1) * IDLE_GROWTH_FACTOR), maxMs);
+}
+function applyJitter(delayMs, ratio, random = Math.random) {
+  if (ratio <= 0) return delayMs;
+  return Math.round(delayMs * (1 + random() * ratio));
+}
+
 // src/streaming/stream-controller.ts
 var DEFAULT_STREAMING_CONFIG = {
   maxReconnectAttempts: 5,
   reconnectBaseDelayMs: 1e3,
   reconnectMaxDelayMs: 1e4,
+  // NOTE (unchanged, deliberately): this watchdog force-disconnects a HEALTHY
+  // SSE connection after 30s of silence and routes it through the same
+  // handleConnectionError path as a real transport failure. Ordinary LLM
+  // latency exceeds 30s routinely, so it fires against working streams — that
+  // is what drives sessions into the polling fallback in the first place. The
+  // fix is a server-side SSE heartbeat, not a bigger number here; raising this
+  // is a guess against a moving target. Everything below only bounds what the
+  // fallback costs once it has been entered.
   activityTimeoutMs: 3e4,
-  pollingIntervalMs: 2e3
+  pollingIntervalMs: 5e3,
+  pollingMaxIntervalMs: 3e4,
+  pollingMaxConsecutiveFailures: 10,
+  pollingMaxConsecutiveRateLimits: 3,
+  pollingMaxConsecutiveClientErrors: 3,
+  pollingMaxDurationMs: 18e5,
+  pollingMaxRetryAfterMs: 3e5,
+  pollingJitterRatio: 0.1,
+  sseRetryIntervalMs: 6e4
 };
 var DEFAULT_POLLING_ENABLED = true;
 var ExecutionStreamControllerImpl = class {
@@ -4363,9 +4278,24 @@ var ExecutionStreamControllerImpl = class {
   seenEventIds = /* @__PURE__ */ new Set();
   _lastEventId = null;
   activityTimeoutId = null;
-  pollingIntervalId = null;
   finalExecution = null;
   finalError = null;
+  // --- Fallback polling state ---
+  // A self-rescheduling timeout, not setInterval: the delay has to change
+  // between ticks (that is what backoff IS), and a timeout chain also cannot
+  // stack overlapping requests the way a fixed interval does when the API is
+  // slow to answer.
+  pollTimeoutId = null;
+  pollDelayMs = 0;
+  pollConsecutiveFailures = 0;
+  pollConsecutiveRateLimits = 0;
+  pollConsecutiveClientErrors = 0;
+  /** When the loop last observed anything new — the clock the give-up bound runs on. */
+  pollLastProgressAt = 0;
+  pollInFlight = false;
+  lastPolledStatus = null;
+  sseRetryTimeoutId = null;
+  sseRetryInFlight = false;
   // Event callbacks
   listeners = {
     log: [],
@@ -4394,6 +4324,39 @@ var ExecutionStreamControllerImpl = class {
     this.config = { ...DEFAULT_STREAMING_CONFIG, ...options.config };
     this.pollingEnabled = options.pollingEnabled ?? DEFAULT_POLLING_ENABLED;
   }
+  // Resolved fallback-poll settings. Read through `??` rather than off the
+  // spread config so an explicit `undefined` in a caller's partial config still
+  // lands on the default instead of NaN-ing the arithmetic.
+  get pollBaseIntervalMs() {
+    return this.config.pollingIntervalMs ?? DEFAULT_STREAMING_CONFIG.pollingIntervalMs;
+  }
+  get pollMaxIntervalMs() {
+    return Math.max(
+      this.config.pollingMaxIntervalMs ?? DEFAULT_STREAMING_CONFIG.pollingMaxIntervalMs,
+      this.pollBaseIntervalMs
+    );
+  }
+  get pollMaxConsecutiveFailures() {
+    return this.config.pollingMaxConsecutiveFailures ?? DEFAULT_STREAMING_CONFIG.pollingMaxConsecutiveFailures;
+  }
+  get pollMaxConsecutiveRateLimits() {
+    return this.config.pollingMaxConsecutiveRateLimits ?? DEFAULT_STREAMING_CONFIG.pollingMaxConsecutiveRateLimits;
+  }
+  get pollMaxConsecutiveClientErrors() {
+    return this.config.pollingMaxConsecutiveClientErrors ?? DEFAULT_STREAMING_CONFIG.pollingMaxConsecutiveClientErrors;
+  }
+  get pollMaxDurationMs() {
+    return this.config.pollingMaxDurationMs ?? DEFAULT_STREAMING_CONFIG.pollingMaxDurationMs;
+  }
+  get pollMaxRetryAfterMs() {
+    return this.config.pollingMaxRetryAfterMs ?? DEFAULT_STREAMING_CONFIG.pollingMaxRetryAfterMs;
+  }
+  get pollJitterRatio() {
+    return this.config.pollingJitterRatio ?? DEFAULT_STREAMING_CONFIG.pollingJitterRatio;
+  }
+  get sseRetryIntervalMs() {
+    return this.config.sseRetryIntervalMs ?? DEFAULT_STREAMING_CONFIG.sseRetryIntervalMs;
+  }
   /**
    * Get the last event ID (for resume support)
    */
@@ -4484,28 +4447,45 @@ var ExecutionStreamControllerImpl = class {
     console.log("[SDK:StreamController] executionId:", this.options.executionId);
     console.log("[SDK:StreamController] orgId:", this.options.orgId);
     console.log("[SDK:StreamController] apiKey:", authToken ? `${authToken.substring(0, 20)}...` : "MISSING");
-    this.sseClient = new SSEClient({
+    if (this.sseClient) {
+      this.sseClient.disconnect();
+      this.sseClient = null;
+    }
+    const client = new SSEClient({
       url,
       authHeader: `Bearer ${authToken}`,
       orgId: this.options.orgId,
       fetch: this.options.fetch,
-      onEvent: (event) => this.handleEvent(event),
+      // Resume from where this session left off. On a first connect this is
+      // null and the header is omitted.
+      lastEventId: this._lastEventId,
+      onEvent: (event) => {
+        if (this.sseClient !== client) return;
+        this.handleEvent(event);
+      },
       onError: (error) => {
+        if (this.sseClient !== client) return;
         console.error("[SDK:StreamController] SSE error:", error);
         this.handleConnectionError(error);
       },
       onConnectionChange: (connected) => {
+        if (this.sseClient !== client) return;
         console.log("[SDK:StreamController] SSE connection change:", connected);
         if (connected) {
           this.status = "connected";
           this.reconnectAttempts = 0;
+          this.stopPolling();
           this.resetActivityTimeout();
         }
-        this.emit("connectionChange", { connected, usingFallback: false });
+        this.emit("connectionChange", {
+          connected,
+          usingFallback: this.status === "fallback_polling"
+        });
       }
     });
+    this.sseClient = client;
     try {
-      await this.sseClient.connect();
+      await client.connect();
       console.log("[SDK:StreamController] SSE connect() completed");
     } catch (error) {
       console.error("[SDK:StreamController] SSE connect() threw:", error);
@@ -4744,6 +4724,7 @@ var ExecutionStreamControllerImpl = class {
   handleComplete(data) {
     this.status = "closed";
     this.stopActivityTimeout();
+    this.stopPolling();
     const sessionId = data.sessionId ?? this.options.sessionId;
     const execution = {
       uuid: this.options.executionId,
@@ -4770,6 +4751,7 @@ var ExecutionStreamControllerImpl = class {
   handleError(error) {
     this.status = "closed";
     this.stopActivityTimeout();
+    this.stopPolling();
     this.finalError = error;
     this.emit("error", error);
     if (this.waitReject) {
@@ -4796,6 +4778,10 @@ var ExecutionStreamControllerImpl = class {
       this.handleError({ error: msg, errorCode: "stream_unrecoverable" });
       return;
     }
+    if (this.status === "fallback_polling") {
+      this.startPolling();
+      return;
+    }
     if (this.reconnectAttempts < this.config.maxReconnectAttempts) {
       this.status = "reconnecting";
       this.reconnectAttempts++;
@@ -4865,42 +4851,216 @@ var ExecutionStreamControllerImpl = class {
     }
   }
   /**
-   * Start polling fallback
+   * Start polling fallback.
+   *
+   * Idempotent — calling it while a loop is already running is a no-op, so no
+   * path can end up with two loops racing the same execution.
    */
   startPolling() {
-    this.pollingIntervalId = setInterval(async () => {
-      try {
-        const execution = await this.options.getExecution(this.options.executionId);
-        for (const log of execution.logs) {
-          if (!this.seenEventIds.has(log.uuid)) {
-            this.seenEventIds.add(log.uuid);
-            this.emit("log", log);
-          }
-        }
-        if (execution.status === "completed") {
-          this.stopPolling();
-          this.handleComplete(execution);
-        } else if (execution.status === "failed" || execution.status === "cancelled") {
-          this.stopPolling();
-          this.handleError({
-            error: execution.error ?? `Execution ${execution.status}`,
-            errorCode: execution.status
-          });
+    if (this.pollTimeoutId !== null || this.pollInFlight) {
+      return;
+    }
+    this.pollLastProgressAt = Date.now();
+    this.pollDelayMs = this.pollBaseIntervalMs;
+    this.pollConsecutiveFailures = 0;
+    this.pollConsecutiveRateLimits = 0;
+    this.pollConsecutiveClientErrors = 0;
+    this.lastPolledStatus = null;
+    this.stopActivityTimeout();
+    this.scheduleSSERetry();
+    this.schedulePoll(this.pollDelayMs);
+  }
+  /**
+   * Queue the next poll tick.
+   */
+  schedulePoll(delayMs) {
+    if (this.status !== "fallback_polling") {
+      return;
+    }
+    this.pollTimeoutId = setTimeout(() => {
+      this.pollTimeoutId = null;
+      void this.runPoll();
+    }, Math.max(0, Math.round(delayMs)));
+  }
+  /**
+   * One poll tick: fetch state, emit what is new, then decide how long to wait
+   * before the next one — or whether there should be a next one at all.
+   */
+  async runPoll() {
+    if (this.status !== "fallback_polling") {
+      return;
+    }
+    if (Date.now() - this.pollLastProgressAt >= this.pollMaxDurationMs) {
+      this.failPolling(
+        `Streaming fallback gave up: no execution progress for ${Math.round(this.pollMaxDurationMs / 1e3)}s`,
+        "polling_timeout"
+      );
+      return;
+    }
+    this.pollInFlight = true;
+    try {
+      const execution = await this.options.getExecution(this.options.executionId);
+      this.pollConsecutiveFailures = 0;
+      this.pollConsecutiveRateLimits = 0;
+      this.pollConsecutiveClientErrors = 0;
+      let sawNewInfo = false;
+      for (const log of execution.logs ?? []) {
+        if (!this.seenEventIds.has(log.uuid)) {
+          this.seenEventIds.add(log.uuid);
+          this.emit("log", log);
+          sawNewInfo = true;
         }
-      } catch (error) {
-        console.error("Polling error:", error);
       }
-    }, this.config.pollingIntervalMs);
+      if (execution.status !== this.lastPolledStatus) {
+        this.lastPolledStatus = execution.status;
+        sawNewInfo = true;
+      }
+      if (sawNewInfo) {
+        this.pollLastProgressAt = Date.now();
+      }
+      if (execution.status === "completed") {
+        this.stopPolling();
+        this.handleComplete(execution);
+        return;
+      }
+      if (execution.status === "failed" || execution.status === "cancelled") {
+        this.stopPolling();
+        this.handleError({
+          error: execution.error ?? `Execution ${execution.status}`,
+          errorCode: execution.status
+        });
+        return;
+      }
+      this.pollDelayMs = sawNewInfo ? this.pollBaseIntervalMs : nextIdleDelayMs(this.pollDelayMs, this.pollMaxIntervalMs);
+    } catch (error) {
+      if (!this.handlePollError(error)) {
+        return;
+      }
+    } finally {
+      this.pollInFlight = false;
+    }
+    this.schedulePoll(applyJitter(this.pollDelayMs, this.pollJitterRatio));
+  }
+  /**
+   * Apply backpressure for a failed poll.
+   *
+   * @returns `true` to keep polling (with `pollDelayMs` updated), `false` when
+   * the loop has been terminated.
+   */
+  handlePollError(error) {
+    const retryAfterMs = getRetryAfterMs(error);
+    const rateLimited = isRateLimited(error) || retryAfterMs !== null;
+    if (rateLimited) {
+      this.pollConsecutiveRateLimits++;
+      console.warn(
+        "[SDK:StreamController] Poll rate-limited",
+        retryAfterMs !== null ? `(server asked for ${Math.round(retryAfterMs / 1e3)}s)` : "(no reset named)"
+      );
+      if (retryAfterMs !== null && retryAfterMs > this.pollMaxRetryAfterMs) {
+        this.failPolling(
+          `Rate limited: the API asked for ${Math.round(retryAfterMs / 1e3)}s, longer than this stream will wait`,
+          "rate_limited"
+        );
+        return false;
+      }
+      if (this.pollConsecutiveRateLimits >= this.pollMaxConsecutiveRateLimits) {
+        this.failPolling(
+          "Rate limited by the API; stopped the streaming fallback rather than keep spending the key quota",
+          "rate_limited"
+        );
+        return false;
+      }
+      this.pollDelayMs = Math.max(retryAfterMs ?? UNNAMED_RATE_LIMIT_WAIT_MS, this.pollDelayMs);
+      return true;
+    }
+    if (isTerminalClientError(error)) {
+      this.pollConsecutiveClientErrors++;
+      const status = getHttpStatus(error);
+      console.warn(
+        `[SDK:StreamController] Poll got HTTP ${status} (${this.pollConsecutiveClientErrors}/${this.pollMaxConsecutiveClientErrors})`
+      );
+      if (this.pollConsecutiveClientErrors >= this.pollMaxConsecutiveClientErrors) {
+        this.failPolling(
+          `Execution status endpoint returned HTTP ${status} ${this.pollConsecutiveClientErrors} times \u2014 cannot track this run`,
+          "polling_unrecoverable"
+        );
+        return false;
+      }
+      this.pollDelayMs = nextFailureDelayMs(this.pollDelayMs, this.pollMaxIntervalMs);
+      return true;
+    }
+    this.pollConsecutiveFailures++;
+    console.warn(
+      `[SDK:StreamController] Poll failed (${this.pollConsecutiveFailures}/${this.pollMaxConsecutiveFailures}):`,
+      error
+    );
+    if (this.pollConsecutiveFailures >= this.pollMaxConsecutiveFailures) {
+      this.failPolling(
+        `Streaming fallback failed ${this.pollConsecutiveFailures} times in a row`,
+        "polling_failed"
+      );
+      return false;
+    }
+    this.pollDelayMs = nextFailureDelayMs(this.pollDelayMs, this.pollMaxIntervalMs);
+    return true;
   }
   /**
-   * Stop polling
+   * Terminate the fallback loop and surface the reason.
+   */
+  failPolling(error, errorCode) {
+    this.stopPolling();
+    this.handleError({ error, errorCode });
+  }
+  /**
+   * Stop polling, including the periodic SSE re-attempt that belongs to it.
    */
   stopPolling() {
-    if (this.pollingIntervalId) {
-      clearInterval(this.pollingIntervalId);
-      this.pollingIntervalId = null;
+    if (this.pollTimeoutId !== null) {
+      clearTimeout(this.pollTimeoutId);
+      this.pollTimeoutId = null;
+    }
+    if (this.sseRetryTimeoutId !== null) {
+      clearTimeout(this.sseRetryTimeoutId);
+      this.sseRetryTimeoutId = null;
     }
   }
+  /**
+   * Queue the next attempt to get the real stream back.
+   */
+  scheduleSSERetry() {
+    if (this.sseRetryTimeoutId !== null || this.status !== "fallback_polling") {
+      return;
+    }
+    this.sseRetryTimeoutId = setTimeout(() => {
+      this.sseRetryTimeoutId = null;
+      this.attemptSSERecovery();
+    }, this.sseRetryIntervalMs);
+  }
+  /**
+   * Re-attempt SSE from inside the fallback, so a transient outage costs the
+   * session a few polls rather than its stream for the lifetime of the tab.
+   *
+   * Success is NOT observed here: `SSEClient.connect()` resolves when the
+   * stream ENDS, not when it opens. The open is observed by
+   * `onConnectionChange(true)`, which flips status and stops this loop. The
+   * promise below only tells us the attempt is over so the next one can be
+   * queued.
+   */
+  attemptSSERecovery() {
+    if (this.status !== "fallback_polling") {
+      return;
+    }
+    if (this.sseRetryInFlight) {
+      this.scheduleSSERetry();
+      return;
+    }
+    this.sseRetryInFlight = true;
+    void this.connectSSE().catch(() => {
+    }).finally(() => {
+      this.sseRetryInFlight = false;
+      this.scheduleSSERetry();
+    });
+  }
   /**
    * Reset activity timeout
    */
@@ -5031,12 +5191,23 @@ async function collectImagesFromStream(stream, options = {}) {
   });
 }
 
+// src/utils/api-paths.ts
+var API_V1 = "/api/v1";
+var EXECUTION_PATH = `${API_V1}/executions`;
+function executionPath(executionId) {
+  return `${EXECUTION_PATH}/${executionId}`;
+}
+function executionCancelPath(executionId) {
+  return `${EXECUTION_PATH}/${executionId}/cancel`;
+}
+
 // src/resources/agents.ts
 var AgentsAPI = class extends BaseResourceAPI {
   constructor(http, getStreamConfig) {
     super(http, "/api/v1/agents");
     this.getStreamConfig = getStreamConfig;
   }
+  getStreamConfig;
   // ===== LIST Operations =====
   /**
    * List all agents in the organization
@@ -5293,7 +5464,7 @@ var AgentsAPI = class extends BaseResourceAPI {
    * ```
    */
   async getExecution(executionId) {
-    return this.http.get(`/executions/${executionId}`);
+    return this.http.get(executionPath(executionId));
   }
   // ===== EDIT Operations =====
   /**
@@ -5348,7 +5519,7 @@ var AgentsAPI = class extends BaseResourceAPI {
    */
   async cancelExecution(executionId) {
     return this.http.post(
-      `/executions/${executionId}/cancel`,
+      executionCancelPath(executionId),
       void 0,
       { skipRetry: true }
     );
@@ -5849,6 +6020,7 @@ var ArtifactsAPI = class extends BaseResourceAPI {
     }
     return this.http.request({
       method: "POST",
+      // KNOWN BROKEN — same missing `/api/v1` prefix as listArtifacts above.
       path: `/executions/${executionId}/artifacts`,
       body: formData,
       headers: {
@@ -5942,6 +6114,7 @@ var SessionsAPI = class extends BaseResourceAPI {
     super(http, "/api/v1/sessions");
     this.getStreamConfig = getStreamConfig;
   }
+  getStreamConfig;
   // ===== LIST Operations =====
   /**
    * List all sessions in the organization
@@ -6121,7 +6294,7 @@ var SessionsAPI = class extends BaseResourceAPI {
    * Get execution result
    */
   async getExecution(executionId) {
-    return this.http.get(`/executions/${executionId}`);
+    return this.http.get(executionPath(executionId));
   }
   // ===== EDIT Operations =====
   /**
@@ -6261,6 +6434,7 @@ var KanbanAPI = class extends BaseResourceAPI {
     super(http, "/api/v1/kanban");
     this.getStreamConfig = getStreamConfig;
   }
+  getStreamConfig;
   // ===== BOARD =====
   /**
    * Get the current org's board (lanes in declared order). Auto-provisions
@@ -6395,7 +6569,7 @@ var KanbanAPI = class extends BaseResourceAPI {
    * @returns Execution details.
    */
   async getCardRun(executionId) {
-    return this.http.get(`/api/v1/agents/executions/${executionId}`);
+    return this.http.get(executionPath(executionId));
   }
   /**
    * Create a stream controller for a card's run, keyed on the card's
@@ -6462,6 +6636,7 @@ var RemoteAgentsAPI = class extends BaseResourceAPI {
     super(http, "/api/v1/remote-agents");
     this.getStreamConfig = getStreamConfig;
   }
+  getStreamConfig;
   /**
    * List all remote agents in the organization
    *
@@ -6595,7 +6770,7 @@ var RemoteAgentsAPI = class extends BaseResourceAPI {
       apiKey: config.apiKey,
       tokenProvider: config.tokenProvider,
       orgId: config.orgId,
-      getExecution: (id) => this.http.get(`/executions/${id}`)
+      getExecution: (id) => this.http.get(executionPath(id))
     });
     return controller;
   }