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 { reviewsHostedContent } from '@app/features/reviews-view/reviews-hosted-content';
import { getChannelParams } from '@block-channel/utils/link';
import { usePrForeignEntityQuery } from '@block-pr/data/queries';
import { prDisplayName } from '@block-pr/util/prKey';
import type { SplitContent } from '@components/app/split-layout/layoutManager';
import type { EntityIconSelector } from '@core/component/EntityIcon';
import { getIconConfig } from '@core/component/EntityIcon';
import { fileTypeToBlockName } from '@core/constant/allBlocks';
import {
type ItemEntity,
isAccessiblePreviewItem,
useItemPreview,
} from '@queries/preview';
import type { Favorite } from '@service-storage/generated/schemas/favorite';
import type { Accessor } from 'solid-js';
/** Icon and legacy block name for a favorite; hosted details use their own route. */
export function favoriteBlockName(favorite: Favorite) {
if (favorite.entityType === 'document') {
return fileTypeToBlockName(favorite.documentSubType ?? favorite.fileType);
}
if (favorite.entityType === 'email_thread') return 'email' as const;
if (favorite.entityType === 'foreign_entity') return 'pr' as const;
// Passes chat/channel/project/call through and remaps channel_message and
// CRM entity types to their block names.
return fileTypeToBlockName(favorite.entityType);
}
/**
* The split content that opens a favorite. Channel-message favorites open
* their owning channel; PR favorites open the Reviews detail route.
*/
export function favoriteSplitContent(favorite: Favorite): SplitContent {
if (favorite.entityType === 'foreign_entity') {
// GitHub PRs are the only foreign-entity favorites exposed by the app today.
return reviewsHostedContent({ type: 'pr', id: favorite.entityId })!;
}
if (favorite.entityType === 'channel_message' && favorite.channelId) {
return {
type: 'channel',
id: favorite.channelId,
params: getChannelParams(favorite.entityId),
};
}
return { type: favoriteBlockName(favorite), id: favorite.entityId };
}
export function favoriteIconType(favorite: Favorite): EntityIconSelector {
if (
favorite.entityType === 'channel' ||
favorite.entityType === 'channel_message'
) {
return (favorite.channelType ?? 'channel') as EntityIconSelector;
}
if (favorite.entityType === 'document') {
// icon: true keeps e.g. docx showing the write icon instead of pdf
return fileTypeToBlockName(
favorite.documentSubType ?? favorite.fileType,
true
);
}
return favoriteBlockName(favorite);
}
/**
* The preview entity that names a favorite: the favorite's own entity for
* kinds the preview pipeline covers, the owning channel for channel-message
* favorites, and undefined for kinds without a preview fetcher
* (e.g. crm_contact), which fall back to their entity-kind label.
*/
function favoritePreviewEntity(favorite: Favorite): ItemEntity | undefined {
switch (favorite.entityType) {
case 'channel':
return { id: favorite.entityId, type: 'channel' };
case 'channel_message':
return favorite.channelId
? { id: favorite.channelId, type: 'channel' }
: undefined;
case 'email_thread':
return { id: favorite.entityId, type: 'email' };
case 'document':
case 'agent_session':
case 'chat':
case 'project':
case 'call':
case 'crm_company':
case 'database':
case 'form':
return { id: favorite.entityId, type: favorite.entityType };
default:
return undefined;
}
}
/** Entity-kind fallback used until a favorite's preview resolves. */
export function favoriteDisplayName(favorite: Favorite): string {
return (
getIconConfig(favoriteIconType(favorite) ?? 'default').prettyName ||
'Untitled'
);
}
/**
* Reactive display name for a favorite: subscribes to the entity's preview
* (fetching it if needed) and resolves like `favoriteDisplayName`.
*
* Call during component setup. The favorite's identity must be stable for
* the component's lifetime (favorites lists key rows by entity, so it is).
*/
export function useFavoriteDisplayName(favorite: Favorite): Accessor<string> {
if (favorite.entityType === 'foreign_entity') {
const query = usePrForeignEntityQuery(() => favorite.entityId);
return () => {
const data = query.isPending ? undefined : query.data;
return data
? (data.pullRequest.name ?? prDisplayName(data.prRef))
: favoriteDisplayName(favorite);
};
}
const entity = favoritePreviewEntity(favorite);
if (!entity) return () => favoriteDisplayName(favorite);
const [preview] = useItemPreview(() => entity);
return () => {
const item = preview();
if (isAccessiblePreviewItem(item) && item.name.trim()) return item.name;
return favoriteDisplayName(favorite);
};
}