Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

feat(bots): 理顺伙伴与群聊入口,点开邀请即可加入,私聊可拉伙伴进群 (#6013)

Dash23c15643b93e
diff --git a/apps/desktop/src/main/__tests__/deepLink.test.ts b/apps/desktop/src/main/__tests__/deepLink.test.ts
index 5c94c61cb2..092bc10d44 100644
--- a/apps/desktop/src/main/__tests__/deepLink.test.ts
+++ b/apps/desktop/src/main/__tests__/deepLink.test.ts
@@ -84,9 +84,24 @@ describe('chat invitation handoff', () => {
it('recognizes the existing generated link and rejects ambiguous targets', () => {
expect(parseDeepLink(link)).toEqual({ type: 'chat-invite', token });
expect(parseDeepLink(link.replace('cindy:', 'xdt-maker:'))).toEqual({ type: 'chat-invite', token });
- for (const value of [link + '/extra', link + '?token=other', link + '#secret', link + 'a', link.slice(0, -1)]) {
- expect(parseDeepLink(value)).toBeNull();
+ // A damaged invitation never yields a token, but the click is reported instead of ignored.
+ for (const value of [link + '/extra', link + '?token=other', link + '#secret', link + 'a', link.slice(0, -1), 'cindy://chat-invite/']) {
+ expect(parseDeepLink(value)).toEqual({ type: 'chat-invite-malformed' });
}
+ expect(parseDeepLink('cindy://chat-invite')).toBeNull();
+ });
+ it('queues one malformed-link notice behind valid invitations without logging the link', () => {
+ setDeepLinkMainWindow(null);
+ const damaged = link.slice(0, -3);
+ handleIncomingDeepLink(damaged, 'open-url');
+ handleIncomingDeepLink(link, 'open-url');
+ handleIncomingDeepLink(damaged + 'x', 'second-instance');
+ handleIncomingDeepLink('cindy://session/ordinary-task', 'open-url');
+ expect(takePendingDeepLink()).toEqual({ type: 'chat-invite-malformed' });
+ expect(takePendingDeepLink()).toEqual({ type: 'chat-invite', token });
+ expect(takePendingDeepLink()).toEqual({ type: 'session', id: 'ordinary-task' });
+ expect(takePendingDeepLink()).toBeNull();
+ expect(JSON.stringify(Object.values(logs).map(log => log.mock.calls))).not.toContain(damaged.slice('cindy://chat-invite/'.length));
});
it.each(['open-url', 'cold-start-argv', 'second-instance'])('retains %s through login focus and unrelated navigation', source => {
setDeepLinkMainWindow(null);
diff --git a/apps/desktop/src/main/deepLink.ts b/apps/desktop/src/main/deepLink.ts
index f738af44ce..e359de2b68 100644
--- a/apps/desktop/src/main/deepLink.ts
+++ b/apps/desktop/src/main/deepLink.ts
@@ -3,7 +3,8 @@
* ---------------------------------------------------------------------------
* URL 形态(scheme 单点在 shared/deepLinkSchemes.ts:生成一律主 scheme cindy://,
* 解析主 + 历史 scheme 都认——存量消息里的 xdt-maker:// 老链接不能死):
- * cindy://chat-invite/<token> —— 预填群邀请,预览后由用户确认加入
+ * cindy://chat-invite/<token> —— 打开群邀请,自动预览后由用户确认加入;
+ * 口令残缺时只回报「链接无效」,不带链接内容
* cindy://session/<sessionId> —— sessionId 直接是 string id
* cindy://project/<urlencoded-workingDir> —— workingDir 全路径 URL-encoded
* cindy://settings/providers[?connect=<providerId>] —— 打开设置「模型供应商」页,
@@ -67,6 +68,8 @@ export const OPEN_SHARE_FILE_FLAG = '--open-share-file';
export type DeepLinkPayload =
| { type: 'chat-invite'; token: string }
+ /** 点开的群邀请链接口令残缺或被改动:不带任何链接内容,只让 Renderer 明确告知。 */
+ | { type: 'chat-invite-malformed' }
| { type: 'shared-task-join'; invitation: string; server: string }
/** 供应商分享链接:原样交给 Renderer 的申请弹窗,由主进程命令再解析与核对区域。 */
| { type: 'provider-share-join'; link: string }
@@ -115,7 +118,7 @@ export function parseDeepLink(url: string): DeepLinkPayload | null {
const rest = url.slice(prefix.length);
if (rest.startsWith('chat-invite/')) {
const token = rest.slice('chat-invite/'.length);
- return /^[A-Za-z0-9_-]{43}$/.test(token) ? { type: 'chat-invite', token } : null;
+ return /^[A-Za-z0-9_-]{43}$/.test(token) ? { type: 'chat-invite', token } : { type: 'chat-invite-malformed' };
}
// provider/import 是双段精确路径,必须在通用 type/value 解析前消费。
if (rest.startsWith('provider/')) {
@@ -282,7 +285,7 @@ export function buildFocusDeepLink(source: string): string {
// 直接 webContents.send,不进 pending
let pendingDeepLink: DeepLinkPayload | null = null;
// Invitation targets must survive unrelated navigation and login focus callbacks.
-const pendingChatInvitations: Array<Extract<DeepLinkPayload, { type: 'chat-invite' }>> = [];
+const pendingChatInvitations: Array<Extract<DeepLinkPayload, { type: 'chat-invite' | 'chat-invite-malformed' }>> = [];
let mainWindowRef: BrowserWindow | null = null;
export function setDeepLinkMainWindow(win: BrowserWindow | null): void {
@@ -440,8 +443,9 @@ function dispatchDeepLink(payload: DeepLinkPayload, shouldFocus = true): void {
}
const win = mainWindowRef;
const windowReady = win && !win.isDestroyed() && win.webContents && !win.webContents.isLoading();
- if (payload.type === 'chat-invite') {
- if (!pendingChatInvitations.some(invitation => invitation.token === payload.token)) {
+ if (payload.type === 'chat-invite' || payload.type === 'chat-invite-malformed') {
+ if (!pendingChatInvitations.some(invitation => invitation.type === payload.type
+ && (payload.type === 'chat-invite-malformed' || (invitation.type === 'chat-invite' && invitation.token === payload.token)))) {
pendingChatInvitations.push(payload);
}
if (shouldFocus) focusMainWindow();
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/chatServer.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/chatServer.test.ts
index bb8cea44fc..fee7ac0ec3 100644
--- a/apps/desktop/src/main/maker-ipc/__tests__/chatServer.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/chatServer.test.ts
@@ -1378,6 +1378,12 @@ describe('Chat Server directed sends', () => {
return entry === 'thread' ? service.chatServer!.reply({ ...input, rootId }) : service.sendMessage(input);
};
+ it('maps each owned Chat Server actor back to its local teammate for entry points outside group settings', async () => {
+ const result = await service.chatServer!.ownedBots();
+ expect(result).toMatchObject({ ok: true });
+ expect(result.ok && result.bots.some(bot => bot.botId === 'local-bot' && typeof bot.actorId === 'string')).toBe(true);
+ });
+
it.each(['main', 'thread'])('rejects a selected bot that left before the %s send instead of posting empty mentions', async entry => {
await service.chatServer!.ownedBots();
members[1]!.state = 'left';
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/chatServerInvitations.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/chatServerInvitations.test.ts
index 00ca0d28f1..b543fe7807 100644
--- a/apps/desktop/src/main/maker-ipc/__tests__/chatServerInvitations.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/chatServerInvitations.test.ts
@@ -83,6 +83,34 @@ describe('Chat Server invitation contract', () => {
reusable = flag;
expect(await service.chatServer!.createInvite({ groupId, clientId })).toEqual({ ok: false, errorCode: 'CHAT_RESPONSE_INVALID' });
});
+ it('previews and accepts the public page link through this account’s own Chat Server with only the token', async () => {
+ const page = `https://device-link.other-region.example/chat-invite/join#${token}?app=cindycn`;
+ fixture.urls.length = 0;
+ expect((await service.chatServer!.previewInvite({ link: `邀请你加入群聊:${page}` })).ok).toBe(true);
+ const accepted = vi.fn(() => ({ body: { groupId } }));
+ const original = fixture.handle.getMockImplementation()!;
+ fixture.handle.mockImplementation((route, ...rest) => route === '/invite-links/accept' ? accepted() : original(route, ...rest));
+ expect(await service.chatServer!.acceptInvite({ link: page, clientId })).toEqual({ ok: true, groupId });
+ expect(fixture.handle).toHaveBeenCalledWith('/invite-links/preview', 'POST', { token }, expect.anything());
+ expect(fixture.handle).toHaveBeenCalledWith('/invite-links/accept', 'POST', { token, operationId: clientId }, expect.anything());
+ // The link's host is never a request target, and the token never enters a URL.
+ expect(fixture.urls.every(url => url.startsWith('https://chat.cindy.app/'))).toBe(true);
+ expect(fixture.urls.some(url => url.includes(token))).toBe(false);
+ });
+ it.each([
+ `https://relay.example.test/chat-invite/join?t=1#${token}`,
+ `https://[email protected]/chat-invite/join#${token}`,
+ `https://relay.example.test/chat-invite/join#${token}?app=other`,
+ `https://relay.example.test/chat-invite/join#${token}#more`,
+ `ftp://relay.example.test/chat-invite/join#${token}`,
+ `cindy://chat-invite/${token.slice(1)}`,
+ ])('rejects %s before contacting the service and without echoing the token', async input => {
+ for (const result of [await service.chatServer!.previewInvite({ link: input }), await service.chatServer!.acceptInvite({ link: input, clientId })]) {
+ expect(result).toEqual({ ok: false, errorCode: 'INVALID_INPUT' });
+ expect(JSON.stringify(result)).not.toContain(token.slice(1));
+ }
+ expect(fixture.handle.mock.calls.some(([route]) => String(route).startsWith('/invite-links/'))).toBe(false);
+ });
it('preserves server denial and never accepts an invitation during preview', async () => {
fixture.handle.mockImplementation(route => route === '/invite-links/preview'
? { status: 404, body: { error: { code: 'INVITATION_NOT_FOUND' } } } : { body: [] });
diff --git a/apps/desktop/src/main/maker-ipc/chatServer.ts b/apps/desktop/src/main/maker-ipc/chatServer.ts
index 8c3d7e28e5..b86ef2e2fc 100644
--- a/apps/desktop/src/main/maker-ipc/chatServer.ts
+++ b/apps/desktop/src/main/maker-ipc/chatServer.ts
@@ -6,6 +6,7 @@ import { getClientEndpoint } from '../clientEndpointsService.js';
import { readFile as readMedia } from '../cindy-media/blobStore.js';
import { getAccessToken, refresh } from '../authManager.js';
import { retryAfterDeadline } from '@cindy/auth-client';
+import { parseChatInvitationToken } from '@cindy/device-link';
import { existsSync, readFileSync } from 'node:fs';
import { request as httpRequest } from 'node:http';
import { request as httpsRequest } from 'node:https';
@@ -1278,9 +1279,9 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceD
try { return { ok: true as const, ...await fn() }; }
catch (error) { return { ok: false as const, errorCode: error instanceof z.ZodError ? 'INVALID_INPUT' : error instanceof Error ? error.message : 'REQUEST_FAILED' }; }
};
- const inviteToken = (link: string) => z.string().regex(/^[A-Za-z0-9_-]{43}$/).parse(
- z.string().max(100).parse(link).trim().replace(/^cindy:\/\/chat-invite\//, ''),
- );
+ // Bare token, cindy://chat-invite/<token> or the public https page link; only the token
+ // reaches this account's own Chat Server. An unreadable link is INVALID_INPUT.
+ const inviteToken = (link: string) => z.string().regex(/^[A-Za-z0-9_-]{43}$/).parse(parseChatInvitationToken(link) ?? '');
// Null is the server's non-expiring contract; omitted/invalid dates are never
// treated as permanent links. Older servers keep their dated, single-use links.
const inviteExpiry = z.string().refine(value => Number.isFinite(Date.parse(value))).nullable();
@@ -1294,7 +1295,7 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceD
}
const operationId = z.string().min(8).max(160).regex(/^[a-zA-Z0-9_.:-]+$/);
const chatServer: ChatServerApi = {
- ownedBots: () => result(async () => { await register(); return { bots: actors.filter(a => a.kind === 'bot' && localBot(a.id)?.status === 'active').map(a => ({ actorId: a.id, name: a.name })) }; }),
+ ownedBots: () => result(async () => { await register(); return { bots: actors.flatMap(a => { const bot = a.kind === 'bot' ? localBot(a.id) : undefined; return bot?.status === 'active' ? [{ actorId: a.id, botId: bot.id, name: a.name }] : []; }) }; }),
refreshProfile: () => result(async () => {
await api('/profile/refresh', 'POST'); profileRefreshedAt = Date.now();
for (const roomId of rooms.keys()) changed(roomId);
diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.ts
index 36ff986801..ef28085c2a 100644
--- a/apps/desktop/src/preload/preload.ts
+++ b/apps/desktop/src/preload/preload.ts
@@ -3795,6 +3795,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
| { type: 'provider-import'; importId: string }
| { type: 'shared-task-join'; invitation: string; server: string }
| { type: 'chat-invite'; token: string }
+ | { type: 'chat-invite-malformed' }
| { type: 'settings'; tab: 'voice-input' | 'providers'; connect?: string },
) => void,
): (() => void) =>
@@ -3836,6 +3837,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
});
} else if (p.type === 'chat-invite' && typeof p.token === 'string' && /^[A-Za-z0-9_-]{43}$/.test(p.token)) {
callback({ type: 'chat-invite', token: p.token });
+ } else if (p.type === 'chat-invite-malformed') {
+ callback({ type: 'chat-invite-malformed' });
} else if (p.type === 'shared-task-join' && typeof p.invitation === 'string' && /^[A-Za-z0-9_-]{43}$/.test(p.invitation) && typeof p.server === 'string' && p.server.length <= 2048) {
callback({ type: 'shared-task-join', invitation: p.invitation, server: p.server });
} else if (
@@ -3876,6 +3879,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
| { type: 'provider-import'; importId: string }
| { type: 'shared-task-join'; invitation: string; server: string }
| { type: 'chat-invite'; token: string }
+ | { type: 'chat-invite-malformed' }
| { type: 'settings'; tab: 'voice-input' | 'providers'; connect?: string }
| null
> => ipcRenderer.invoke('deep-link:take-pending'),
diff --git a/apps/desktop/src/renderer/components/layout/MainLayout.tsx b/apps/desktop/src/renderer/components/layout/MainLayout.tsx
index d963c8ded7..1d083b9d3c 100644
--- a/apps/desktop/src/renderer/components/layout/MainLayout.tsx
+++ b/apps/desktop/src/renderer/components/layout/MainLayout.tsx
@@ -1,5 +1,5 @@
import { drainPendingDeepLinks } from '@/lib/pendingDeepLinks';
-import { ChatInviteHost, requestChatInvite } from '@/features/bots/ChatInviteHost';
+import { ChatInviteHost, reportMalformedChatInvite, requestChatInvite } from '@/features/bots/ChatInviteHost';
import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
import { buildSharedTaskInvitationLink } from '@cindy/device-link';
import { JoinSharedTaskDialog } from '@/features/device-link/JoinSharedTaskDialog';
@@ -640,6 +640,7 @@ export function MainLayout() {
| { type: 'provider-import'; importId: string }
| { type: 'shared-task-join'; invitation: string; server: string }
| { type: 'chat-invite'; token: string }
+ | { type: 'chat-invite-malformed' }
| { type: 'provider-share-join'; link: string }
| { type: 'settings'; tab: 'voice-input' | 'providers' | 'billing'; connect?: string; intent?: 'topup' },
) => {
@@ -647,6 +648,10 @@ export function MainLayout() {
requestChatInvite(payload.token);
return;
}
+ if (payload.type === 'chat-invite-malformed') {
+ reportMalformedChatInvite();
+ return;
+ }
if (payload.type === 'provider-share-join') {
requestProviderShareJoin(payload.link);
return;
@@ -711,7 +716,7 @@ export function MainLayout() {
useEffect(() => {
const unsubscribe = window.electronAPI.onDeepLinkNavigate((payload) => {
- if (payload.type === 'chat-invite') {
+ if (payload.type === 'chat-invite' || payload.type === 'chat-invite-malformed') {
void pullChatInvitations();
return;
}
diff --git a/apps/desktop/src/renderer/features/bots/BotAddToGroupMenu.tsx b/apps/desktop/src/renderer/features/bots/BotAddToGroupMenu.tsx
new file mode 100644
index 0000000000..aa8d646831
--- /dev/null
+++ b/apps/desktop/src/renderer/features/bots/BotAddToGroupMenu.tsx
@@ -0,0 +1,134 @@
+/**
+ * The private chat's way into group chat: start a new group with this teammate
+ * already picked, or bring them into a group you are in. It reuses the group
+ * creation dialog and the same member invitation the group settings use, so the
+ * server's membership rules stay the only authority. The private chat itself is
+ * untouched — group lanes never carry its history.
+ */
+import { useRef, useState } from 'react';
+import { MessagesSquare, UserPlus, Users } from 'lucide-react';
+import { useNavigate } from 'react-router-dom';
+import { useTranslation } from 'react-i18next';
+
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuLabel,
+ DropdownMenuSub,
+ DropdownMenuSubContent,
+ DropdownMenuSubTrigger,
+ DropdownMenuTrigger,
+} from '@/components/ui/dropdown-menu';
+import { WINDOW_NO_DRAG_STYLE } from '@/components/layout/windowDrag';
+import { getDataOwnerGeneration, isDataOwnerGenerationCurrent } from '@/contexts/dataOwnerGeneration';
+import { toast } from '@/lib/toast';
+import { BotGroupCreateDialog, isSelectable } from './BotGroupCreateDialog';
+import { refreshBotGroups, useBotGroupList } from './botGroupStore';
+import { useBotProfiles } from './botStore';
+import { chatErrorKey } from './chatError';
+
+const key = (name: string) => `bots.groupChat.addFromChat.${name}`;
+const groupRoute = (id: string) => `/bots/groups/${encodeURIComponent(id)}`;
+
+export function BotAddToGroupMenu({ botId }: { botId: string }) {
+ const { t } = useTranslation();
+ const navigate = useNavigate();
+ const bot = useBotProfiles().find(profile => profile.id === botId);
+ const { groups } = useBotGroupList();
+ const [creating, setCreating] = useState(false);
+ const [menuOpen, setMenuOpen] = useState(false);
+ const [busy, setBusy] = useState(false);
+ const busyRef = useRef(false);
+ const trigger = useRef<HTMLButtonElement>(null);
+ // A paused, disabled or archived teammate cannot join anything: no entry rather than a dead one.
+ if (!bot || !isSelectable(bot)) return null;
+ const joinable = groups.filter(group => group.serverBacked && !group.archived
+ && !group.members.some(member => member.botId === botId));
+
+ async function addTo(groupId: string, groupName: string) {
+ if (busyRef.current) return;
+ busyRef.current = true; setBusy(true);
+ const owner = getDataOwnerGeneration();
+ const failed = (code: string) => { if (isDataOwnerGenerationCurrent(owner)) toast.error(t(chatErrorKey(code))); };
+ try {
+ const api = window.electronAPI.maker.chatServer;
+ const owned = await api.ownedBots();
+ if (!isDataOwnerGenerationCurrent(owner)) return;
+ if (!owned.ok) { failed(owned.errorCode); return; }
+ const actorId = owned.bots.find(candidate => candidate.botId === botId)?.actorId;
+ if (!actorId) { toast.error(t(key('unavailable'), { name: bot!.name })); return; }
+ const result = await api.manage({ groupId, action: { type: 'member', actorId, action: 'invite' } });
+ if (!isDataOwnerGenerationCurrent(owner)) return;
+ if (!result.ok) { failed(result.errorCode); return; }
+ refreshBotGroups();
+ toast.success(t(key('added'), { name: bot!.name, group: groupName }), {
+ // Long enough to reach the action; hover and focus pause it further.
+ duration: 6000,
+ // The toast outlives this account: after a switch its group belongs to someone else.
+ action: { label: t(key('openGroup')), onClick: () => { if (isDataOwnerGenerationCurrent(owner)) navigate(groupRoute(groupId)); } },
+ });
+ } catch {
+ failed('REQUEST_FAILED');
+ } finally {
+ busyRef.current = false; setBusy(false);
+ }
+ }
+
+ const label = t(key('triggerFor'), { name: bot.name });
+ return (
+ <>
+ {/* busyRef flips before focus returns to the trigger, so a repeated Enter cannot reopen
+ the menu while the previous addition is still pending. */}
+ <DropdownMenu open={menuOpen} onOpenChange={open => {
+ if (open && busyRef.current) return;
+ if (open) refreshBotGroups();
+ setMenuOpen(open);
+ }}>
+ <DropdownMenuTrigger asChild>
+ <button
+ ref={trigger}
+ type="button"
+ aria-label={label}
+ title={label}
+ disabled={busy}
+ className="flex h-7 w-7 shrink-0 items-center justify-center rounded-full text-[var(--text-tertiary)] hover:bg-[var(--surface-hover)] hover:text-[var(--text-primary)] disabled:opacity-50"
+ style={WINDOW_NO_DRAG_STYLE}
+ >
+ <UserPlus size={15} />
+ </button>
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="end" onCloseAutoFocus={event => { if (creating) event.preventDefault(); }}>
+ <DropdownMenuItem onSelect={() => setCreating(true)}>
+ <Users size={14} className="mr-2" />
+ {t(key('newGroup'))}
+ </DropdownMenuItem>
+ {joinable.length > 0 ? (
+ <DropdownMenuSub>
+ <DropdownMenuSubTrigger>
+ <MessagesSquare size={14} className="mr-2" />
+ {t(key('existingGroup'))}
+ </DropdownMenuSubTrigger>
+ <DropdownMenuSubContent className="max-h-72 max-w-64 overflow-y-auto">
+ {/* Name both sides of the action before it runs: this teammate, into that group. */}
+ <DropdownMenuLabel className="truncate">{t(key('addTo'), { name: bot.name })}</DropdownMenuLabel>
+ {joinable.map(group => (
+ <DropdownMenuItem key={group.id} disabled={busy} onSelect={() => void addTo(group.id, group.name)}>
+ <span className="min-w-0 truncate">{group.name}</span>
+ </DropdownMenuItem>
+ ))}
+ </DropdownMenuSubContent>
+ </DropdownMenuSub>
+ ) : null}
+ </DropdownMenuContent>
+ </DropdownMenu>
+ {creating ? (
+ <BotGroupCreateDialog
+ initialBotIds={[botId]}
+ onOpenChange={open => { if (!open) { setCreating(false); trigger.current?.focus(); } }}
+ onCreated={id => { setCreating(false); navigate(groupRoute(id)); }}
+ />
+ ) : null}
+ </>
+ );
+}
diff --git a/apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx b/apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx
index 21c8121637..1cf5756e29 100644
--- a/apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx
@@ -1,16 +1,17 @@
import { Button } from '@/components/ui/button';
-import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from '@/components/ui/dropdown-menu';
-import { Bot, Plus, Users } from 'lucide-react';
+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger } from '@/components/ui/dropdown-menu';
+import { Bot, Link2, Plus, Users } from 'lucide-react';
import { useRef, useState } from 'react';
import { useNavigate } from 'react-router-dom';
import { BotRosterView } from './BotRosterView';
import { BotGroupCreateDialog } from './BotGroupCreateDialog';
+import { ChatInviteDialog } from './ChatInviteDialog';
import { useTranslation } from 'react-i18next';
export function BotCreateMenu({ compact = false, label }: { compact?: boolean; label?: string }) {
const { t } = useTranslation();
const navigate = useNavigate();
- const [dialog, setDialog] = useState<'bot' | 'group' | null>(null);
+ const [dialog, setDialog] = useState<'bot' | 'group' | 'join' | null>(null);
const trigger = useRef<HTMLButtonElement>(null);
return (
@@ -52,6 +53,13 @@ export function BotCreateMenu({ compact = false, label }: { compact?: boolean; l
<Users size={14} className="mr-2" />
{t('bots.groupChat.create.title')}
</DropdownMenuItem>
+ {/* Clicking an invitation opens it directly; this is the fallback when the link
+ arrived as plain text that the sending app did not make clickable. */}
+ <DropdownMenuSeparator />
+ <DropdownMenuItem onSelect={() => setDialog('join')}>
+ <Link2 size={14} className="mr-2" />
+ {t('bots.list.joinWithLink')}
+ </DropdownMenuItem>
</DropdownMenuContent>
</DropdownMenu>
)}
@@ -67,6 +75,12 @@ export function BotCreateMenu({ compact = false, label }: { compact?: boolean; l
onCreated={id => { setDialog(null); navigate(`/bots/groups/${encodeURIComponent(id)}`); }}
/>
) : null}
+ {dialog === 'join' ? (
+ <ChatInviteDialog
+ onClose={() => { setDialog(null); trigger.current?.focus(); }}
+ onJoined={id => navigate(`/bots/groups/${encodeURIComponent(id)}`)}
+ />
+ ) : null}
</>
);
}
diff --git a/apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx b/apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx
index 85911d7bd1..c0d9d0c460 100644
--- a/apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx
@@ -28,14 +28,18 @@ function pickableBots(bots: readonly BotProfile[]): BotProfile[] {
.sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id));
}
-function isSelectable(bot: BotProfile): boolean {
+/** Whether a teammate can join a group right now (shared with entry points outside this dialog). */
+export function isSelectable(bot: BotProfile): boolean {
return (bot.status ?? 'active') === 'active' && bot.enabled !== false;
}
export function BotGroupCreateDialog({
+ initialBotIds = [],
onOpenChange,
onCreated,
}: {
+ /** Preselected teammates, e.g. the one whose private chat started this group. */
+ initialBotIds?: readonly string[];
onOpenChange: (open: boolean) => void;
onCreated: (groupId: string) => void;
}) {
@@ -51,7 +55,7 @@ export function BotGroupCreateDialog({
}, []);
const minMembers = serverBacked ? 0 : BOT_GROUP_MIN_MEMBERS;
const [name, setName] = useState('');
- const [selectedIds, setSelectedIds] = useState<string[]>([]);
+ const [selectedIds, setSelectedIds] = useState<string[]>(() => initialBotIds.slice(0, BOT_GROUP_MAX_MEMBERS));
const [nameError, setNameError] = useState(false);
const [membersError, setMembersError] = useState(false);
const [submitError, setSubmitError] = useState<string | null>(null);
diff --git a/apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx b/apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx
index 9258fe494c..6fd1c6082a 100644
--- a/apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx
@@ -8,7 +8,8 @@
* right end of the bar — because "click the name" is the discoverable one and
* "the gear is on the right" is the learned one. Local teammates also get a
* permanent way into their workbench here: the sidebar tab can be closed, and
- * nothing else reopens it.
+ * nothing else reopens it — plus the IM-style "add people" entry that turns
+ * this chat into a group or brings the teammate into one.
*/
import { useMemo } from 'react';
import { LayoutGrid, Settings2 } from 'lucide-react';
@@ -18,6 +19,7 @@ import { useTranslation } from 'react-i18next';
import { WINDOW_NO_DRAG_STYLE } from '@/components/layout/windowDrag';
import { useRegisterContentHeader } from '../feature-context';
import { openBotWorkbenchTab } from '@/features/right-sidebar/lib/openBotWorkbenchTab';
+import { BotAddToGroupMenu } from './BotAddToGroupMenu';
import { BotAvatar } from './BotAvatar';
import { isCindyDeviceBot } from './cindyDeviceRoster';
import { CindyHeaderDevicePicker } from './CindyDevicePicker';
@@ -32,6 +34,8 @@ export interface BotChatIdentity {
name: string;
avatar?: string | null;
avatarColor?: string | null;
+ /** Only the teammate's own canonical private chat (not channel routes or read-only history) can start a group. */
+ canonicalChat?: boolean;
}
export function BotSessionContentHeader({ bot }: { bot: BotChatIdentity }) {
@@ -67,6 +71,7 @@ export function BotSessionContentHeader({ bot }: { bot: BotChatIdentity }) {
{bot.deviceName}
</span>
) : null}
+ {bot.canonicalChat && !bot.deviceId ? <BotAddToGroupMenu botId={bot.id} /> : null}
{!bot.deviceId && bot.sessionId ? (
<button
type="button"
diff --git a/apps/desktop/src/renderer/features/bots/BotSessionView.tsx b/apps/desktop/src/renderer/features/bots/BotSessionView.tsx
index bec9364ac9..e1146ccae4 100644
--- a/apps/desktop/src/renderer/features/bots/BotSessionView.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotSessionView.tsx
@@ -107,6 +107,12 @@ function BotSessionGateView() {
: gateIdentity,
[gateIdentity, liveName, liveAvatar, liveAvatarColor],
);
+ // A read-only demoted copy offers no add-to-group entry, like its settings.
+ const canonicalChat = gate.kind === 'ready' && gate.isCanonical && !shadowed;
+ const chatIdentity = useMemo(
+ () => (gateIdentity ? { ...(identity ?? gateIdentity), canonicalChat } : null),
+ [gateIdentity, identity, canonicalChat],
+ );
useEffect(() => {
let cancelled = false;
@@ -269,7 +275,7 @@ function BotSessionGateView() {
<div className="min-h-0 flex-1">
<CCAgentSessionView
botMentions={gate.mentions}
- botIdentity={identity ?? gate.identity}
+ botIdentity={chatIdentity ?? gate.identity}
botUnreadBoundaryAt={gate.unreadBoundaryAt}
onBotReadThrough={gate.isCanonical ? onReadThrough : undefined}
{...(readOnly ? { readOnly: true } : {})}
diff --git a/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx b/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx
index b9f8504937..f8c9631dae 100644
--- a/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx
@@ -60,7 +60,6 @@ import { refreshBotGroups, useBotGroupList } from './botGroupStore';
import { BOT_GROUP_SETTINGS_PARAM } from './botGroupPresentation';
import { chatErrorKey } from './chatError';
import { subscribeBotReadState, getBotLastReadAtMap } from './botReadState';
-import { ChatJoinButton } from './ChatServerControls';
import { isBotGroupLaneSession, withoutBotGroupLanes } from './botGroupLane';
import {
botListSubtitle,
@@ -554,7 +553,6 @@ function BotsSidebarContent() {
{showHidden ? <EyeOff size={15} /> : <Eye size={15} />}
</button>
) : null}
- <ChatJoinButton onJoined={id => navigate(`/bots/groups/${encodeURIComponent(id)}`)} />
<BotCreateMenu />
</span>
</div>
diff --git a/apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx b/apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx
index 7656314413..e2c24fdf2c 100644
--- a/apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx
+++ b/apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx
@@ -13,8 +13,16 @@ import { chatErrorKey } from './chatError';
const key = (name: string) => `bots.groupChat.server.${name}`;
const api = () => window.electronAPI.maker.chatServer;
-export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined }: { groupId?: string; initialLink?: string; onClose: () => void; onJoined?: (id: string) => void }) {
+/**
+ * Without `groupId` this joins a group: either from a clicked invitation
+ * (`initialLink`, previewed immediately, no paste field) or from a pasted link.
+ * `malformedLink` reports a clicked link whose token could not be read.
+ */
+export function ChatInviteDialog({ groupId, initialLink = '', malformedLink = false, onClose, onJoined }: {
+ groupId?: string; initialLink?: string; malformedLink?: boolean; onClose: () => void; onJoined?: (id: string) => void;
+}) {
const { t, i18n } = useTranslation();
+ const fromLink = !groupId && (Boolean(initialLink) || malformedLink);
const [link, setLink] = useState(initialLink);
const [expiresAt, setExpiresAt] = useState<string | null | undefined>();
const [reusable, setReusable] = useState<boolean | undefined>();
@@ -23,13 +31,18 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined
const [revokeUnsupported, setRevokeUnsupported] = useState(false);
const [now, setNow] = useState(Date.now());
const [preview, setPreview] = useState<ChatInvitePreview | null>(null);
- const [error, setError] = useState('');
- const [busy, setBusy] = useState(false);
+ const [error, setError] = useState(() => malformedLink ? t(key('malformedInvite')) : '');
+ // The server said this invitation cannot be used; asking it again will not help.
+ const [unusable, setUnusable] = useState(malformedLink);
+ const [busy, setBusy] = useState(fromLink && !malformedLink);
const busyRef = useRef(false);
const mounted = useRef(true);
const operation = useRef(crypto.randomUUID());
const revokeOperation = useRef(crypto.randomUUID());
useEffect(() => { mounted.current = true; return () => { mounted.current = false; }; }, []);
+ // A clicked link already expresses the intent to look (once, on open); joining still
+ // needs the explicit accept.
+ useEffect(() => { if (fromLink && !malformedLink) void run(); }, []);
const expiry = groupId ? expiresAt : preview?.expiresAt;
const expired = typeof expiry === 'string' && Date.parse(expiry) <= now;
useEffect(() => {
@@ -53,6 +66,9 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined
busyRef.current = true; setBusy(true); setError('');
const owner = getDataOwnerGeneration();
const current = () => mounted.current && isDataOwnerGenerationCurrent(owner);
+ // Reading an invitation is side-effect free; a result discarded for an older owner
+ // generation is simply read again for the current one instead of leaving the dialog loading.
+ const reading = action === 'main' && !groupId && !preview;
try {
if (action === 'copy') {
if (expired || (typeof expiry === 'string' && Date.parse(expiry) <= Date.now()) || revoked || !link) return;
@@ -80,16 +96,19 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined
} else if (!preview) {
const result = await api().previewInvite({ link });
if (!current()) return;
- if (!result.ok) { setError(t(chatErrorKey(result.errorCode))); return; }
+ if (!result.ok) {
+ setUnusable(chatErrorKey(result.errorCode) === key('invalidInvite'));
+ setError(t(chatErrorKey(result.errorCode))); return;
+ }
+ // Already a member: the invitation's only remaining purpose is to open the group.
+ if (result.joined) { onJoined?.(result.groupId); onClose(); return; }
setPreview(result); setNow(Date.now());
- } else if (preview.joined) {
- onJoined?.(preview.groupId); onClose();
} else {
if (expired || (typeof expiry === 'string' && Date.parse(expiry) <= Date.now())) return;
const result = await api().acceptInvite({ link, clientId: operation.current });
if (!current()) return;
if (!result.ok) {
- if (['INVITATION_NOT_FOUND', 'INVITATION_UNAVAILABLE'].includes(result.errorCode)) setPreview(null);
+ if (['INVITATION_NOT_FOUND', 'INVITATION_UNAVAILABLE'].includes(result.errorCode)) { setPreview(null); setUnusable(fromLink); }
setError(t(chatErrorKey(result.errorCode))); return;
}
refreshBotGroups(); onJoined?.(result.groupId); onClose();
@@ -104,19 +123,24 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined
if (mounted.current) {
setBusy(false);
if (action === 'revoke') setRevokeConfirm(false);
+ if (reading && !isDataOwnerGenerationCurrent(owner)) void run();
}
}
}
const title = t(key(groupId ? 'invite' : 'join'));
- return <Dialog.Root open onOpenChange={open => !busyRef.current && !open && onClose()}>
+ // Reading a clicked invitation changes nothing, so it never traps the user; accepting,
+ // creating and revoking still hold the dialog until their result is known.
+ const locked = () => busyRef.current && !(fromLink && !preview);
+ return <Dialog.Root open onOpenChange={open => !open && !locked() && onClose()}>
<Dialog.Portal><Dialog.Overlay className="modal-scrim fixed inset-0 z-[70]" />
<Dialog.Content onPointerDownOutside={e => e.preventDefault()}
- onEscapeKeyDown={e => { if (e.isComposing || e.keyCode === 229 || busyRef.current) e.preventDefault(); }}
+ onEscapeKeyDown={e => { if (e.isComposing || e.keyCode === 229 || locked()) e.preventDefault(); }}
className="modal-panel fixed inset-0 z-[71] m-auto flex h-fit max-h-[85vh] w-[min(460px,calc(100vw-32px))] flex-col gap-4 p-5 outline-none">
<Dialog.Title className="text-18 font-medium text-[var(--confirm-title)]">{title}</Dialog.Title>
- <Dialog.Description className="text-13 leading-normal text-[var(--confirm-desc)]">{t(key(groupId ? 'inviteDescription' : 'joinDescription'))}</Dialog.Description>
- {(!groupId || link) && <Input aria-label={t(key('inviteLink'))} value={link} readOnly={!!groupId} disabled={busy || revoked}
+ <Dialog.Description className="text-13 leading-normal text-[var(--confirm-desc)]">{t(key(groupId ? 'inviteDescription' : fromLink ? 'linkDescription' : 'joinDescription'))}</Dialog.Description>
+ {!fromLink && (!groupId || link) && <Input aria-label={t(key('inviteLink'))} value={link} readOnly={!!groupId} disabled={busy || revoked}
placeholder={t(key('pasteLink'))} onChange={value => { setLink(value); setPreview(null); setError(''); operation.current = crypto.randomUUID(); }} />}
+ {fromLink && !preview && !error && <p role="status" className="text-13 leading-normal text-[var(--text-secondary)]">{t(key('loadingInvite'))}</p>}
{preview && <div className="space-y-1 rounded-lg bg-[var(--surface-elevated)] p-3">
<p className="text-15 font-medium text-[var(--text-primary)]">{preview.name}</p>
<p className="text-13 text-[var(--text-secondary)]">{t(key('invitedBy'), { name: preview.inviterName })}</p>
@@ -125,12 +149,12 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined
{groupId && link && !revoked && !expired && !canRevoke && <p className="text-13 leading-normal text-[var(--text-secondary)]">{t(key('revokeUnsupported'))}</p>}
{error && <p role="alert" className="text-13 text-[var(--error-fg)]">{error}</p>}
<div className="flex flex-wrap justify-end gap-2">
- <Button variant="secondary" palette="confirmation" size="lg" disabled={busy} onClick={onClose}>{t('bots.close')}</Button>
+ <Button variant="secondary" palette="confirmation" size="lg" disabled={busy && !(fromLink && !preview)} onClick={onClose}>{t('bots.close')}</Button>
{groupId && link && !revoked && !expired && <Button variant="secondary" palette="confirmation" size="lg" disabled={busy || !canRevoke} onClick={() => setRevokeConfirm(true)}>{t(key('revokeLink'))}</Button>}
{groupId && link && !expired && !revoked
? <Button variant="cta" palette="confirmation" size="lg" loading={busy} onClick={() => void run('copy')}>{t(key('copyLink'))}</Button>
- : <Button variant="cta" palette="confirmation" size="lg" loading={busy} disabled={!groupId && (!link.trim() || (expired && !preview?.joined))} onClick={() => void run()}>
- {t(key(groupId ? 'createLink' : preview ? (preview.joined ? 'openGroup' : 'accept') : 'previewInvite'))}
+ : (!fromLink || preview || (error && !unusable)) && <Button variant="cta" palette="confirmation" size="lg" loading={busy} disabled={!groupId && (!link.trim() || expired)} onClick={() => void run()}>
+ {t(key(groupId ? 'createLink' : preview ? 'accept' : fromLink ? 'retryInvite' : 'previewInvite'))}
</Button>}
</div>
</Dialog.Content>
diff --git a/apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx b/apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx
index cb329312cd..e9d09f34d4 100644
--- a/apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx
+++ b/apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx
@@ -6,6 +6,8 @@ import { ChatInviteDialog } from './ChatInviteDialog';
// in memory through login/owner remounts; every new dialog re-previews as the
// current account and still requires explicit acceptance.
let pending: readonly string[] = [];
+/** Stands in for a clicked link whose token was unreadable; never a valid 43-character token. */
+const MALFORMED = 'malformed';
const listeners = new Set<() => void>();
const getSnapshot = () => pending;
const subscribe = (listener: () => void) => {
@@ -13,12 +15,21 @@ const subscribe = (listener: () => void) => {
return () => { listeners.delete(listener); };
};
-export function requestChatInvite(token: string): void {
- if (!/^[A-Za-z0-9_-]{43}$/.test(token) || pending.includes(token)) return;
- pending = [...pending, token];
+function enqueue(entry: string): void {
+ if (pending.includes(entry)) return;
+ pending = [...pending, entry];
for (const listener of listeners) listener();
}
+export function requestChatInvite(token: string): void {
+ if (/^[A-Za-z0-9_-]{43}$/.test(token)) enqueue(token);
+}
+
+/** A clicked invitation link was truncated or altered: say so instead of ignoring the click. */
+export function reportMalformedChatInvite(): void {
+ enqueue(MALFORMED);
+}
+
function dismiss(token: string): void {
pending = pending.filter(value => value !== token);
for (const listener of listeners) listener();
@@ -28,6 +39,7 @@ function dismiss(token: string): void {
export function ChatInviteHost() {
const [token] = useSyncExternalStore(subscribe, getSnapshot);
const navigate = useNavigate();
+ if (token === MALFORMED) return <ChatInviteDialog key={token} malformedLink onClose={() => dismiss(token)} />;
return token ? <ChatInviteDialog key={token} initialLink={`cindy://chat-invite/${token}`}
onClose={() => dismiss(token)}
onJoined={id => navigate(`/bots/groups/${encodeURIComponent(id)}`)} /> : null;
diff --git a/apps/desktop/src/renderer/features/bots/ChatServerControls.tsx b/apps/desktop/src/renderer/features/bots/ChatServerControls.tsx
index de2411464b..ae43aa98a2 100644
--- a/apps/desktop/src/renderer/features/bots/ChatServerControls.tsx
+++ b/apps/desktop/src/renderer/features/bots/ChatServerControls.tsx
@@ -1,5 +1,5 @@
import { chatErrorKey } from './chatError';
-import { useEffect, useRef, useState } from 'react';
+import { useRef, useState } from 'react';
import { ChatInviteDialog } from './ChatInviteDialog';
import { UserPlus } from 'lucide-react';
import { useTranslation } from 'react-i18next';
@@ -69,23 +69,13 @@ export function ChatMessageActions({ groupId, shareScope, message, align = messa
);
}
-function InviteControl({ groupId, onJoined }: { groupId?: string; onJoined?: (id: string) => void }) {
+/** Group owners and admins create or revoke invitation links from the group header. */
+export function ChatInviteButton({ groupId }: { groupId: string }) {
const { t } = useTranslation();
const [open, setOpen] = useState(false);
- const title = t(key(groupId ? 'invite' : 'join'));
+ const title = t(key('invite'));
return <>
<Tip text={title}><button type="button" className={iconClass} style={WINDOW_NO_DRAG_STYLE} aria-label={title} onClick={() => setOpen(true)}><UserPlus size={16} /></button></Tip>
- {open && <ChatInviteDialog groupId={groupId} onClose={() => setOpen(false)} onJoined={onJoined} />}
+ {open && <ChatInviteDialog groupId={groupId} onClose={() => setOpen(false)} />}
</>;
}
-export const ChatInviteButton = InviteControl;
-export function ChatJoinButton({ onJoined }: { onJoined: (id: string) => void }) {
- const [enabled, setEnabled] = useState(false);
- useEffect(() => {
- let disposed = false;
- const read = () => { void window.electronAPI?.maker?.chatServer?.status().then(status => { if (!disposed) setEnabled(status.enabled); }).catch(() => undefined); };
- read(); const timer = setInterval(read, 3000);
- return () => { disposed = true; clearInterval(timer); };
- }, []);
- return enabled ? <InviteControl onJoined={onJoined} /> : null;
-}
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/BotAddToGroupMenu.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/BotAddToGroupMenu.test.tsx
new file mode 100644
index 0000000000..40ae3de564
--- /dev/null
+++ b/apps/desktop/src/renderer/features/bots/__tests__/BotAddToGroupMenu.test.tsx
@@ -0,0 +1,156 @@
+// @vitest-environment jsdom
+import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { afterEach, beforeEach, expect, it, vi } from 'vitest';
+import { setDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';
+
+const mocks = vi.hoisted(() => ({
+ profiles: [] as unknown[], groups: [] as unknown[], navigate: vi.fn(), refresh: vi.fn(),
+ ownedBots: vi.fn(), manage: vi.fn(), success: vi.fn(), error: vi.fn(), createDialog: vi.fn(),
+}));
+vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (key: string, values?: object) => values ? `${key}:${JSON.stringify(values)}` : key }) }));
+vi.mock('react-router-dom', () => ({ useNavigate: () => mocks.navigate }));
+vi.mock('../botStore', () => ({ useBotProfiles: () => mocks.profiles }));
+vi.mock('../botGroupStore', () => ({ useBotGroupList: () => ({ groups: mocks.groups, loaded: true }), refreshBotGroups: mocks.refresh }));
+vi.mock('@/lib/toast', () => ({ toast: { success: mocks.success, error: mocks.error } }));
+vi.mock('../BotGroupCreateDialog', async importOriginal => ({
+ ...await importOriginal<typeof import('../BotGroupCreateDialog')>(),
+ BotGroupCreateDialog: (props: { initialBotIds?: string[]; onCreated: (id: string) => void }) => {
+ mocks.createDialog(props.initialBotIds);
+ return <div role="dialog"><button type="button" onClick={() => props.onCreated('new-room')}>create</button></div>;
+ },
+}));
+
+const { BotAddToGroupMenu } = await import('../BotAddToGroupMenu');
+const k = (name: string) => `bots.groupChat.addFromChat.${name}`;
+const teammate = (overrides = {}) => ({ id: 'bot-1', name: '小可', status: 'active', enabled: true, avatar: '', avatarColor: 'violet', createdAt: 1, sessions: [], ...overrides });
+const group = (id: string, name: string, overrides = {}) => ({ id, name, serverBacked: true, archived: false, members: [], replyMode: 'all', speakingMode: 'auto', organizerBotId: null, ...overrides });
+const trigger = `${k('triggerFor')}:${JSON.stringify({ name: '小可' })}`;
+const openMenu = () => fireEvent.keyDown(screen.getByRole('button', { name: trigger }), { key: 'Enter' });
+const openExisting = () => fireEvent.keyDown(screen.getByRole('menuitem', { name: k('existingGroup') }), { key: 'ArrowRight' });
+
+beforeEach(() => {
+ vi.clearAllMocks();
+ setDataOwnerGeneration('owner-a');
+ mocks.profiles = [teammate()];
+ mocks.groups = [
+ group('room-a', '产品组'),
+ group('room-member', '已在群', { members: [{ botId: 'bot-1', name: '小可', avatar: '', avatarColor: 'violet', status: 'active' }] }),
+ group('room-archived', '已归档', { archived: true }),
+ group('room-local', '旧本地群', { serverBacked: false }),
+ ];
+ mocks.ownedBots.mockResolvedValue({ ok: true, bots: [{ actorId: 'actor-1', botId: 'bot-1', name: '小可' }] });
+ mocks.manage.mockResolvedValue({ ok: true });
+ Object.defineProperty(window, 'electronAPI', { configurable: true, value: { maker: { chatServer: { ownedBots: mocks.ownedBots, manage: mocks.manage } } } });
+});
+afterEach(cleanup);
+
+it.each([
+ ['paused', { status: 'paused' }],
+ ['turned off', { enabled: false }],
+ ['archived', { status: 'archived' }],
+])('offers no entry for a %s teammate', (_label, overrides) => {
+ mocks.profiles = [teammate(overrides)];
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ expect(screen.queryByRole('button', { name: /triggerFor/ })).toBeNull();
+});
+
+it('offers no entry for a teammate that is not on this computer', () => {
+ render(<BotAddToGroupMenu botId="remote-bot" />);
+ expect(screen.queryByRole('button', { name: /triggerFor/ })).toBeNull();
+});
+
+it('starts a new group with this teammate preselected and opens it', () => {
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ openMenu();
+ expect(mocks.refresh).toHaveBeenCalled();
+ fireEvent.click(screen.getByRole('menuitem', { name: k('newGroup') }));
+ expect(mocks.createDialog).toHaveBeenCalledWith(['bot-1']);
+ fireEvent.click(screen.getByRole('button', { name: 'create' }));
+ expect(mocks.navigate).toHaveBeenCalledWith('/bots/groups/new-room');
+ expect(mocks.manage).not.toHaveBeenCalled();
+});
+
+it('lists only shared groups the teammate can still join and adds it through the member invitation', async () => {
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ openMenu(); openExisting();
+ const items = (await screen.findAllByRole('menuitem')).map(item => item.textContent);
+ expect(items).toContain('产品组');
+ for (const hidden of ['已在群', '已归档', '旧本地群']) expect(items).not.toContain(hidden);
+ // Before anything runs, the submenu names who is being added; each row names where.
+ expect(screen.getByText(`${k('addTo')}:${JSON.stringify({ name: '小可' })}`)).toBeTruthy();
+ await act(async () => { fireEvent.click(screen.getByRole('menuitem', { name: '产品组' })); });
+ expect(mocks.manage).toHaveBeenCalledExactlyOnceWith({ groupId: 'room-a', action: { type: 'member', actorId: 'actor-1', action: 'invite' } });
+ expect(mocks.refresh).toHaveBeenCalled();
+ expect(mocks.success).toHaveBeenCalledWith(`${k('added')}:${JSON.stringify({ name: '小可', group: '产品组' })}`, expect.objectContaining({ action: expect.any(Object) }));
+ mocks.success.mock.calls[0][1].action.onClick();
+ expect(mocks.navigate).toHaveBeenCalledWith('/bots/groups/room-a');
+});
+
+it('ignores the success toast’s open action once the account has changed', async () => {
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ openMenu(); openExisting();
+ await act(async () => { fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' })); });
+ const { onClick } = mocks.success.mock.calls[0][1].action;
+ setDataOwnerGeneration('owner-b');
+ onClick();
+ expect(mocks.navigate).not.toHaveBeenCalled();
+});
+
+it('hides the existing-group choice when there is nowhere left to add the teammate', () => {
+ mocks.groups = [mocks.groups[1]];
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ openMenu();
+ expect(screen.getByRole('menuitem', { name: k('newGroup') })).toBeTruthy();
+ expect(screen.queryByRole('menuitem', { name: k('existingGroup') })).toBeNull();
+});
+
+it.each([
+ ['FORBIDDEN', 'bots.groupChat.server.notAllowed'],
+ ['ROLE_REQUIRED', 'bots.groupChat.server.notAllowed'],
+ ['REQUEST_TIMEOUT', 'bots.groupChat.server.requestFailed'],
+])('explains a refused addition (%s) without claiming success', async (errorCode, message) => {
+ mocks.manage.mockResolvedValue({ ok: false, errorCode });
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ openMenu(); openExisting();
+ await act(async () => { fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' })); });
+ expect(mocks.error).toHaveBeenCalledWith(message);
+ expect(mocks.success).not.toHaveBeenCalled();
+});
+
+it('says the teammate is unavailable when Chat Server has no identity for it, without inviting anyone else', async () => {
+ mocks.ownedBots.mockResolvedValue({ ok: true, bots: [{ actorId: 'actor-2', botId: 'bot-2', name: 'Other' }] });
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ openMenu(); openExisting();
+ await act(async () => { fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' })); });
+ expect(mocks.manage).not.toHaveBeenCalled();
+ expect(mocks.error).toHaveBeenCalledWith(`${k('unavailable')}:${JSON.stringify({ name: '小可' })}`);
+});
+
+it('does not reopen the menu or add again while an addition is pending', async () => {
+ let finish!: (value: unknown) => void;
+ mocks.manage.mockReturnValue(new Promise(resolve => { finish = resolve; }));
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ openMenu(); openExisting();
+ fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' }));
+ await waitFor(() => expect(mocks.manage).toHaveBeenCalledTimes(1));
+ openMenu();
+ expect(screen.queryByRole('menuitem')).toBeNull();
+ await act(async () => finish({ ok: true }));
+ expect(mocks.manage).toHaveBeenCalledTimes(1);
+ expect(mocks.success.mock.calls[0][1].duration).toBeGreaterThanOrEqual(5000);
+ openMenu();
+ expect(screen.getByRole('menuitem', { name: k('newGroup') })).toBeTruthy();
+});
+
+it('drops the result of an addition that finished after the account changed', async () => {
+ let finish!: (value: unknown) => void;
+ mocks.manage.mockReturnValue(new Promise(resolve => { finish = resolve; }));
+ render(<BotAddToGroupMenu botId="bot-1" />);
+ openMenu(); openExisting();
+ fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' }));
+ await waitFor(() => expect(mocks.manage).toHaveBeenCalled());
+ setDataOwnerGeneration('owner-b');
+ await act(async () => finish({ ok: true }));
+ expect(mocks.success).not.toHaveBeenCalled();
+ expect(mocks.error).not.toHaveBeenCalled();
+});
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/BotGroupCreateDialog.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/BotGroupCreateDialog.test.tsx
index 88a99be334..b17a9415f6 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/BotGroupCreateDialog.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/BotGroupCreateDialog.test.tsx
@@ -112,6 +112,18 @@ describe('BotGroupCreateDialog', () => {
expect(onCreated).not.toHaveBeenCalled();
});
+ it('starts with the private-chat teammate already picked and still lets the user change it', async () => {
+ const onCreated = vi.fn();
+ render(<BotGroupCreateDialog initialBotIds={['c']} onOpenChange={vi.fn()} onCreated={onCreated} />);
+ expect(checkbox('Bot c').getAttribute('aria-checked')).toBe('true');
+ expect(checkbox('Bot a').getAttribute('aria-checked')).toBe('false');
+ fireEvent.change(screen.getByRole('textbox'), { target: { value: '新项目' } });
+ fireEvent.click(checkbox('Bot a'));
+ fireEvent.click(screen.getByRole('button', { name: 'bots.groupChat.create.submit' }));
+ await waitFor(() => expect(onCreated).toHaveBeenCalledWith('g-new'));
+ expect(mocks.createBotGroup).toHaveBeenCalledWith({ name: '新项目', botIds: ['a', 'c'] });
+ });
+
it('closes from Cancel', () => {
const { onOpenChange } = renderDialog();
fireEvent.click(screen.getByRole('button', { name: 'bots.cancel' }));
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteDialog.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteDialog.test.tsx
index fff4025a0a..74c5baf817 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteDialog.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteDialog.test.tsx
@@ -52,7 +52,7 @@ describe('invitation validity', () => {
it('disables acceptance for expired previews', async () => {
mocks.previewInvite.mockResolvedValue({ ok: true, groupId: 'room', name: 'Room', inviterName: 'Host', expiresAt: '2000-01-01T00:00:00Z', joined: false });
render(<ChatInviteDialog initialLink={link} onClose={vi.fn()} />);
- await act(async () => fireEvent.click(screen.getByRole('button', { name: k('previewInvite') })));
+ await screen.findByText('Room');
expect(screen.getByRole('status').textContent).toBe(k('expiredLink'));
expect((screen.getByRole('button', { name: k('accept') }) as HTMLButtonElement).disabled).toBe(true);
expect(mocks.acceptInvite).not.toHaveBeenCalled();
@@ -161,12 +161,13 @@ describe('invitation validity', () => {
it('discards a stale reusable preview when the server reports an expired or revoked link on acceptance', async () => {
mocks.acceptInvite.mockResolvedValue({ ok: false, errorCode: 'INVITATION_NOT_FOUND' });
render(<ChatInviteDialog initialLink={link} onClose={vi.fn()} />);
- await act(async () => fireEvent.click(screen.getByRole('button', { name: k('previewInvite') })));
+ await screen.findByRole('button', { name: k('accept') });
expect(screen.getByRole('status').textContent).toBe(k('reusableLink'));
await act(async () => fireEvent.click(screen.getByRole('button', { name: k('accept') })));
expect(screen.queryByRole('status')).toBeNull();
expect(screen.getByRole('alert').textContent).toBe(k('invalidInvite'));
- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);
+ expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();
+ expect(mocks.previewInvite).toHaveBeenCalledTimes(1);
});
it('does not show permanent validity when a response omits the reusable flag', async () => {
mocks.createInvite.mockResolvedValue({ ok: true, link, expiresAt: null });
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteHost.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteHost.test.tsx
index 24d7c43196..e6e94f61b2 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteHost.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteHost.test.tsx
@@ -3,7 +3,7 @@ import { StrictMode } from 'react';
import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
import { MemoryRouter, useLocation } from 'react-router-dom';
import { afterEach, beforeEach, expect, it, vi } from 'vitest';
-import { ChatInviteHost, requestChatInvite } from '../ChatInviteHost';
+import { ChatInviteHost, reportMalformedChatInvite, requestChatInvite } from '../ChatInviteHost';
import { setDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';
const api = vi.hoisted(() => ({ previewInvite: vi.fn(), acceptInvite: vi.fn() }));
@@ -17,7 +17,7 @@ function Location() { return <p data-testid="location">{useLocation().pathname}<
function mount() {
return render(<StrictMode><MemoryRouter><ChatInviteHost /><Location /></MemoryRouter></StrictMode>);
}
-async function preview() { await act(async () => { fireEvent.click(screen.getByRole('button', { name: k('previewInvite') })); }); }
+async function retry() { await act(async () => { fireEvent.click(screen.getByRole('button', { name: k('retryInvite') })); }); }
beforeEach(() => {
vi.clearAllMocks();
setDataOwnerGeneration('owner-a');
@@ -33,14 +33,15 @@ afterEach(async () => {
cleanup();
});
-it('keeps an invitation until the authenticated host mounts and requires preview plus explicit acceptance', async () => {
+it('keeps an invitation until the authenticated host mounts, previews it without a paste field and requires explicit acceptance', async () => {
requestChatInvite(token);
mount();
- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);
- expect(api.previewInvite).not.toHaveBeenCalled();
+ expect(screen.queryByRole('textbox')).toBeNull();
+ expect(screen.getByRole('status').textContent).toBe(k('loadingInvite'));
+ expect(screen.getByRole('button', { name: 'bots.close' }).hasAttribute('disabled')).toBe(false);
+ await screen.findByText('Invited group');
+ expect(api.previewInvite).toHaveBeenCalledExactlyOnceWith({ link });
expect(api.acceptInvite).not.toHaveBeenCalled();
- await preview(); await screen.findByText('Invited group');
- expect(api.previewInvite).toHaveBeenCalledWith({ link });
act(() => requestChatInvite(token));
expect(screen.getAllByRole('dialog')).toHaveLength(1);
expect(api.previewInvite).toHaveBeenCalledTimes(1);
@@ -51,71 +52,132 @@ it('keeps an invitation until the authenticated host mounts and requires preview
});
it.each([
- ['INVITATION_NOT_FOUND', 'invalidInvite'],
- ['INVITATION_UNAVAILABLE', 'invalidInvite'],
['FORBIDDEN', 'notAllowed'],
['AUTH_REQUIRED', 'loginRequired'],
['HOST_NOT_READY', 'requestFailed'],
-])('retains the target after %s and allows retry once the service is ready', async (errorCode, message) => {
+])('retains the target after %s and reloads it on request', async (errorCode, message) => {
api.previewInvite.mockResolvedValueOnce({ ok: false, errorCode });
- requestChatInvite(token); mount(); await preview();
+ requestChatInvite(token); mount();
expect((await screen.findByRole('alert')).textContent).toBe(k(message));
- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);
+ expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();
+ await retry(); await screen.findByText('Invited group');
+ expect(api.previewInvite).toHaveBeenLastCalledWith({ link });
expect(api.acceptInvite).not.toHaveBeenCalled();
- await preview(); await screen.findByText('Invited group');
});
-it('opens an already joined group without accepting again', async () => {
+it.each(['INVITATION_NOT_FOUND', 'INVITATION_UNAVAILABLE', 'INVALID_INPUT'])('explains an unusable invitation (%s) without offering to accept or reload it', async errorCode => {
+ api.previewInvite.mockResolvedValueOnce({ ok: false, errorCode });
+ requestChatInvite(token); mount();
+ expect((await screen.findByRole('alert')).textContent).toBe(k('invalidInvite'));
+ expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();
+ expect(screen.queryByRole('button', { name: k('retryInvite') })).toBeNull();
+ fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));
+ expect(screen.queryByRole('dialog')).toBeNull();
+ expect(api.acceptInvite).not.toHaveBeenCalled();
+});
+
+it('opens an already joined group directly without accepting again', async () => {
api.previewInvite.mockResolvedValue({ ok: true, groupId: 'room', name: 'Invited group', inviterName: 'Host', joined: true });
- requestChatInvite(token); mount(); await preview(); await screen.findByText('Invited group');
- fireEvent.click(screen.getByRole('button', { name: k('openGroup') }));
- expect(screen.getByTestId('location').textContent).toBe('/bots/groups/room');
+ requestChatInvite(token); mount();
+ await waitFor(() => expect(screen.getByTestId('location').textContent).toBe('/bots/groups/room'));
+ expect(screen.queryByRole('dialog')).toBeNull();
+ expect(api.acceptInvite).not.toHaveBeenCalled();
+});
+
+it('reports a malformed clicked link once, without contacting the service', async () => {
+ reportMalformedChatInvite(); reportMalformedChatInvite();
+ mount();
+ expect(screen.getAllByRole('dialog')).toHaveLength(1);
+ expect(screen.getByRole('alert').textContent).toBe(k('malformedInvite'));
+ expect(screen.queryByRole('textbox')).toBeNull();
+ expect(screen.queryByRole('button', { name: k('retryInvite') })).toBeNull();
+ expect(api.previewInvite).not.toHaveBeenCalled();
+ fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));
+ expect(screen.queryByRole('dialog')).toBeNull();
+});
+
+it('lets the user dismiss an invitation while it is still loading', async () => {
+ api.previewInvite.mockReturnValueOnce(new Promise(() => undefined));
+ requestChatInvite(token); mount();
+ await waitFor(() => expect(api.previewInvite).toHaveBeenCalledTimes(1));
+ fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));
+ expect(screen.queryByRole('dialog')).toBeNull();
+});
+
+it('reads the invitation again when the same account moved to a newer data generation mid-request', async () => {
+ let finish!: (result: unknown) => void;
+ api.previewInvite.mockReturnValueOnce(new Promise(resolve => { finish = resolve; }));
+ requestChatInvite(token); mount();
+ await waitFor(() => expect(api.previewInvite).toHaveBeenCalledTimes(1));
+ setDataOwnerGeneration('owner-a');
+ await act(async () => finish({ ok: true, groupId: 'stale-room', name: 'Stale result', inviterName: 'Old', joined: false }));
+ expect(screen.queryByText('Stale result')).toBeNull();
+ await screen.findByText('Invited group');
+ expect(api.previewInvite).toHaveBeenCalledTimes(2);
+ expect(api.previewInvite).toHaveBeenLastCalledWith({ link });
expect(api.acceptInvite).not.toHaveBeenCalled();
});
it('discards an old account preview while preserving its target through account selection', async () => {
let finish!: (result: unknown) => void;
api.previewInvite.mockReturnValueOnce(new Promise(resolve => { finish = resolve; }));
- requestChatInvite(token); const view = mount(); await preview();
- view.unmount(); setDataOwnerGeneration('owner-b'); mount();
- await act(async () => finish({ ok: true, groupId: 'old-room', name: 'Private old result', joined: false }));
+ requestChatInvite(token); const view = mount();
+ await waitFor(() => expect(api.previewInvite).toHaveBeenCalledTimes(1));
+ view.unmount(); setDataOwnerGeneration('owner-b');
+ api.previewInvite.mockReturnValueOnce(new Promise(() => undefined));
+ mount();
+ await act(async () => finish({ ok: true, groupId: 'old-room', name: 'Private old result', inviterName: 'Old', joined: false }));
expect(screen.queryByText('Private old result')).toBeNull();
- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);
expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();
- await preview(); await screen.findByText('Invited group');
+ // The new account previews the same target afresh.
+ expect(api.previewInvite).toHaveBeenCalledTimes(2);
+ expect(api.previewInvite).toHaveBeenLastCalledWith({ link });
expect(api.acceptInvite).not.toHaveBeenCalled();
});
it('queues a second invite without replacing the current confirmation and reuses the id on retry', async () => {
api.acceptInvite.mockResolvedValueOnce({ ok: false, errorCode: 'REQUEST_TIMEOUT' });
- requestChatInvite(token); mount(); await preview(); await screen.findByText('Invited group');
+ requestChatInvite(token); mount(); await screen.findByText('Invited group');
act(() => requestChatInvite('b'.repeat(43)));
+ expect(api.previewInvite).toHaveBeenCalledTimes(1);
fireEvent.click(screen.getByRole('button', { name: k('accept') }));
await screen.findByRole('alert');
fireEvent.click(screen.getByRole('button', { name: k('accept') }));
- await waitFor(() => expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(`cindy://chat-invite/${'b'.repeat(43)}`));
+ await waitFor(() => expect(api.previewInvite).toHaveBeenLastCalledWith({ link: `cindy://chat-invite/${'b'.repeat(43)}` }));
expect(api.acceptInvite.mock.calls[0][0].clientId).toBe(api.acceptInvite.mock.calls[1][0].clientId);
});
-it.each(['INVITATION_NOT_FOUND', 'FORBIDDEN'])('keeps the dialog when acceptance is rejected after preview: %s', async errorCode => {
- api.acceptInvite.mockResolvedValue({ ok: false, errorCode });
- requestChatInvite(token); mount(); await preview();
+it('keeps the dialog without an accept button when the invitation became unusable after preview', async () => {
+ api.acceptInvite.mockResolvedValue({ ok: false, errorCode: 'INVITATION_NOT_FOUND' });
+ requestChatInvite(token); mount(); await screen.findByText('Invited group');
fireEvent.click(screen.getByRole('button', { name: k('accept') }));
- await screen.findByRole('alert');
+ expect((await screen.findByRole('alert')).textContent).toBe(k('invalidInvite'));
expect(screen.getByTestId('location').textContent).toBe('/');
- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);
+ expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();
+ expect(screen.queryByRole('button', { name: k('retryInvite') })).toBeNull();
+});
+
+it('keeps the confirmation when acceptance is refused for this account', async () => {
+ api.acceptInvite.mockResolvedValue({ ok: false, errorCode: 'FORBIDDEN' });
+ requestChatInvite(token); mount(); await screen.findByText('Invited group');
+ fireEvent.click(screen.getByRole('button', { name: k('accept') }));
+ expect((await screen.findByRole('alert')).textContent).toBe(k('notAllowed'));
+ expect(screen.getByTestId('location').textContent).toBe('/');
+ expect(screen.getByText('Invited group')).toBeTruthy();
+ expect(screen.getByRole('button', { name: k('accept') })).toBeTruthy();
});
it('ignores an old account acceptance result after logout and preserves a fresh confirmation for the new account', async () => {
let finish!: (result: unknown) => void;
api.acceptInvite.mockReturnValueOnce(new Promise(resolve => { finish = resolve; }));
- requestChatInvite(token); const view = mount(); await preview();
+ requestChatInvite(token); const view = mount(); await screen.findByText('Invited group');
const accept = screen.getByRole('button', { name: k('accept') });
fireEvent.click(accept); fireEvent.click(accept);
expect(api.acceptInvite).toHaveBeenCalledTimes(1);
+ expect(screen.getByRole('button', { name: 'bots.close' }).hasAttribute('disabled')).toBe(true);
view.unmount(); setDataOwnerGeneration('owner-b'); mount();
await act(async () => finish({ ok: true, groupId: 'old-room' }));
expect(screen.getByTestId('location').textContent).toBe('/');
- expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();
- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);
+ await screen.findByText('Invited group');
+ expect(api.acceptInvite).toHaveBeenCalledTimes(1);
});
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/ChatServerControls.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/ChatServerControls.test.tsx
index bc9ceb2032..dbee91d28f 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/ChatServerControls.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/ChatServerControls.test.tsx
@@ -3,7 +3,8 @@ import { StrictMode, type ReactNode } from 'react';
import { act, cleanup, createEvent, fireEvent, render as renderUI, screen, waitFor, within } from '@testing-library/react';
import { Tooltip } from '@/components/ui/tooltip';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { ChatInviteButton, ChatJoinButton, ChatMessageActions } from '../ChatServerControls';
+import { ChatInviteButton, ChatMessageActions } from '../ChatServerControls';
+import { ChatInviteDialog } from '../ChatInviteDialog';
import { ChatThreadPanel } from '../ChatThreadPanel';
import type { BotGroupDetail, BotGroupMessageView } from '../../../../shared/botGroupChat';
import { shareSelectionStore } from '@/components/chat/shareSelectionStore';
@@ -212,10 +213,10 @@ describe('chat interaction controls', () => {
expect(group.messages[0].reactions?.[0].me).toBe(true);
});
- it('shows invitation preview first; only explicit acceptance joins', async () => {
+ it('shows a pasted invitation preview first; only explicit acceptance joins', async () => {
const joined = vi.fn();
- render(<StrictMode><ChatJoinButton onJoined={joined} /></StrictMode>);
- fireEvent.click(await screen.findByRole('button', { name: k('join') }));
+ render(<StrictMode><ChatInviteDialog onClose={vi.fn()} onJoined={joined} /></StrictMode>);
+ expect(mocks.previewInvite).not.toHaveBeenCalled();
fireEvent.change(screen.getByRole('textbox', { name: k('inviteLink') }), { target: { value: 'cindy://chat-invite/test' } });
fireEvent.click(screen.getByRole('button', { name: k('previewInvite') }));
await screen.findByText('Invited group');
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botGroupSidebar.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botGroupSidebar.test.tsx
index c659828f08..5270703fb5 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/botGroupSidebar.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botGroupSidebar.test.tsx
@@ -107,6 +107,11 @@ vi.mock('../BotGroupCreateDialog', () => ({
vi.mock('../BotRosterView', () => ({
BotRosterView: () => <div role="dialog">create-teammate-dialog</div>,
}));
+vi.mock('../ChatInviteDialog', () => ({
+ ChatInviteDialog: ({ groupId, initialLink, onJoined }: { groupId?: string; initialLink?: string; onJoined?: (id: string) => void }) =>
+ <div role="dialog"><span>{`join-dialog:${groupId ?? ''}:${initialLink ?? ''}`}</span>
+ <button type="button" onClick={() => onJoined?.('joined-room')}>joined</button></div>,
+}));
vi.mock('../BotGenerationLabel', () => ({
BotGenerationLabel: ({ sessionId }: { sessionId?: string }) => <span>{`generation:${sessionId}`}</span>,
}));
@@ -528,6 +533,22 @@ describe('BotsSidebar group chats', () => {
expect(screen.getByRole('dialog').textContent).toBe('create-group-dialog');
});
+ it('keeps only the plus menu in the header and offers pasting an invitation as a separate fallback', async () => {
+ await renderSidebar();
+ expect(screen.queryByRole('button', { name: 'bots.groupChat.server.join' })).toBeNull();
+ fireEvent.keyDown(screen.getByRole('button', { name: 'bots.list.createMenu' }), { key: 'Enter' });
+ expect(screen.getAllByRole('menuitem').map(item => item.textContent)).toEqual([
+ 'bots.list.createTeammate', 'bots.groupChat.create.title', 'bots.list.joinWithLink',
+ ]);
+ expect(screen.getAllByRole('separator')).toHaveLength(1);
+ fireEvent.click(screen.getByRole('menuitem', { name: 'bots.list.joinWithLink' }));
+ expect(screen.getByRole('dialog').textContent).toContain('join-dialog::');
+ expect(screen.queryByText('create-group-dialog')).toBeNull();
+ expect(screen.queryByText('create-teammate-dialog')).toBeNull();
+ fireEvent.click(screen.getByRole('button', { name: 'joined' }));
+ expect(mocks.navigate).toHaveBeenCalledWith('/bots/groups/joined-room');
+ });
+
it('opens teammate creation from the same plus menu', async () => {
await renderSidebar();
fireEvent.keyDown(screen.getByRole('button', { name: 'bots.list.createMenu' }), { key: 'Enter' });
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botNavigation.test.ts b/apps/desktop/src/renderer/features/bots/__tests__/botNavigation.test.ts
index 3a38a47c51..1f2860af1f 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/botNavigation.test.ts
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botNavigation.test.ts
@@ -166,7 +166,9 @@ describe('Bot task route recovery', () => {
expect(source).toContain('window.electronAPI.localDb.bots.list(');
expect(source).toContain('lastReadAtByBotId: { [botId]: lastReadAt }');
expect(source).toContain('botMentions={gate.mentions}');
- expect(source).toContain('botIdentity={identity ?? gate.identity}');
+ expect(source).toContain('botIdentity={chatIdentity ?? gate.identity}');
+ // The live identity is wrapped with canonicalChat so only the main private chat offers add-to-group.
+ expect(source).toContain('{ ...(identity ?? gateIdentity), canonicalChat }');
expect(source).toContain('botUnreadBoundaryAt={gate.unreadBoundaryAt}');
});
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSessionContentHeader.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botSessionContentHeader.test.tsx
index 9bf200621c..9d253c3f8c 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/botSessionContentHeader.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSessionContentHeader.test.tsx
@@ -71,6 +71,17 @@ describe('BotSessionContentHeader', () => {
expect(view.container.innerHTML).toBe(originalHeader);
});
+ it('offers add-to-group only in an active local teammate’s canonical private chat', () => {
+ deviceData.local = [localCindy];
+ const view = render(<BotSessionContentHeader bot={{ ...localCindy, canonicalChat: true }} />);
+ expect(screen.getByRole('button', { name: 'bots.groupChat.addFromChat.triggerFor' })).toBeTruthy();
+ // Channel routes and read-only history reuse this header without the canonical flag.
+ view.rerender(<BotSessionContentHeader bot={localCindy} />);
+ expect(screen.queryByRole('button', { name: 'bots.groupChat.addFromChat.triggerFor' })).toBeNull();
+ view.rerender(<BotSessionContentHeader bot={{ ...localCindy, canonicalChat: true, deviceId: 'cloud', deviceName: 'Cloud' }} />);
+ expect(screen.queryByRole('button', { name: 'bots.groupChat.addFromChat.triggerFor' })).toBeNull();
+ });
+
it('keeps the device label and opens settings for a sole remote Cindy', () => {
deviceData.remote = [remoteCindy];
deviceData.pathname = '/bots/remote/cloud/cindy-default';
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx
index d3512a5220..fec3f2de04 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx
@@ -23,9 +23,9 @@ vi.mock('react-router-dom', () => ({
useParams: () => mocks.params,
}));
vi.mock('@/features/cc-agent/CCAgentSessionView', () => ({
- CCAgentSessionView: ({ botUnreadBoundaryAt, onBotReadThrough, readOnly }: { botUnreadBoundaryAt?: number | null; onBotReadThrough?: (at: number) => void; readOnly?: boolean }) => {
+ CCAgentSessionView: ({ botUnreadBoundaryAt, onBotReadThrough, readOnly, botIdentity }: { botUnreadBoundaryAt?: number | null; onBotReadThrough?: (at: number) => void; readOnly?: boolean; botIdentity?: { canonicalChat?: boolean } }) => {
mocks.read = onBotReadThrough;
- return <div data-testid="chat" data-unread-boundary={botUnreadBoundaryAt ?? ''} data-readonly={readOnly ? 'yes' : 'no'} />;
+ return <div data-testid="chat" data-unread-boundary={botUnreadBoundaryAt ?? ''} data-readonly={readOnly ? 'yes' : 'no'} data-canonical-chat={String(botIdentity?.canonicalChat)} />;
},
}));
@@ -92,6 +92,8 @@ describe('Bot conversation read position', () => {
it('waits for a rendered reply rather than marking a mounted chat read to wall-clock time', async () => {
const view = render(<BotSessionView />);
await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());
+ // Private-chat actions (add to group) belong to the canonical chat only.
+ expect(view.getByTestId('chat').dataset.canonicalChat).toBe('true');
expect(getBotLastReadAt('bot-1')).toBeNull();
act(() => mocks.read?.(3_000));
expect(getBotLastReadAt('bot-1')).toBe(3_000);
@@ -114,6 +116,7 @@ describe('Bot conversation read position', () => {
installElectronApi({ ...readyBot, sessions: [{ id: 'session-1', kind: 'chat', role: 'history', status: 'active' }] });
const view = render(<BotSessionView />);
await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());
+ expect(view.getByTestId('chat').dataset.canonicalChat).toBe('false');
expect(mocks.read).toBeUndefined();
expect(getBotLastReadAt('bot-1')).toBe(5_000);
});
@@ -135,6 +138,7 @@ describe('a demoted copy', () => {
await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());
expect(view.getByTestId('shadow-banner').textContent).toBe('bot-1');
expect(view.getByTestId('chat').getAttribute('data-readonly')).toBe('yes');
+ expect(view.getByTestId('chat').dataset.canonicalChat).toBe('false');
});
it('keeps an ordinary companion writable', async () => {
@@ -142,5 +146,6 @@ describe('a demoted copy', () => {
await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());
expect(view.queryByTestId('shadow-banner')).toBeNull();
expect(view.getByTestId('chat').getAttribute('data-readonly')).toBe('no');
+ expect(view.getByTestId('chat').dataset.canonicalChat).toBe('true');
});
});
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/chatInviteBrowserHandoff.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/chatInviteBrowserHandoff.test.tsx
index 1586f5c41d..df42712213 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/chatInviteBrowserHandoff.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/chatInviteBrowserHandoff.test.tsx
@@ -6,7 +6,7 @@ import { MemoryRouter } from 'react-router-dom';
import { afterEach, expect, it, vi } from 'vitest';
import type { BrowserWindow } from 'electron';
import { drainPendingDeepLinks } from '@/lib/pendingDeepLinks';
-import { ChatInviteHost, requestChatInvite } from '../ChatInviteHost';
+import { ChatInviteHost, reportMalformedChatInvite, requestChatInvite } from '../ChatInviteHost';
import { handleIncomingDeepLink, setDeepLinkMainWindow, takePendingDeepLink } from '../../../../main/deepLink';
vi.mock('electron', () => ({ app: { focus: vi.fn() }, BrowserWindow: class {} }));
@@ -51,9 +51,11 @@ it.each(['darwin', 'win32', 'linux'].flatMap(platform => [false, true].map(alrea
() => false,
);
const acceptInvite = vi.fn();
- Object.defineProperty(window, 'electronAPI', { configurable: true, value: { maker: { chatServer: { acceptInvite } } } });
+ const previewInvite = vi.fn(() => new Promise(() => undefined));
+ Object.defineProperty(window, 'electronAPI', { configurable: true, value: { maker: { chatServer: { acceptInvite, previewInvite } } } });
const receive = (payload: { type: string; token?: string }) => {
if (payload.type === 'chat-invite' && payload.token) requestChatInvite(payload.token);
+ if (payload.type === 'chat-invite-malformed') reportMalformedChatInvite();
};
const pull = () => drainPendingDeepLinks(async () => takePendingDeepLink(), receive);
const connect = () => bridge.onDeepLinkNavigate(() => void pull());
@@ -86,7 +88,7 @@ it.each(['darwin', 'win32', 'linux'].flatMap(platform => [false, true].map(alrea
}
render(<MemoryRouter><ChatInviteHost /></MemoryRouter>);
expect(screen.getAllByRole('dialog')).toHaveLength(1);
- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(anchor.href);
+ expect(previewInvite).toHaveBeenCalledExactlyOnceWith({ link: anchor.href });
expect(acceptInvite).not.toHaveBeenCalled();
expect(takePendingDeepLink()).toBeNull();
// Malformed events must not be forwarded by preload.
@@ -94,3 +96,29 @@ it.each(['darwin', 'win32', 'linux'].flatMap(platform => [false, true].map(alrea
fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));
expect(screen.queryByRole('dialog')).toBeNull();
});
+
+it('turns a truncated clicked invitation into an explicit notice through preload and the pending queue', async () => {
+ let listener: ((payload: unknown) => void) | undefined;
+ const bridge = new Function('fanOutDeepLinkNavigate', 'isDeepLinkProviderConnectId', `${compiled}; return bridge;`)(
+ (callback: (payload: unknown) => void) => { listener = callback; return () => { listener = undefined; }; },
+ () => false,
+ );
+ const previewInvite = vi.fn();
+ Object.defineProperty(window, 'electronAPI', { configurable: true, value: { maker: { chatServer: { previewInvite } } } });
+ const pull = () => drainPendingDeepLinks(async () => takePendingDeepLink(), (payload: { type: string }) => {
+ if (payload.type === 'chat-invite-malformed') reportMalformedChatInvite();
+ });
+ const win = { isDestroyed: () => false, isMinimized: () => false, isVisible: () => true,
+ setAlwaysOnTop: vi.fn(), moveTop: vi.fn(), focus: vi.fn(),
+ webContents: { isLoading: () => false, send: (_channel: string, payload: unknown) => listener?.(payload) },
+ } as unknown as BrowserWindow;
+ setDeepLinkMainWindow(win);
+ bridge.onDeepLinkNavigate(() => void pull());
+ await act(async () => { handleIncomingDeepLink(`cindy://chat-invite/${'truncated'.padEnd(30, 'a')}`, 'open-url'); });
+ render(<MemoryRouter><ChatInviteHost /></MemoryRouter>);
+ expect(screen.getByRole('alert').textContent).toBe('bots.groupChat.server.malformedInvite');
+ expect(previewInvite).not.toHaveBeenCalled();
+ expect(takePendingDeepLink()).toBeNull();
+ fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));
+ expect(screen.queryByRole('dialog')).toBeNull();
+});
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index 1aa63e3594..a8d4bf9061 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -8756,6 +8756,7 @@
"list": {
"createMenu": "Create",
"createTeammate": "New teammate",
+ "joinWithLink": "Enter Invite Link…",
"startChat": "Start the conversation",
"selectChat": "Select a teammate or group chat to start chatting",
"typing": "Typing…",
@@ -9172,6 +9173,15 @@
"files": {
"openFailed": "Couldn’t open the file. It may have been moved or deleted."
},
+ "addFromChat": {
+ "triggerFor": "Add {{name}} to a Group Chat",
+ "addTo": "Add {{name}} to",
+ "newGroup": "New Group Chat…",
+ "existingGroup": "Add to Existing Group",
+ "added": "Added {{name}} to “{{group}}”",
+ "openGroup": "Open Group",
+ "unavailable": "{{name}} can’t join a group chat right now"
+ },
"server": {
"quoteReply": "Quote reply",
"startTopic": "Start a thread",
@@ -9200,8 +9210,11 @@
"copied": "Invitation link copied",
"createLink": "Create invitation link",
"accept": "Accept and join",
- "openGroup": "Open group",
"previewInvite": "Preview invitation",
+ "linkDescription": "Once you join, you become a member and can read the group’s chat history.",
+ "loadingInvite": "Loading invitation…",
+ "retryInvite": "Reload Invitation",
+ "malformedInvite": "This invitation link is incomplete or malformed. Ask the person who invited you for a new link.",
"invalidInvite": "This invitation is invalid, used, expired or revoked. Request a new link.",
"notAllowed": "This account does not have permission. Check your account or contact the group owner.",
"loginRequired": "Sign in to your account and try again.",
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index a5e42bfb1a..95a1a18756 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -8719,6 +8719,7 @@
"list": {
"createMenu": "新規作成",
"createTeammate": "パートナーを作成",
+ "joinWithLink": "招待リンクを入力…",
"startChat": "会話を始める",
"selectChat": "パートナーやグループチャットを選んで、会話を始めましょう",
"typing": "入力中…",
@@ -9135,6 +9136,15 @@
"files": {
"openFailed": "ファイルを開けませんでした。移動または削除された可能性があります"
},
+ "addFromChat": {
+ "triggerFor": "{{name}} をグループチャットに追加",
+ "addTo": "{{name}} の追加先",
+ "newGroup": "グループチャットを作成…",
+ "existingGroup": "既存のグループに追加",
+ "added": "{{name}} を「{{group}}」に追加しました",
+ "openGroup": "グループを開く",
+ "unavailable": "{{name}} は現在グループチャットに参加できません"
+ },
"server": {
"quoteReply": "引用して返信",
"startTopic": "スレッドを作成",
@@ -9163,8 +9173,11 @@
"copied": "招待リンクをコピーしました",
"createLink": "招待リンクを作成",
"accept": "承諾して参加",
- "openGroup": "グループを開く",
"previewInvite": "招待を確認",
+ "linkDescription": "参加するとメンバーになり、チャット履歴を閲覧できます。",
+ "loadingInvite": "招待を読み込んでいます…",
+ "retryInvite": "招待を再読み込み",
+ "malformedInvite": "招待リンクが不完全か、形式が正しくありません。招待した人に新しいリンクを依頼してください。",
"invalidInvite": "招待が無効、使用済み、期限切れ、または無効化されています。新しいリンクを取得してください。",
"notAllowed": "このアカウントに権限がありません。アカウントを確認するか、グループ管理者に連絡してください。",
"loginRequired": "ログインしてから再試行してください。",
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index 4523238f17..b1dd02f6bf 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -8719,6 +8719,7 @@
"list": {
"createMenu": "새로 만들기",
"createTeammate": "새 파트너",
+ "joinWithLink": "초대 링크 입력…",
"startChat": "대화 시작하기",
"selectChat": "파트너 또는 그룹 채팅을 선택해 대화를 시작하세요",
"typing": "입력 중…",
@@ -9135,6 +9136,15 @@
"files": {
"openFailed": "파일을 열지 못했습니다. 이동되었거나 삭제되었을 수 있습니다"
},
+ "addFromChat": {
+ "triggerFor": "{{name}}을(를) 그룹 채팅에 추가",
+ "addTo": "{{name}} 추가할 그룹",
+ "newGroup": "그룹 채팅 만들기…",
+ "existingGroup": "기존 그룹에 추가",
+ "added": "{{name}}을(를) \"{{group}}\"에 추가했습니다",
+ "openGroup": "그룹 열기",
+ "unavailable": "{{name}}은(는) 지금 그룹 채팅에 참여할 수 없습니다"
+ },
"server": {
"quoteReply": "인용 답글",
"startTopic": "스레드 만들기",
@@ -9163,8 +9173,11 @@
"copied": "초대 링크를 복사했습니다",
"createLink": "초대 링크 만들기",
"accept": "수락하고 참여",
- "openGroup": "그룹 열기",
"previewInvite": "초대 확인",
+ "linkDescription": "참여하면 그룹 구성원이 되어 대화 기록을 볼 수 있습니다.",
+ "loadingInvite": "초대를 불러오는 중…",
+ "retryInvite": "초대 다시 불러오기",
+ "malformedInvite": "초대 링크가 불완전하거나 형식이 올바르지 않습니다. 초대한 사람에게 새 링크를 요청하세요.",
"invalidInvite": "유효하지 않거나 사용, 만료 또는 취소된 초대입니다. 새 링크를 받으세요.",
"notAllowed": "현재 계정에 권한이 없습니다. 계정을 확인하거나 그룹 소유자에게 문의하세요.",
"loginRequired": "현재 계정에 로그인한 후 다시 시도하세요.",
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
index 7938047253..60cc217afe 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -8719,6 +8719,7 @@
"list": {
"createMenu": "新建",
"createTeammate": "新建伙伴",
+ "joinWithLink": "输入邀请链接…",
"startChat": "开始对话",
"selectChat": "选择伙伴或群聊,开始对话",
"typing": "正在输入…",
@@ -9135,6 +9136,15 @@
"files": {
"openFailed": "文件没能打开,可能已被移动或删除"
},
+ "addFromChat": {
+ "triggerFor": "将 {{name}} 添加到群聊",
+ "addTo": "将 {{name}} 添加到",
+ "newGroup": "发起群聊…",
+ "existingGroup": "添加到已有群聊",
+ "added": "已将 {{name}} 加入「{{group}}」",
+ "openGroup": "打开群聊",
+ "unavailable": "{{name}} 暂时无法加入群聊"
+ },
"server": {
"quoteReply": "引用回复",
"startTopic": "创建话题",
@@ -9163,8 +9173,11 @@
"copied": "邀请链接已复制",
"createLink": "生成邀请链接",
"accept": "接受并加入",
- "openGroup": "打开群聊",
"previewInvite": "查看邀请",
+ "linkDescription": "确认后你会成为群成员,可阅读群聊记录。",
+ "loadingInvite": "正在读取邀请…",
+ "retryInvite": "重新读取邀请",
+ "malformedInvite": "邀请链接不完整或格式不对,请向邀请人重新获取链接。",
"invalidInvite": "邀请无效、已使用、已过期或已撤销,请获取新的邀请链接。",
"notAllowed": "当前账号没有权限,请检查账号或联系群主。",
"loginRequired": "请先登录当前账号,再重试。",
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
index ef76f7d9f6..c4ad7c08bc 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -8719,6 +8719,7 @@
"list": {
"createMenu": "新增",
"createTeammate": "新增夥伴",
+ "joinWithLink": "輸入邀請連結…",
"startChat": "開始對話",
"selectChat": "選擇夥伴或群聊,開始對話",
"typing": "正在輸入…",
@@ -9135,6 +9136,15 @@
"files": {
"openFailed": "檔案沒能開啟,可能已被移動或刪除"
},
+ "addFromChat": {
+ "triggerFor": "將 {{name}} 新增至群聊",
+ "addTo": "將 {{name}} 新增至",
+ "newGroup": "發起群聊…",
+ "existingGroup": "新增至現有群聊",
+ "added": "已將 {{name}} 加入「{{group}}」",
+ "openGroup": "開啟群組",
+ "unavailable": "{{name}} 暫時無法加入群聊"
+ },
"server": {
"quoteReply": "引用回覆",
"startTopic": "建立話題",
@@ -9163,8 +9173,11 @@
"copied": "已複製邀請連結",
"createLink": "產生邀請連結",
"accept": "接受並加入",
- "openGroup": "開啟群組",
"previewInvite": "查看邀請",
+ "linkDescription": "確認後你會成為群組成員,可閱讀群聊記錄。",
+ "loadingInvite": "正在讀取邀請…",
+ "retryInvite": "重新讀取邀請",
+ "malformedInvite": "邀請連結不完整或格式不正確,請向邀請人重新取得連結。",
"invalidInvite": "邀請無效、已使用、已過期或已撤銷,請取得新的邀請連結。",
"notAllowed": "目前帳號沒有權限,請檢查帳號或聯絡群主。",
"loginRequired": "請先登入目前帳號,再重試。",
diff --git a/apps/desktop/src/renderer/lib/pendingDeepLinks.ts b/apps/desktop/src/renderer/lib/pendingDeepLinks.ts
index 4928f8e8d6..979082d528 100644
--- a/apps/desktop/src/renderer/lib/pendingDeepLinks.ts
+++ b/apps/desktop/src/renderer/lib/pendingDeepLinks.ts
@@ -10,5 +10,5 @@ export async function drainPendingDeepLinks<T extends { type: string }>(
do {
payload = await take();
if (payload) receive(payload);
- } while (payload?.type === 'chat-invite');
+ } while (payload?.type === 'chat-invite' || payload?.type === 'chat-invite-malformed');
}
diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.ts
index a43ca20a6e..dfabcb7065 100644
--- a/apps/desktop/src/renderer/vite-env.d.ts
+++ b/apps/desktop/src/renderer/vite-env.d.ts
@@ -2923,6 +2923,7 @@ interface ElectronAPI {
| { type: 'provider-import'; importId: string }
| { type: 'shared-task-join'; invitation: string; server: string }
| { type: 'chat-invite'; token: string }
+ | { type: 'chat-invite-malformed' }
| { type: 'provider-share-join'; link: string }
| { type: 'settings'; tab: 'voice-input' | 'providers' | 'billing'; connect?: string; intent?: 'topup' },
) => void,
@@ -2942,6 +2943,7 @@ interface ElectronAPI {
| { type: 'provider-import'; importId: string }
| { type: 'shared-task-join'; invitation: string; server: string }
| { type: 'chat-invite'; token: string }
+ | { type: 'chat-invite-malformed' }
| { type: 'provider-share-join'; link: string }
| { type: 'settings'; tab: 'voice-input' | 'providers' | 'billing'; connect?: string; intent?: 'topup' }
| null
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index ffc4f5fc39..ce6c526897 100644
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@ -18,7 +18,7 @@
| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |
| `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 |
| `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |
-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatLoadingImage.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupQuote.tsx, apps/desktop/src/renderer/features/bots/BotGroupRuntimeFailureNotice.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotHomeComputerSetting.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskLink.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotTodoList.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx, apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/CloudCompanionOfflineView.tsx, apps/desktop/src/renderer/features/bots/CompanionShadowBanner.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/WorkbenchSessionList.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupComposerChrome.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botTodo.css, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/chatError.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/companionCloudPresentation.ts, apps/desktop/src/renderer/features/bots/companionCloudStore.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotGroupMentionPicker.tsx, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkbenchSessionPages.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 277 | 38 | 483 |
+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatLoadingImage.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAddToGroupMenu.tsx, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupQuote.tsx, apps/desktop/src/renderer/features/bots/BotGroupRuntimeFailureNotice.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotHomeComputerSetting.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskLink.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotTodoList.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx, apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/CloudCompanionOfflineView.tsx, apps/desktop/src/renderer/features/bots/CompanionShadowBanner.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/WorkbenchSessionList.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupComposerChrome.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botTodo.css, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/chatError.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/companionCloudPresentation.ts, apps/desktop/src/renderer/features/bots/companionCloudStore.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotGroupMentionPicker.tsx, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkbenchSessionPages.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 277 | 38 | 484 |
| `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 17 | 7 | 45 |
| `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 3 |
| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatLoadingImage.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 252 | 38 | 337 |
diff --git a/docs/dev-rules/protocol-compatibility.md b/docs/dev-rules/protocol-compatibility.md
index 2b2af9200a..abb2ec8039 100644
--- a/docs/dev-rules/protocol-compatibility.md
+++ b/docs/dev-rules/protocol-compatibility.md
@@ -22,6 +22,20 @@ Gateway 边界对整块报价校验,非法或无有效币种即整体省略,
模型快照投影,成功刷新缺字段会移除旧展示;没有新权限、数据库迁移或独立价格缓存。
两端可独立升级,完整展示需两端支持。字段只用于报价展示,不参与账单或调用授权。
+## 群聊邀请公开链接
+
+device-link-server 的公开页 `<deviceLinkBase>/chat-invite/join#<token>[?app=cindy|cindycn|cindydev]`
+与 Desktop 粘贴解析共用同一规则:口令为 43 位 base64url,只放在 fragment;URL 无 query、无用户信息;
+fragment 只允许一个闭集 `app` 提示,不允许额外 `#` / `?` 段;协议为 https,仅本机回环地址允许 http。
+页面在电脑上唤起既有 `cindy://chat-invite/<token>`,手机不唤起。客户端解析见
+`packages/device-link/src/chatInvitation.ts`(`parseChatInvitationToken`),继续接受裸口令与
+`cindy://chat-invite/<token>`;链接主机只校验形状,从不作为请求地址,也不据此切换 Chat Server
+或登录区域,口令只以请求正文发给当前账号的 Chat Server。
+
+发布顺序:先发布接受 https 粘贴的客户端,并保留「伙伴 → + → 输入邀请链接…」;sh-dev、sh-prod、
+sgp-prod 都部署该页面后,才把 `createInvite` 生成的链接切换为 https。旧客户端点击 https 链接
+经页面转到 `cindy://` 仍可用,但粘贴 https 链接需要新版客户端。Chat Server API 不变。
+
## 手机直连群的设置管理
现有 `bot-group-chat` 数据可选追加 `supportsSettingsManagement`。仅服务器群的新版 Host
diff --git a/docs/product-rules/bot-group-chat.md b/docs/product-rules/bot-group-chat.md
index 789cb1ec2e..95108a9196 100644
--- a/docs/product-rules/bot-group-chat.md
+++ b/docs/product-rules/bot-group-chat.md
@@ -22,7 +22,16 @@
- **群是独立的对象**,不是某位伙伴的主任务,也不是普通任务。它与伙伴私聊在侧栏同一列表,
保留显式置顶,其余按最新消息排序;群有新消息时向前排列,不另设「群聊」分组,也不进入左侧任务列表。
- 顶部统一用一个加号提供「新建伙伴」和「新建群聊」,搜索同时覆盖伙伴与群聊。
+ 顶部统一用一个加号提供「新建伙伴」和「新建群聊」两个创建入口,分隔线下另有「输入邀请链接…」作为手动加群的后备;
+ 不再常驻单独的加群按钮。搜索同时覆盖伙伴与群聊。
+- **私聊右上角可以把伙伴带进群**:本机可用伙伴的私聊头部有「添加到群聊」:「发起群聊…」打开新建群聊并预选该伙伴;
+ 「添加到已有群聊」只列出你已加入、未归档、该伙伴尚未在内的服务端群,沿用群设置「邀请我的伙伴」的成员邀请,
+ 权限以服务端为准(已加入成员可带入自己的伙伴),失败如实提示。子菜单先写明「将 某伙伴 添加到」,每行是目标群名;
+ 添加进行中菜单不能再次打开,成功提示带「打开群聊」,切换账号后旧提示不再导航。原私聊保持不变,私聊记录不会带进群。
+ 覆盖范围:Desktop 中本机且可用(未暂停、未关闭、未归档)伙伴的主私聊,包括本机 Cindy;
+ 同一头部也用于渠道会话与只读历史任务,这两处不显示该入口;
+ 其他电脑上的伙伴私聊(`/bots/remote/…`)不显示,因为建群与群设置的候选都只来自本机伙伴(`ownedBots` 只映射本机 Profile),
+ 该伙伴的群执行由所在电脑负责。Desktop 目前没有人与人的单聊界面;Mobile 不在本次范围。
- **群未读包括其他人和伙伴的消息**:自己的消息不新增未读。打开群且前台读到末尾才清除;
停在旧记录处或窗口在后台时,保留新消息的提醒。
- **消息操作复用统一组件**:复制、分享、引用回复、创建话题、表情回应与时间使用现有消息操作栏,
@@ -472,13 +481,24 @@ Desktop 群聊只对 `TOKEN_EXPIRED`、`INVALID_TOKEN`、`AUTH_REQUIRED` 的 401
### Desktop 群邀请深链续接
群邀请沿用创建接口生成的 `cindy://chat-invite/<token>`,由主进程校验并暂存目标。
-登录、账号选择与本地数据库就绪后,在主窗口复用邀请预览与确认弹窗;点击链接不自动加入。
+登录、账号选择与本地数据库就绪后,在主窗口打开邀请弹窗并**自动读取邀请**(不显示粘贴框),
+展示群名与邀请人;点击链接不自动加入,仍须点「接受并加入」。读取中可随时关闭;接受进行中不可关闭。
重复打开同一待处理邀请只保留一份,不覆盖正在确认的另一邀请。账号切换仅保留邀请目标,
-新账号重新预览,旧账号的异步结果不得导航或清除待处理邀请。失败保留链接供重试;
-已加入时显示「打开群聊」,不重复调用接受接口。邀请只在本次应用运行的内存中保留,
+新账号重新预览,旧账号的异步结果不得导航或清除待处理邀请。
+同一账号数据代次在读取中更新时,作废旧结果并按当前代次重新读取,不停留在读取中。
+读取结果:已是成员时直接打开该群并关闭弹窗,不调用接受接口;服务端判定无效、已用、过期或撤销时
+说明原因,只留「关闭」;账号无权、未登录或服务暂不可用时说明原因并提供「重新读取邀请」。
+口令残缺或被改动的链接(如聊天软件截断)不带任何链接内容地回报为「邀请链接不完整或格式不对」,
+不访问服务端、不进入日志。邀请只在本次应用运行的内存中保留,
不写路由、日志或持久存储,关闭弹窗或成功处理后清除。
-本段只描述 Desktop 已有应用协议的消费,不声明存在 HTTPS 落地页或 Mobile 加群入口。
-实现见 `main/deepLink.ts`、`renderer/features/bots/ChatInviteHost.tsx`;离线浏览器转交回归见
+侧栏不常驻加群按钮;链接在发送方应用里不可点击时,从伙伴列表加号菜单的「输入邀请链接…」粘贴,
+预览与确认规则相同。该后备在 HTTPS 邀请落地页上线后再评估是否保留。
+「输入邀请链接…」也接受公开页链接 `https://…/chat-invite/join#<token>`,只取口令,交给当前账号的 Chat Server;
+规则与页面一致,见 [跨端协议兼容 · 群聊邀请公开链接](../dev-rules/protocol-compatibility.md)。
+「复制邀请链接」仍生成 `cindy://chat-invite/<token>`,三个环境部署公开页后再切换。
+本段不声明公开页已部署,也不新增 Mobile 加群入口。
+实现见 `main/deepLink.ts`、`renderer/features/bots/ChatInviteHost.tsx`、`ChatInviteDialog.tsx`;
+回归见 `ChatInviteHost.test.tsx`、`deepLink.test.ts`,离线浏览器转交(含残缺链接)见
`chatInviteBrowserHandoff.test.tsx`,原生系统唤起仍需相应平台验收。
### Desktop 群邀请链接的有效期与撤销
diff --git a/packages/device-link/src/__tests__/chatInvitation.test.ts b/packages/device-link/src/__tests__/chatInvitation.test.ts
new file mode 100644
index 0000000000..11453066f1
--- /dev/null
+++ b/packages/device-link/src/__tests__/chatInvitation.test.ts
@@ -0,0 +1,66 @@
+import { describe, expect, it } from 'vitest';
+import { CHAT_INVITATION_PATH, parseChatInvitationToken } from '../chatInvitation.js';
+
+const token = 'Ab0_-'.repeat(8) + 'xyz';
+const page = `https://relay.example.test${CHAT_INVITATION_PATH}#${token}`;
+
+describe('chat invitation links', () => {
+ it('keeps accepting bare tokens and the existing custom-scheme link', () => {
+ expect(token).toHaveLength(43);
+ expect(parseChatInvitationToken(token)).toBe(token);
+ expect(parseChatInvitationToken(` cindy://chat-invite/${token}\n`)).toBe(token);
+ });
+
+ it('reads the token from the public page link, with or without a build hint, and from shared text', () => {
+ for (const input of [
+ page,
+ `${page}?app=cindy`, `${page}?app=cindycn`, `${page}?app=cindydev`,
+ `https://relay.example.test/prefix${CHAT_INVITATION_PATH}#${token}`,
+ `http://localhost:3000${CHAT_INVITATION_PATH}#${token}`,
+ `http://127.0.0.1:3000${CHAT_INVITATION_PATH}#${token}`,
+ `http://[::1]:3000${CHAT_INVITATION_PATH}#${token}`,
+ `http://[::1]${CHAT_INVITATION_PATH}#${token}?app=cindydev`,
+ `本机预览:http://[::1]:3000${CHAT_INVITATION_PATH}#${token}。`,
+ `Local preview: http://[::1]:3000${CHAT_INVITATION_PATH}#${token}.`,
+ `[本机](http://[::1]:3000${CHAT_INVITATION_PATH}#${token})`,
+ `邀请你加入群聊:${page}`, `Join us: ${page}.`, `「${page}」`, `[群聊](${page})`,
+ ]) expect(parseChatInvitationToken(input)).toBe(token);
+ // The secret lives only in the fragment, never in the HTTP request.
+ const url = new URL(page);
+ expect(url.pathname + url.search).not.toContain(token);
+ });
+
+ it.each([
+ ['a query string', `https://relay.example.test${CHAT_INVITATION_PATH}?token=${token}#${token}`],
+ ['the token in the query', `https://relay.example.test${CHAT_INVITATION_PATH}?${token}`],
+ ['the token in the path', `https://relay.example.test${CHAT_INVITATION_PATH}/${token}`],
+ ['user info', `https://user:[email protected]${CHAT_INVITATION_PATH}#${token}`],
+ ['plain http to a public host', `http://relay.example.test${CHAT_INVITATION_PATH}#${token}`],
+ ['plain http to a public IPv6 host', `http://[2001:db8::1]${CHAT_INVITATION_PATH}#${token}`],
+ ['two loopback IPv6 invitation links', `http://[::1]:3000${CHAT_INVITATION_PATH}#${token} https://[::1]${CHAT_INVITATION_PATH}#${token}`],
+ ['IPv6 user info', `https://user@[::1]${CHAT_INVITATION_PATH}#${token}`],
+ ['an IPv6 link with a query', `http://[::1]:3000${CHAT_INVITATION_PATH}?t=1#${token}`],
+ ['an unknown app hint', `${page}?app=other`],
+ ['a redirect hint', `${page}?redirect=https://evil.example.test`],
+ ['two fragment parameters', `${page}?app=cindy?app=cindycn`],
+ ['an extra fragment segment', `${page}#again`],
+ ['a short token', page.slice(0, -1)],
+ ['a long token', `${page}a`],
+ ['a non-base64url token', page.slice(0, -1) + '='],
+ ['a different page', `https://relay.example.test/shared-task/join#${token}`],
+ ['another custom scheme', `cindycn://chat-invite/${token}`],
+ ['a legacy custom scheme', `xdt-maker://chat-invite/${token}`],
+ ['javascript', `javascript:alert(1)//${CHAT_INVITATION_PATH}#${token}`],
+ ['an uppercase scheme', page.replace('https', 'HTTPS')],
+ ['two invitation links', `${page} ${page.replace('relay', 'other')}`],
+ ['a truncated custom link', `cindy://chat-invite/${token.slice(0, 20)}`],
+ ['empty text', ' '],
+ ])('rejects %s', (_label, input) => {
+ expect(parseChatInvitationToken(input)).toBeNull();
+ });
+
+ it('rejects non-string and oversized input', () => {
+ expect(parseChatInvitationToken(undefined as unknown as string)).toBeNull();
+ expect(parseChatInvitationToken(`${page} ${'x'.repeat(8192)}`)).toBeNull();
+ });
+});
diff --git a/packages/device-link/src/chatInvitation.ts b/packages/device-link/src/chatInvitation.ts
new file mode 100644
index 0000000000..22fb37c0d6
--- /dev/null
+++ b/packages/device-link/src/chatInvitation.ts
@@ -0,0 +1,44 @@
+/**
+ * Chat Server group invitations. The public page keeps the token in the fragment —
+ * `<deviceLinkBase>/chat-invite/join#<token>[?app=cindy|cindycn|cindydev]` — and desktop
+ * opens `cindy://chat-invite/<token>`. Only the token is used: the client always asks its
+ * own Chat Server, so a link's host is checked for shape and never becomes a request target
+ * or a reason to switch servers or regions. Rules match the page's own validation.
+ */
+export const CHAT_INVITATION_PATH = '/chat-invite/join';
+const TOKEN = /^[A-Za-z0-9_-]{43}$/;
+const CUSTOM_SCHEME_PREFIX = 'cindy://chat-invite/';
+const LOOPBACK = new Set(['localhost', '127.0.0.1', '[::1]']);
+
+/**
+ * Accept a bare token, the existing `cindy://chat-invite/<token>` link, or one public page
+ * link in shared text. Anything else (query, user info, extra fragment segments, unknown
+ * app hint, other schemes, several invitation links) is null.
+ */
+export function parseChatInvitationToken(input: string): string | null {
+ if (typeof input !== 'string' || input.length > 8192) return null;
+ const text = input.trim();
+ if (TOKEN.test(text)) return text;
+ if (text.startsWith(CUSTOM_SCHEME_PREFIX)) {
+ const token = text.slice(CUSTOM_SCHEME_PREFIX.length);
+ return TOKEN.test(token) ? token : null;
+ }
+ // Trailing sentence punctuation is not part of a link; it can never complete a token.
+ // Brackets end a link (Markdown `[text](url)`) except around an IPv6 host such as `[::1]`.
+ const links = text.match(/https?:\/\/(?:\[[0-9A-Fa-f:.]+\])?[^\s<>"',。!?、()「」“”‘’[\])]+/g)
+ ?.map((link) => link.replace(/[.,;!]+$/, ''))
+ .filter((link) => {
+ try { return new URL(link).pathname.endsWith(CHAT_INVITATION_PATH); } catch { return false; }
+ });
+ if (links?.length !== 1) return null;
+ try {
+ const url = new URL(links[0]);
+ if (url.username || url.password || url.search) return null;
+ if (url.protocol !== 'https:' && !(url.protocol === 'http:' && LOOPBACK.has(url.hostname))) return null;
+ const [token, hint, extra] = url.hash.slice(1).split('?');
+ if (extra !== undefined || (hint !== undefined && !/^app=(cindy|cindycn|cindydev)$/.test(hint))) return null;
+ return TOKEN.test(token) ? token : null;
+ } catch {
+ return null;
+ }
+}
diff --git a/packages/device-link/src/index.ts b/packages/device-link/src/index.ts
index d16bb621fc..888464433d 100644
--- a/packages/device-link/src/index.ts
+++ b/packages/device-link/src/index.ts
@@ -42,6 +42,7 @@ export * from "./sharedTaskInvitation.js";
export * from "./sharedTaskProbe.js";
export * from "./providerShareApi.js";
export * from "./providerShareInvitation.js";
+export * from "./chatInvitation.js";
export * from "./providerShareCatalog.js";
export * from "./providerShareEnvelope.js";
export * from "./providerGroup.js";
diff --git a/packages/maker-shared/src/botGroupChat.ts b/packages/maker-shared/src/botGroupChat.ts
index a92c6f6b4f..328bbc27f5 100644
--- a/packages/maker-shared/src/botGroupChat.ts
+++ b/packages/maker-shared/src/botGroupChat.ts
@@ -554,7 +554,8 @@ export type ChatGroupAction =
| { type: 'archive'; archived: boolean; expectedRevision: number };
export interface ChatServerApi {
manage(input: { groupId: string; action: ChatGroupAction }): Promise<ChatServerResult<Record<never, never>>>;
- ownedBots(): Promise<ChatServerResult<{ bots: Array<{ actorId: string; name: string }> }>>;
+ /** `botId` is the local teammate id behind each Chat Server actor. */
+ ownedBots(): Promise<ChatServerResult<{ bots: Array<{ actorId: string; botId?: string; name: string }> }>>;
refreshProfile(): Promise<ChatServerResult<Record<never, never>>>;
status(): Promise<{ enabled: boolean; connected: boolean }>;
thread(input: { groupId: string; rootId: string; before?: number; sourceMessageIds?: string[] }): Promise<ChatServerResult<{