import type { PromptLinkRepository } from "@t3tools/shared/promptLinks";
const PROMPT_LINK_PARAM_KEYS = ["prompt", "repo", "pr", "provider", "model"] as const;
type RouteParams = Readonly<Record<string, unknown>> | undefined;
export function promptLinkSearchFromParams(
params: RouteParams,
keys: ReadonlyArray<string> = PROMPT_LINK_PARAM_KEYS,
): string | null {
const search = new URLSearchParams();
for (const key of keys) {
const raw = params?.[key];
const value = Array.isArray(raw) ? raw[0] : raw;
if (typeof value === "string") search.set(key, value);
}
return search.size > 0 ? search.toString() : null;
}
export function withoutPromptLinkParams(params: object | undefined): Record<string, unknown> {
return Object.fromEntries(
Object.entries(params ?? {}).filter(
([key]) => !(PROMPT_LINK_PARAM_KEYS as ReadonlyArray<string>).includes(key),
),
);
}
export function promptLinkNotice(input: {
readonly hiddenCharacters: number;
readonly modelUnavailable?: boolean;
readonly pullRequestUnavailable?: number | null;
}): string {
return [
input.hiddenCharacters > 0
? "This prompt had hidden characters, it may be malicious. They were removed. Read it before you send."
: "This prompt came from a link. Read it before you send.",
input.modelUnavailable
? "The requested model is not available, so your default is used."
: null,
input.pullRequestUnavailable != null
? `Pull request #${input.pullRequestUnavailable} could not be loaded, so this task starts from your default branch.`
: null,
]
.filter((line) => line !== null)
.join("\n\n");
}
export function linkedThreadDraftAction(currentText: string, prompt: string) {
if (currentText.trim().length === 0) return "fill" as const;
return currentText === prompt ? ("keep" as const) : ("ask" as const);
}
export function promptLinkScratchEnvironmentId<Id extends string>(
environmentIdsMostRecentFirst: ReadonlyArray<Id>,
scratchEnvironmentIds: ReadonlyArray<Id>,
): Id | null {
return (
environmentIdsMostRecentFirst.find((id) => scratchEnvironmentIds.includes(id)) ??
scratchEnvironmentIds[0] ??
null
);
}
export function latestThreadEnvironmentIds<Id extends string>(
threads: ReadonlyArray<{ readonly environmentId: Id; readonly updatedAt: string }>,
): ReadonlyArray<Id> {
const latest = new Map<Id, string>();
for (const thread of threads) {
if (thread.updatedAt > (latest.get(thread.environmentId) ?? "")) {
latest.set(thread.environmentId, thread.updatedAt);
}
}
return Array.from(latest.keys()).sort((left, right) =>
(latest.get(right) ?? "").localeCompare(latest.get(left) ?? ""),
);
}
export const promptLinkRepositoryName = (repository: PromptLinkRepository) =>
`${repository.owner}/${repository.name}`;
/**
* Advances a parsed link at each navigation state; `resolve` is the link to apply. The first
* state after the parse must hold the link's screen. A link that never lands there, or whose
* screen is left before its target is ready, is dropped so it cannot apply on a later visit.
*/
export function stepPendingPromptLink<Link>(
link: Link,
input: { readonly screenOnStack: boolean; readonly ready: boolean },
): { readonly pending: Link | null; readonly resolve: Link | null } {
if (!input.screenOnStack) return { pending: null, resolve: null };
if (input.ready) return { pending: null, resolve: link };
return { pending: link, resolve: null };
}