Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
// oxlint-disable ok/no-raw-error-toast -- pre-rule backlog: toasts here show raw error text; delete this line once the file maps each failure to written copy. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-raw-error-toast
import { useLingui } from '@lingui/react/macro';
import { Suspense, useEffect, useId, useState } from 'react';
import { ErrorBoundary, type FallbackProps } from 'react-error-boundary';
import { toast } from 'sonner';
import { Button } from '@/components/ui/button';
import { useTerminalConsentState, useTerminalEnabledWriter } from '@/hooks/use-terminal-enabled';
import type { OkDesktopBridge } from '@/lib/desktop-bridge-types';
import { lazyWithPreload } from '@/lib/lazy-with-preload';
import type { TerminalLaunchIntent } from './EditorPane';
import type { TerminalCommandId } from './handoff/terminal-command-events';
import { TerminalStartingNotice } from './TerminalStartingNotice';
const TerminalPanel = lazyWithPreload(() =>
import('./TerminalPanel').then((m) => ({ default: m.TerminalPanel })),
);
interface TerminalGateProps {
readonly bridge: OkDesktopBridge;
readonly onClose?: () => void;
readonly onExit?: (info: { readonly exitCode: number; readonly signal: number | null }) => void;
readonly onTitleChange?: (title: string) => void;
readonly launch?: TerminalLaunchIntent | null;
readonly commandId?: TerminalCommandId | null;
readonly adoptPtyId?: string | null;
readonly onPtyId?: (ptyId: string | null) => void;
}
export function TerminalGate({
bridge,
onClose,
onExit,
onTitleChange,
launch = null,
commandId = null,
adoptPtyId = null,
onPtyId,
}: TerminalGateProps) {
const { enabled, synced } = useTerminalConsentState();
const writer = useTerminalEnabledWriter();
const { t } = useLingui();
const [settledConsent, setSettledConsent] = useState<{
enabled: boolean | null;
hasSynced: boolean;
}>({ enabled: null, hasSynced: false });
useEffect(() => {
if (!synced) return;
setSettledConsent((previous) =>
previous.hasSynced && previous.enabled === enabled ? previous : { enabled, hasSynced: true },
);
}, [enabled, synced]);
const gateSynced = synced || settledConsent.hasSynced;
const gateEnabled = synced ? enabled : settledConsent.enabled;
const optedOut = gateSynced && gateEnabled === false;
useEffect(() => {
if (optedOut) return;
TerminalPanel.preload();
}, [optedOut]);
function handleEnable() {
if (writer === null) {
toast.error(t`Terminal settings not loaded yet — try again in a moment.`);
return;
}
const result = writer(true);
if (!result.ok) toast.error(t`Could not enable the terminal: ${result.error}`);
}
if (gateSynced && !optedOut) {
return (
<ErrorBoundary
fallbackRender={(props) => <TerminalErrorFallback {...props} />}
onError={(error, info) => {
console.error(
'[TerminalGate] rendered fallback for the terminal panel',
error,
info.componentStack,
);
}}
>
<Suspense fallback={<TerminalStartingNotice />}>
<TerminalPanel
bridge={bridge}
className="h-full"
onClose={onClose}
onExit={onExit}
onTitleChange={onTitleChange}
launch={launch}
commandId={commandId}
adoptPtyId={adoptPtyId}
onPtyId={onPtyId}
/>
</Suspense>
</ErrorBoundary>
);
}
return optedOut ? (
<TerminalNotEnabledNotice enableDisabled={writer === null} onEnable={handleEnable} />
) : (
<TerminalStartingNotice />
);
}
function TerminalErrorFallback({ error }: FallbackProps) {
const { t } = useLingui();
const message =
error instanceof Error && /dynamically imported module|Failed to fetch/i.test(error.message)
? t`A newer version may have been deployed since this tab opened.`
: t`Something went wrong starting the terminal.`;
return (
<section
aria-label={t`Terminal failed to load`}
className="flex h-full w-full flex-col items-center justify-center gap-3 bg-background p-6 text-center"
role="alert"
>
<p className="max-w-sm text-sm text-foreground">{message}</p>
<Button onClick={() => window.location.reload()}>{t`Reload`}</Button>
</section>
);
}
interface TerminalNotEnabledNoticeProps {
readonly enableDisabled: boolean;
readonly onEnable: () => void;
}
function TerminalNotEnabledNotice({ enableDisabled, onEnable }: TerminalNotEnabledNoticeProps) {
const { t } = useLingui();
const pendingReasonId = useId();
return (
<section
aria-label={t`Terminal disabled`}
className="flex h-full w-full flex-col items-center justify-center gap-3 bg-background p-6 text-center"
>
<p className="max-w-sm text-sm text-foreground">
{t`The terminal is turned off for this project. Turn it back on to run commands here.`}
</p>
<Button
disabled={enableDisabled}
aria-describedby={enableDisabled ? pendingReasonId : undefined}
onClick={onEnable}
>
{t`Enable terminal`}
</Button>
{enableDisabled ? (
<p id={pendingReasonId} className="text-xs text-muted-foreground">
{t`Terminal settings not loaded yet — try again in a moment.`}
</p>
) : null}
<p className="text-xs text-muted-foreground">{t`You can also manage this in Settings.`}</p>
</section>
);
}