@athenaintel/react 0.38.1 → 0.39.0

package/dist/workbench/live-desktop-api.d.ts

@@ -0,0 +1,69 @@
+import type { StatewireAuthSource } from '../runtime/statewire-auth-headers';
+export declare const LiveDesktopMode: {
+    readonly WATCH: 'watch';
+    readonly CONTROL: 'control';
+};
+export type LiveDesktopMode = (typeof LiveDesktopMode)[keyof typeof LiveDesktopMode];
+/** What the session route answered. */
+export type LiveDesktopSession = {
+    status: 'ready';
+    /** A path on agora's own origin, carrying the single-use ticket. */
+    viewerPath: string;
+    mode: LiveDesktopMode;
+    /** The remote screen, when known: what the frame keeps the aspect of. */
+    display: {
+        width: number;
+        height: number;
+    } | null;
+} | {
+    status: 'display_not_running';
+    detail: string;
+} | {
+    status: 'unsupported';
+    detail: string;
+};
+export declare function computerLiveDesktopSessionPath(assetId: string): string;
+/** The route's body as a session, or `null` for a shape the pane cannot use. */
+export declare function readLiveDesktopSession(body: unknown): LiveDesktopSession | null;
+/**
+ * The viewer page's URL on agora's origin. Throws when *viewerPath* would
+ * leave that origin: the frame is given agora's page or nothing.
+ */
+export declare function liveDesktopViewerUrl({ backendUrl, viewerPath, }: {
+    backendUrl: string;
+    viewerPath: string;
+}): string;
+/** Ask for a viewer of the computer's desktop. Every failure is an `AthenaSdkError`. */
+export declare function createComputerLiveDesktopSession({ backendUrl, auth, assetId, mode, start, embedOrigin, signal, }: {
+    backendUrl: string;
+    auth: StatewireAuthSource;
+    assetId: string;
+    mode: LiveDesktopMode;
+    /** Start the computer's display when it is down (this also opens its browser). */
+    start: boolean;
+    /** The origin of the page that will frame the viewer (this page's). */
+    embedOrigin: string | null;
+    signal?: AbortSignal;
+}): Promise<LiveDesktopSession>;
+/** Names the viewer page's messages (`LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE` in agora). */
+export declare const LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE = "athena-live-desktop";
+/** The viewer page's messages the pane acts on; the rest are ignored. */
+export type LiveDesktopViewerMessage = {
+    status: 'ready';
+} | {
+    status: 'error';
+    detail: string;
+} | {
+    status: 'open';
+} | {
+    status: 'closed';
+    code: number;
+    reason: string;
+};
+export declare function readLiveDesktopViewerMessage(data: unknown): LiveDesktopViewerMessage | null;
+/**
+ * Close codes agora's relay ends a view with for good
+ * (`LIVE_DESKTOP_CLOSE_*` in agora `live_desktop.py`): the view is over and
+ * the pane says why. Any other close is a drop Selkies re-dials by itself.
+ */
+export declare function finalLiveDesktopCloseNotice(code: number): string | null;

package/dist/workbench/live-desktop-api.js

