sailfork / t3code-github / apps/ mobile/ src/ features/ prompt-links/ newTaskPromptLink.ts

import * as Dialog from "../../components/ui/Dialog";
import {
  StackActions,
  type NavigationState,
  type PartialState,
  type StackActionType,
} from "@react-navigation/native";
import { availableScratchWorkspaceRoot } from "@t3tools/client-runtime/operations/projects";
import {
  findPromptLinkProjects,
  findPromptLinkPullRequestThread,
  resolvePromptLinkModelSelection,
} from "@t3tools/client-runtime/prompt-links";
import {
  executeAtomQuery,
  isAtomCommandInterrupted,
  runAtomCommand,
  squashAtomCommandFailure,
} from "@t3tools/client-runtime/state/runtime";
import type { EnvironmentProject } from "@t3tools/client-runtime/state/shell";
import type { EnvironmentId, ThreadId } from "@t3tools/contracts";
import {
  parseNewThreadLink,
  type LinkedPrompt,
  type PromptLinkPullRequest,
  type PromptLinkRepository,
} from "@t3tools/shared/promptLinks";
import { Atom, type AsyncResult } from "effect/reactivity";

import { findLinkedRoute, findStackRoute, updateLinkedRoute } from "../../lib/appLinking";
import { rootNavigationRef } from "../../lib/rootNavigation";
import { scopedThreadKey } from "../../lib/scopedEntities";
import { appAtomRegistry } from "../../state/atom-registry";
import { environmentProjects, projectEnvironment } from "../../state/projects";
import { composerPullRequests } from "../../state/pull-requests";
import { environmentServerConfigsAtom } from "../../state/server";
import { environmentThreadShells } from "../../state/threads";
import {
  createNewTaskDraft,
  setComposerDraftText,
  updateComposerDraftSettings,
  waitForComposerDraftsLoaded,
} from "../../state/use-composer-drafts";
import { workspaceConnections, workspaceStateAtom } from "../../state/workspace";
import { applyLinkedPromptToThreadDraft, showPromptLinkNotice } from "./prompt-link-actions";
import {
  latestThreadEnvironmentIds,
  promptLinkNotice,
  promptLinkRepositoryName,
  promptLinkScratchEnvironmentId,
  promptLinkSearchFromParams,
  stepPendingPromptLink,
  withoutPromptLinkParams,
} from "./prompt-link-model";

// Found at any depth, both in the parsed link and on the live stack, so the two never disagree on
// whether the link has landed.
const NEW_TASK_ROUTE = "NewTaskProject";
const NEW_TASK_ROUTES = [NEW_TASK_ROUTE];

type LinkedDraftRequest = {
  readonly prompt: LinkedPrompt | null;
  readonly provider: string | null;
  readonly model: string | null;
  readonly pullRequest: PromptLinkPullRequest | null;
};

// A cold launch from a link has no projects or threads yet. Matching then would offer to clone a
// repository the user already has.
const shellsSettledAtom = Atom.make((get) => {
  const workspace = get(workspaceStateAtom);
  return !(
    workspace.isLoadingConnections ||
    workspace.hasPendingShellSnapshot ||
    // A machine still connecting may hold the repository or thread. One that keeps failing to
    // reconnect has settled offline, and must not hold every link.
    workspace.connectingEnvironments.some(
      (environment) =>
        environment.connectionState === "connecting" || environment.connectionError === null,
    )
  );
}).pipe(Atom.withLabel("mobile:prompt-link-shells-settled"));

let pendingLink: string | null = null;
let stopWaitingForShells: (() => void) | null = null;

/**
 * `new?prompt=…&repo=…` drops its params as it arrives, so the screen never sees them and each
 * opening resolves once. It resolves when its screen is on the navigation state that follows and
 * the shells have settled; a newer link replaces one still waiting.
 */
export function takeNewTaskPromptLink(
  state: PartialState<NavigationState> | undefined,
): PartialState<NavigationState> | undefined {
  const route = findLinkedRoute(state, NEW_TASK_ROUTES);
  const search = promptLinkSearchFromParams(
    route?.params as Readonly<Record<string, unknown>> | undefined,
  );
  if (search === null) return state;
  pendingLink = search;
  return updateLinkedRoute(state, NEW_TASK_ROUTES, (linked) => ({
    ...linked,
    params: withoutPromptLinkParams(linked.params),
  }));
}

/** Wired to the navigation container's state changes. */
export function resolvePendingNewTaskPromptLink(state: NavigationState | undefined): void {
  if (pendingLink === null) return;
  const step = stepPendingPromptLink(pendingLink, {
    // A screen pushed above New task (such as Add project) drops the link, so it never lands
    // over the wrong screen.
    screenOnStack: findStackRoute(state, NEW_TASK_ROUTE)?.focused === true,
    ready: appAtomRegistry.get(shellsSettledAtom),
  });
  if (step.pending === null) dropPendingLink();
  else pendingLink = step.pending;
  if (step.resolve !== null) resolveLink(step.resolve);
  else if (step.pending !== null) {
    stopWaitingForShells ??= appAtomRegistry.subscribe(shellsSettledAtom, (settled) => {
      if (settled) resolvePendingNewTaskPromptLink(rootNavigationRef.getRootState());
    });
  }
}

