@opengeni/react 1.0.1 → 1.0.2-canary.37191796234001

package/dist/chunk-ZYRGEKWS.js

@@ -0,0 +1,216 @@
+// src/components/timeline-annotation-layout.ts
+var ANNOTATION_BADGE_GAP_PX = 32;
+var ANNOTATION_BADGE_MIN_GAP_PX = 12;
+var ANNOTATION_REVIEW_DIALOG_WIDTH_PX = 400;
+var ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX = 32 * 16;
+var ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX = 160;
+var ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX = 80;
+var ANNOTATION_REVIEW_MARGIN_PX = 12;
+var ANNOTATION_NOTE_PREVIEW_CHARS = 280;
+var ANNOTATION_CARD_STACK_SCROLL_AT = 4;
+function clampAnnotationAxis(value, min, max) {
+  return Math.min(Math.max(value, min), Math.max(min, max));
+}
+function annotationBoxIntersects(a, b) {
+  return a.left <= b.right && a.right >= b.left && a.top <= b.bottom && a.bottom >= b.top;
+}
+function annotationViewportBox(viewportWidth, viewportHeight, scroller) {
+  const viewport = {
+    left: 0,
+    top: 0,
+    right: Math.max(1, viewportWidth),
+    bottom: Math.max(1, viewportHeight)
+  };
+  if (!scroller || scroller.right - scroller.left <= 0 || scroller.bottom - scroller.top <= 0) {
+    return viewport;
+  }
+  return {
+    left: Math.max(viewport.left, scroller.left),
+    top: Math.max(viewport.top, scroller.top),
+    right: Math.min(viewport.right, scroller.right),
+    bottom: Math.min(viewport.bottom, scroller.bottom)
+  };
+}
+function annotationNoteNeedsDisclosure(note) {
+  const trimmed = note.trim();
+  if (trimmed.length === 0) return false;
+  return trimmed.length > ANNOTATION_NOTE_PREVIEW_CHARS || trimmed.split("\n").length > 4;
+}
+function annotationAxisStops(min, max, gap) {
+  if (max <= min) return [min];
+  const stops = [];
+  for (let value = min; value <= max + 1e-6; value += gap) {
+    stops.push(value);
+  }
+  return stops;
+}
+function annotationPointKey(left, top) {
+  return `${Math.round(left * 100) / 100},${Math.round(top * 100) / 100}`;
+}
+function annotationPointFree(left, top, placed, gap) {
+  return placed.every((other) => Math.hypot(left - other.left, top - other.top) >= gap);
+}
+function annotationBadgePackGap(viewport, count, preferred = ANNOTATION_BADGE_GAP_PX) {
+  if (count <= 1) return preferred;
+  const width = Math.max(
+    1,
+    viewport.right - ANNOTATION_REVIEW_MARGIN_PX - (viewport.left + ANNOTATION_REVIEW_MARGIN_PX)
+  );
+  const height = Math.max(1, viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX - (viewport.top + 8));
+  let gap = preferred;
+  const capacity = (step) => (Math.floor(width / step) + 1) * (Math.floor(height / step) + 1);
+  while (gap > ANNOTATION_BADGE_MIN_GAP_PX && capacity(gap) < count) {
+    gap -= 1;
+  }
+  return gap;
+}
+var ANNOTATION_BADGE_SHIFT_DIRS = [
+  [1, 0],
+  [1, 1],
+  [0, 1],
+  [-1, 1],
+  [-1, 0],
+  [-1, -1],
+  [0, -1],
+  [1, -1]
+];
+function layoutAnnotationBadges(anchors, viewport, preferredGap = ANNOTATION_BADGE_GAP_PX) {
+  const minLeft = viewport.left + ANNOTATION_REVIEW_MARGIN_PX;
+  const maxLeft = viewport.right - ANNOTATION_REVIEW_MARGIN_PX;
+  const minTop = viewport.top + 8;
+  const maxTop = viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX;
+  const gap = annotationBadgePackGap(viewport, anchors.length, preferredGap);
+  const cells = annotationAxisStops(minLeft, maxLeft, gap).flatMap(
+    (left) => annotationAxisStops(minTop, maxTop, gap).map((top) => ({ left, top }))
+  );
+  const placed = [];
+  for (const anchor of [...anchors].sort((left, right) => left.ordinal - right.ordinal)) {
+    const originLeft = clampAnnotationAxis(anchor.left, minLeft, maxLeft);
+    const originTop = clampAnnotationAxis(anchor.top, minTop, maxTop);
+    const seen = /* @__PURE__ */ new Set();
+    const candidates = [];
+    const pushCandidate = (left, top) => {
+      if (left < minLeft || left > maxLeft || top < minTop || top > maxTop) return;
+      const key = annotationPointKey(left, top);
+      if (seen.has(key)) return;
+      seen.add(key);
+      candidates.push({ left, top });
+    };
+    pushCandidate(originLeft, originTop);
+    for (const [dx, dy] of ANNOTATION_BADGE_SHIFT_DIRS) {
+      const colliders = [...placed].sort(
+        (left, right) => right.left * dx + right.top * dy - (left.left * dx + left.top * dy)
+      );
+      for (const collider of colliders) {
+        pushCandidate(collider.left + dx * gap, collider.top + dy * gap);
+      }
+    }
+    const maxRadius = Math.ceil(Math.max(maxLeft - minLeft, maxTop - minTop) / Math.max(gap, 1)) + 1;
+    for (let radius = 1; radius <= maxRadius; radius++) {
+      const ring = [];
+      for (let dx = -radius; dx <= radius; dx++) {
+        for (let dy = -radius; dy <= radius; dy++) {
+          if (Math.max(Math.abs(dx), Math.abs(dy)) !== radius) continue;
+          ring.push([dx, dy]);
+        }
+      }
+      ring.sort((left, right) => {
+        const leftDir = (left[0] < 0 ? 2 : 0) + (left[1] < 0 ? 1 : 0);
+        const rightDir = (right[0] < 0 ? 2 : 0) + (right[1] < 0 ? 1 : 0);
+        if (leftDir !== rightDir) return leftDir - rightDir;
+        const hypot = Math.hypot(left[0], left[1]) - Math.hypot(right[0], right[1]);
+        if (hypot !== 0) return hypot;
+        if (left[0] !== right[0]) return right[0] - left[0];
+        return left[1] - right[1];
+      });
+      for (const [dx, dy] of ring) {
+        pushCandidate(originLeft + dx * gap, originTop + dy * gap);
+      }
+    }
+    for (const cell of cells) {
+      pushCandidate(cell.left, cell.top);
+    }
+    const free = candidates.find(
+      (point) => annotationPointFree(point.left, point.top, placed, gap)
+    );
+    let chosen = free ?? candidates[0];
+    if (!free && placed.length > 0) {
+      let bestMin = Number.NEGATIVE_INFINITY;
+      for (const point of candidates) {
+        const minDist = placed.reduce(
+          (current, other) => Math.min(current, Math.hypot(point.left - other.left, point.top - other.top)),
+          Number.POSITIVE_INFINITY
+        );
+        if (minDist > bestMin) {
+          bestMin = minDist;
+          chosen = point;
+        }
+      }
+    }
+    placed.push({ ...anchor, left: chosen.left, top: chosen.top });
+  }
+  return placed;
+}
+function scrollAnnotationRowIntoList(list, row) {
+  if (!list || !row || !list.contains(row)) return;
+  const listRect = list.getBoundingClientRect();
+  const rowRect = row.getBoundingClientRect();
+  if (rowRect.top < listRect.top) {
+    list.scrollTop -= listRect.top - rowRect.top;
+    return;
+  }
+  if (rowRect.bottom > listRect.bottom) {
+    list.scrollTop += rowRect.bottom - listRect.bottom;
+  }
+}
+function clampAnnotationDialogPlacement(input) {
+  const margin = ANNOTATION_REVIEW_MARGIN_PX;
+  const panelWidth = Math.min(
+    input.panelWidth ?? ANNOTATION_REVIEW_DIALOG_WIDTH_PX,
+    Math.max(1, input.viewportWidth - margin * 2)
+  );
+  const left = Math.min(
+    Math.max(margin, input.triggerLeft),
+    Math.max(margin, input.viewportWidth - panelWidth - margin)
+  );
+  const spaceBelow = input.viewportHeight - input.triggerBottom - margin;
+  const spaceAbove = input.triggerTop - margin;
+  const above = spaceBelow < Math.min(input.contentHeight, 200) && spaceAbove > spaceBelow;
+  const viewportBudget = Math.max(
+    ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX,
+    input.viewportHeight - margin * 2
+  );
+  const available = Math.max(
+    Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget),
+    above ? spaceAbove : spaceBelow
+  );
+  let maxHeight = Math.min(
+    Math.max(input.contentHeight, Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget)),
+    available,
+    Math.floor(input.viewportHeight * 0.7) || viewportBudget,
+    ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX,
+    viewportBudget
+  );
+  let top = above ? Math.max(margin, input.triggerTop - 8 - maxHeight) : Math.min(
+    input.triggerBottom + 8,
+    Math.max(margin, input.viewportHeight - margin - maxHeight)
+  );
+  top = Math.max(margin, top);
+  maxHeight = Math.min(
+    maxHeight,
+    Math.max(ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX, input.viewportHeight - margin - top)
+  );
+  return { left, top, maxHeight, above };
+}
+
+export {
+  ANNOTATION_REVIEW_DIALOG_WIDTH_PX,
+  ANNOTATION_CARD_STACK_SCROLL_AT,
+  annotationBoxIntersects,
+  annotationViewportBox,
+  annotationNoteNeedsDisclosure,
+  layoutAnnotationBadges,
+  scrollAnnotationRowIntoList,
+  clampAnnotationDialogPlacement
+};
+//# sourceMappingURL=chunk-ZYRGEKWS.js.map

