Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
import { searchQuickAccessItems } from '@core/context/quickAccess/entity-search';
import type {
Bucket,
EntityItem,
QuickAccessItem,
QuickAccessList,
QuickAccessListOptions,
UserItem,
} from '@core/context/quickAccess/types';
import type { CrmContactEntity } from '@entity';
import { type Accessor, createRoot, createSignal } from 'solid-js';
import { afterEach, describe, expect, it, vi } from 'vitest';
import type { CategoryFilter } from './types';
import { type CommandContactSource, useCommandItems } from './useCommandItems';
const VIEWER = 'macro|[email protected]';
const mocks = vi.hoisted(() => ({
lists: {} as Record<string, () => QuickAccessItem[]>,
searchDms: (): QuickAccessItem[] => [],
}));
vi.mock('@app/lib/analytics/posthog', () => ({
useFeatureFlag: () => () => ({ enabled: false, loading: false }),
}));
vi.mock('@core/context/user', () => ({
useUserId: () => () => 'macro|[email protected]',
}));
vi.mock('@app/constants/hotkeys', () => ({
GO_TO_COMMAND_SCOPE: 'go-to',
GO_TO_LEADER_KEY: 'g',
}));
vi.mock('@core/context/quickAccess', () => ({
useQuickAccess: () => ({
useList: (first: Bucket | QuickAccessListOptions) => {
const items = () => {
if (typeof first === 'string') return mocks.lists[first]?.() ?? [];
if (first.enabled && !first.enabled()) return [];
const buckets = Array.isArray(first.buckets) ? first.buckets : [];
return searchQuickAccessItems(
[
...buckets.flatMap((bucket) => mocks.lists[bucket]?.() ?? []),
...(buckets.includes('dm') ? mocks.searchDms() : []),
],
first.searchTerm?.() ?? ''
);
};
return {
items,
totalCount: () => items().length,
hasMore: () => false,
isLoading: () => false,
isLoadingMore: () => false,
error: () => undefined,
loadMore: async () => {},
} satisfies QuickAccessList;
},
usesRecordSelection: () => false,
usesSearchProjection: () => false,
}),
}));
vi.mock('@core/hotkey/getCommands', () => ({
getActiveCommandsFromScope: () => [],
}));
vi.mock('@core/hotkey/state', () => ({
activeScope: () => 'global',
hotkeyScopeTree: new Map(),
}));
vi.mock('./recency', () => ({ getCommandLastUsedAt: () => undefined }));
vi.mock('./state', () => ({
CommandState: {
commandScopeCommands: () => [],
isEntityActionMode: () => false,
},
}));
const contact = (
id: string,
name: string,
email: string
): CrmContactEntity => ({
type: 'crm_contact',
id,
ownerId: 'team',
companyId: 'company',
name,
email,
hidden: false,
lastInteraction: '2026-09-01T00:00:00Z',
});
const user = (email: string, name: string): UserItem => ({
kind: 'user',
bucket: 'person',
id: `macro|${email}`,
searchText: `${name} | ${email}`,
sortTimestamp: 0,
timestamps: {},
data: { id: `macro|${email}`, email, name },
});
const directMessage = (
id: string,
name: string,
other: string
): EntityItem => ({
kind: 'entity',
bucket: 'dm',
id,
searchText: name,
sortTimestamp: 1,
timestamps: {},
data: {
type: 'channel',
id,
name,
ownerId: VIEWER,
channelType: 'direct_message',
participantIds: [VIEWER, other],
},
});
let dispose: (() => void) | undefined;
afterEach(() => {
dispose?.();
mocks.lists = {};
mocks.searchDms = () => [];
});
function setup(initialCategory: CategoryFilter = 'dms', crmEnabled = true) {
return createRoot((cleanup) => {
dispose = cleanup;
const [query, setQuery] = createSignal('');
const [category, setCategory] = createSignal(initialCategory);
const [contacts, setContacts] = createSignal<CrmContactEntity[]>([]);
const [users, setUsers] = createSignal<UserItem[]>([]);
const [dms, setDms] = createSignal<EntityItem[]>([]);
const [searchDms, setSearchDms] = createSignal<EntityItem[]>([]);
const [hasMore, setHasMore] = createSignal(false);
const [loading, setLoading] = createSignal(false);
mocks.lists = { person: users, dm: dms };
mocks.searchDms = searchDms;
const discovery = {
search: undefined as Accessor<string> | undefined,
active: undefined as Accessor<boolean> | undefined,
loadMore: vi.fn(async () => {}),
};
const contactDiscovery = (
search: Accessor<string>,
active: Accessor<boolean>
): CommandContactSource => {
discovery.search = search;
discovery.active = active;
return {
contacts: () => (active() ? contacts() : []),
isLoading: loading,
hasMore,
isLoadingMore: () => false,
error: () => undefined,
loadMore: discovery.loadMore,
};
};
const result = useCommandItems(query, category, {
searchActive: () => true,
contactDiscovery: crmEnabled ? contactDiscovery : undefined,
});
return {
result,
discovery,
ids: () => result.items().map((item) => item.id),
setQuery,
setCategory,
setContacts,
setUsers,
setDms,
setSearchDms,
setHasMore,
setLoading,
};
});
}
describe('command menu contact discovery', () => {
it.each(['all', 'dms'] as const)(
'merges a DM found beyond the recent list with its person and CRM alias in %s',
(category) => {
const t = setup(category);
const person = user('[email protected]', 'Sample Person');
const dm = directMessage('older-dm', 'Sample Person', person.id);
t.setUsers([person]);
t.setQuery('Sample');
expect(t.ids()).toEqual([`search:${category}:Sample`, person.id]);
// Typed cache search finds this DM without adding it to the browse list.
t.setSearchDms([dm]);
expect(t.ids()).toEqual([`search:${category}:Sample`, dm.id]);
t.setContacts([
contact('crm-person', 'Sample CRM alias', person.data.email),
]);
expect(t.ids()).toEqual([`search:${category}:Sample`, dm.id]);
const result = t.result.items().find((item) => item.id === dm.id);
expect(result?.searchText).toContain(person.data.email);
expect(result?.searchText).toContain('Sample CRM alias');
// Hydrating the browse list later must not add a second row.
t.setDms([dm]);
expect(t.ids()).toEqual([`search:${category}:Sample`, dm.id]);
}
);
it.each(['all', 'dms'] as const)(
'finds a teammate without a DM or CRM contact in %s, including with CRM disabled',
(category) => {
const t = setup(category, false);
const gabriel = user('[email protected]', 'Gabriel Birman');
t.setUsers([gabriel, user('[email protected]', 'Valentina')]);
expect(t.ids()).toEqual([]);
t.setQuery('Gabriel');
expect(t.ids()).toEqual([`search:${category}:Gabriel`, gabriel.id]);
t.setQuery('[email protected]');
expect(t.ids()).toEqual([
`search:${category}:[email protected]`,
gabriel.id,
]);
t.setQuery('');
expect(t.ids()).toEqual([]);
t.setQuery('Gabriel');
t.setCategory('channels');
expect(t.ids()).not.toContain(gabriel.id);
}
);
it('keeps a teammate separate from group DMs and excludes the viewer', () => {
const t = setup('dms', false);
const gabriel = user('[email protected]', 'Gabriel Birman');
const viewer = user('[email protected]', 'Gabriel Viewer');
const group = directMessage('group-gabriel', 'Gabriel group', gabriel.id);
if (group.data.type !== 'channel') throw new Error('Expected channel');
group.data.participantIds = [VIEWER, gabriel.id, 'macro|[email protected]'];
t.setUsers([gabriel, viewer]);
t.setDms([group]);
t.setQuery('Gabriel');
expect(t.ids()).toContain(gabriel.id);
expect(t.ids()).toContain(group.id);
expect(t.ids()).not.toContain(viewer.id);
});
it.each(['all', 'dms'] as const)(
'replaces a matching person with their DM when it arrives in %s',
(category) => {
const t = setup(category);
const gabriel = user('[email protected]', 'Gabriel Birman');
t.setUsers([gabriel]);
t.setQuery('Gabriel');
t.setContacts([
contact('crm-gabriel', 'Gabriel External', '[email protected]'),
]);
expect(t.ids()).toEqual([
`search:${category}:Gabriel`,
gabriel.id,
'crm-gabriel',
]);
const dm = directMessage('dm-gabriel', 'Gabriel Birman', gabriel.id);
t.setDms([dm]);
expect(t.ids()).toEqual([
`search:${category}:Gabriel`,
dm.id,
'crm-gabriel',
]);
t.setQuery('[email protected]');
t.setContacts([]);
expect(t.ids()).toEqual([`search:${category}:[email protected]`, dm.id]);
}
);
it('lists contacts beyond the cached seed under People for a typed query', () => {
const t = setup('dms');
t.setContacts([
contact('crm-asher', 'Asher at HackerNoon', '[email protected]'),
]);
expect(t.discovery.active?.()).toBe(false);
expect(t.ids()).toEqual([]);
t.setQuery('asher');
expect(t.discovery.active?.()).toBe(true);
expect(t.discovery.search?.()).toBe('asher');
expect(t.ids()).toEqual(['search:dms:asher', 'crm-asher']);
});
it('adds contacts to a typed All search but keeps blank All on recency', () => {
const t = setup('all');
t.setContacts([contact('crm-pat', 'Pat Doe', '[email protected]')]);
expect(t.discovery.active?.()).toBe(false);
expect(t.ids()).not.toContain('crm-pat');
t.setQuery('pat doe');
expect(t.ids()).toContain('crm-pat');
});
it.each(['all', 'dms'] as const)(
'keeps existing DMs ahead of recent CRM contacts in %s as server results arrive',
(category) => {
const t = setup(category);
const dm = directMessage(
'dm-jack',
'Jackson Kustec',
'macro|[email protected]'
);
t.setDms([dm]);
t.setQuery('jack');
expect(t.ids()).toEqual([`search:${category}:jack`, dm.id]);
t.setContacts([
{
...contact('crm-jack', 'Jack Healey', '[email protected]'),
lastInteraction: new Date().toISOString(),
},
]);
expect(t.ids()).toEqual([`search:${category}:jack`, dm.id, 'crm-jack']);
t.setQuery('');
expect(t.ids()).toEqual([dm.id]);
}
);
it('keeps contacts out of unrelated categories', () => {
const t = setup('documents');
t.setQuery('asher');
t.setContacts([contact('crm-asher', 'Asher', '[email protected]')]);
expect(t.discovery.active?.()).toBe(false);
expect(t.ids()).not.toContain('crm-asher');
t.setCategory('people');
expect(t.discovery.active?.()).toBe(true);
});
it('prefers the Macro user sharing the email even when only the CRM name matched', () => {
const t = setup('dms');
const asher = user('[email protected]', 'Asher Smith');
t.setUsers([asher]);
t.setContacts([
contact('crm-asher', 'Asher at HackerNoon', ' [email protected]'),
contact('crm-plus', 'Asher Press', '[email protected]'),
]);
t.setQuery('hackernoon');
const items = t.result.items();
// The plus alias is a different address, so it stays a contact.
expect(items.map((item) => item.id)).toEqual([
'search:dms:hackernoon',
asher.id,
'crm-plus',
]);
expect(items[1].kind).toBe('user');
expect(items.some((item) => item.id === 'crm-asher')).toBe(false);
});
it("opens the person's existing conversation instead of a second row", () => {
const t = setup('dms');
const asher = user('[email protected]', 'Asher Smith');
const dm = directMessage('dm-asher', 'Asher Smith', asher.id);
// People already lists the conversation; only the CRM name matches.
t.setUsers([asher]);
t.setDms([dm]);
t.setContacts([
contact('crm-asher', 'Asher at HackerNoon', asher.data.email),
]);
t.setQuery('hackernoon');
expect(t.ids()).toEqual(['search:dms:hackernoon', 'dm-asher']);
t.setQuery('asher');
expect(t.ids().filter((id) => id === 'dm-asher')).toHaveLength(1);
});
it('pages contacts with the rest of the menu and reports their loading', async () => {
const t = setup('dms');
t.setQuery('pat');
expect(t.result.pagination.hasMore()).toBe(false);
t.setHasMore(true);
expect(t.result.pagination.hasMore()).toBe(true);
await t.result.pagination.loadMore();
expect(t.discovery.loadMore).toHaveBeenCalledOnce();
t.setLoading(true);
expect(t.result.isLoadingEntities()).toBe(true);
});
});