@@ -0,0 +1,139 @@
+import { getAthenaApiBaseUrl } from "../collab/mint.js";
+import { AthenaSdkError } from "../diagnostics/errors.js";
+import { isRecord } from "../lib/utils.js";
+import { sendWithCredentialRenewal } from "../runtime/credential-renewal.js";
+const LiveDesktopMode = { WATCH: "watch", CONTROL: "control" };
+function computerLiveDesktopSessionPath(assetId) {
+  return `/api/sandbox/computer/${encodeURIComponent(assetId)}/live-desktop/session`;
+}
+function readDisplay(value) {
+  if (!isRecord(value)) return null;
+  const { width, height } = value;
+  return typeof width === "number" && width > 0 && typeof height === "number" && height > 0 ? { width, height } : null;
+}
+function readLiveDesktopSession(body) {
+  if (!isRecord(body)) return null;
+  const detail = typeof body.detail === "string" ? body.detail : "";
+  if (body.status === "display_not_running") return { status: "display_not_running", detail };
+  if (body.status === "unsupported") return { status: "unsupported", detail };
+  if (body.status !== "ready") return null;
+  const { viewer_path: viewerPath, mode } = body;
+  if (typeof viewerPath !== "string" || !/^\/(?!\/)/.test(viewerPath)) return null;
+  if (mode !== LiveDesktopMode.WATCH && mode !== LiveDesktopMode.CONTROL) return null;
+  return { status: "ready", viewerPath, mode, display: readDisplay(body.display) };
+}
+function liveDesktopViewerUrl({
+  backendUrl,
+  viewerPath
+}) {
+  const base = new URL(`${getAthenaApiBaseUrl(backendUrl)}/`);
+  const url = new URL(viewerPath, base);
+  if (url.origin !== base.origin) {
+    throw new Error("The live desktop viewer must be served by the Athena API");
+  }
+  return url.toString();
+}
+function refusalDetail(body) {
+  if (!isRecord(body)) return null;
+  return typeof body.detail === "string" && body.detail ? body.detail : null;
+}
+async function createComputerLiveDesktopSession({
+  backendUrl,
+  auth,
+  assetId,
+  mode,
+  start,
+  embedOrigin,
+  signal
+}) {
+  const url = `${getAthenaApiBaseUrl(backendUrl)}${computerLiveDesktopSessionPath(assetId)}`;
+  const body = JSON.stringify({
+    start,
+    mode,
+    ...embedOrigin ? { embed_origin: embedOrigin } : {}
+  });
+  const send = async (headers) => {
+    try {
+      return await fetch(url, {
+        method: "POST",
+        headers: { ...headers, "Content-Type": "application/json" },
+        body,
+        signal: signal ?? null
+      });
+    } catch (error) {
+      if ((error instanceof DOMException || error instanceof Error) && error.name === "AbortError") {
+        throw error;
+      }
+      throw new AthenaSdkError({
+        code: "live_desktop_failed",
+        message: "The computer’s desktop could not be reached.",
+        cause: error,
+        hint: "Check the network and that backendUrl points at the Agora API base."
+      });
+    }
+  };
+  const response = await sendWithCredentialRenewal(auth, send);
+  const parsed = await response.json().catch(() => void 0);
+  if (!response.ok) {
+    throw new AthenaSdkError({
+      code: response.status === 401 ? "auth_rejected" : "live_desktop_failed",
+      message: refusalDetail(parsed) ?? `Opening the computer’s desktop failed (${response.status}).`,
+      status: response.status,
+      detail: parsed,
+      hint: response.status === 403 ? "Watching a computer’s desktop needs edit access to it, in its own workspace." : void 0
+    });
+  }
+  const session = readLiveDesktopSession(parsed);
+  if (!session) {
+    throw new AthenaSdkError({
+      code: "live_desktop_failed",
+      message: "The computer’s desktop answered in a shape this app does not understand.",
+      status: response.status,
+      detail: parsed
+    });
+  }
+  return session;
+}
+const LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE = "athena-live-desktop";
+function readLiveDesktopViewerMessage(data) {
+  if (!isRecord(data) || data.source !== LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE) return null;
+  switch (data.status) {
+    case "ready":
+      return { status: "ready" };
+    case "open":
+      return { status: "open" };
+    case "error":
+      return typeof data.detail === "string" ? { status: "error", detail: data.detail.slice(0, 300) } : null;
+    case "closed":
+      return typeof data.code === "number" ? {
+        status: "closed",
+        code: data.code,
+        reason: typeof data.reason === "string" ? data.reason.slice(0, 120) : ""
+      } : null;
+    default:
+      return null;
+  }
+}
+function finalLiveDesktopCloseNotice(code) {
+  switch (code) {
+    case 4001:
+      return "The desktop session expired. Reconnect to start a new one.";
+    case 4003:
+      return "You no longer have access to this computer’s desktop.";
+    case 4008:
+      return "The desktop session reached its time limit, so the computer can go idle. Reconnect to keep watching.";
+    default:
+      return null;
+  }
+}
+export {
+  LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE,
+  LiveDesktopMode,
+  computerLiveDesktopSessionPath,
+  createComputerLiveDesktopSession,
+  finalLiveDesktopCloseNotice,
+  liveDesktopViewerUrl,
+  readLiveDesktopSession,
+  readLiveDesktopViewerMessage
+};
+//# sourceMappingURL=live-desktop-api.js.map