package/dist/chunk-ZYRGEKWS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/timeline-annotation-layout.ts"],"sourcesContent":["export type AnnotationBox = {\n  left: number;\n  right: number;\n  top: number;\n  bottom: number;\n};\n\nexport type AnnotationBadgeAnchor = {\n  id: string;\n  ordinal: number;\n  left: number;\n  top: number;\n  incomplete: boolean;\n};\n\nexport const ANNOTATION_BADGE_GAP_PX = 32;\nexport const ANNOTATION_BADGE_MIN_GAP_PX = 12;\nexport const ANNOTATION_REVIEW_DIALOG_WIDTH_PX = 400;\nexport const ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX = 32 * 16;\nexport const ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX = 160;\nexport const ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX = 80;\nexport const ANNOTATION_REVIEW_MARGIN_PX = 12;\nexport const ANNOTATION_NOTE_PREVIEW_CHARS = 280;\nexport const ANNOTATION_CARD_STACK_SCROLL_AT = 4;\n\nfunction clampAnnotationAxis(value: number, min: number, max: number): number {\n  return Math.min(Math.max(value, min), Math.max(min, max));\n}\n\nexport function annotationBoxIntersects(a: AnnotationBox, b: AnnotationBox): boolean {\n  return a.left <= b.right && a.right >= b.left && a.top <= b.bottom && a.bottom >= b.top;\n}\n\nexport function annotationViewportBox(\n  viewportWidth: number,\n  viewportHeight: number,\n  scroller?: AnnotationBox | null,\n): AnnotationBox {\n  const viewport: AnnotationBox = {\n    left: 0,\n    top: 0,\n    right: Math.max(1, viewportWidth),\n    bottom: Math.max(1, viewportHeight),\n  };\n  if (!scroller || scroller.right - scroller.left <= 0 || scroller.bottom - scroller.top <= 0) {\n    return viewport;\n  }\n  return {\n    left: Math.max(viewport.left, scroller.left),\n    top: Math.max(viewport.top, scroller.top),\n    right: Math.min(viewport.right, scroller.right),\n    bottom: Math.min(viewport.bottom, scroller.bottom),\n  };\n}\n\nexport function annotationNoteNeedsDisclosure(note: string): boolean {\n  const trimmed = note.trim();\n  if (trimmed.length === 0) return false;\n  return trimmed.length > ANNOTATION_NOTE_PREVIEW_CHARS || trimmed.split(\"\\n\").length > 4;\n}\n\nfunction annotationAxisStops(min: number, max: number, gap: number): number[] {\n  if (max <= min) return [min];\n  const stops: number[] = [];\n  for (let value = min; value <= max + 1e-6; value += gap) {\n    stops.push(value);\n  }\n  return stops;\n}\n\nfunction annotationPointKey(left: number, top: number): string {\n  return `${Math.round(left * 100) / 100},${Math.round(top * 100) / 100}`;\n}\n\nfunction annotationPointFree(\n  left: number,\n  top: number,\n  placed: readonly AnnotationBadgeAnchor[],\n  gap: number,\n): boolean {\n  return placed.every((other) => Math.hypot(left - other.left, top - other.top) >= gap);\n}\n\nexport function annotationBadgePackGap(\n  viewport: AnnotationBox,\n  count: number,\n  preferred = ANNOTATION_BADGE_GAP_PX,\n): number {\n  if (count <= 1) return preferred;\n  const width = Math.max(\n    1,\n    viewport.right - ANNOTATION_REVIEW_MARGIN_PX - (viewport.left + ANNOTATION_REVIEW_MARGIN_PX),\n  );\n  const height = Math.max(1, viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX - (viewport.top + 8));\n  let gap = preferred;\n  const capacity = (step: number) =>\n    (Math.floor(width / step) + 1) * (Math.floor(height / step) + 1);\n  while (gap > ANNOTATION_BADGE_MIN_GAP_PX && capacity(gap) < count) {\n    gap -= 1;\n  }\n  return gap;\n}\n\nconst ANNOTATION_BADGE_SHIFT_DIRS: Array<[number, number]> = [\n  [1, 0],\n  [1, 1],\n  [0, 1],\n  [-1, 1],\n  [-1, 0],\n  [-1, -1],\n  [0, -1],\n  [1, -1],\n];\n\nexport function layoutAnnotationBadges(\n  anchors: readonly AnnotationBadgeAnchor[],\n  viewport: AnnotationBox,\n  preferredGap = ANNOTATION_BADGE_GAP_PX,\n): AnnotationBadgeAnchor[] {\n  const minLeft = viewport.left + ANNOTATION_REVIEW_MARGIN_PX;\n  const maxLeft = viewport.right - ANNOTATION_REVIEW_MARGIN_PX;\n  const minTop = viewport.top + 8;\n  const maxTop = viewport.bottom - ANNOTATION_REVIEW_MARGIN_PX;\n  const gap = annotationBadgePackGap(viewport, anchors.length, preferredGap);\n  const cells = annotationAxisStops(minLeft, maxLeft, gap).flatMap((left) =>\n    annotationAxisStops(minTop, maxTop, gap).map((top) => ({ left, top })),\n  );\n  const placed: AnnotationBadgeAnchor[] = [];\n  for (const anchor of [...anchors].sort((left, right) => left.ordinal - right.ordinal)) {\n    const originLeft = clampAnnotationAxis(anchor.left, minLeft, maxLeft);\n    const originTop = clampAnnotationAxis(anchor.top, minTop, maxTop);\n    const seen = new Set<string>();\n    const candidates: Array<{ left: number; top: number }> = [];\n    const pushCandidate = (left: number, top: number) => {\n      if (left < minLeft || left > maxLeft || top < minTop || top > maxTop) return;\n      const key = annotationPointKey(left, top);\n      if (seen.has(key)) return;\n      seen.add(key);\n      candidates.push({ left, top });\n    };\n    pushCandidate(originLeft, originTop);\n    for (const [dx, dy] of ANNOTATION_BADGE_SHIFT_DIRS) {\n      const colliders = [...placed].sort(\n        (left, right) => right.left * dx + right.top * dy - (left.left * dx + left.top * dy),\n      );\n      for (const collider of colliders) {\n        pushCandidate(collider.left + dx * gap, collider.top + dy * gap);\n      }\n    }\n    const maxRadius =\n      Math.ceil(Math.max(maxLeft - minLeft, maxTop - minTop) / Math.max(gap, 1)) + 1;\n    for (let radius = 1; radius <= maxRadius; radius++) {\n      const ring: Array<[number, number]> = [];\n      for (let dx = -radius; dx <= radius; dx++) {\n        for (let dy = -radius; dy <= radius; dy++) {\n          if (Math.max(Math.abs(dx), Math.abs(dy)) !== radius) continue;\n          ring.push([dx, dy]);\n        }\n      }\n      ring.sort((left, right) => {\n        const leftDir = (left[0] < 0 ? 2 : 0) + (left[1] < 0 ? 1 : 0);\n        const rightDir = (right[0] < 0 ? 2 : 0) + (right[1] < 0 ? 1 : 0);\n        if (leftDir !== rightDir) return leftDir - rightDir;\n        const hypot = Math.hypot(left[0], left[1]) - Math.hypot(right[0], right[1]);\n        if (hypot !== 0) return hypot;\n        if (left[0] !== right[0]) return right[0] - left[0];\n        return left[1] - right[1];\n      });\n      for (const [dx, dy] of ring) {\n        pushCandidate(originLeft + dx * gap, originTop + dy * gap);\n      }\n    }\n    for (const cell of cells) {\n      pushCandidate(cell.left, cell.top);\n    }\n    const free = candidates.find((point) =>\n      annotationPointFree(point.left, point.top, placed, gap),\n    );\n    let chosen = free ?? candidates[0]!;\n    if (!free && placed.length > 0) {\n      let bestMin = Number.NEGATIVE_INFINITY;\n      for (const point of candidates) {\n        const minDist = placed.reduce(\n          (current, other) =>\n            Math.min(current, Math.hypot(point.left - other.left, point.top - other.top)),\n          Number.POSITIVE_INFINITY,\n        );\n        if (minDist > bestMin) {\n          bestMin = minDist;\n          chosen = point;\n        }\n      }\n    }\n    placed.push({ ...anchor, left: chosen.left, top: chosen.top });\n  }\n  return placed;\n}\n\nexport function scrollAnnotationRowIntoList(\n  list: HTMLElement | null | undefined,\n  row: HTMLElement | null | undefined,\n): void {\n  if (!list || !row || !list.contains(row)) return;\n  const listRect = list.getBoundingClientRect();\n  const rowRect = row.getBoundingClientRect();\n  if (rowRect.top < listRect.top) {\n    list.scrollTop -= listRect.top - rowRect.top;\n    return;\n  }\n  if (rowRect.bottom > listRect.bottom) {\n    list.scrollTop += rowRect.bottom - listRect.bottom;\n  }\n}\n\nexport function clampAnnotationDialogPlacement(input: {\n  triggerLeft: number;\n  triggerTop: number;\n  triggerBottom: number;\n  contentHeight: number;\n  viewportWidth: number;\n  viewportHeight: number;\n  panelWidth?: number;\n}): {\n  left: number;\n  top: number;\n  maxHeight: number;\n  above: boolean;\n} {\n  const margin = ANNOTATION_REVIEW_MARGIN_PX;\n  const panelWidth = Math.min(\n    input.panelWidth ?? ANNOTATION_REVIEW_DIALOG_WIDTH_PX,\n    Math.max(1, input.viewportWidth - margin * 2),\n  );\n  const left = Math.min(\n    Math.max(margin, input.triggerLeft),\n    Math.max(margin, input.viewportWidth - panelWidth - margin),\n  );\n  const spaceBelow = input.viewportHeight - input.triggerBottom - margin;\n  const spaceAbove = input.triggerTop - margin;\n  const above = spaceBelow < Math.min(input.contentHeight, 200) && spaceAbove > spaceBelow;\n  const viewportBudget = Math.max(\n    ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX,\n    input.viewportHeight - margin * 2,\n  );\n  const available = Math.max(\n    Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget),\n    above ? spaceAbove : spaceBelow,\n  );\n  let maxHeight = Math.min(\n    Math.max(input.contentHeight, Math.min(ANNOTATION_REVIEW_DIALOG_MIN_HEIGHT_PX, viewportBudget)),\n    available,\n    Math.floor(input.viewportHeight * 0.7) || viewportBudget,\n    ANNOTATION_REVIEW_DIALOG_MAX_HEIGHT_PX,\n    viewportBudget,\n  );\n  let top = above\n    ? Math.max(margin, input.triggerTop - 8 - maxHeight)\n    : Math.min(\n        input.triggerBottom + 8,\n        Math.max(margin, input.viewportHeight - margin - maxHeight),\n      );\n  top = Math.max(margin, top);\n  maxHeight = Math.min(\n    maxHeight,\n    Math.max(ANNOTATION_REVIEW_DIALOG_FLOOR_HEIGHT_PX, input.viewportHeight - margin - top),\n  );\n  return { left, top, maxHeight, above };\n}\n"],"mappings":"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","names":[]}

