Skip to content

πŸ™Œ OpenHands: AI-Driven Development

4.0 KB
Raw Blame
import ConversationService from "#/api/conversation-service/conversation-service.api";
import {
  ConversationTab,
  useConversationStore,
} from "#/stores/conversation-store";
import { useFilesTabStore } from "#/stores/files-tab-store";
import type { CanvasUIAction } from "#/types/agent-server/core";
import { setConversationState } from "#/utils/conversation-local-storage";
import { toFilesTabPath } from "#/utils/path-utils";

const VALID_TABS: ReadonlySet<ConversationTab> = new Set<ConversationTab>([
  "files",
  "browser",
  "terminal",
  "planner",
  "tasklist",
]);

type PanelRevealListener = () => void;

const panelRevealListeners = new Set<PanelRevealListener>();

/**
 * Subscribe to requests to reveal the conversation drawer. The store flags set
 * below open the desktop side drawer; at phone width the drawer only exists on
 * the `/conversations/:id/panel` route, so the conversation route listens here
 * and navigates there (see `useConversationPanelRoute`).
 */
export function subscribeToPanelReveal(
  listener: PanelRevealListener,
): () => void {
  panelRevealListeners.add(listener);
  return () => {
    panelRevealListeners.delete(listener);
  };
}

/**
 * Ask whoever shows the conversation drawer to reveal it. Desktop already
 * shows the drawer from the store flags; at phone width the conversation
 * route answers by opening `/conversations/:id/panel`.
 */
export function requestPanelReveal(): void {
  panelRevealListeners.forEach((listener) => listener());
}

// Mirrors src/hooks/use-select-conversation-tab.ts so a non-React caller (the
// WebSocket dispatch) gets the same "persist the tab and reveal the right
// panel if collapsed" behavior as in-app tab switches.
function navigateToTab(tab: ConversationTab, conversationId: string | null) {
  const store = useConversationStore.getState();
  store.setSelectedTab(tab);
  if (conversationId) {
    setConversationState(conversationId, { selectedTab: tab });
  }
  if (!store.isRightPanelShown) {
    store.setHasRightPanelToggled(true);
    store.setIsRightPanelShown(true);
  }
  requestPanelReveal();
}

function isValidTab(value: string): value is ConversationTab {
  return VALID_TABS.has(value as ConversationTab);
}

/**
 * Chat path click β†’ same as agent `navigate_to_file`.
 * Optional `conversationId` tags the selection so FilesTab accepts it.
 */
export function openWorkspaceFile(
  path: string,
  conversationId?: string | null,
): void {
  const conversation = ConversationService.getCurrentConversation();
  handleCanvasUIAction(
    {
      kind: "CanvasUIAction",
      command: "navigate_to_file",
      path,
    } as CanvasUIAction,
    conversationId ?? conversation?.id ?? null,
  );
}

export function handleCanvasUIAction(
  action: CanvasUIAction,
  conversationId: string | null = null,
): void {
  switch (action.command) {
    case "navigate_to_file":
    case "show_preview": {
      navigateToTab("files", conversationId);
      if (!action.path) return;

      const workingDir =
        ConversationService.getCurrentConversation()?.workspace?.working_dir;
      const path = toFilesTabPath(action.path, workingDir);
      if (!path) return;

      useFilesTabStore.getState().setSelectedPath(path, conversationId);
      return;
    }
    case "open_tab":
      if (action.tab === "vscode") {
        // The in-app VS Code tab was removed β€” on cloud backends VS Code
        // now opens in a new browser window via the link in the drawer tab
        // row. Route agent requests to Files so the drawer still opens.
        navigateToTab("files", conversationId);
      } else if (action.tab && isValidTab(action.tab)) {
        navigateToTab(action.tab, conversationId);
      } else if (action.tab) {
        // Surface unknown tab names so they're diagnosable from the browser
        // console rather than failing silently. Valid tabs are listed in
        // VALID_TABS above and mirror ConversationTab.
        console.warn(
          `[canvas_ui] Ignoring open_tab with unknown tab: ${action.tab}`,
        );
      }
      return;
  }
}