Skip to content

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.

1.8 KB
Raw Blame
import { isGroupBotMember, type BotId, type GroupMembership } from "@akeru/contracts";
import { collectComposerInlineTokens } from "@akeru/shared/composerInlineTokens";
import * as Effect from "effect/Effect";

/**
 * Group members named by `@bot:<id>` tokens in a message, latest mention first. Clients may
 * send the token without resolving it to respondingBotId. Plain `@Name` stays client-resolved.
 */
export function groupMentionCandidates(
  members: ReadonlyArray<GroupMembership>,
  text: string,
): ReadonlyArray<BotId> {
  const memberBotIds = members.flatMap((member) =>
    isGroupBotMember(member) ? [member.botId] : [],
  );

  const candidates: BotId[] = [];

  for (const token of collectComposerInlineTokens(`${text}\n`).toReversed()) {
    if (token.type !== "bot-mention") continue;
    const botId = memberBotIds.find((id) => id === token.value);

    if (botId !== undefined && !candidates.includes(botId)) candidates.push(botId);
  }

  return candidates;
}

/**
 * The bot a group turn addresses: an explicit respondingBotId, else the latest active member
 * mentioned by token, else the boss. The decider and the pre-dispatch provider and cap gates
 * share this so they always check the bot that will actually run.
 */
export const resolveGroupResponderBotId = <E, R>(input: {
  readonly group: {
    readonly members: ReadonlyArray<GroupMembership>;
    readonly bossBotId: BotId | null;
  };
  readonly respondingBotId: BotId | undefined;
  readonly text: string;
  readonly isActive: (botId: BotId) => Effect.Effect<boolean, E, R>;
}): Effect.Effect<BotId | null, E, R> =>
  Effect.gen(function* () {
    if (input.respondingBotId !== undefined) return input.respondingBotId;

    for (const botId of groupMentionCandidates(input.group.members, input.text)) {
      if (yield* input.isActive(botId)) return botId;
    }

    return input.group.bossBotId;
  });