package/dist/workbench/live-desktop-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-desktop-api.js","sources":["../../src/workbench/live-desktop-api.ts"],"sourcesContent":["/**\n * A computer's live desktop, as an app the computer serves on Athena embeds it.\n *\n * `POST /api/sandbox/computer/{asset_id}/live-desktop/session` (agora\n * `web/api/computer/live_desktop.py`) is the gate: VIEW with the workspace\n * fence, the computer in the caller's current workspace, EDIT and the\n * computer role policy, for watching as for control. It answers the viewer\n * page's path (carrying a 60 s single-use ticket), or why there is nothing to\n * show. The session names the page that will frame the viewer\n * (`embed_origin`, this page's own origin): agora accepts only an Athena app\n * the caller may open in the computer's workspace, and binds the viewer's\n * `frame-ancestors` and messages to it.\n *\n * The viewer page is Selkies' own web client, served by agora from the guest.\n * Whoever controls the computer controls that page, so its messages are hints\n * for the UI (connected, failed, closed) and never trusted beyond that.\n */\nimport { getAthenaApiBaseUrl } from '../collab/mint';\nimport { AthenaSdkError } from '../diagnostics/errors';\nimport { isRecord } from '../lib/utils';\nimport { sendWithCredentialRenewal } from '../runtime/credential-renewal';\nimport type { StatewireAuthSource } from '../runtime/statewire-auth-headers';\n\nexport const LiveDesktopMode = { WATCH: 'watch', CONTROL: 'control' } as const;\nexport type LiveDesktopMode = (typeof LiveDesktopMode)[keyof typeof LiveDesktopMode];\n\n/** What the session route answered. */\nexport type LiveDesktopSession =\n  | {\n      status: 'ready';\n      /** A path on agora's own origin, carrying the single-use ticket. */\n      viewerPath: string;\n      mode: LiveDesktopMode;\n      /** The remote screen, when known: what the frame keeps the aspect of. */\n      display: { width: number; height: number } | null;\n    }\n  | { status: 'display_not_running'; detail: string }\n  | { status: 'unsupported'; detail: string };\n\nexport function computerLiveDesktopSessionPath(assetId: string): string {\n  return `/api/sandbox/computer/${encodeURIComponent(assetId)}/live-desktop/session`;\n}\n\nfunction readDisplay(value: unknown): { width: number; height: number } | null {\n  if (!isRecord(value)) return null;\n  const { width, height } = value;\n  return typeof width === 'number' && width > 0 && typeof height === 'number' && height > 0\n    ? { width, height }\n    : null;\n}\n\n/** The route's body as a session, or `null` for a shape the pane cannot use. */\nexport function readLiveDesktopSession(body: unknown): LiveDesktopSession | null {\n  if (!isRecord(body)) return null;\n  const detail = typeof body.detail === 'string' ? body.detail : '';\n  if (body.status === 'display_not_running') return { status: 'display_not_running', detail };\n  if (body.status === 'unsupported') return { status: 'unsupported', detail };\n  if (body.status !== 'ready') return null;\n  const { viewer_path: viewerPath, mode } = body;\n  // Only a path on agora's own origin, never a protocol-relative URL.\n  if (typeof viewerPath !== 'string' || !/^\\/(?!\\/)/.test(viewerPath)) return null;\n  if (mode !== LiveDesktopMode.WATCH && mode !== LiveDesktopMode.CONTROL) return null;\n  return { status: 'ready', viewerPath, mode, display: readDisplay(body.display) };\n}\n\n/**\n * The viewer page's URL on agora's origin. Throws when *viewerPath* would\n * leave that origin: the frame is given agora's page or nothing.\n */\nexport function liveDesktopViewerUrl({\n  backendUrl,\n  viewerPath,\n}: {\n  backendUrl: string;\n  viewerPath: string;\n}): string {\n  const base = new URL(`${getAthenaApiBaseUrl(backendUrl)}/`);\n  const url = new URL(viewerPath, base);\n  if (url.origin !== base.origin) {\n    throw new Error('The live desktop viewer must be served by the Athena API');\n  }\n  return url.toString();\n}\n\nfunction refusalDetail(body: unknown): string | null {\n  if (!isRecord(body)) return null;\n  return typeof body.detail === 'string' && body.detail ? body.detail : null;\n}\n\n/** Ask for a viewer of the computer's desktop. Every failure is an `AthenaSdkError`. */\nexport async function createComputerLiveDesktopSession({\n  backendUrl,\n  auth,\n  assetId,\n  mode,\n  start,\n  embedOrigin,\n  signal,\n}: {\n  backendUrl: string;\n  auth: StatewireAuthSource;\n  assetId: string;\n  mode: LiveDesktopMode;\n  /** Start the computer's display when it is down (this also opens its browser). */\n  start: boolean;\n  /** The origin of the page that will frame the viewer (this page's). */\n  embedOrigin: string | null;\n  signal?: AbortSignal;\n}): Promise<LiveDesktopSession> {\n  const url = `${getAthenaApiBaseUrl(backendUrl)}${computerLiveDesktopSessionPath(assetId)}`;\n  const body = JSON.stringify({\n    start,\n    mode,\n    ...(embedOrigin ? { embed_origin: embedOrigin } : {}),\n  });\n  const send = async (headers: Record<string, string>): Promise<Response> => {\n    try {\n      return await fetch(url, {\n        method: 'POST',\n        headers: { ...headers, 'Content-Type': 'application/json' },\n        body,\n        signal: signal ?? null,\n      });\n    } catch (error) {\n      if ((error instanceof DOMException || error instanceof Error) && error.name === 'AbortError') {\n        throw error;\n      }\n      throw new AthenaSdkError({\n        code: 'live_desktop_failed',\n        message: 'The computer’s desktop could not be reached.',\n        cause: error,\n        hint: 'Check the network and that backendUrl points at the Agora API base.',\n      });\n    }\n  };\n  const response = await sendWithCredentialRenewal(auth, send);\n  const parsed: unknown = await response.json().catch(() => undefined);\n  if (!response.ok) {\n    throw new AthenaSdkError({\n      code: response.status === 401 ? 'auth_rejected' : 'live_desktop_failed',\n      message:\n        refusalDetail(parsed) ?? `Opening the computer’s desktop failed (${response.status}).`,\n      status: response.status,\n      detail: parsed,\n      hint:\n        response.status === 403\n          ? 'Watching a computer’s desktop needs edit access to it, in its own workspace.'\n          : undefined,\n    });\n  }\n  const session = readLiveDesktopSession(parsed);\n  if (!session) {\n    throw new AthenaSdkError({\n      code: 'live_desktop_failed',\n      message: 'The computer’s desktop answered in a shape this app does not understand.',\n      status: response.status,\n      detail: parsed,\n    });\n  }\n  return session;\n}\n\n/** Names the viewer page's messages (`LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE` in agora). */\nexport const LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE = 'athena-live-desktop';\n\n/** The viewer page's messages the pane acts on; the rest are ignored. */\nexport type LiveDesktopViewerMessage =\n  | { status: 'ready' }\n  | { status: 'error'; detail: string }\n  | { status: 'open' }\n  | { status: 'closed'; code: number; reason: string };\n\nexport function readLiveDesktopViewerMessage(data: unknown): LiveDesktopViewerMessage | null {\n  if (!isRecord(data) || data.source !== LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE) return null;\n  switch (data.status) {\n    case 'ready':\n      return { status: 'ready' };\n    case 'open':\n      return { status: 'open' };\n    case 'error':\n      return typeof data.detail === 'string'\n        ? { status: 'error', detail: data.detail.slice(0, 300) }\n        : null;\n    case 'closed':\n      return typeof data.code === 'number'\n        ? {\n            status: 'closed',\n            code: data.code,\n            reason: typeof data.reason === 'string' ? data.reason.slice(0, 120) : '',\n          }\n        : null;\n    default:\n      return null;\n  }\n}\n\n/**\n * Close codes agora's relay ends a view with for good\n * (`LIVE_DESKTOP_CLOSE_*` in agora `live_desktop.py`): the view is over and\n * the pane says why. Any other close is a drop Selkies re-dials by itself.\n */\nexport function finalLiveDesktopCloseNotice(code: number): string | null {\n  switch (code) {\n    case 4001:\n      return 'The desktop session expired. Reconnect to start a new one.';\n    case 4003:\n      return 'You no longer have access to this computer’s desktop.';\n    case 4008:\n      return 'The desktop session reached its time limit, so the computer can go idle. Reconnect to keep watching.';\n    default:\n      return null;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/workbench/session-workbench-context.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"session-workbench-context.cjs","sources":["../../src/workbench/session-workbench-context.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query';\nimport type { ComponentType, ReactNode } from 'react';\nimport { createContext, useContext } from 'react';\nimport type { SessionWorkspace } from './session-workspace-api';\nimport { useAthenaSessionWorkspace } from './use-session-workspace';\n\n/** What every pane knows about the thread the workbench shows. */\nexport interface SessionWorkbenchPaneContext {\n  /**\n   * The thread the chat is attached to (defined for a never-started chat too);\n   * `null` outside `<AthenaProvider>`.\n   */\n  threadId: string | null;\n  /**\n   * Whether the backend knows the thread yet. A never-started chat has no\n   * workspace, pull requests or history to read, so panes show their empty\n   * state instead of asking.\n   */\n  isPersisted: boolean;\n  /** Whether the thread's run is live — panes that read the backend poll while it is. */\n  isRunning: boolean;\n}\n\n/**\n * One tab the workbench can open. Hosts add their own beside the built-in\n * ones (`DEFAULT_SESSION_WORKBENCH_PANES`) — a Harvey-style \"Matter\" pane, a\n * Hebbia-style \"Grid\" — and choose which open by default.\n */\nexport interface SessionWorkbenchPane {\n  /** Stable id; also what `defaultOpenPaneIds` names. */\n  id: string;\n  /** Tab label. */\n  title: string;\n  /**\n   * One line on what the pane shows (\"Commands the agent ran and their\n   * output\"). The workbench lists it under the title when no pane is open.\n   */\n  description?: string;\n  /** Tab icon (a lucide icon, or any component taking `className`). */\n  icon?: ComponentType<{ className?: string }>;\n  /** The pane body for the workbench's current thread. */\n  render: (context: SessionWorkbenchPaneContext) => ReactNode;\n}\n\nexport const SessionWorkbenchContext = createContext<SessionWorkbenchPaneContext | null>(null);\n\n/**\n * The workbench's thread context, for a custom pane's components. Throws\n * outside `SessionWorkbench`.\n */\nexport function useSessionWorkbench(): SessionWorkbenchPaneContext {\n  const context = useContext(SessionWorkbenchContext);\n  if (context === null) {\n    throw new Error('[AthenaSDK] useSessionWorkbench must be used within <SessionWorkbench>');\n  }\n  return context;\n}\n\n/** How often a pane re-reads the workspace while the run is live. */\nexport const SESSION_WORKSPACE_LIVE_REFETCH_MS = 15_000;\n\n/**\n * The workbench thread's workspace (computers and assets), shared by every\n * pane through one query: polled while the run is live, idle for a\n * never-started chat.\n */\nexport function useSessionWorkbenchWorkspace(): UseQueryResult<SessionWorkspace, Error> {\n  const { threadId, isPersisted, isRunning } = useSessionWorkbench();\n  return useAthenaSessionWorkspace({\n    threadId,\n    enabled: isPersisted,\n    refetchIntervalMs: isRunning ? SESSION_WORKSPACE_LIVE_REFETCH_MS : false,\n  });\n}\n"],"names":["createContext","useContext","useAthenaSessionWorkspace"],"mappings":";;;;AA4CO,MAAM,0BAA0BA,MAAAA,cAAkD,IAAI;AAMtF,SAAS,sBAAmD;AACjE,QAAM,UAAUC,MAAAA,WAAW,uBAAuB;AAClD,MAAI,YAAY,MAAM;AACpB,UAAM,IAAI,MAAM,wEAAwE;AAAA,EAC1F;AACA,SAAO;AACT;AAGO,MAAM,oCAAoC;AAO1C,SAAS,+BAAwE;AACtF,QAAM,EAAE,UAAU,aAAa,UAAA,IAAc,oBAAA;AAC7C,SAAOC,8CAA0B;AAAA,IAC/B;AAAA,IACA,SAAS;AAAA,IACT,mBAAmB,YAAY,oCAAoC;AAAA,EAAA,CACpE;AACH;;;;;"}
+{"version":3,"file":"session-workbench-context.cjs","sources":["../../src/workbench/session-workbench-context.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query';\nimport type { ComponentType, ReactNode } from 'react';\nimport { createContext, useContext } from 'react';\nimport type { SessionWorkspace } from './session-workspace-api';\nimport { useAthenaSessionWorkspace } from './use-session-workspace';\n\n/** What every pane knows about the thread the workbench shows. */\nexport interface SessionWorkbenchPaneContext {\n  /**\n   * The thread the chat is attached to (defined for a never-started chat too);\n   * `null` outside `<AthenaProvider>`.\n   */\n  threadId: string | null;\n  /**\n   * Whether the backend knows the thread yet. A never-started chat has no\n   * workspace, pull requests or history to read, so panes show their empty\n   * state instead of asking.\n   */\n  isPersisted: boolean;\n  /** Whether the thread's run is live — panes that read the backend poll while it is. */\n  isRunning: boolean;\n  /**\n   * Whether the pane is on screen: `false` while the workbench is collapsed to\n   * its rail (the pane stays mounted, hidden). A pane that streams — the\n   * Computer pane's live desktop — stops while hidden. Optional for hosts that\n   * build this context themselves; absent reads as visible.\n   */\n  isVisible?: boolean;\n}\n\n/**\n * One tab the workbench can open. Hosts add their own beside the built-in\n * ones (`DEFAULT_SESSION_WORKBENCH_PANES`) — a Harvey-style \"Matter\" pane, a\n * Hebbia-style \"Grid\" — and choose which open by default.\n */\nexport interface SessionWorkbenchPane {\n  /** Stable id; also what `defaultOpenPaneIds` names. */\n  id: string;\n  /** Tab label. */\n  title: string;\n  /**\n   * One line on what the pane shows (\"Commands the agent ran and their\n   * output\"). The workbench lists it under the title when no pane is open.\n   */\n  description?: string;\n  /** Tab icon (a lucide icon, or any component taking `className`). */\n  icon?: ComponentType<{ className?: string }>;\n  /** The pane body for the workbench's current thread. */\n  render: (context: SessionWorkbenchPaneContext) => ReactNode;\n}\n\nexport const SessionWorkbenchContext = createContext<SessionWorkbenchPaneContext | null>(null);\n\n/**\n * The workbench's thread context, for a custom pane's components. Throws\n * outside `SessionWorkbench`.\n */\nexport function useSessionWorkbench(): SessionWorkbenchPaneContext {\n  const context = useContext(SessionWorkbenchContext);\n  if (context === null) {\n    throw new Error('[AthenaSDK] useSessionWorkbench must be used within <SessionWorkbench>');\n  }\n  return context;\n}\n\n/** How often a pane re-reads the workspace while the run is live. */\nexport const SESSION_WORKSPACE_LIVE_REFETCH_MS = 15_000;\n\n/**\n * The workbench thread's workspace (computers and assets), shared by every\n * pane through one query: polled while the run is live, idle for a\n * never-started chat.\n */\nexport function useSessionWorkbenchWorkspace(): UseQueryResult<SessionWorkspace, Error> {\n  const { threadId, isPersisted, isRunning } = useSessionWorkbench();\n  return useAthenaSessionWorkspace({\n    threadId,\n    enabled: isPersisted,\n    refetchIntervalMs: isRunning ? SESSION_WORKSPACE_LIVE_REFETCH_MS : false,\n  });\n}\n"],"names":["createContext","useContext","useAthenaSessionWorkspace"],"mappings":";;;;AAmDO,MAAM,0BAA0BA,MAAAA,cAAkD,IAAI;AAMtF,SAAS,sBAAmD;AACjE,QAAM,UAAUC,MAAAA,WAAW,uBAAuB;AAClD,MAAI,YAAY,MAAM;AACpB,UAAM,IAAI,MAAM,wEAAwE;AAAA,EAC1F;AACA,SAAO;AACT;AAGO,MAAM,oCAAoC;AAO1C,SAAS,+BAAwE;AACtF,QAAM,EAAE,UAAU,aAAa,UAAA,IAAc,oBAAA;AAC7C,SAAOC,8CAA0B;AAAA,IAC/B;AAAA,IACA,SAAS;AAAA,IACT,mBAAmB,YAAY,oCAAoC;AAAA,EAAA,CACpE;AACH;;;;;"}

package/dist/workbench/session-workbench-context.d.ts

@@ -16,6 +16,13 @@ export interface SessionWorkbenchPaneContext {
     isPersisted: boolean;
     /** Whether the thread's run is live — panes that read the backend poll while it is. */
     isRunning: boolean;
+    /**
+     * Whether the pane is on screen: `false` while the workbench is collapsed to
+     * its rail (the pane stays mounted, hidden). A pane that streams — the
+     * Computer pane's live desktop — stops while hidden. Optional for hosts that
+     * build this context themselves; absent reads as visible.
+     */
+    isVisible?: boolean;
 }
 /**
  * One tab the workbench can open. Hosts add their own beside the built-in

package/dist/workbench/session-workbench-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-workbench-context.js","sources":["../../src/workbench/session-workbench-context.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query';\nimport type { ComponentType, ReactNode } from 'react';\nimport { createContext, useContext } from 'react';\nimport type { SessionWorkspace } from './session-workspace-api';\nimport { useAthenaSessionWorkspace } from './use-session-workspace';\n\n/** What every pane knows about the thread the workbench shows. */\nexport interface SessionWorkbenchPaneContext {\n  /**\n   * The thread the chat is attached to (defined for a never-started chat too);\n   * `null` outside `<AthenaProvider>`.\n   */\n  threadId: string | null;\n  /**\n   * Whether the backend knows the thread yet. A never-started chat has no\n   * workspace, pull requests or history to read, so panes show their empty\n   * state instead of asking.\n   */\n  isPersisted: boolean;\n  /** Whether the thread's run is live — panes that read the backend poll while it is. */\n  isRunning: boolean;\n}\n\n/**\n * One tab the workbench can open. Hosts add their own beside the built-in\n * ones (`DEFAULT_SESSION_WORKBENCH_PANES`) — a Harvey-style \"Matter\" pane, a\n * Hebbia-style \"Grid\" — and choose which open by default.\n */\nexport interface SessionWorkbenchPane {\n  /** Stable id; also what `defaultOpenPaneIds` names. */\n  id: string;\n  /** Tab label. */\n  title: string;\n  /**\n   * One line on what the pane shows (\"Commands the agent ran and their\n   * output\"). The workbench lists it under the title when no pane is open.\n   */\n  description?: string;\n  /** Tab icon (a lucide icon, or any component taking `className`). */\n  icon?: ComponentType<{ className?: string }>;\n  /** The pane body for the workbench's current thread. */\n  render: (context: SessionWorkbenchPaneContext) => ReactNode;\n}\n\nexport const SessionWorkbenchContext = createContext<SessionWorkbenchPaneContext | null>(null);\n\n/**\n * The workbench's thread context, for a custom pane's components. Throws\n * outside `SessionWorkbench`.\n */\nexport function useSessionWorkbench(): SessionWorkbenchPaneContext {\n  const context = useContext(SessionWorkbenchContext);\n  if (context === null) {\n    throw new Error('[AthenaSDK] useSessionWorkbench must be used within <SessionWorkbench>');\n  }\n  return context;\n}\n\n/** How often a pane re-reads the workspace while the run is live. */\nexport const SESSION_WORKSPACE_LIVE_REFETCH_MS = 15_000;\n\n/**\n * The workbench thread's workspace (computers and assets), shared by every\n * pane through one query: polled while the run is live, idle for a\n * never-started chat.\n */\nexport function useSessionWorkbenchWorkspace(): UseQueryResult<SessionWorkspace, Error> {\n  const { threadId, isPersisted, isRunning } = useSessionWorkbench();\n  return useAthenaSessionWorkspace({\n    threadId,\n    enabled: isPersisted,\n    refetchIntervalMs: isRunning ? SESSION_WORKSPACE_LIVE_REFETCH_MS : false,\n  });\n}\n"],"names":[],"mappings":";;AA4CO,MAAM,0BAA0B,cAAkD,IAAI;AAMtF,SAAS,sBAAmD;AACjE,QAAM,UAAU,WAAW,uBAAuB;AAClD,MAAI,YAAY,MAAM;AACpB,UAAM,IAAI,MAAM,wEAAwE;AAAA,EAC1F;AACA,SAAO;AACT;AAGO,MAAM,oCAAoC;AAO1C,SAAS,+BAAwE;AACtF,QAAM,EAAE,UAAU,aAAa,UAAA,IAAc,oBAAA;AAC7C,SAAO,0BAA0B;AAAA,IAC/B;AAAA,IACA,SAAS;AAAA,IACT,mBAAmB,YAAY,oCAAoC;AAAA,EAAA,CACpE;AACH;"}
+{"version":3,"file":"session-workbench-context.js","sources":["../../src/workbench/session-workbench-context.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query';\nimport type { ComponentType, ReactNode } from 'react';\nimport { createContext, useContext } from 'react';\nimport type { SessionWorkspace } from './session-workspace-api';\nimport { useAthenaSessionWorkspace } from './use-session-workspace';\n\n/** What every pane knows about the thread the workbench shows. */\nexport interface SessionWorkbenchPaneContext {\n  /**\n   * The thread the chat is attached to (defined for a never-started chat too);\n   * `null` outside `<AthenaProvider>`.\n   */\n  threadId: string | null;\n  /**\n   * Whether the backend knows the thread yet. A never-started chat has no\n   * workspace, pull requests or history to read, so panes show their empty\n   * state instead of asking.\n   */\n  isPersisted: boolean;\n  /** Whether the thread's run is live — panes that read the backend poll while it is. */\n  isRunning: boolean;\n  /**\n   * Whether the pane is on screen: `false` while the workbench is collapsed to\n   * its rail (the pane stays mounted, hidden). A pane that streams — the\n   * Computer pane's live desktop — stops while hidden. Optional for hosts that\n   * build this context themselves; absent reads as visible.\n   */\n  isVisible?: boolean;\n}\n\n/**\n * One tab the workbench can open. Hosts add their own beside the built-in\n * ones (`DEFAULT_SESSION_WORKBENCH_PANES`) — a Harvey-style \"Matter\" pane, a\n * Hebbia-style \"Grid\" — and choose which open by default.\n */\nexport interface SessionWorkbenchPane {\n  /** Stable id; also what `defaultOpenPaneIds` names. */\n  id: string;\n  /** Tab label. */\n  title: string;\n  /**\n   * One line on what the pane shows (\"Commands the agent ran and their\n   * output\"). The workbench lists it under the title when no pane is open.\n   */\n  description?: string;\n  /** Tab icon (a lucide icon, or any component taking `className`). */\n  icon?: ComponentType<{ className?: string }>;\n  /** The pane body for the workbench's current thread. */\n  render: (context: SessionWorkbenchPaneContext) => ReactNode;\n}\n\nexport const SessionWorkbenchContext = createContext<SessionWorkbenchPaneContext | null>(null);\n\n/**\n * The workbench's thread context, for a custom pane's components. Throws\n * outside `SessionWorkbench`.\n */\nexport function useSessionWorkbench(): SessionWorkbenchPaneContext {\n  const context = useContext(SessionWorkbenchContext);\n  if (context === null) {\n    throw new Error('[AthenaSDK] useSessionWorkbench must be used within <SessionWorkbench>');\n  }\n  return context;\n}\n\n/** How often a pane re-reads the workspace while the run is live. */\nexport const SESSION_WORKSPACE_LIVE_REFETCH_MS = 15_000;\n\n/**\n * The workbench thread's workspace (computers and assets), shared by every\n * pane through one query: polled while the run is live, idle for a\n * never-started chat.\n */\nexport function useSessionWorkbenchWorkspace(): UseQueryResult<SessionWorkspace, Error> {\n  const { threadId, isPersisted, isRunning } = useSessionWorkbench();\n  return useAthenaSessionWorkspace({\n    threadId,\n    enabled: isPersisted,\n    refetchIntervalMs: isRunning ? SESSION_WORKSPACE_LIVE_REFETCH_MS : false,\n  });\n}\n"],"names":[],"mappings":";;AAmDO,MAAM,0BAA0B,cAAkD,IAAI;AAMtF,SAAS,sBAAmD;AACjE,QAAM,UAAU,WAAW,uBAAuB;AAClD,MAAI,YAAY,MAAM;AACpB,UAAM,IAAI,MAAM,wEAAwE;AAAA,EAC1F;AACA,SAAO;AACT;AAGO,MAAM,oCAAoC;AAO1C,SAAS,+BAAwE;AACtF,QAAM,EAAE,UAAU,aAAa,UAAA,IAAc,oBAAA;AAC7C,SAAO,0BAA0B;AAAA,IAC/B;AAAA,IACA,SAAS;AAAA,IACT,mBAAmB,YAAY,oCAAoC;AAAA,EAAA,CACpE;AACH;"}

package/dist/workbench/session-workbench-panes.cjs

@@ -8,6 +8,7 @@ const react$1 = require("react");
 const assetPanelStore = require("../assets/asset-panel-store.cjs");
 const athenaUrls = require("../lib/athena-urls.cjs");
 const AthenaContext = require("../provider/AthenaContext.cjs");
+const statewireHistoryContext = require("../provider/statewire-history-context.cjs");
 const pullRequestDisplay = require("../threads/pull-request-display.cjs");
 const sessionListModel = require("../threads/session-list-model.cjs");
 const statewireThreadList = require("../threads/statewire-thread-list.cjs");
@@ -15,6 +16,7 @@ const useAthenaSessionAttention = require("../threads/use-athena-session-attenti
 const writeTodosToolUi = require("../tools/write-todos-tool-ui.cjs");
 const sessionWorkbenchContext = require("./session-workbench-context.cjs");
 const sessionWorkbenchModel = require("./session-workbench-model.cjs");
+const ComputerLiveDesktop = require("./ComputerLiveDesktop.cjs");
 const useSessionWorkspace = require("./use-session-workspace.cjs");
 const threadExtras = require("../agent-runtime/src/thread-extras.cjs");
 const statewireState = require("../agent-runtime/src/statewire-state.cjs");
@@ -195,9 +197,37 @@ const ShellRowItem = ({
     ] }) : null
   ] });
 };