package/dist/client.d.ts

@@ -4,7 +4,9 @@ import type { OpenGeniClient } from "@opengeni/sdk";
  * pass the real SDK client, a proxy-backed client that routes through their
  * own API, or a scripted client in tests/demos.
  */
-export type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listHumanInputRequests" | "getHumanInputRequest" | "submitHumanInputResponse" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "getVariableSetVariable" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listChannels" | "createChannel" | "updateChannel" | "deleteChannel" | "updateSessionChannel" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listPacks" | "registerPack" | "enablePack" | "previewPackInstallation" | "installPack" | "previewPackUninstall" | "uninstallPack" | "deletePack" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "getWorkspaceModelCatalog" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "streamWorkspaceInteractionRevisions" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "listNetworkRoutes" | "getNetworkRoute" | "createNetworkRoute" | "updateNetworkRoute" | "listSiteAuthConnections" | "getSiteAuthConnection" | "createSiteAuthConnection" | "updateSiteAuthConnection" | "listAuthRuns" | "getAuthRun" | "startBrowserAuthRun" | "reportBrowserAuthRun" | "protectedBrowserAuthFill" | "verifyBrowserAuthRun" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention" | "listAttachedBrowsers" | "getAttachedBrowser" | "listBrowserIdentities" | "getBrowserIdentity" | "createBrowserIdentity" | "updateBrowserIdentity" | "listBrowserRevisions" | "listBrowserSessions" | "getBrowserSession" | "readBrowserClipboard" | "listBrowserDownloads" | "getBrowserDownload" | "saveBrowserDownload" | "createBrowserSession" | "listBrowserTargets" | "openBrowserTarget" | "selectBrowserTarget" | "closeBrowserTarget" | "observeBrowserTarget" | "actInBrowser" | "getBrowserActionReceipt" | "listBrowserDiagnostics" | "attachBrowserSession" | "heartbeatBrowserSession" | "publishBrowserRevision" | "suspendBrowserSession" | "resumeBrowserSession" | "endBrowserSession" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession" | "fsList" | "fsListBatch" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "gitReadBatch" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose"> & Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource" | "streamWorkspaceLiveEvents">>;
+type SessionClientMethods = Pick<OpenGeniClient, "getClientConfig" | "getSession" | "getSessionLineage" | "updateSession" | "updateSessionPin" | "listSessions" | "listSessionPage" | "sendMessage" | "steerMessage" | "pauseSession" | "resumeSession" | "sendApprovalDecision" | "listHumanInputRequests" | "getHumanInputRequest" | "submitHumanInputResponse" | "listEvents" | "streamEvents" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "getComposerDraft" | "saveComposerDraft" | "submitComposerDraft" | "listTurns" | "getGoal" | "updateGoal" | "deleteGoal" | "clearSessionContext" | "compactSessionContext" | "listScheduledTasks" | "uploadFile" | "getFile" | "createFileDownloadUrl" | "listVariableSets" | "getVariableSetVariable" | "createVariableSet" | "updateVariableSet" | "deleteVariableSet" | "setVariableSetVariable" | "deleteVariableSetVariable" | "listEnvironments" | "createEnvironment" | "updateEnvironment" | "deleteEnvironment" | "setEnvironmentVariable" | "deleteEnvironmentVariable" | "listChannels" | "createChannel" | "updateChannel" | "reorderChannels" | "deleteChannel" | "updateSessionChannel" | "listRigs" | "createRig" | "getRig" | "updateRig" | "deleteRig" | "listRigVersions" | "activateRigVersion" | "listRigChanges" | "proposeRigChange" | "getRigChange" | "verifyRigChange" | "promoteRigChange" | "verifyRig" | "listWorkspaces" | "createWorkspace" | "updateWorkspace" | "setWorkspaceInferenceState" | "getWorkspace" | "getWorkspaceModelCatalog" | "listWorkspaceControlEvents" | "streamWorkspaceControlEvents" | "streamWorkspaceInteractionRevisions" | "getBillingUsage" | "getClientConfig" | "getStreamCapabilities" | "acknowledgeStream" | "attachViewer" | "heartbeatViewer" | "detachViewer" | "listNetworkRoutes" | "getNetworkRoute" | "createNetworkRoute" | "updateNetworkRoute" | "listSiteAuthConnections" | "getSiteAuthConnection" | "createSiteAuthConnection" | "updateSiteAuthConnection" | "listAuthRuns" | "getAuthRun" | "startBrowserAuthRun" | "reportBrowserAuthRun" | "protectedBrowserAuthFill" | "verifyBrowserAuthRun" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention" | "listAttachedBrowsers" | "getAttachedBrowser" | "listBrowserIdentities" | "getBrowserIdentity" | "createBrowserIdentity" | "updateBrowserIdentity" | "listBrowserRevisions" | "listBrowserSessions" | "getBrowserSession" | "readBrowserClipboard" | "listBrowserDownloads" | "getBrowserDownload" | "saveBrowserDownload" | "createBrowserSession" | "listBrowserTargets" | "openBrowserTarget" | "selectBrowserTarget" | "closeBrowserTarget" | "observeBrowserTarget" | "actInBrowser" | "getBrowserActionReceipt" | "listBrowserDiagnostics" | "attachBrowserSession" | "heartbeatBrowserSession" | "publishBrowserRevision" | "suspendBrowserSession" | "resumeBrowserSession" | "endBrowserSession" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession" | "fsList" | "fsListBatch" | "fsRead" | "fsWrite" | "fsDelete" | "fsMove" | "fsMkdir" | "gitStatus" | "gitDiff" | "gitReadBatch" | "getWorkspaceCapture" | "getWorkspaceCaptureFile" | "terminalExec" | "terminalPtyOpen" | "terminalPtyWrite" | "terminalPtyResize" | "terminalPtyClose"> & Partial<Pick<OpenGeniClient, "createVideoArtifactPlaybackSource" | "streamWorkspaceLiveEvents" | "listSessionBackgroundCommands" | "cancelSessionBackgroundCommand" | "getComputerInputPosture">>;
+/** Compact list transport is optional for scripted and older clients. */
+export type SessionClientLike = SessionClientMethods & Partial<Pick<OpenGeniClient, "listSessionSummaryPage">>;
 /**
  * Tenant-safe client surface required by the session-only React entry.
  *
@@ -14,7 +16,7 @@ export type SessionClientLike = Pick<OpenGeniClient, "getClientConfig" | "getSes
  * host that does not expose that authority still supports every session-local
  * composer/control path.
  */
