@opengeni/react 4.0.2 → 5.0.2-canary.0

package/dist/session-ui.d.ts

@@ -1,6 +1,8 @@
 export { HumanInputForm } from "./components/human-input-form.js";
 export type { HumanInputAnswerDraft, HumanInputFormMessages, HumanInputFormProps, } from "./components/human-input-form.js";
 export { HumanInputSurface } from "./components/human-input-surface.js";
+export { ApprovalSurface } from "./components/approval-surface.js";
+export type { ApprovalSurfaceProps, ApprovalSurfaceMessages } from "./components/approval-surface.js";
 export type { HumanInputSurfaceProps } from "./components/human-input-surface.js";
 export { MessageTimeline, TimelineRow } from "./components/message-timeline.js";
 export type { MessageTimelineProps } from "./components/message-timeline.js";

package/dist/session-ui.js

@@ -1,4 +1,5 @@
 import {
+  ApprovalSurface,
   BUILT_IN_TURN_SUMMARY_FACET_IDS,
   HumanInputForm,
   HumanInputSurface,
@@ -13,7 +14,7 @@ import {
   sessionChromeGoalPillLabel,
   sessionChromeGoalPillState,
   userMessageLikelyNeedsDisclosure
-} from "./chunk-CQG7YUJB.js";
+} from "./chunk-WRVKY242.js";
 import "./chunk-YBM6CQRU.js";
 import "./chunk-5M6VTFJ5.js";
 import "./chunk-ZYRGEKWS.js";