+const ShellHistoryFooter = ({
+  history,
+  empty
+}) => {
+  const { canLoadOlder, loading, loadOlder } = history;
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col items-center gap-2 px-3 py-4 text-center", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-[11px] text-muted-foreground", children: empty ? "No commands in the part of this session loaded so far." : "Earlier commands are in the part of this session not loaded yet." }),
+    canLoadOlder && loadOlder ? /* @__PURE__ */ jsxRuntime.jsxs(
+      "button",
+      {
+        type: "button",
+        onClick: loadOlder,
+        disabled: loading,
+        className: cnfast.cn(
+          "inline-flex items-center gap-1.5 rounded-md border border-border px-2 py-1 font-medium text-xs transition-colors hover:bg-muted disabled:opacity-60",
+          FOCUS_RING_CLASS
+        ),
+        children: [
+          loading ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.LoaderIcon, { className: "size-3.5 animate-spin", "aria-hidden": true }) : null,
+          loading ? "Loading earlier commands…" : "Load earlier commands"
+        ]
+      }
+    ) : /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-[11px] text-muted-foreground", children: "The rest is further back than one view of the conversation loads." })
+  ] });
+};
 const ShellPaneContent = () => {
+  const { threadId } = sessionWorkbenchContext.useSessionWorkbench();
   const messages = react.useAuiState((state) => state.thread.messages);
   const workspace = sessionWorkbenchContext.useSessionWorkbenchWorkspace().data ?? null;
+  const history = statewireHistoryContext.useStatewireHistory(threadId);
+  const partial = (history == null ? void 0 : history.hasOlder) === true;
   const rows = react$1.useMemo(() => sessionWorkbenchModel.deriveShellRows({ messages, workspace }), [messages, workspace]);
   const [query, setQuery] = react$1.useState("");
   const [expanded, setExpanded] = react$1.useState(() => /* @__PURE__ */ new Set());
@@ -209,6 +239,7 @@ const ShellPaneContent = () => {
     return next;
   });
   if (rows.length === 0) {
+    if (partial && history) return /* @__PURE__ */ jsxRuntime.jsx(ShellHistoryFooter, { history, empty: true });
     return /* @__PURE__ */ jsxRuntime.jsx(PaneEmpty, { icon: lucideReact.TerminalIcon, title: "No commands yet", children: "Every shell command the agent runs shows here with where it ran and how it ended." });
   }
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col", children: [
@@ -227,7 +258,10 @@ const ShellPaneContent = () => {
           }
         )
       ] }),
