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 { throwOnErr } from '@core/util/result';
import { queryClient } from '@queries/client';
import { authServiceClient } from '@service-auth/client';
import type { CursorApiKeyStatus } from '@service-auth/generated/schemas';
import { useMutation, useQuery } from '@tanstack/solid-query';
import { authKeys } from './keys';
function fetchCursorApiKeyStatus() {
return throwOnErr(() => authServiceClient.getCursorApiKeyStatus());
}
function fetchCursorModels() {
return throwOnErr(() => authServiceClient.listCursorModels());
}
/**
* What the query reads as before its answer arrives. Placeholder rather than
* pending, so reading `data` never suspends the surface asking — the message
* composer must paint on first render, and blocking the input on one optional
* mention entry is not a trade it would ever make. A caller that needs to
* tell "not yet" from "no key" has `isPlaceholderData`.
*/
const NOT_CONNECTED: CursorApiKeyStatus = {
registered: false,
defaultModelId: null,
updatedAt: null,
};
/**
* Whether the signed-in user has a Cursor API key stored.
*
* The response deliberately carries no part of the key, so this is only ever
* enough to render "connected" or "not connected" — which is all the settings
* surface needs.
*/
export function useCursorApiKeyStatusQuery(
enabled: () => boolean = () => true
) {
return useQuery(() => ({
queryKey: authKeys.cursorApiKeyStatus.queryKey,
enabled: enabled(),
queryFn: fetchCursorApiKeyStatus,
placeholderData: NOT_CONNECTED,
}));
}
/**
* Stores a Cursor API key, replacing any existing one.
*
* Invalidates rather than writing the response into the cache: the mutation
* returns the same shape the query does, but a user who pastes a key in two
* tabs should see one truth, and the round trip is cheap.
*/
export function useSaveCursorApiKey() {
return useMutation(() => ({
mutationFn: async (apiKey: string) =>
throwOnErr(async () => await authServiceClient.putCursorApiKey(apiKey)),
onSuccess: async () => {
await queryClient.invalidateQueries({
queryKey: authKeys.cursorApiKeyStatus.queryKey,
});
},
}));
}
/**
* Forgets the stored Cursor API key.
*
* This does not revoke anything at Cursor; the Harness settings copy makes
* that distinction explicit.
*/
export function useDisconnectCursorApiKey() {
return useMutation(() => ({
mutationFn: async () =>
throwOnErr(async () => await authServiceClient.deleteCursorApiKey()),
onSuccess: async () => {
await queryClient.invalidateQueries({
queryKey: authKeys.cursorApiKeyStatus.queryKey,
});
},
}));
}
/**
* The models the user's Cursor account offers, for agent configuration.
*
* Enabled only once a key is registered: the endpoint asks Cursor live through
* that key, and a keyless account has nothing to list. Kept fresh for a while
* — the model roster changes rarely, and a settings visit is not worth a round
* trip every time.
*/
export function useCursorModelsQuery(enabled: () => boolean) {
return useQuery(() => ({
queryKey: authKeys.cursorModels.queryKey,
queryFn: fetchCursorModels,
enabled: enabled(),
staleTime: 5 * 60 * 1000,
}));
}
/**
* Chooses the model the user's sessions start on.
*
* Invalidates the status query so the picker reflects the stored choice from
* one source of truth, exactly as the key mutations do.
*/
export function useSetCursorDefaultModel() {
return useMutation(() => ({
mutationFn: async (modelId: string) =>
throwOnErr(
async () => await authServiceClient.putCursorDefaultModel(modelId)
),
onSuccess: async () => {
await queryClient.invalidateQueries({
queryKey: authKeys.cursorApiKeyStatus.queryKey,
});
},
}));
}