function dropPendingLink(): void {
  pendingLink = null;
  stopWaitingForShells?.();
  stopWaitingForShells = null;
}

/** Dispatches as the new-task screen would, so `replace` swaps that screen out. */
function dispatchFromNewTask(action: StackActionType): void {
  const root = rootNavigationRef.getRootState();
  const screen = findStackRoute(root, NEW_TASK_ROUTE);
  const target = screen?.navigatorKey ?? root?.key;
  rootNavigationRef.dispatch({
    ...action,
    ...(target ? { target } : {}),
    ...(screen ? { source: screen.routeKey } : {}),
  });
}

function runQuery<A, E>(atom: Atom.Atom<AsyncResult.AsyncResult<A, E>>) {
  return executeAtomQuery(appAtomRegistry, atom, {
    label: atom.label?.[0] ?? "atom query",
    reportFailure: false,
  });
}

function writeDraft(
  draftKey: string,
  environmentId: EnvironmentId,
  request: LinkedDraftRequest,
): boolean {
  if (request.prompt) setComposerDraftText(draftKey, request.prompt.text);
  if (request.provider === null) return false;
  const resolved = resolvePromptLinkModelSelection(
    appAtomRegistry.get(environmentServerConfigsAtom).get(environmentId)?.providers ?? [],
    { provider: request.provider, model: request.model },
  );
  if (resolved) updateComposerDraftSettings(draftKey, { modelSelection: resolved.selection });
  return resolved?.exact !== true;
}

function openThread(
  thread: { readonly environmentId: EnvironmentId; readonly id: ThreadId },
  prompt: LinkedDraftRequest["prompt"],
) {
  dispatchFromNewTask(
    StackActions.replace("Thread", {
      environmentId: String(thread.environmentId),
      threadId: String(thread.id),
    }),
  );
  if (prompt) {
    void applyLinkedPromptToThreadDraft(
      scopedThreadKey(thread.environmentId, thread.id),
      prompt,
      promptLinkNotice({ hiddenCharacters: prompt.hiddenCharacters }),
    );
  }
}

// A pull request's thread can be an older settled thread no shell holds, so ask every
// connected environment with the repository. A lookup on another one would wait forever.
async function findServerPullRequestThread(
  projects: ReadonlyArray<EnvironmentProject>,
  pullRequest: PromptLinkPullRequest,
) {
  const connected = new Set(
    appAtomRegistry
      .get(workspaceConnections.environmentsAtom)
      .filter((environment) => environment.connectionState === "connected")
      .map((environment) => environment.environmentId),
  );
  const lookups = projects
    .filter((project) => connected.has(project.environmentId))
    .map(async (project) => {
      const linked = await runQuery(
        composerPullRequests.linkedThreadsUncached({
          environmentId: project.environmentId,
          input: {
            projectId: project.id,
            repository: promptLinkRepositoryName(pullRequest),
            number: pullRequest.number,
          },
        }),
      );
      const thread =
        linked._tag === "Success"
          ? linked.value.threads.find((candidate) => candidate.archivedAt === null)
          : undefined;
      return thread && { environmentId: project.environmentId, id: thread.id };
    });
  // The most recent project wins without waiting for the lookups after it.
  for (const lookup of lookups) {
    const thread = await lookup;
    if (thread) return thread;
  }
  return undefined;
}

async function openProjectDraft(project: EnvironmentProject, request: LinkedDraftRequest) {
  try {
    await waitForComposerDraftsLoaded();
  } catch {
    Dialog.alert("Could not open link", "Drafts could not be loaded, so the prompt was not added.");
    return;
  }
  const draftKey = createNewTaskDraft({
    environmentId: project.environmentId,
    projectId: project.id,
  });
  let pullRequestUnavailable: number | null = null;
  if (request.pullRequest) {
    const detail = await runQuery(
      composerPullRequests.detail({
        environmentId: project.environmentId,
        input: {
          projectId: project.id,
          repository: promptLinkRepositoryName(request.pullRequest),
          number: request.pullRequest.number,
        },
      }),
    );
    if (detail._tag === "Success") {
      updateComposerDraftSettings(draftKey, {
        workspaceSelection: {
          mode: "worktree",
          branch: detail.value.headBranch,
          worktreePath: null,
          startFromOrigin: false,
          pullRequestReference: detail.value.url,
        },
      });
    } else {
      pullRequestUnavailable = request.pullRequest.number;
    }
  }
  const modelUnavailable = writeDraft(draftKey, project.environmentId, request);
  dispatchFromNewTask(
    StackActions.push("Thread", {
      draft: {
        draftId: draftKey,
        title: request.pullRequest ? `PR #${request.pullRequest.number}` : project.title,
      },
    }),
  );
  if (request.prompt || pullRequestUnavailable !== null || modelUnavailable) {
    showPromptLinkNotice(
      promptLinkNotice({
        hiddenCharacters: request.prompt?.hiddenCharacters ?? 0,
        modelUnavailable,
        pullRequestUnavailable,
      }),
    );
  }
}