@@ -33,6 +34,7 @@ import "./chunk-NEXLLTP4.js";
 import "./chunk-VRBL3F5E.js";
 import "./chunk-22KP6LR5.js";
 export {
+  ApprovalSurface,
   BUILT_IN_TURN_SUMMARY_FACET_IDS,
   HumanInputForm,
   HumanInputSurface,

package/dist/sites-ui.d.ts

@@ -0,0 +1,33 @@
+import type { OpenGeniClient, WorkspaceArtifact, WorkspaceArtifactContentResponse, WorkspaceArtifactDetailResponse } from "@opengeni/sdk";
+import { type PublishedHtmlArtifactToolBridge } from "./components/artifacts/published-html-artifact-frame.js";
+/** Implement with an authenticated host proxy. Never put an organization key
+ * in browser props; replace the client object when the host actor changes. */
+export type SiteClient = Pick<OpenGeniClient, "listWorkspaceArtifacts" | "getWorkspaceArtifact" | "getWorkspaceArtifactHtml" | "rollbackWorkspaceArtifact" | "setWorkspaceArtifactStatus">;
+type SiteDisplayContent = Pick<WorkspaceArtifactContentResponse, "artifactId" | "versionId" | "html" | "requestedTools">;
+type SiteScope = {
+    client: SiteClient;
+    workspaceId: string;
+    className?: string;
+};
+/** Shared native/embedded read boundary: pin content to the observed version,
+ * and never accept a response belonging to another workspace or Site. */
+export declare function loadSiteSnapshot(client: Pick<SiteClient, "getWorkspaceArtifact" | "getWorkspaceArtifactHtml">, workspaceId: string, siteId: string, options?: {
+    signal?: AbortSignal;
+    includeArchivedContent?: boolean;
+}): Promise<{
+    detail: WorkspaceArtifactDetailResponse;
+    content: SiteDisplayContent | null;
+}>;
+export type SiteListProps = SiteScope & {
+    status?: "active" | "archived";
+    onOpen: (site: WorkspaceArtifact) => void;
+};
+export type SiteDetailProps = SiteScope & {
+    siteId: string;
+    /** Presentation hint only: the backend still enforces artifacts:publish. */
+    canPublish?: boolean;
+    toolBridge?: PublishedHtmlArtifactToolBridge;
+};
+export declare function SiteList(props: SiteListProps): import("react").JSX.Element;
+export declare function SiteDetail(props: SiteDetailProps): import("react").JSX.Element;
+export {};

package/dist/sites.d.ts

@@ -0,0 +1,3 @@
+/** Public package entry: keep TSX implementation behind a release-rewritable .ts boundary. */
+export { SiteList, SiteDetail, loadSiteSnapshot } from "./sites-ui.js";
+export type { SiteClient, SiteListProps, SiteDetailProps } from "./sites-ui.js";

package/dist/sites.js

@@ -0,0 +1,288 @@
+import {
+  PublishedHtmlArtifactFrame
+} from "./chunk-BRFMGY4L.js";
+
+// src/sites-ui.tsx
+import { useEffect, useRef, useState } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+async function loadSiteSnapshot(client, workspaceId, siteId, options = {}) {
+  const requestOptions = options.signal ? { signal: options.signal } : {};
+  const detail = await client.getWorkspaceArtifact(workspaceId, siteId, requestOptions);
+  options.signal?.throwIfAborted();
+  if (detail.artifact.id !== siteId || detail.artifact.workspaceId !== workspaceId)
+    throw new Error("Site scope mismatch");
+  const versionId = detail.artifact.currentVersion?.id;
+  const content = versionId && (detail.artifact.status === "active" || options.includeArchivedContent) ? {
+    artifactId: siteId,
+    versionId,
+    requestedTools: detail.artifact.currentVersion.requestedTools,
+    html: await client.getWorkspaceArtifactHtml(workspaceId, siteId, {
+      ...requestOptions,
+      versionId
+    })
+  } : null;
+  options.signal?.throwIfAborted();
+  if (content && (content.artifactId !== siteId || content.versionId !== versionId))
+    throw new Error("Site content mismatch");
+  return { detail: structuredClone(detail), content: content ? structuredClone(content) : null };
+}
+function useScopeKey(values) {
+  const [scope, setScope] = useState(values);
+  const [generation, setGeneration] = useState(0);
+  if (values.some((value, index) => value !== scope[index])) {
+    setScope(values);
+    setGeneration(generation + 1);
+  }
+  return generation;
+}
+function SiteList(props) {
+  const key = useScopeKey([props.client, props.workspaceId, props.status]);
+  return /* @__PURE__ */ jsx(ScopedSiteList, { ...props }, key);
+}
+function ScopedSiteList({
+  client,
+  workspaceId,
+  status = "active",
+  onOpen,
+  className
+}) {
+  const [page, setPage] = useState(null);
+  const [cursor, setCursor] = useState();
+  const [error, setError] = useState(false);
+  const [reload, setReload] = useState(0);
+  useEffect(() => {
+    const abort = new AbortController();
+    setPage(null);
+    setError(false);
+    void Promise.resolve().then(
+      () => client.listWorkspaceArtifacts(workspaceId, {
+        status,
+        ...cursor ? { cursor } : {},
+        limit: 50,
+        signal: abort.signal
+      })
+    ).then((result) => {
+      if (!abort.signal.aborted) setPage(structuredClone(result));
+    }).catch(() => {
+      if (!abort.signal.aborted) setError(true);
+    });
+    return () => abort.abort();
+  }, [client, workspaceId, status, cursor, reload]);
+  return /* @__PURE__ */ jsxs("section", { className, "aria-label": "Sites", "aria-busy": !page && !error, children: [
+    error ? /* @__PURE__ */ jsx("p", { role: "alert", children: "Sites are unavailable or access has changed. Refresh to check access." }) : !page ? /* @__PURE__ */ jsx("p", { role: "status", children: "Loading Sites\u2026" }) : page.artifacts.length === 0 ? /* @__PURE__ */ jsxs("p", { role: "status", children: [
+      "No ",
+      status,
+      " Sites."
+    ] }) : /* @__PURE__ */ jsx("ul", { children: page.artifacts.map((site) => /* @__PURE__ */ jsxs("li", { children: [
+      /* @__PURE__ */ jsx("button", { type: "button", onClick: () => onOpen(structuredClone(site)), children: site.title }),
+      /* @__PURE__ */ jsx("p", { children: site.description }),
+      /* @__PURE__ */ jsxs("span", { children: [
+        site.status,
+        " \xB7 revision ",
+        site.currentVersion?.revision ?? "unpublished"
+      ] })
+    ] }, site.id)) }),
+    page?.nextCursor && /* @__PURE__ */ jsx("button", { type: "button", onClick: () => setCursor(page.nextCursor), children: "Next page" }),
+    cursor && /* @__PURE__ */ jsx("button", { type: "button", onClick: () => setCursor(void 0), children: "First page" }),
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: () => setReload((value) => value + 1), children: "Refresh Sites" })
+  ] });
+}
+function SiteDetail(props) {
+  const key = useScopeKey([props.client, props.workspaceId, props.siteId]);
+  return /* @__PURE__ */ jsx(ScopedSiteDetail, { ...props }, key);
+}
+function ScopedSiteDetail({
+  client,
+  workspaceId,
+  siteId,
+  canPublish = false,
+  toolBridge,
+  className
+}) {
+  const [loaded, setLoaded] = useState(null);
+  const [error, setError] = useState(false);
+  const [reload, setReload] = useState(0);
+  const [busy, setBusy] = useState(false);
+  const [rollbackId, setRollbackId] = useState("");
+  const [confirmation, setConfirmation] = useState(null);
+  const mutation = useRef(null);
+  useEffect(() => () => mutation.current?.abort(), []);
+  useEffect(() => {
+    const abort = new AbortController();
+    setLoaded(null);
+    setError(false);
+    setConfirmation(null);
+    setRollbackId("");
+    void Promise.resolve().then(async () => {
+      const snapshot = await loadSiteSnapshot(client, workspaceId, siteId, {
+        signal: abort.signal
+      });
+      if (!abort.signal.aborted) setLoaded(snapshot);
+    }).catch(() => {
+      if (!abort.signal.aborted) {
+        setLoaded(null);
+        setError(true);
+      }
+    });
+    return () => abort.abort();
+  }, [client, workspaceId, siteId, reload]);
+  useEffect(() => {
+    if (!loaded || busy) return;
+    const abort = new AbortController();
+    let checking = false;
+    const timer = setInterval(() => {
+      if (checking) return;
+      checking = true;
+      void Promise.resolve().then(() => client.getWorkspaceArtifact(workspaceId, siteId, { signal: abort.signal })).then((detail) => {
+        if (abort.signal.aborted) return;
+        if (detail.artifact.id !== siteId || detail.artifact.workspaceId !== workspaceId)
+          throw new Error("Site scope mismatch");
+        if (detail.artifact.currentVersion?.id !== loaded.detail.artifact.currentVersion?.id || detail.artifact.status !== loaded.detail.artifact.status) {
+          setLoaded(null);
+          setReload((value) => value + 1);
+        }
+      }).catch(() => {
+        if (!abort.signal.aborted) {
+          setLoaded(null);
+          setError(true);
+        }
+      }).finally(() => {
+        checking = false;
+      });
+    }, 15e3);
+    return () => {
+      abort.abort();
+      clearInterval(timer);
+    };
+  }, [client, workspaceId, siteId, loaded, busy]);
+  const commit = async () => {
+    const current = loaded?.detail.artifact.currentVersion;
+    if (!canPublish || !loaded || !current || !confirmation || mutation.current) return;
+    const abort = new AbortController();
+    mutation.current = abort;
+    setBusy(true);
+    try {
+      const common = { expectedCurrentVersionId: current.id, idempotencyKey: crypto.randomUUID() };
+      if (confirmation === "rollback") {
+        if (!loaded.detail.versions.some((version) => version.id === rollbackId))
+          throw new Error("Unknown version");
+        await client.rollbackWorkspaceArtifact(
+          workspaceId,
+          siteId,
+          { ...common, versionId: rollbackId, reason: "Restore explicitly selected Site version" },
+          { signal: abort.signal }
+        );
+      } else {
+        await client.setWorkspaceArtifactStatus(
+          workspaceId,
+          siteId,
+          {
+            ...common,
+            status: loaded.detail.artifact.status === "active" ? "archived" : "active",
+            reason: "Explicit Site status change"
+          },
+          { signal: abort.signal }
+        );
+      }
+      if (!abort.signal.aborted) {
+        setLoaded(null);
+        setReload((value) => value + 1);
+      }
+    } catch {
+      if (!abort.signal.aborted) {
+        setLoaded(null);
+        setError(true);
+      }
+    } finally {
+      if (!abort.signal.aborted) {
+        mutation.current = null;
+        setBusy(false);
+        setConfirmation(null);
+      }
+    }
+  };
+  const site = loaded?.detail.artifact;
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      className,
+      "aria-label": "Site details",
+      "aria-busy": busy || !loaded && !error,
+      children: [
+        error && /* @__PURE__ */ jsx("p", { role: "alert", children: "Site state could not be confirmed or access has changed. Refresh before continuing." }),
+        !loaded && !error && /* @__PURE__ */ jsx("p", { role: "status", children: "Loading Site\u2026" }),
+        site && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx("h2", { children: site.title }),
+          /* @__PURE__ */ jsx("p", { children: site.description }),
+          /* @__PURE__ */ jsxs("p", { children: [
+            site.status,
+            " \xB7 revision ",
+            site.currentVersion?.revision ?? "unpublished"
+          ] }),
+          loaded.content && /* @__PURE__ */ jsx(
+            PublishedHtmlArtifactFrame,
+            {
+              html: loaded.content.html,
+              title: site.title,
+              ...toolBridge ? { toolBridge } : {}
+            }
+          ),
+          /* @__PURE__ */ jsx("h3", { children: "Versions" }),
+          /* @__PURE__ */ jsx("ul", { children: loaded.detail.versions.map((version) => /* @__PURE__ */ jsxs("li", { children: [
+            "Revision ",
+            version.revision,
+            " \xB7 ",
+            version.createdAt,
+            version.id === site.currentVersion?.id ? " \xB7 current" : ""
+          ] }, version.id)) }),
+          loaded.detail.versionsTruncated && /* @__PURE__ */ jsx("p", { children: "Older versions are not included in this response." }),
+          canPublish && site.currentVersion && /* @__PURE__ */ jsxs("fieldset", { disabled: busy, children: [
+            /* @__PURE__ */ jsx("legend", { children: "Manage Site" }),
+            /* @__PURE__ */ jsx("button", { type: "button", onClick: () => setConfirmation("status"), children: site.status === "active" ? "Archive Site" : "Restore Site" }),
+            /* @__PURE__ */ jsxs("label", { children: [
+              "Version to restore",
+              /* @__PURE__ */ jsxs(
+                "select",
+                {
+                  value: rollbackId,
+                  onChange: (event) => {
+                    setRollbackId(event.target.value);
+                    setConfirmation(null);
+                  },
+                  children: [
+                    /* @__PURE__ */ jsx("option", { value: "", children: "Choose a version" }),
+                    loaded.detail.versions.filter((version) => version.id !== site.currentVersion?.id).map((version) => /* @__PURE__ */ jsxs("option", { value: version.id, children: [
+                      "Revision ",
+                      version.revision
+                    ] }, version.id))
+                  ]
+                }
+              )
+            ] }),
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                disabled: !rollbackId,
+                onClick: () => setConfirmation("rollback"),
+                children: "Review rollback"
+              }
+            ),
+            confirmation && /* @__PURE__ */ jsxs("div", { role: "group", "aria-label": "Confirm Site change", children: [
+              /* @__PURE__ */ jsx("p", { children: confirmation === "rollback" ? "Make the selected version current?" : site.status === "active" ? "Archive this Site for workspace users?" : "Restore this Site for workspace users?" }),
+              /* @__PURE__ */ jsx("button", { type: "button", onClick: () => void commit(), children: "Confirm change" }),
+              /* @__PURE__ */ jsx("button", { type: "button", onClick: () => setConfirmation(null), children: "Keep current state" })
+            ] })
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx("button", { type: "button", disabled: busy, onClick: () => setReload((value) => value + 1), children: "Refresh Site" })
+      ]
+    }
+  );
+}
+export {
+  SiteDetail,
+  SiteList,
+  loadSiteSnapshot
+};
+//# sourceMappingURL=sites.js.map

