Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
/**
* Composer `@browser` and `@chat:<id>` mentions: which chats the picker
* offers, and the bounded context a mention adds to the provider input.
*
* The composer stores only the token, so the WebSocket payload stays the
* size of the prompt. The server expands tokens at turn start from its own
* projection, capped by the budgets below.
*/
/** Recent turns read from a mentioned chat. */
export const THREAD_MENTION_TURN_LIMIT = 3;
/** Character budget for one mentioned chat's excerpt. */
export const THREAD_MENTION_MAX_CHARS = 4_000;
/** Character cap for a single message inside an excerpt. */
export const THREAD_MENTION_MAX_MESSAGE_CHARS = 1_200;
/** Chats expanded per prompt. Further mentions stay as plain references. */
export const THREAD_MENTION_MAX_THREADS = 3;
/** Distinct chat mentions the server looks up per prompt, including hidden or missing ones. */
export const THREAD_MENTION_MAX_LOOKUPS = 12;
/** Rows the composer picker shows for chats. */
export const THREAD_MENTION_PICKER_LIMIT = 6;
const DELEGATION_THREAD_ID_PREFIX = "delegation-thread-";
export interface ComposerThreadMentionCandidate {
readonly id: string;
readonly projectId: string;
readonly title: string;
readonly archivedAt: string | null;
readonly updatedAt?: string | undefined;
}
/**
* Chats a mention never reaches: deleted and archived chats, and background
* bot-work chats that delegation creates for its own bookkeeping. The picker
* uses this to filter its rows, and the server applies it again at turn start
* so a typed or pasted `@chat:<id>` cannot reach a hidden chat.
*/
export function isHiddenComposerThread(thread: {
readonly id: string;
readonly archivedAt: string | null;
readonly deletedAt?: string | null | undefined;
}): boolean {
return (
thread.archivedAt !== null ||
(thread.deletedAt ?? null) !== null ||
thread.id.startsWith(DELEGATION_THREAD_ID_PREFIX)
);
}
/**
* Filters and orders chats for the `@` picker: visible chats other than the
* current one whose title contains the query (or whose id is in `matchedIds`,
* from content search), current project first, then most recently updated.
*/
export function rankComposerThreadMentions<T extends ComposerThreadMentionCandidate>(
threads: ReadonlyArray<T>,
input: {
readonly query: string;
readonly currentThreadId: string | null;
readonly currentProjectId: string | null;
readonly matchedIds?: ReadonlySet<string>;
readonly limit?: number;
},
): T[] {
const query = input.query.trim().toLowerCase();
return [...threads]
.filter(
(thread) =>
thread.id !== input.currentThreadId &&
!isHiddenComposerThread(thread) &&
(query.length === 0 ||
thread.title.toLowerCase().includes(query) ||
input.matchedIds?.has(thread.id) === true),
)
.sort((left, right) => {
const leftLocal = left.projectId === input.currentProjectId ? 0 : 1;
const rightLocal = right.projectId === input.currentProjectId ? 0 : 1;
if (leftLocal !== rightLocal) return leftLocal - rightLocal;
return (right.updatedAt ?? "").localeCompare(left.updatedAt ?? "");
})
.slice(0, input.limit ?? THREAD_MENTION_PICKER_LIMIT);
}
export interface ThreadMentionMessage {
readonly role: "user" | "assistant" | "system";
readonly text: string;
}
export interface ThreadMentionSource {
readonly id: string;
readonly title: string;
readonly messages: ReadonlyArray<ThreadMentionMessage>;
}
function clip(text: string, max: number): string {
return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1)).trimEnd()}…`;
}
function escapeAttribute(value: string): string {
return value.replaceAll("&", "&").replaceAll('"', """).replaceAll("<", "<");
}
/**
* Builds one chat excerpt from its newest messages, keeping whole messages
* until `THREAD_MENTION_MAX_CHARS` is spent. The result never exceeds the
* budget plus the wrapper tag.
*/
export function buildThreadMentionExcerpt(source: ThreadMentionSource): string {
const lines: string[] = [];
let remaining = THREAD_MENTION_MAX_CHARS;
for (let index = source.messages.length - 1; index >= 0; index--) {
const message = source.messages[index];
if (message === undefined) continue;
if (message.role === "system") continue;
const body = message.text.trim();
if (body.length === 0) continue;
const speaker = message.role === "user" ? "User" : "Bot";
const line = `${speaker}: ${clip(body, THREAD_MENTION_MAX_MESSAGE_CHARS)}`;
if (line.length > remaining) {
if (remaining > 80) lines.push(clip(line, remaining));
break;
}
lines.push(line);
remaining -= line.length + 1;
}
const chronologicalLines: string[] = [];
for (let index = lines.length - 1; index >= 0; index--) {
const line = lines[index];
if (line !== undefined) chronologicalLines.push(line);
}
const body =
chronologicalLines.length > 0
? chronologicalLines.join("\n")
: "(This chat has no messages yet.)";
return `<chat_context id="${escapeAttribute(source.id)}" title="${escapeAttribute(source.title)}">\n${body}\n</chat_context>`;
}
/**
* Appends mention context to the provider input. `threads` holds the chats
* that could be read, in mention order; unreadable ones are simply absent.
*/
export function appendComposerMentionContext(
prompt: string,
input: {
readonly browser: "enabled" | "disabled" | null;
readonly threads: ReadonlyArray<ThreadMentionSource>;
},
): string {
const sections: string[] = [];
if (input.browser === "enabled") {
sections.push(
"The user mentioned @browser. Use your Akeru preview browser tools (preview_*) for this request. Do not start a separate browser.",
);
} else if (input.browser === "disabled") {
sections.push(
"The user mentioned @browser, but agent browser access is turned off in Settings, so you have no browser tools. Say so if the request needs a browser.",
);
}
for (const thread of input.threads.slice(0, THREAD_MENTION_MAX_THREADS)) {
sections.push(buildThreadMentionExcerpt(thread));
}
if (sections.length === 0) return prompt;
return `${prompt}\n\n<mention_context>\n${sections.join("\n")}\n</mention_context>`;
}