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 { analytics } from '@app/lib/analytics';
import { Telemetry } from '@macro-inc/observability';
import type { EmailSendAttemptFieldsFragment } from '@service-storage/graphql/generated/graphql';
import { CombinedError } from '@urql/core';
import type { EmailSendIntent } from './send-queue';
/** Retries get short traces correlated by the durable attempt ID across reloads. */
export async function traceEmailSend<T>(
operation: 'persist' | 'submit' | 'cancel' | 'status',
attempt: { attemptId: string | number; linkId: string | number },
run: () => Promise<T>
): Promise<T> {
return Telemetry.span(`email.send.${operation}`, async (span) => {
span.setAttr('email_send.attempt_id', attempt.attemptId);
span.setAttr('email_send.link_id', attempt.linkId);
try {
return await run();
} catch (error) {
// GraphQL exceptions may contain input values; export only classification.
span.error(`Email ${operation} failed: ${emailSendFailureKind(error)}`);
throw error;
}
});
}
export type EmailSendObservation = {
operation:
| 'enqueue'
| 'cancel'
| 'restore'
| 'recover'
| 'status'
| 'refresh';
outcome:
| 'started'
| 'queued'
| 'committed'
| 'completed'
| 'error'
| 'observed';
status?: EmailSendAttemptFieldsFragment['status'];
durationMs?: number;
failureKind?: 'network' | 'graphql' | 'unknown';
};
/** Classify failures without exporting error messages, response bodies, or extensions. */
export function emailSendFailureKind(
error: unknown
): NonNullable<EmailSendObservation['failureKind']> {
return error instanceof CombinedError
? error.networkError
? 'network'
: 'graphql'
: 'unknown';
}
/** Explicit fields only: never pass a request, snapshot, or raw exception to telemetry. */
export function recordEmailSend(
observation: EmailSendObservation,
intent?: EmailSendIntent
): void {
try {
const attributes = {
'email_send.operation': observation.operation,
'email_send.outcome': observation.outcome,
...(observation.failureKind
? { 'email_send.failure_kind': observation.failureKind }
: {}),
...(observation.status
? { 'email_send.status': observation.status }
: {}),
...(observation.durationMs !== undefined
? { 'email_send.duration_ms': Math.max(0, observation.durationMs) }
: {}),
...(intent
? {
'email_send.attempt_id': intent.uuid,
'email_send.link_id': intent.metadata.payload.input.attempt.linkId,
'email_send.phase': intent.phase,
'email_send.cancellation_requested': !!intent.cancellationRequested,
}
: {}),
};
if (observation.outcome === 'error') {
Telemetry.warn('email_send.lifecycle', attributes);
} else {
Telemetry.info('email_send.lifecycle', attributes);
}
} catch {
// Exporter failures cannot change send authority or draft persistence.
}
}
/** Product analytics for one accepted send: flags only, never content or addresses. */
export function trackEmailMessageSent(properties: { isReply: boolean }): void {
try {
analytics.track('email_message_sent', properties);
} catch (error) {
Telemetry.error(error);
}
}