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 { MACRO_NEW_BOT_ID } from '@core/constant/macroNew';
import { throwOnErr } from '@core/util/result';
import { agentHarnessServiceClient } from '@service-agent-harness/client';
import {
type QueryClient,
queryOptions,
useQuery,
} from '@tanstack/solid-query';
import type { Accessor } from 'solid-js';
import { v7 as uuidv7 } from 'uuid';
import { queryClient } from '../client';
import { agentSessionWarmKeys } from './keys';
const CLIENT_WARM_TTL_MS = 5 * 60 * 1000;
type WarmSession = {
id: string;
model: string;
instructions?: string | null;
expires: number;
};
function warmAgentSessionQueryOptions(owner: string | undefined) {
return queryOptions({
queryKey: agentSessionWarmKeys.owner(owner).queryKey,
enabled: !!owner,
staleTime: CLIENT_WARM_TTL_MS,
gcTime: CLIENT_WARM_TTL_MS,
retry: false,
refetchOnWindowFocus: false,
queryFn: async () => {
if (!owner) return null;
// Keep one reservation in flight across Home -> Agents navigation.
// Aborting on unmount would abandon its server ID and warm another.
const result = await throwOnErr(() =>
agentHarnessServiceClient.warm(uuidv7())
);
if (result.session) {
return {
id: result.session.id,
model: result.session.model,
instructions: result.session.instructions,
expires: Date.now() + CLIENT_WARM_TTL_MS,
} satisfies WarmSession;
}
return null;
},
});
}
/** Best-effort speculation; never read its data into a Suspense boundary. */
export function useWarmAgentSessionQuery(userId: Accessor<string | undefined>) {
return useQuery(() => warmAgentSessionQueryOptions(userId()));
}
/** Why a new session did or did not start on a warm reservation. */
export type WarmClaim =
| 'hit'
/** A reservation was ready on another model. */
| 'miss_model'
/** No reservation, or only an expired one. */
| 'miss_none_ready'
/** A reservation was ready with other instructions. */
| 'miss_other'
/** The session is not the owner's default agent, so none could match. */
| 'not_attempted';
/**
* Consume once, only for the owner and exact default-agent configuration.
* Keep the empty cache fresh until creation finishes and releases server capacity.
*/
export function takeWarmAgentSession(
options: {
userId?: string;
botId?: string;
modelOverride?: string;
instructions?: string;
repoUrl?: string;
},
client: QueryClient = queryClient
): { id?: string; claim: WarmClaim } {
if (
!options.userId ||
(options.botId && options.botId !== MACRO_NEW_BOT_ID) ||
options.repoUrl
)
return { claim: 'not_attempted' };
const key = agentSessionWarmKeys.owner(options.userId).queryKey;
const entry = client.getQueryData<WarmSession | null>(key);
if (!entry) return { claim: 'miss_none_ready' };
if (entry.expires <= Date.now()) {
client.setQueryData(key, null);
return { claim: 'miss_none_ready' };
}
if (options.modelOverride && options.modelOverride !== entry.model)
return { claim: 'miss_model' };
if (
(options.instructions?.trim() || '') !== (entry.instructions?.trim() || '')
)
return { claim: 'miss_other' };
client.setQueryData(key, null);
return { id: entry.id, claim: 'hit' };
}
/** Prepare one replacement after creation succeeds, joining any existing request. */
export function replenishWarmAgentSession(
userId: string,
client: QueryClient = queryClient
): void {
const key = agentSessionWarmKeys.owner(userId).queryKey;
const query = client.getQueryState<WarmSession | null>(key);
// A different configuration may have left a usable reservation in the cache.
// No query means this owner has not mounted a warming surface.
if (!query || query.data) return;
client.invalidateQueries(
{ queryKey: key, exact: true },
{ cancelRefetch: false }
);
}