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 type { TagFilterMode } from '@app/features/next-soup/filters/filter-store/types';
import type { EntityData } from '@entity';
import { hasOwnTouchFloor } from '@queries/soup/normalized-cache/own-touch';
import type {
SoupApiItem,
SoupProperty,
} from '@service-storage/generated/schemas';
import { match } from 'ts-pattern';
export const LIST_VIEWS = [
'home',
'recent',
'agents',
'mail',
'documents',
'tasks',
'channels',
'calls',
'companies',
'folders',
'search',
] as const;
export type ListView = (typeof LIST_VIEWS)[number];
export const LIST_VIEW_PATHS = {
home: '/home',
recent: '/recent',
agents: '/agents',
mail: '/mail',
documents: '/documents',
tasks: '/tasks',
channels: '/channels',
calls: '/calls',
companies: '/companies',
folders: '/folders',
search: '/search',
} as const satisfies Record<ListView, string>;
/** External linked accounts (WhatsApp); a settings-like view, not an entity list. */
export const EXTERNAL_VIEW_PATH = '/external';
export const LIST_VIEW_ID = {
home: 'home',
recent: 'recent',
agents: 'agents',
mail: 'mail',
documents: 'documents',
tasks: 'tasks',
channels: 'channels',
calls: 'calls',
companies: 'companies',
folders: 'folders',
search: 'search',
} as const satisfies Record<ListView, string>;
export const isListViewID = (id: string | null | undefined): id is ListView => {
if (!id) return false;
return LIST_VIEWS.includes(id as 'home');
};
/**
* List views whose entities are taggable, so their filter bar surfaces the tag
* filter. Mirrors TAGGABLE_ENTITY_TYPES (document/task/thread/project/chat/
* call). Channels, companies, and the mixed home feed are omitted.
*/
export const TAGGABLE_LIST_VIEWS: ReadonlySet<ListView> = new Set<ListView>([
'documents',
'tasks',
'mail',
'folders',
'agents',
'calls',
]);
/** The entity id a soup item normalizes under (channels/calls nest theirs). */
const soupItemEntityId = (item: SoupApiItem): string => {
switch (item.tag) {
case 'channel':
return item.data.channel.id;
case 'call':
return item.data.callId;
default:
return item.data.id;
}
};
export const soupItemMatchesListView = (
item: SoupApiItem,
view: ListView | undefined
): boolean =>
match(view)
.with(
'agents',
() =>
item.tag === 'chat' ||
(item.tag === 'document' && item.data.subType?.type === 'skill')
)
.with('mail', () => item.tag === 'emailThread')
.with(
'documents',
() => item.tag === 'document' && item.data.subType?.type !== 'task'
)
.with(
'tasks',
() => item.tag === 'document' && item.data.subType?.type === 'task'
)
.with('channels', () => item.tag === 'channel')
.with('calls', () => item.tag === 'call')
.with('folders', () => item.tag === 'project')
.with('home', 'search', undefined, () => true)
// Membership in the recent view is "did I touch it", not a type check:
// only rows that carry a touch timestamp (from the touched_by_me page)
// or an outstanding optimistic own-touch belong. Without this, any
// websocket-inserted entity — including other people's — would enter
// the feed.
.with(
'recent',
() => item.touched_at != null || hasOwnTouchFloor(soupItemEntityId(item))
)
// Customers lists companies and, on its People tab, contacts.
.with(
'companies',
() => item.tag === 'crmCompany' || item.tag === 'crmContact'
)
.exhaustive();
const propertiesMatchTagFilter = (
properties: readonly SoupProperty[] | undefined,
tagOptionIds: readonly string[],
mode: TagFilterMode
): boolean => {
if (tagOptionIds.length === 0) return true;
if (!properties?.length) return false;
const held = new Set<string>();
for (const { value } of properties) {
if (value?.type === 'SelectOption') {
for (const id of value.value) held.add(id);
}
}
return mode === 'all'
? tagOptionIds.every((id) => held.has(id))
: tagOptionIds.some((id) => held.has(id));
};
/**
* Whether a soup item carries the given tag option ids — at least one of them
* ('any', the default) or every one ('all'). Tags are SelectOption property
* values on the item and option ids are globally unique, so the owning
* definition is not consulted. An empty filter matches everything. Used to
* gate optimistic websocket inserts so the grouped render (which skips client
* predicates) still honors an active tag filter.
*/
export const soupItemMatchesTagFilter = (
item: SoupApiItem,
tagOptionIds: readonly string[],
mode: TagFilterMode = 'any'
): boolean =>
propertiesMatchTagFilter(
'properties' in item.data ? item.data.properties : undefined,
tagOptionIds,
mode
);
/**
* `soupItemMatchesTagFilter` for mapped entities. Rendered rows are checked
* against the active tag filter as a client-side backstop, since the server
* does not tag-filter every soup union. Rows carrying loaded properties are
* matched on those (emails included); rows without loaded properties never
* match, so they are excluded rather than leaking through unfiltered.
*/
export const entityMatchesTagFilter = (
entity: EntityData,
tagOptionIds: readonly string[],
mode: TagFilterMode = 'any'
): boolean =>
propertiesMatchTagFilter(
'properties' in entity ? entity.properties : undefined,
tagOptionIds,
mode
);