async function openScratchDraft(request: LinkedDraftRequest) {
  const serverConfigs = appAtomRegistry.get(environmentServerConfigsAtom);
  const environmentId = promptLinkScratchEnvironmentId(
    latestThreadEnvironmentIds(appAtomRegistry.get(environmentThreadShells.threadShellsAtom)),
    appAtomRegistry
      .get(workspaceConnections.environmentsAtom)
      .filter(
        (environment) =>
          availableScratchWorkspaceRoot(
            environment.connectionState,
            serverConfigs.get(environment.environmentId),
          ) !== null,
      )
      .map((environment) => environment.environmentId),
  );
  if (environmentId === null) {
    Dialog.alert(
      "Could not start without a project",
      "No connected environment offers threads without a project.",
    );
    return;
  }
  const result = await runAtomCommand(
    appAtomRegistry,
    projectEnvironment.openScratch,
    { environmentId, input: {} },
    { reportFailure: false },
  );
  if (result._tag === "Failure") {
    if (!isAtomCommandInterrupted(result)) {
      const error = squashAtomCommandFailure(result);
      Dialog.alert(
        "Could not start without a project",
        error instanceof Error
          ? error.message
          : "The folder for threads without a project could not be created.",
      );
    }
    return;
  }
  await openProjectDraft(result.value, { ...request, pullRequest: null });
}

function cloneRepository(repository: PromptLinkRepository, request: LinkedDraftRequest) {
  // The clone screen lets the user pick another environment before cloning.
  const environmentId =
    appAtomRegistry.get(environmentProjects.projectsAtom)[0]?.environmentId ??
    appAtomRegistry.get(workspaceConnections.environmentsAtom)[0]?.environmentId ??
    null;
  if (environmentId === null) {
    Dialog.alert("Could not clone", "Connect an environment first.");
    return;
  }
  const prompt =
    request.pullRequest === null &&
    appAtomRegistry.get(environmentServerConfigsAtom).has(environmentId)
      ? request.prompt
      : null;
  const name = promptLinkRepositoryName(repository);
  dispatchFromNewTask(
    StackActions.push("AddProjectDestination", {
      environmentId,
      remoteUrl: `https://github.com/${name}.git`,
      repositoryTitle: name,
      repositoryName: repository.name,
      ...(prompt ? { prompt: prompt.text } : {}),
    }),
  );
  if (!request.prompt) return;
  showPromptLinkNotice(
    [
      promptLinkNotice({
        hiddenCharacters: request.prompt.hiddenCharacters,
        modelUnavailable: prompt !== null && request.provider !== null,
      }),
      prompt
        ? "The prompt opens in a new task once the clone starts."
        : "Open the link again after the clone to get the prompt.",
    ].join("\n\n"),
  );
}

function resolveLink(linkSearch: string) {
  const threads = appAtomRegistry.get(environmentThreadShells.threadShellsAtom);
  const parsed = parseNewThreadLink(linkSearch);
  if (!parsed.ok) {
    Dialog.alert("Could not open link", parsed.error);
    return;
  }
  const link = parsed.value;
  const request: LinkedDraftRequest =
    link.kind === "new"
      ? { prompt: link.prompt, provider: link.provider, model: link.model, pullRequest: null }
      : { prompt: link.prompt, provider: null, model: null, pullRequest: link.pullRequest };

  if (link.kind === "pull-request") {
    const thread = findPromptLinkPullRequestThread(threads, link.pullRequest);
    if (thread) {
      openThread(thread, link.prompt);
      return;
    }
  }

  const repository = link.kind === "new" ? link.repository : link.pullRequest;
  if (repository === null) {
    void openScratchDraft(request);
    return;
  }
  const lastActivity = new Map<string, string>();
  for (const thread of threads) {
    const key = `${thread.environmentId}:${thread.projectId}`;
    if (thread.updatedAt > (lastActivity.get(key) ?? "")) lastActivity.set(key, thread.updatedAt);
  }
  const activityOf = (project: EnvironmentProject) =>
    lastActivity.get(`${project.environmentId}:${project.id}`) ?? "";
  const projects = findPromptLinkProjects(
    [...appAtomRegistry.get(environmentProjects.projectsAtom)].sort((left, right) =>
      activityOf(right).localeCompare(activityOf(left)),
    ),
    repository,
  );
  const project = projects[0];
  if (project) {
    const { pullRequest } = request;
    void (async () => {
      const thread = pullRequest && (await findServerPullRequestThread(projects, pullRequest));
      if (thread) openThread(thread, request.prompt);
      else await openProjectDraft(project, request);
    })();
    return;
  }
  Dialog.alert(`You don't have ${promptLinkRepositoryName(repository)}`, undefined, [
    { text: "Cancel", style: "cancel" },
    ...(request.prompt
      ? [{ text: "Use without project", onPress: () => void openScratchDraft(request) }]
      : []),
    { text: "Clone", onPress: () => cloneRepository(repository, request) },
  ]);
}