-export type EmbeddedSessionClientLike = Pick<OpenGeniClient, "getSession" | "listEvents" | "streamEvents" | "getComposerDraft" | "saveComposerDraft" | "sendMessage" | "steerMessage" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "pauseSession" | "resumeSession" | "sendApprovalDecision"> & {
+export type EmbeddedSessionClientLike = Pick<OpenGeniClient, "getSession" | "listEvents" | "streamEvents" | "getComposerDraft" | "saveComposerDraft" | "submitComposerDraft" | "sendMessage" | "steerMessage" | "getQueue" | "moveQueueItem" | "editQueueItem" | "steerQueueItem" | "deleteQueueItem" | "pauseSession" | "resumeSession" | "sendApprovalDecision"> & {
     setWorkspaceInferenceState?: OpenGeniClient["setWorkspaceInferenceState"] | undefined;
 };
 /** Event-read surface shared by hooks that optionally tail a session. */
@@ -26,7 +28,7 @@ export type EmbeddedGoalClientLike = EmbeddedSessionEventClientLike & Pick<OpenG
 /** Exact client surface required by {@link useSessionLineage}. */
 export type EmbeddedSessionLineageClientLike = EmbeddedSessionEventClientLike & Pick<OpenGeniClient, "getSessionLineage">;
 /** Exact client surface required by {@link useFileAttachments}. */
-export type EmbeddedFileAttachmentClientLike = Pick<OpenGeniClient, "uploadFile">;
+export type EmbeddedFileAttachmentClientLike = Pick<OpenGeniClient, "uploadFile"> & Partial<Pick<OpenGeniClient, "createFileDownloadUrl">>;
 /** Exact client surface required by structured human-input hooks. */
 export type EmbeddedHumanInputSessionClientLike = EmbeddedSessionEventClientLike & Pick<OpenGeniClient, "listHumanInputRequests" | "submitHumanInputResponse">;
 /** Exact client surface required by MCP approval-policy hooks. */
@@ -38,6 +40,7 @@ export type EmbeddedInterventionClientLike = Pick<OpenGeniClient, "streamWorkspa
 /** Exact public SDK surface required by BrowserSession hooks and components. */
 export type EmbeddedBrowserInteractionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listNetworkRoutes" | "getNetworkRoute" | "createNetworkRoute" | "updateNetworkRoute" | "listSiteAuthConnections" | "getSiteAuthConnection" | "createSiteAuthConnection" | "updateSiteAuthConnection" | "listAuthRuns" | "getAuthRun" | "startBrowserAuthRun" | "reportBrowserAuthRun" | "protectedBrowserAuthFill" | "verifyBrowserAuthRun" | "listInteractionInterventions" | "getInteractionIntervention" | "createInteractionIntervention" | "resolveInteractionIntervention" | "listAttachedBrowsers" | "getAttachedBrowser" | "listBrowserIdentities" | "getBrowserIdentity" | "createBrowserIdentity" | "updateBrowserIdentity" | "listBrowserRevisions" | "listBrowserSessions" | "getBrowserSession" | "readBrowserClipboard" | "listBrowserDownloads" | "getBrowserDownload" | "saveBrowserDownload" | "createBrowserSession" | "listBrowserTargets" | "openBrowserTarget" | "selectBrowserTarget" | "closeBrowserTarget" | "observeBrowserTarget" | "actInBrowser" | "getBrowserActionReceipt" | "listBrowserDiagnostics" | "attachBrowserSession" | "heartbeatBrowserSession" | "publishBrowserRevision" | "suspendBrowserSession" | "resumeBrowserSession" | "endBrowserSession"> & EmbeddedInterventionClientLike;
 /** Exact public SDK surface required by ComputerSession hooks and components. */
-export type EmbeddedComputerInteractionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession"> & EmbeddedInterventionClientLike;
+export type EmbeddedComputerInteractionClientLike = Pick<OpenGeniClient, "streamWorkspaceInteractionRevisions" | "listComputerSessions" | "getComputerSession" | "readComputerClipboard" | "createComputerSession" | "listComputerTargets" | "observeComputerTarget" | "actInComputer" | "getComputerActionReceipt" | "attachComputerSession" | "heartbeatComputerSession" | "endComputerSession"> & EmbeddedInterventionClientLike & Partial<Pick<OpenGeniClient, "getComputerInputPosture">>;
 /** Complete public Browser + Computer interaction surface. */
 export type EmbeddedInteractionClientLike = EmbeddedBrowserInteractionClientLike & EmbeddedComputerInteractionClientLike;
+export {};

package/dist/clipboard.js

@@ -1,3 +1,4 @@
+import "./chunk-IWIDV7SB.js";
 import {
   copyTextToClipboard
 } from "./chunk-JVYQRRC4.js";

package/dist/commands/types.d.ts

@@ -40,6 +40,8 @@ export type CommandContext = {
     permissions: Permission[];
     /** Surface a transient ok/error notice in the composer. */
     notice: (notice: Notice) => void;
+    /** Optional presentation hook for native command failures; never rewrites command content. */
+    formatError?: ((error: unknown, defaultMessage: string) => string) | undefined;
     /** Open the in-composer /help panel (rendered from the registry). */
     openHelp: () => void;
     /**

package/dist/components/anthropic-mark.d.ts

@@ -0,0 +1,3 @@
+import type { SVGProps } from "react";
+/** AnthropicMark: Simple Icons, CC0; https://github.com/simple-icons/simple-icons */
+export declare function AnthropicMark(props: SVGProps<SVGSVGElement>): import("react").JSX.Element;

package/dist/components/approval-surface.d.ts

@@ -2,12 +2,16 @@ import { type ReactNode } from "react";
 import type { PendingApproval } from "../approvals.js";
 export type ApprovalSurfaceMessages = {
     title: string;
+    /** Screen-reader context for the decision; not shown visually. */
     description: string;
     approve: string;
     reject: string;
     approving: string;
     rejecting: string;
     formatToolName: (name: string) => string;
+    /** Toggle for the exact arguments when they are shown as readable fields. */
+    showDetails?: string | undefined;
+    hideDetails?: string | undefined;
 };
 export declare const defaultApprovalSurfaceMessages: ApprovalSurfaceMessages;
 export type ApprovalSurfaceProps = {
@@ -20,6 +24,17 @@ export type ApprovalSurfaceProps = {
     renderApproval?: ((approval: PendingApproval) => ReactNode) | undefined;
     className?: string | undefined;
 };
+export type ApprovalField = {
+    key: string;
+    label: string;
+    value: string;
+};
+/**
+ * Readable fields for a flat argument object (scalars and short scalar lists).
+ * Returns null when the arguments are nested, large, or not an object, so the
+ * caller shows the exact JSON instead of a lossy summary.
+ */
+export declare function approvalArgumentFields(value: unknown): ApprovalField[] | null;
 /**
  * Host-neutral approval presentation backed by the native pending-approval
  * projection and control callbacks. It owns only presentation and duplicate

package/dist/components/artifacts/artifact-chrome.d.ts

@@ -0,0 +1,120 @@
+import { type ComponentProps, type ReactNode } from "react";
+/**
+ * Shared chrome for artifact surfaces: the OpenGeni console and embedding hosts
+ * render the same header, controls, and load states. Class names use the
+ * package theme aliases, so the console's own Tailwind build and the compiled
+ * `.og-root` stylesheet resolve them identically.
+ */
+export type ArtifactKind = "document" | "spreadsheet" | "presentation" | "site" | "image" | "file";
+declare const BUTTON_VARIANT: {
+    readonly ghost: "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50";
+    readonly outline: "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:border-border dark:bg-input/30 dark:hover:bg-input/50";
+};
+declare const BUTTON_SIZE: {
+    readonly sm: "h-8 gap-1.5 rounded-md px-3 has-[>svg]:px-2.5";
+    readonly icon: "size-9";
+    readonly "icon-sm": "size-8";
+};
+export declare function ArtifactButton({ variant, size, className, type, ...props }: ComponentProps<"button"> & {
+    variant?: keyof typeof BUTTON_VARIANT;
+    size?: keyof typeof BUTTON_SIZE;
+}): import("react").JSX.Element;
+export declare function ArtifactBadge({ className, ...props }: ComponentProps<"span">): import("react").JSX.Element;
+export declare const ArtifactSelect: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").SelectHTMLAttributes<HTMLSelectElement>, HTMLSelectElement>, "ref"> & import("react").RefAttributes<HTMLSelectElement>>;
+export declare function artifactKindIcon(kind: ArtifactKind): ReactNode;
+export declare function artifactKindSubtitle(kind: ArtifactKind): string;
+type LoadErrorCopy = Readonly<Record<"unavailable" | "invalid" | "transient", {
+    title: string;
+    message: string;
+}>>;
+/**
+ * Every user-facing string in the artifact surfaces (inline Site preview, Site
+ * frame, viewer header and states). Hosts translate by passing a partial
+ * `labels` object; unspecified keys keep the English defaults.
+ */
+export type ArtifactLabels = Readonly<{
+    back: string;
+    close: string;
+    /** Header title and loading copy until an artifact's title is known. */
+    opening: string;
+    /** Header title when an artifact cannot be opened. */
+    artifact: string;
+    startingEditor: string;
+    kindSubtitle: (kind: ArtifactKind) => string;
+    live: string;
+    reloadSite: string;
+    openFullScreen: string;
+    editWithAgent: string;
+    editShort: string;
+    preview: string;
+    loadPreview: string;
+    loadSitePreview: string;
+    siteVersion: string;
+    savedVersion: string;
+    version: (revision: number) => string;
+    openSite: string;
+    loadingSite: string;
+    siteArchived: string;
+    siteUnpublished: string;
+    siteReferenceInvalid: string;
+    siteLoadFailed: string;
+    retry: string;
+    tryAgain: string;
+    toolCount: (count: number) => string;
+    toolsAvailable: (count: number) => string;
+    sourceFileCount: (count: number) => string;
+    viewingDisabled: {
+        title: string;
+        message: string;
+    };
+    editorsMissing: {
+        title: string;
+        message: string;
+    };
+    siteErrors: LoadErrorCopy;
+    editableErrors: LoadErrorCopy;
+    reference: (id: string) => string;
+}>;
+export declare const DEFAULT_ARTIFACT_LABELS: ArtifactLabels;
+/** Translate every artifact surface below; nested providers override outer ones. */
+export declare function ArtifactLabelsProvider({ labels, children, }: {
+    labels: Partial<ArtifactLabels> | undefined;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useArtifactLabels(): ArtifactLabels;
+/**
+ * One artifact header: optional Back, the kind tile, title (or a host-supplied
+ * title control), trailing actions, and optional Close. The console dock and
+ * embedded viewers share it.
+ */
+export declare function ArtifactViewerHeader({ kind, title, subtitle, titleSlot, onBack, backLabel, actions, onClose, closeLabel, }: Readonly<{
+    /** `null` while the host does not know the modality yet. */
+    kind: ArtifactKind | null;
+    title: string;
+    subtitle?: string | undefined;
+    /** Replaces the title text, for example with a picker. */
+    titleSlot?: ReactNode;
+    onBack?: (() => void) | undefined;
+    backLabel?: string | undefined;
+    actions?: ReactNode;
+    onClose?: (() => void) | undefined;
+    closeLabel?: string | undefined;
+}>): import("react").JSX.Element;
+export declare function ArtifactLoading({ label }: {
+    label: string;
+}): import("react").JSX.Element;
+export declare function ArtifactProblem({ view, onRetry, }: {
+    view: ArtifactLoadErrorView;
+    onRetry?: (() => void) | undefined;
+}): import("react").JSX.Element;
+export type ArtifactLoadErrorKind = "site" | "editable";
+export type ArtifactLoadErrorView = Readonly<{
+    title: string;
+    message: string;
+    retryable: boolean;
+    correlationId?: string;
+}>;
+/** Site/editor load copy. Never surfaces raw OpenGeni API status text. */
+export declare function artifactLoadErrorView(error: unknown, kind: ArtifactLoadErrorKind, labels?: ArtifactLabels): ArtifactLoadErrorView;
+export declare function artifactLoadErrorMessage(view: ArtifactLoadErrorView, labels?: ArtifactLabels): string;
+export {};

package/dist/components/artifacts/artifact-sandbox.d.ts

@@ -0,0 +1,27 @@
+import { type ReactNode } from "react";
+import { type PublishedHtmlArtifactToolBridge } from "./published-html-artifact-frame.js";
+export type ArtifactSandboxProps = {
+    html: string;
+    height?: number | undefined;
+    autoHeight?: boolean | undefined;
+    theme?: "light" | "dark" | undefined;
+    headerControls?: ReactNode | undefined;
+    title: string;
+    /** Hide the visible title/icon while retaining the accessible iframe title. */
+    showTitle?: boolean | undefined;
+    showLiveStatus?: boolean | undefined;
+    versionLabel?: string | undefined;
+    className?: string | undefined;
+    editDisabled?: boolean | undefined;
+    onEdit?: (() => void) | undefined;
+    toolBridge?: PublishedHtmlArtifactToolBridge | undefined;
+    connectedToolCount?: number | undefined;
+    sourceFileCount?: number | undefined;
+    fill?: boolean | undefined;
+};
+/**
+ * The Site/preview frame chrome shared by the console and embedding hosts:
+ * title, version and tool badges, live status, reload, and a full-screen mode
+ * that escapes the host's scroll containers through the modal top layer.
+ */
+export declare function ArtifactSandbox(props: ArtifactSandboxProps): import("react").JSX.Element;

package/dist/components/artifacts/artifact-surface.d.ts

@@ -3,6 +3,8 @@ export type ArtifactModality = "spreadsheet" | "document" | "presentation";
 export type ArtifactSurfaceProps = {
     modality: ArtifactModality;
     title: string;
+    /** An embedding host may already provide the artifact title and navigation. */
+    showHeader?: boolean | undefined;
     subtitle?: ReactNode | undefined;
     actions?: ReactNode | undefined;
     children: ReactNode;
@@ -15,4 +17,4 @@ export type ArtifactSurfaceProps = {
  * persistence state: hosts can use the same surface for a local draft, a
  * durable OpenGeni artifact, or a collaborative projection.
  */
-export declare function ArtifactSurface({ modality, title, subtitle, actions, children, footer, busy, className, }: ArtifactSurfaceProps): import("react").JSX.Element;
+export declare function ArtifactSurface({ modality, title, showHeader, subtitle, actions, children, footer, busy, className, }: ArtifactSurfaceProps): import("react").JSX.Element;

package/dist/components/artifacts/chat-interactive-block.d.ts

@@ -0,0 +1,29 @@
+import type { OpenGeniClient, ToolGatewayIdentity } from "@opengeni/sdk";
+import { type ArtifactLabels } from "./artifact-chrome.js";
+import type { PublishedHtmlArtifactToolBridge } from "./published-html-artifact-frame.js";
+/** Reads a Site needs to render; the console client, the SDK client, or a proxy. */
+export type SiteSnapshotClient = Pick<OpenGeniClient, "getWorkspaceArtifact" | "getWorkspaceArtifactHtml"> & Partial<Pick<OpenGeniClient, "getWorkspaceArtifactContent">>;
+/** The exact saved Site a tool bridge is pinned to (absent for inline HTML). */
+export type SiteToolScope = {
+    artifactId: string;
+    siteVersionId: string;
+    requestedTools: readonly ToolGatewayIdentity[];
+};
+/** Host-owned Site API access. Omit it and Sites render without workspace tools. */
+export type SiteToolBridgeFactory = (site?: SiteToolScope) => PublishedHtmlArtifactToolBridge | undefined;
+export type ChatInteractiveBlockProps = {
+    workspaceId: string;
+    kind: "html" | "site";
+    content: string;
+    client: SiteSnapshotClient;
+    toolBridge?: SiteToolBridgeFactory | undefined;
+    theme?: "light" | "dark" | undefined;
+    /** Translations for the preview's copy; defaults to English. */
+    labels?: Partial<ArtifactLabels> | undefined;
+};
+/**
+ * Inline preview for an assistant `opengeni-html` or `opengeni-site` fence, as
+ * the OpenGeni console renders it. "Open Site" goes through the nearest
+ * `resolveLink`, so a host decides where a Site opens.
+ */
+export declare function ChatInteractiveBlock({ labels, ...props }: ChatInteractiveBlockProps): import("react").JSX.Element;

package/dist/components/artifacts/deferred-chat-media.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from "react";
+/**
+ * Reserve the chat slot before starting expensive media work. Activation is
+ * one-way: scrolling away must not discard an interactive preview's state.
+ * The timeline parks at its initial tip in layout effects before this observer
+ * is attached, so historical previews above the entry viewport stay dormant.
+ */
+export declare function DeferredChatMedia({ children, height, label, actionLabel, }: {
+    children: ReactNode;
+    height: number;
+    /** What is loading, as in "Load {label}". */
+    label?: string | undefined;
+    /** The complete (translated) activation label; overrides `label`. */
+    actionLabel?: string | undefined;
+}): import("react").JSX.Element;

package/dist/components/artifacts/document-editor.d.ts

@@ -150,6 +150,7 @@ export type DocumentProjectionEditorProps = Omit<DocumentEditorProps, "document"
 };
 export type DocumentProjectionArtifactSurfaceProps = Omit<DocumentProjectionEditorProps, "ariaLabel" | "className"> & {
     title: string;
+    showHeader?: boolean | undefined;
     subtitle?: ReactNode | undefined;
     busy?: boolean | undefined;
     className?: string | undefined;
@@ -157,6 +158,7 @@ export type DocumentProjectionArtifactSurfaceProps = Omit<DocumentProjectionEdit
 };
 export type DocumentArtifactSurfaceProps = Omit<DocumentEditorProps, "ariaLabel" | "className"> & {
     title: string;
+    showHeader?: boolean | undefined;
     subtitle?: ReactNode | undefined;
     busy?: boolean | undefined;
     className?: string | undefined;
@@ -167,6 +169,6 @@ export declare function DocumentEditor(props: DocumentEditorProps): import("reac
 /** Projection-first document editor with one async command boundary. */
 export declare function DocumentProjectionEditor({ projection, commit, onCommandError, onSelectionChange, readOnly, ...props }: DocumentProjectionEditorProps): import("react").JSX.Element;
 /** Artifact chrome plus the reusable document editor. */
-export declare function DocumentArtifactSurface({ document, title, subtitle, busy, className, editorClassName, ...editorProps }: DocumentArtifactSurfaceProps): import("react").JSX.Element;
+export declare function DocumentArtifactSurface({ document, title, showHeader, subtitle, busy, className, editorClassName, ...editorProps }: DocumentArtifactSurfaceProps): import("react").JSX.Element;
 /** Artifact chrome over the projection-first document editor. */
-export declare function DocumentProjectionArtifactSurface({ projection, title, subtitle, busy, className, editorClassName, ...editorProps }: DocumentProjectionArtifactSurfaceProps): import("react").JSX.Element;
+export declare function DocumentProjectionArtifactSurface({ projection, title, showHeader, subtitle, busy, className, editorClassName, ...editorProps }: DocumentProjectionArtifactSurfaceProps): import("react").JSX.Element;

package/dist/components/artifacts/editable-artifact-ui.d.ts

@@ -5,9 +5,10 @@ export declare function editableArtifactProjectionKey(view: EditableArtifactSync
 export declare function editableArtifactStatusLabel(view: EditableArtifactSyncView): string;
 /** Revoked read authority must hide any projection retained before invalidation. */
 export declare function editableArtifactAccessRevoked(view: EditableArtifactSyncView): boolean;
-export declare function EditableArtifactMessage({ title, detail, retry, }: {
+export declare function EditableArtifactMessage({ title, detail, retry, retryLabel, }: {
     title: string;
     detail: string;
     retry?: (() => void) | undefined;
+    retryLabel?: string | undefined;
 }): import("react").JSX.Element;
 export declare function asEditableArtifactError(cause: unknown, fallback: string): Error;