-      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "pt-1.5 text-[11px] text-muted-foreground", "aria-live": "polite", children: query.trim() ? `${visible.length} of ${rows.length} commands` : `${rows.length} command${rows.length === 1 ? "" : "s"}` })
+      /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "pt-1.5 text-[11px] text-muted-foreground", "aria-live": "polite", children: [
+        query.trim() ? `${visible.length} of ${rows.length} commands` : `${rows.length} command${rows.length === 1 ? "" : "s"}`,
+        partial ? " so far" : ""
+      ] })
     ] }),
     visible.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "px-3 py-6 text-center text-muted-foreground text-xs", children: "No command matches." }) : /* @__PURE__ */ jsxRuntime.jsx("ul", { "aria-label": "Shell commands", children: visible.map((row) => /* @__PURE__ */ jsxRuntime.jsx(
       ShellRowItem,
@@ -237,7 +271,8 @@ const ShellPaneContent = () => {
         onToggle: () => toggle(row.id)
       },
       row.id
-    )) })
+    )) }),
+    partial && history ? /* @__PURE__ */ jsxRuntime.jsx(ShellHistoryFooter, { history, empty: false }) : null
   ] });
 };
 const SessionShellPane = () => /* @__PURE__ */ jsxRuntime.jsx(RequiresStatewireThread, { icon: lucideReact.TerminalIcon, children: /* @__PURE__ */ jsxRuntime.jsx(ShellPaneContent, {}) });
@@ -381,6 +416,7 @@ const SessionComputerPane = () => {
     return /* @__PURE__ */ jsxRuntime.jsx(PaneEmpty, { icon: lucideReact.MonitorIcon, title: "No computer used yet", children: "When the agent runs commands on a computer, it shows here with a link and its SSH command." });
   }
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col pb-3", children: [
+    /* @__PURE__ */ jsxRuntime.jsx(ComputerLiveDesktop.ComputerLiveDesktop, { assetId: primary.assetId, className: "mx-3 mt-3" }),
     /* @__PURE__ */ jsxRuntime.jsx(ComputerCard, { computer: primary }),
     others.length > 0 ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
       /* @__PURE__ */ jsxRuntime.jsx(SectionHeading, { children: "Also used" }),