Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

3.6 KB
Raw Blame
import type { AttachmentPart, ThreadInfo } from '@inkeep/open-knowledge-core/acp/thread-protocol';
import { t } from '@lingui/core/macro';
import { toast } from 'sonner';
import { agentDisplayName } from '@/lib/acp/agent-display';
import { getAgentThreadClient, ThreadChannelUnavailableError } from '@/lib/acp/thread-client';
import {
  stageThreadDraft,
  stageThreadDraftContent,
  type ThreadDraftContent,
} from '@/lib/acp/thread-draft-staging';

const inflightLaunches = new Set<string>();
const IMAGE_CAPABILITY_WATCH_MS = 60_000;

export type ThreadLaunchOutcome = 'started' | 'deduped' | 'failed';

function warnWhenLaunchedImagesAreUnsupported(
  info: ThreadInfo,
  attachments: readonly AttachmentPart[] | undefined,
): void {
  if (attachments === undefined || !attachments.some((part) => part.kind === 'image')) return;
  const client = getAgentThreadClient();
  const agentName = agentDisplayName(info.agent.name);
  let unsubscribe: (() => void) | null = null;
  const timer = setTimeout(() => {
    if (unsubscribe !== null) {
      console.warn(
        '[agent-threads] image capability still unknown for',
        info.threadId,
        'after the watch window — skipping the attachment warning',
      );
    }
    unsubscribe?.();
    unsubscribe = null;
  }, IMAGE_CAPABILITY_WATCH_MS);
  const check = (): void => {
    if (unsubscribe === null) return;
    const capabilities = client.getThread(info.threadId)?.info.promptCapabilities;
    if (capabilities === null || capabilities === undefined) return;
    clearTimeout(timer);
    unsubscribe();
    unsubscribe = null;
    if (capabilities.image !== true) {
      toast.error(t`${agentName} doesn't accept image attachments.`);
    }
  };
  unsubscribe = client.subscribe(check);
  check();
}

export function launchAgentThread(
  agent: { source: 'registry' | 'custom'; id: string },
  prompt: string | null,
  docName: string | null,
  titleHint: string | null,
  stageDraft?: string | ThreadDraftContent | null,
  attachments?: readonly AttachmentPart[],
  onCreated?: (info: ThreadInfo) => void,
): Promise<ThreadLaunchOutcome> {
  const launchKey = `${agent.source}:${agent.id}`;
  if (inflightLaunches.has(launchKey)) return Promise.resolve('deduped');
  inflightLaunches.add(launchKey);
  const client = getAgentThreadClient();
  const request = {
    agent,
    prompt: prompt ?? undefined,
    docName: docName ?? undefined,
    titleHint: titleHint ?? undefined,
    ...(attachments !== undefined && attachments.length > 0 ? { attachments } : {}),
  };
  return client
    .createThread(request, onCreated)
    .then((info) => {
      warnWhenLaunchedImagesAreUnsupported(info, attachments);
      if (stageDraft != null) {
        try {
          if (typeof stageDraft === 'string') stageThreadDraft(info.threadId, stageDraft);
          else stageThreadDraftContent(info.threadId, stageDraft);
        } catch (err) {
          console.error('[agent-threads] draft staging failed for', info.threadId, err);
        }
      }
      return 'started' as const;
    })
    .catch((err) => {
      console.error('[agent-threads] launch failed:', err);
      toast.error(
        err instanceof ThreadChannelUnavailableError
          ? t`Couldn't connect to the agent service. Make sure the OpenKnowledge server is running and up to date (restart it if it was already running), then try again.`
          : t`Couldn't start the agent thread — please try again.`,
      );
      return 'failed' as const;
    })
    .finally(() => {
      inflightLaunches.delete(launchKey);
    });
}

export function hasInflightThreadLaunch(): boolean {
  return inflightLaunches.size > 0;
}