Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

2.8 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import { useSetAtom, useStore } from "jotai";
import useEvent from "react-use-event-hook";
import { agentSessionStateAtom } from "@/components/chat/acp/state";
import { toast } from "@/components/ui/use-toast";
import { useAIConfigActions } from "@/core/ai/config";
import { pendingAiPromptAtom } from "@/core/ai/state";
import type { CopilotMode } from "@/core/ai/tools/registry";
import { aiModelConfiguredAtom } from "@/core/config/config";
import { getFeatureFlag } from "@/core/config/feature-flag";
import { Logger } from "@/utils/Logger";
import { useChromeActions } from "../state";
import { type AiPanelTab, aiPanelTabAtom, useAiPanelTab } from "./useAiPanel";

// Error fixes work best with kernel access, so we default the chat panel to
// code mode. The agents panel manages its own mode, so this is chat-only.
const FIX_CHAT_MODE: CopilotMode = "code_mode";

export interface OpenAiAssistantOptions {
  prompt: string;
  submit?: boolean;
  /** Override the user's AI sidebar tab. When omitted, the stored tab is used. */
  panel?: AiPanelTab;
}

// Resolve which AI panel to open.
export function resolveAiPanelTab(
  panel: AiPanelTab | undefined,
  storedTab: AiPanelTab,
): AiPanelTab {
  if (panel) {
    return panel;
  }
  return getFeatureFlag("external_agents") ? storedTab : "chat";
}

/**
 * Opens the AI assistant sidebar panel and delivers a prompt to it.
 *
 * If no `panel` is given, the user's configured tab is respected.
 */
export function useOpenAiAssistant() {
  const { openApplication } = useChromeActions();
  const { setAiPanelTab } = useAiPanelTab();
  const { saveModeChange } = useAIConfigActions();
  const setPendingPrompt = useSetAtom(pendingAiPromptAtom);
  const store = useStore();

  return useEvent(async (opts: OpenAiAssistantOptions) => {
    const tab = resolveAiPanelTab(opts.panel, store.get(aiPanelTabAtom));

    const chatPanelReady = store.get(aiModelConfiguredAtom);
    const agentsPanelReady =
      getFeatureFlag("external_agents") &&
      store.get(agentSessionStateAtom).sessions.length > 0;
    const isReady = tab === "agents" ? agentsPanelReady : chatPanelReady;

    if (!isReady) {
      toast({
        title: tab === "agents" ? "No agent session" : "AI not configured",
        description:
          tab === "agents"
            ? "Start an agent session or switch to the chat panel."
            : "Configure an AI provider and chat model to fix with AI.",
        variant: "danger",
      });
      return;
    }

    if (opts.panel) {
      setAiPanelTab(opts.panel);
    }

    if (tab === "chat") {
      await saveModeChange(FIX_CHAT_MODE).catch(() =>
        Logger.error("Failed to save mode change"),
      );
    }

    setPendingPrompt({
      prompt: opts.prompt,
      submit: opts.submit ?? false,
    });

    openApplication("ai");
  });
}