package/dist/sites.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sites-ui.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport type {\n  OpenGeniClient,\n  WorkspaceArtifact,\n  WorkspaceArtifactContentResponse,\n  WorkspaceArtifactDetailResponse,\n  WorkspaceArtifactListResponse,\n} from \"@opengeni/sdk\";\nimport {\n  PublishedHtmlArtifactFrame,\n  type PublishedHtmlArtifactToolBridge,\n} from \"./components/artifacts/published-html-artifact-frame\";\n\n/** Implement with an authenticated host proxy. Never put an organization key\n * in browser props; replace the client object when the host actor changes. */\nexport type SiteClient = Pick<\n  OpenGeniClient,\n  | \"listWorkspaceArtifacts\"\n  | \"getWorkspaceArtifact\"\n  | \"getWorkspaceArtifactHtml\"\n  | \"rollbackWorkspaceArtifact\"\n  | \"setWorkspaceArtifactStatus\"\n>;\ntype SiteDisplayContent = Pick<\n  WorkspaceArtifactContentResponse,\n  \"artifactId\" | \"versionId\" | \"html\" | \"requestedTools\"\n>;\ntype SiteScope = { client: SiteClient; workspaceId: string; className?: string };\n/** Shared native/embedded read boundary: pin content to the observed version,\n * and never accept a response belonging to another workspace or Site. */\nexport async function loadSiteSnapshot(\n  client: Pick<SiteClient, \"getWorkspaceArtifact\" | \"getWorkspaceArtifactHtml\">,\n  workspaceId: string,\n  siteId: string,\n  options: { signal?: AbortSignal; includeArchivedContent?: boolean } = {},\n): Promise<{\n  detail: WorkspaceArtifactDetailResponse;\n  content: SiteDisplayContent | null;\n}> {\n  const requestOptions = options.signal ? { signal: options.signal } : {};\n  const detail = await client.getWorkspaceArtifact(workspaceId, siteId, requestOptions);\n  options.signal?.throwIfAborted();\n  if (detail.artifact.id !== siteId || detail.artifact.workspaceId !== workspaceId)\n    throw new Error(\"Site scope mismatch\");\n  const versionId = detail.artifact.currentVersion?.id;\n  const content =\n    versionId && (detail.artifact.status === \"active\" || options.includeArchivedContent)\n      ? {\n          artifactId: siteId,\n          versionId,\n          requestedTools: detail.artifact.currentVersion!.requestedTools,\n          html: await client.getWorkspaceArtifactHtml(workspaceId, siteId, {\n            ...requestOptions,\n            versionId,\n          }),\n        }\n      : null;\n  options.signal?.throwIfAborted();\n  if (content && (content.artifactId !== siteId || content.versionId !== versionId))\n    throw new Error(\"Site content mismatch\");\n  return { detail: structuredClone(detail), content: content ? structuredClone(content) : null };\n}\nexport type SiteListProps = SiteScope & {\n  status?: \"active\" | \"archived\";\n  onOpen: (site: WorkspaceArtifact) => void;\n};\nexport type SiteDetailProps = SiteScope & {\n  siteId: string;\n  /** Presentation hint only: the backend still enforces artifacts:publish. */\n  canPublish?: boolean;\n  toolBridge?: PublishedHtmlArtifactToolBridge;\n};\n\nfunction useScopeKey(values: readonly unknown[]) {\n  const [scope, setScope] = useState(values);\n  const [generation, setGeneration] = useState(0);\n  if (values.some((value, index) => value !== scope[index])) {\n    setScope(values);\n    setGeneration(generation + 1);\n  }\n  return generation;\n}\n\nexport function SiteList(props: SiteListProps) {\n  const key = useScopeKey([props.client, props.workspaceId, props.status]);\n  return <ScopedSiteList key={key} {...props} />;\n}\nfunction ScopedSiteList({\n  client,\n  workspaceId,\n  status = \"active\",\n  onOpen,\n  className,\n}: SiteListProps) {\n  const [page, setPage] = useState<WorkspaceArtifactListResponse | null>(null);\n  const [cursor, setCursor] = useState<string | undefined>();\n  const [error, setError] = useState(false);\n  const [reload, setReload] = useState(0);\n  useEffect(() => {\n    const abort = new AbortController();\n    setPage(null);\n    setError(false);\n    void Promise.resolve()\n      .then(() =>\n        client.listWorkspaceArtifacts(workspaceId, {\n          status,\n          ...(cursor ? { cursor } : {}),\n          limit: 50,\n          signal: abort.signal,\n        }),\n      )\n      .then((result) => {\n        if (!abort.signal.aborted) setPage(structuredClone(result));\n      })\n      .catch(() => {\n        if (!abort.signal.aborted) setError(true);\n      });\n    return () => abort.abort();\n  }, [client, workspaceId, status, cursor, reload]);\n  return (\n    <section className={className} aria-label=\"Sites\" aria-busy={!page && !error}>\n      {error ? (\n        <p role=\"alert\">Sites are unavailable or access has changed. Refresh to check access.</p>\n      ) : !page ? (\n        <p role=\"status\">Loading Sites…</p>\n      ) : page.artifacts.length === 0 ? (\n        <p role=\"status\">No {status} Sites.</p>\n      ) : (\n        <ul>\n          {page.artifacts.map((site) => (\n            <li key={site.id}>\n              <button type=\"button\" onClick={() => onOpen(structuredClone(site))}>\n                {site.title}\n              </button>\n              <p>{site.description}</p>\n              <span>\n                {site.status} · revision {site.currentVersion?.revision ?? \"unpublished\"}\n              </span>\n            </li>\n          ))}\n        </ul>\n      )}\n      {page?.nextCursor && (\n        <button type=\"button\" onClick={() => setCursor(page.nextCursor!)}>\n          Next page\n        </button>\n      )}\n      {cursor && (\n        <button type=\"button\" onClick={() => setCursor(undefined)}>\n          First page\n        </button>\n      )}\n      <button type=\"button\" onClick={() => setReload((value) => value + 1)}>\n        Refresh Sites\n      </button>\n    </section>\n  );\n}\n\nexport function SiteDetail(props: SiteDetailProps) {\n  const key = useScopeKey([props.client, props.workspaceId, props.siteId]);\n  return <ScopedSiteDetail key={key} {...props} />;\n}\nfunction ScopedSiteDetail({\n  client,\n  workspaceId,\n  siteId,\n  canPublish = false,\n  toolBridge,\n  className,\n}: SiteDetailProps) {\n  const [loaded, setLoaded] = useState<{\n    detail: WorkspaceArtifactDetailResponse;\n    content: SiteDisplayContent | null;\n  } | null>(null);\n  const [error, setError] = useState(false);\n  const [reload, setReload] = useState(0);\n  const [busy, setBusy] = useState(false);\n  const [rollbackId, setRollbackId] = useState(\"\");\n  const [confirmation, setConfirmation] = useState<\"status\" | \"rollback\" | null>(null);\n  const mutation = useRef<AbortController | null>(null);\n  useEffect(() => () => mutation.current?.abort(), []);\n  useEffect(() => {\n    const abort = new AbortController();\n    setLoaded(null);\n    setError(false);\n    setConfirmation(null);\n    setRollbackId(\"\");\n    void Promise.resolve()\n      .then(async () => {\n        const snapshot = await loadSiteSnapshot(client, workspaceId, siteId, {\n          signal: abort.signal,\n        });\n        if (!abort.signal.aborted) setLoaded(snapshot);\n      })\n      .catch(() => {\n        if (!abort.signal.aborted) {\n          setLoaded(null);\n          setError(true);\n        }\n      });\n    return () => abort.abort();\n  }, [client, workspaceId, siteId, reload]);\n  // Recheck live read authority without rebuilding the iframe on every tick.\n  // No overlapping polls, and failures remove the document and tool bridge.\n  useEffect(() => {\n    if (!loaded || busy) return;\n    const abort = new AbortController();\n    let checking = false;\n    const timer = setInterval(() => {\n      if (checking) return;\n      checking = true;\n      void Promise.resolve()\n        .then(() => client.getWorkspaceArtifact(workspaceId, siteId, { signal: abort.signal }))\n        .then((detail) => {\n          if (abort.signal.aborted) return;\n          if (detail.artifact.id !== siteId || detail.artifact.workspaceId !== workspaceId)\n            throw new Error(\"Site scope mismatch\");\n          if (\n            detail.artifact.currentVersion?.id !== loaded.detail.artifact.currentVersion?.id ||\n            detail.artifact.status !== loaded.detail.artifact.status\n          ) {\n            setLoaded(null);\n            setReload((value) => value + 1);\n          }\n        })\n        .catch(() => {\n          if (!abort.signal.aborted) {\n            setLoaded(null);\n            setError(true);\n          }\n        })\n        .finally(() => {\n          checking = false;\n        });\n    }, 15_000);\n    return () => {\n      abort.abort();\n      clearInterval(timer);\n    };\n  }, [client, workspaceId, siteId, loaded, busy]);\n  const commit = async () => {\n    const current = loaded?.detail.artifact.currentVersion;\n    if (!canPublish || !loaded || !current || !confirmation || mutation.current) return;\n    const abort = new AbortController();\n    mutation.current = abort;\n    setBusy(true);\n    try {\n      const common = { expectedCurrentVersionId: current.id, idempotencyKey: crypto.randomUUID() };\n      if (confirmation === \"rollback\") {\n        if (!loaded.detail.versions.some((version) => version.id === rollbackId))\n          throw new Error(\"Unknown version\");\n        await client.rollbackWorkspaceArtifact(\n          workspaceId,\n          siteId,\n          { ...common, versionId: rollbackId, reason: \"Restore explicitly selected Site version\" },\n          { signal: abort.signal },\n        );\n      } else {\n        await client.setWorkspaceArtifactStatus(\n          workspaceId,\n          siteId,\n          {\n            ...common,\n            status: loaded.detail.artifact.status === \"active\" ? \"archived\" : \"active\",\n            reason: \"Explicit Site status change\",\n          },\n          { signal: abort.signal },\n        );\n      }\n      if (!abort.signal.aborted) {\n        setLoaded(null);\n        setReload((value) => value + 1);\n      }\n    } catch {\n      if (!abort.signal.aborted) {\n        setLoaded(null);\n        setError(true);\n      }\n    } finally {\n      if (!abort.signal.aborted) {\n        mutation.current = null;\n        setBusy(false);\n        setConfirmation(null);\n      }\n    }\n  };\n  const site = loaded?.detail.artifact;\n  return (\n    <section\n      className={className}\n      aria-label=\"Site details\"\n      aria-busy={busy || (!loaded && !error)}\n    >\n      {error && (\n        <p role=\"alert\">\n          Site state could not be confirmed or access has changed. Refresh before continuing.\n        </p>\n      )}\n      {!loaded && !error && <p role=\"status\">Loading Site…</p>}\n      {site && (\n        <>\n          <h2>{site.title}</h2>\n          <p>{site.description}</p>\n          <p>\n            {site.status} · revision {site.currentVersion?.revision ?? \"unpublished\"}\n          </p>\n          {loaded.content && (\n            <PublishedHtmlArtifactFrame\n              html={loaded.content.html}\n              title={site.title}\n              {...(toolBridge ? { toolBridge } : {})}\n            />\n          )}\n          <h3>Versions</h3>\n          <ul>\n            {loaded.detail.versions.map((version) => (\n              <li key={version.id}>\n                Revision {version.revision} · {version.createdAt}\n                {version.id === site.currentVersion?.id ? \" · current\" : \"\"}\n              </li>\n            ))}\n          </ul>\n          {loaded.detail.versionsTruncated && (\n            <p>Older versions are not included in this response.</p>\n          )}\n          {canPublish && site.currentVersion && (\n            <fieldset disabled={busy}>\n              <legend>Manage Site</legend>\n              <button type=\"button\" onClick={() => setConfirmation(\"status\")}>\n                {site.status === \"active\" ? \"Archive Site\" : \"Restore Site\"}\n              </button>\n              <label>\n                Version to restore\n                <select\n                  value={rollbackId}\n                  onChange={(event) => {\n                    setRollbackId(event.target.value);\n                    setConfirmation(null);\n                  }}\n                >\n                  <option value=\"\">Choose a version</option>\n                  {loaded.detail.versions\n                    .filter((version) => version.id !== site.currentVersion?.id)\n                    .map((version) => (\n                      <option key={version.id} value={version.id}>\n                        Revision {version.revision}\n                      </option>\n                    ))}\n                </select>\n              </label>\n              <button\n                type=\"button\"\n                disabled={!rollbackId}\n                onClick={() => setConfirmation(\"rollback\")}\n              >\n                Review rollback\n              </button>\n              {confirmation && (\n                <div role=\"group\" aria-label=\"Confirm Site change\">\n                  <p>\n                    {confirmation === \"rollback\"\n                      ? \"Make the selected version current?\"\n                      : site.status === \"active\"\n                        ? \"Archive this Site for workspace users?\"\n                        : \"Restore this Site for workspace users?\"}\n                  </p>\n                  <button type=\"button\" onClick={() => void commit()}>\n                    Confirm change\n                  </button>\n                  <button type=\"button\" onClick={() => setConfirmation(null)}>\n                    Keep current state\n                  </button>\n                </div>\n              )}\n            </fieldset>\n          )}\n        </>\n      )}\n      <button type=\"button\" disabled={busy} onClick={() => setReload((value) => value + 1)}>\n        Refresh Site\n      </button>\n    </section>\n  );\n}\n"],"mappings":";;;;;AAAA,SAAS,WAAW,QAAQ,gBAAgB;AAqFnC,SAwND,UAxNC,KAyCD,YAzCC;AAvDT,eAAsB,iBACpB,QACA,aACA,QACA,UAAsE,CAAC,GAItE;AACD,QAAM,iBAAiB,QAAQ,SAAS,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AACtE,QAAM,SAAS,MAAM,OAAO,qBAAqB,aAAa,QAAQ,cAAc;AACpF,UAAQ,QAAQ,eAAe;AAC/B,MAAI,OAAO,SAAS,OAAO,UAAU,OAAO,SAAS,gBAAgB;AACnE,UAAM,IAAI,MAAM,qBAAqB;AACvC,QAAM,YAAY,OAAO,SAAS,gBAAgB;AAClD,QAAM,UACJ,cAAc,OAAO,SAAS,WAAW,YAAY,QAAQ,0BACzD;AAAA,IACE,YAAY;AAAA,IACZ;AAAA,IACA,gBAAgB,OAAO,SAAS,eAAgB;AAAA,IAChD,MAAM,MAAM,OAAO,yBAAyB,aAAa,QAAQ;AAAA,MAC/D,GAAG;AAAA,MACH;AAAA,IACF,CAAC;AAAA,EACH,IACA;AACN,UAAQ,QAAQ,eAAe;AAC/B,MAAI,YAAY,QAAQ,eAAe,UAAU,QAAQ,cAAc;AACrE,UAAM,IAAI,MAAM,uBAAuB;AACzC,SAAO,EAAE,QAAQ,gBAAgB,MAAM,GAAG,SAAS,UAAU,gBAAgB,OAAO,IAAI,KAAK;AAC/F;AAYA,SAAS,YAAY,QAA4B;AAC/C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,MAAM;AACzC,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,CAAC;AAC9C,MAAI,OAAO,KAAK,CAAC,OAAO,UAAU,UAAU,MAAM,KAAK,CAAC,GAAG;AACzD,aAAS,MAAM;AACf,kBAAc,aAAa,CAAC;AAAA,EAC9B;AACA,SAAO;AACT;AAEO,SAAS,SAAS,OAAsB;AAC7C,QAAM,MAAM,YAAY,CAAC,MAAM,QAAQ,MAAM,aAAa,MAAM,MAAM,CAAC;AACvE,SAAO,oBAAC,kBAA0B,GAAG,SAAT,GAAgB;AAC9C;AACA,SAAS,eAAe;AAAA,EACtB;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT;AAAA,EACA;AACF,GAAkB;AAChB,QAAM,CAAC,MAAM,OAAO,IAAI,SAA+C,IAAI;AAC3E,QAAM,CAAC,QAAQ,SAAS,IAAI,SAA6B;AACzD,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,KAAK;AACxC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,CAAC;AACtC,YAAU,MAAM;AACd,UAAM,QAAQ,IAAI,gBAAgB;AAClC,YAAQ,IAAI;AACZ,aAAS,KAAK;AACd,SAAK,QAAQ,QAAQ,EAClB;AAAA,MAAK,MACJ,OAAO,uBAAuB,aAAa;AAAA,QACzC;AAAA,QACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,QAC3B,OAAO;AAAA,QACP,QAAQ,MAAM;AAAA,MAChB,CAAC;AAAA,IACH,EACC,KAAK,CAAC,WAAW;AAChB,UAAI,CAAC,MAAM,OAAO,QAAS,SAAQ,gBAAgB,MAAM,CAAC;AAAA,IAC5D,CAAC,EACA,MAAM,MAAM;AACX,UAAI,CAAC,MAAM,OAAO,QAAS,UAAS,IAAI;AAAA,IAC1C,CAAC;AACH,WAAO,MAAM,MAAM,MAAM;AAAA,EAC3B,GAAG,CAAC,QAAQ,aAAa,QAAQ,QAAQ,MAAM,CAAC;AAChD,SACE,qBAAC,aAAQ,WAAsB,cAAW,SAAQ,aAAW,CAAC,QAAQ,CAAC,OACpE;AAAA,YACC,oBAAC,OAAE,MAAK,SAAQ,mFAAqE,IACnF,CAAC,OACH,oBAAC,OAAE,MAAK,UAAS,iCAAc,IAC7B,KAAK,UAAU,WAAW,IAC5B,qBAAC,OAAE,MAAK,UAAS;AAAA;AAAA,MAAI;AAAA,MAAO;AAAA,OAAO,IAEnC,oBAAC,QACE,eAAK,UAAU,IAAI,CAAC,SACnB,qBAAC,QACC;AAAA,0BAAC,YAAO,MAAK,UAAS,SAAS,MAAM,OAAO,gBAAgB,IAAI,CAAC,GAC9D,eAAK,OACR;AAAA,MACA,oBAAC,OAAG,eAAK,aAAY;AAAA,MACrB,qBAAC,UACE;AAAA,aAAK;AAAA,QAAO;AAAA,QAAa,KAAK,gBAAgB,YAAY;AAAA,SAC7D;AAAA,SAPO,KAAK,EAQd,CACD,GACH;AAAA,IAED,MAAM,cACL,oBAAC,YAAO,MAAK,UAAS,SAAS,MAAM,UAAU,KAAK,UAAW,GAAG,uBAElE;AAAA,IAED,UACC,oBAAC,YAAO,MAAK,UAAS,SAAS,MAAM,UAAU,MAAS,GAAG,wBAE3D;AAAA,IAEF,oBAAC,YAAO,MAAK,UAAS,SAAS,MAAM,UAAU,CAAC,UAAU,QAAQ,CAAC,GAAG,2BAEtE;AAAA,KACF;AAEJ;AAEO,SAAS,WAAW,OAAwB;AACjD,QAAM,MAAM,YAAY,CAAC,MAAM,QAAQ,MAAM,aAAa,MAAM,MAAM,CAAC;AACvE,SAAO,oBAAC,oBAA4B,GAAG,SAAT,GAAgB;AAChD;AACA,SAAS,iBAAiB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA;AACF,GAAoB;AAClB,QAAM,CAAC,QAAQ,SAAS,IAAI,SAGlB,IAAI;AACd,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,KAAK;AACxC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,CAAC;AACtC,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AACtC,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,EAAE;AAC/C,QAAM,CAAC,cAAc,eAAe,IAAI,SAAuC,IAAI;AACnF,QAAM,WAAW,OAA+B,IAAI;AACpD,YAAU,MAAM,MAAM,SAAS,SAAS,MAAM,GAAG,CAAC,CAAC;AACnD,YAAU,MAAM;AACd,UAAM,QAAQ,IAAI,gBAAgB;AAClC,cAAU,IAAI;AACd,aAAS,KAAK;AACd,oBAAgB,IAAI;AACpB,kBAAc,EAAE;AAChB,SAAK,QAAQ,QAAQ,EAClB,KAAK,YAAY;AAChB,YAAM,WAAW,MAAM,iBAAiB,QAAQ,aAAa,QAAQ;AAAA,QACnE,QAAQ,MAAM;AAAA,MAChB,CAAC;AACD,UAAI,CAAC,MAAM,OAAO,QAAS,WAAU,QAAQ;AAAA,IAC/C,CAAC,EACA,MAAM,MAAM;AACX,UAAI,CAAC,MAAM,OAAO,SAAS;AACzB,kBAAU,IAAI;AACd,iBAAS,IAAI;AAAA,MACf;AAAA,IACF,CAAC;AACH,WAAO,MAAM,MAAM,MAAM;AAAA,EAC3B,GAAG,CAAC,QAAQ,aAAa,QAAQ,MAAM,CAAC;AAGxC,YAAU,MAAM;AACd,QAAI,CAAC,UAAU,KAAM;AACrB,UAAM,QAAQ,IAAI,gBAAgB;AAClC,QAAI,WAAW;AACf,UAAM,QAAQ,YAAY,MAAM;AAC9B,UAAI,SAAU;AACd,iBAAW;AACX,WAAK,QAAQ,QAAQ,EAClB,KAAK,MAAM,OAAO,qBAAqB,aAAa,QAAQ,EAAE,QAAQ,MAAM,OAAO,CAAC,CAAC,EACrF,KAAK,CAAC,WAAW;AAChB,YAAI,MAAM,OAAO,QAAS;AAC1B,YAAI,OAAO,SAAS,OAAO,UAAU,OAAO,SAAS,gBAAgB;AACnE,gBAAM,IAAI,MAAM,qBAAqB;AACvC,YACE,OAAO,SAAS,gBAAgB,OAAO,OAAO,OAAO,SAAS,gBAAgB,MAC9E,OAAO,SAAS,WAAW,OAAO,OAAO,SAAS,QAClD;AACA,oBAAU,IAAI;AACd,oBAAU,CAAC,UAAU,QAAQ,CAAC;AAAA,QAChC;AAAA,MACF,CAAC,EACA,MAAM,MAAM;AACX,YAAI,CAAC,MAAM,OAAO,SAAS;AACzB,oBAAU,IAAI;AACd,mBAAS,IAAI;AAAA,QACf;AAAA,MACF,CAAC,EACA,QAAQ,MAAM;AACb,mBAAW;AAAA,MACb,CAAC;AAAA,IACL,GAAG,IAAM;AACT,WAAO,MAAM;AACX,YAAM,MAAM;AACZ,oBAAc,KAAK;AAAA,IACrB;AAAA,EACF,GAAG,CAAC,QAAQ,aAAa,QAAQ,QAAQ,IAAI,CAAC;AAC9C,QAAM,SAAS,YAAY;AACzB,UAAM,UAAU,QAAQ,OAAO,SAAS;AACxC,QAAI,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,gBAAgB,SAAS,QAAS;AAC7E,UAAM,QAAQ,IAAI,gBAAgB;AAClC,aAAS,UAAU;AACnB,YAAQ,IAAI;AACZ,QAAI;AACF,YAAM,SAAS,EAAE,0BAA0B,QAAQ,IAAI,gBAAgB,OAAO,WAAW,EAAE;AAC3F,UAAI,iBAAiB,YAAY;AAC/B,YAAI,CAAC,OAAO,OAAO,SAAS,KAAK,CAAC,YAAY,QAAQ,OAAO,UAAU;AACrE,gBAAM,IAAI,MAAM,iBAAiB;AACnC,cAAM,OAAO;AAAA,UACX;AAAA,UACA;AAAA,UACA,EAAE,GAAG,QAAQ,WAAW,YAAY,QAAQ,2CAA2C;AAAA,UACvF,EAAE,QAAQ,MAAM,OAAO;AAAA,QACzB;AAAA,MACF,OAAO;AACL,cAAM,OAAO;AAAA,UACX;AAAA,UACA;AAAA,UACA;AAAA,YACE,GAAG;AAAA,YACH,QAAQ,OAAO,OAAO,SAAS,WAAW,WAAW,aAAa;AAAA,YAClE,QAAQ;AAAA,UACV;AAAA,UACA,EAAE,QAAQ,MAAM,OAAO;AAAA,QACzB;AAAA,MACF;AACA,UAAI,CAAC,MAAM,OAAO,SAAS;AACzB,kBAAU,IAAI;AACd,kBAAU,CAAC,UAAU,QAAQ,CAAC;AAAA,MAChC;AAAA,IACF,QAAQ;AACN,UAAI,CAAC,MAAM,OAAO,SAAS;AACzB,kBAAU,IAAI;AACd,iBAAS,IAAI;AAAA,MACf;AAAA,IACF,UAAE;AACA,UAAI,CAAC,MAAM,OAAO,SAAS;AACzB,iBAAS,UAAU;AACnB,gBAAQ,KAAK;AACb,wBAAgB,IAAI;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AACA,QAAM,OAAO,QAAQ,OAAO;AAC5B,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,cAAW;AAAA,MACX,aAAW,QAAS,CAAC,UAAU,CAAC;AAAA,MAE/B;AAAA,iBACC,oBAAC,OAAE,MAAK,SAAQ,iGAEhB;AAAA,QAED,CAAC,UAAU,CAAC,SAAS,oBAAC,OAAE,MAAK,UAAS,gCAAa;AAAA,QACnD,QACC,iCACE;AAAA,8BAAC,QAAI,eAAK,OAAM;AAAA,UAChB,oBAAC,OAAG,eAAK,aAAY;AAAA,UACrB,qBAAC,OACE;AAAA,iBAAK;AAAA,YAAO;AAAA,YAAa,KAAK,gBAAgB,YAAY;AAAA,aAC7D;AAAA,UACC,OAAO,WACN;AAAA,YAAC;AAAA;AAAA,cACC,MAAM,OAAO,QAAQ;AAAA,cACrB,OAAO,KAAK;AAAA,cACX,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;AAAA;AAAA,UACtC;AAAA,UAEF,oBAAC,QAAG,sBAAQ;AAAA,UACZ,oBAAC,QACE,iBAAO,OAAO,SAAS,IAAI,CAAC,YAC3B,qBAAC,QAAoB;AAAA;AAAA,YACT,QAAQ;AAAA,YAAS;AAAA,YAAI,QAAQ;AAAA,YACtC,QAAQ,OAAO,KAAK,gBAAgB,KAAK,kBAAe;AAAA,eAFlD,QAAQ,EAGjB,CACD,GACH;AAAA,UACC,OAAO,OAAO,qBACb,oBAAC,OAAE,+DAAiD;AAAA,UAErD,cAAc,KAAK,kBAClB,qBAAC,cAAS,UAAU,MAClB;AAAA,gCAAC,YAAO,yBAAW;AAAA,YACnB,oBAAC,YAAO,MAAK,UAAS,SAAS,MAAM,gBAAgB,QAAQ,GAC1D,eAAK,WAAW,WAAW,iBAAiB,gBAC/C;AAAA,YACA,qBAAC,WAAM;AAAA;AAAA,cAEL;AAAA,gBAAC;AAAA;AAAA,kBACC,OAAO;AAAA,kBACP,UAAU,CAAC,UAAU;AACnB,kCAAc,MAAM,OAAO,KAAK;AAChC,oCAAgB,IAAI;AAAA,kBACtB;AAAA,kBAEA;AAAA,wCAAC,YAAO,OAAM,IAAG,8BAAgB;AAAA,oBAChC,OAAO,OAAO,SACZ,OAAO,CAAC,YAAY,QAAQ,OAAO,KAAK,gBAAgB,EAAE,EAC1D,IAAI,CAAC,YACJ,qBAAC,YAAwB,OAAO,QAAQ,IAAI;AAAA;AAAA,sBAChC,QAAQ;AAAA,yBADP,QAAQ,EAErB,CACD;AAAA;AAAA;AAAA,cACL;AAAA,eACF;AAAA,YACA;AAAA,cAAC;AAAA;AAAA,gBACC,MAAK;AAAA,gBACL,UAAU,CAAC;AAAA,gBACX,SAAS,MAAM,gBAAgB,UAAU;AAAA,gBAC1C;AAAA;AAAA,YAED;AAAA,YACC,gBACC,qBAAC,SAAI,MAAK,SAAQ,cAAW,uBAC3B;AAAA,kCAAC,OACE,2BAAiB,aACd,uCACA,KAAK,WAAW,WACd,2CACA,0CACR;AAAA,cACA,oBAAC,YAAO,MAAK,UAAS,SAAS,MAAM,KAAK,OAAO,GAAG,4BAEpD;AAAA,cACA,oBAAC,YAAO,MAAK,UAAS,SAAS,MAAM,gBAAgB,IAAI,GAAG,gCAE5D;AAAA,eACF;AAAA,aAEJ;AAAA,WAEJ;AAAA,QAEF,oBAAC,YAAO,MAAK,UAAS,UAAU,MAAM,SAAS,MAAM,UAAU,CAAC,UAAU,QAAQ,CAAC,GAAG,0BAEtF;AAAA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/react",
-  "version": "4.0.2",
+  "version": "5.0.2-canary.0",
   "description": "React hooks and styled components for OpenGeni: live session streaming, chat composer, message timeline, session status, and fleet views — token-themed (CSS variables), dark-first, built on Tailwind v4 + Radix + Motion.",
   "license": "Apache-2.0",
   "repository": {
@@ -21,6 +21,19 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
+    "./sites": {
+      "types": "./dist/sites.d.ts",
+      "import": "./dist/sites.js"
+    },
+    "./connect.css": {
+      "types": "./styles/connect.d.ts",
+      "style": "./styles/connect.css",
+      "default": "./styles/connect.css"
+    },
+    "./connect": {
+      "types": "./dist/connect.d.ts",
+      "import": "./dist/connect.js"
+    },
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
@@ -120,7 +133,8 @@
     "@dnd-kit/utilities": "3.2.2",
     "@fontsource-variable/noto-sans-arabic": "5.2.10",
     "@fontsource-variable/noto-sans-jp": "5.2.10",
-    "@opengeni/sdk": "^4.0.2",
+    "@opengeni/connect": "^0.2.0-canary.0",
+    "@opengeni/sdk": "^5.0.0-canary.0",
     "clsx": "^2.1.1",
     "dequal": "2.0.3",
     "lucide-react": "^1.8.0",

package/src/components/message-timeline.tsx

@@ -157,6 +157,8 @@ export type MessageTimelineProps = {
    * a Reconnect button without a handler to run it.
    */
   onReconnect?: ((item: AuthNeededItem) => void | Promise<void>) | undefined;
+  /** Host-owned inline connection setup. Return undefined to use the default recovery card. */
+  renderAuthNeeded?: ((item: AuthNeededItem) => ReactNode | undefined) | undefined;
   /**
    * Decide which durable authentication notices this timeline presents.
    * Defaults to showing every notice. Embedded hosts can suppress notices for
@@ -407,6 +409,7 @@ export function MessageTimeline({
   onOpenSession,
   onMemoryClick,
   onReconnect,
+  renderAuthNeeded,
   shouldRenderAuthNeeded,
   resolveProviderLogo,
   toolRegistry = defaultToolRegistry,
@@ -910,6 +913,7 @@ export function MessageTimeline({
         onOpenSession,
         onMemoryClick,
         onReconnect,
+        renderAuthNeeded,
         resolveProviderLogo,
         toolRegistry,
         loadRetainedScreenshot,
@@ -925,6 +929,7 @@ export function MessageTimeline({
       onMemoryClick,
       onOpenSession,
       onReconnect,
+      renderAuthNeeded,
       renderMessageActions,
       renderMessageText,
       resolveProviderLogo,
@@ -2309,6 +2314,7 @@ type TimelineGroupBehaviorProps = {
   onOpenSession: MessageTimelineProps["onOpenSession"];
   onMemoryClick: MessageTimelineProps["onMemoryClick"];
   onReconnect: MessageTimelineProps["onReconnect"];
+  renderAuthNeeded: MessageTimelineProps["renderAuthNeeded"];
   resolveProviderLogo: MessageTimelineProps["resolveProviderLogo"];
   toolRegistry: ToolRegistry;
   loadRetainedScreenshot: MessageTimelineProps["loadRetainedScreenshot"];
@@ -2373,6 +2379,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
   onOpenSession,
   onMemoryClick,
   onReconnect,
+  renderAuthNeeded,
   resolveProviderLogo,
   toolRegistry,
   loadRetainedScreenshot,
@@ -2393,6 +2400,8 @@ const TimelineGroupView = memo(function TimelineGroupView({
   onOpenSession?: ((sessionId: string) => void) | undefined;
   onMemoryClick?: ((memoryId: string) => void) | undefined;
   onReconnect?: ((item: AuthNeededItem) => void | Promise<void>) | undefined;
+  /** Host-owned inline connection setup. Return undefined to use the default recovery card. */
+  renderAuthNeeded?: ((item: AuthNeededItem) => ReactNode | undefined) | undefined;
   resolveProviderLogo?: ((providerDomain: string) => string | null | undefined) | undefined;
   toolRegistry: ToolRegistry;
   loadRetainedScreenshot?: RetainedScreenshotLoader | undefined;
@@ -2550,6 +2559,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
               onOpenSession,
               onMemoryClick,
               onReconnect,
+              renderAuthNeeded,
               resolveProviderLogo,
               toolRegistry,
               loadRetainedScreenshot,
@@ -2565,6 +2575,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
               onOpenSession={onOpenSession}
               onMemoryClick={onMemoryClick}
               onReconnect={onReconnect}
+              renderAuthNeeded={renderAuthNeeded}
               resolveProviderLogo={resolveProviderLogo}
               toolRegistry={toolRegistry}
               loadRetainedScreenshot={loadRetainedScreenshot}
@@ -2610,6 +2621,7 @@ const TimelineGroupView = memo(function TimelineGroupView({
           renderMessageActions={renderMessageActions}
           renderMessageText={renderMessageText}
           onReconnect={onReconnect}
+          renderAuthNeeded={renderAuthNeeded}
           resolveProviderLogo={resolveProviderLogo}
           onOpenSession={onOpenSession}
           loadVideoArtifactPlayback={loadVideoArtifactPlayback}
@@ -2862,6 +2874,7 @@ export function TimelineRow({
   renderMessageActions,
   renderMessageText,
   onReconnect,
+  renderAuthNeeded,
   resolveProviderLogo,
   onOpenSession,
   loadVideoArtifactPlayback,
@@ -2872,6 +2885,8 @@ export function TimelineRow({
     | ((text: string, item: AgentMessageItem | UserMessageItem) => ReactNode)
     | undefined;
   onReconnect?: ((item: AuthNeededItem) => void | Promise<void>) | undefined;
+  /** Host-owned inline connection setup. Return undefined to use the default recovery card. */
+  renderAuthNeeded?: ((item: AuthNeededItem) => ReactNode | undefined) | undefined;
   resolveProviderLogo?: ((providerDomain: string) => string | null | undefined) | undefined;
   onOpenSession?: ((sessionId: string) => void) | undefined;
   loadVideoArtifactPlayback?: VideoArtifactPlaybackLoader | undefined;
@@ -2915,11 +2930,13 @@ export function TimelineRow({
       return <CompactionRow item={item} />;
     case "auth-needed":
       return (
-        <AuthNeededRow
-          item={item}
-          onReconnect={onReconnect}
-          resolveProviderLogo={resolveProviderLogo}
-        />
+        renderAuthNeeded?.(item) ?? (
+          <AuthNeededRow
+            item={item}
+            onReconnect={onReconnect}
+            resolveProviderLogo={resolveProviderLogo}
+          />
+        )
       );
     default:
       return null;

package/src/components/sandbox-workspace.tsx

@@ -699,7 +699,8 @@ export function useSandboxWorkspaceTabs(
     (captureState.fileCount ?? 0) > 0 ||
     (captureState.capture?.repos.some((repo) => (repo.branchDiff?.length ?? 0) > 0) ?? false);
   const captureUnavailable =
-    (captureState.fileCount === 0 && !captureHasChanges) || captureState.error !== null;
+    !captureState.loading &&
+    ((captureState.fileCount === 0 && !captureHasChanges) || captureState.error !== null);
   if (defaultTabRef.current.value === null) {
     if (initialTab && (!isWorkbenchSurface(initialTab) || surfaceSet.has(initialTab))) {
       defaultTabRef.current.value = initialTab;
@@ -711,7 +712,13 @@ export function useSandboxWorkspaceTabs(
       );
     } else if (captureUnavailable && initialWorkspaceTab(events) === WORKBENCH_TAB_CHANGES) {
       defaultTabRef.current.value = sourceDrivenDefaultTab(true, changesEnabled, filesEnabled);
-    } else if (captureState.fileCount !== null || captureState.error !== null) {
+    } else if (
+      !captureState.loading &&
+      (captureState.fileCount !== null || captureState.error !== null)
+    ) {
+      // Metadata may arrive before a signed manifest. While that manifest is
+      // loading, neither a positive count nor zero (committed-only changes)
+      // proves an unavailable capture, so leave the default unresolved.
       // No durable review surface exists. Files owns the explicit live-workspace
       // gate; a user can open Changes deliberately if they need a fresh Git read.
       defaultTabRef.current.value = sourceDrivenDefaultTab(false, changesEnabled, filesEnabled);