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 { ToRuntimeMessage, ToServerMessage } from './protocol/generated';
/** A connection to the agent proxy carrying agent_runtime_protocol's typed
* tagged messages. `connect` returns the production implementation; tests
* implement this interface directly with a mock. Assign both handlers before
* traffic flows. */
export interface Socket {
/** Assigned by the consumer; fired once the socket is ready to send. */
onOpen: () => void;
/** Assigned by the consumer; fired for each decoded upstream message. */
onMessage: (message: ToRuntimeMessage) => void;
send(message: ToServerMessage): void;
close(): void;
}
/** Dial the production `Socket`: one JSON `ToServerMessage`/`ToRuntimeMessage`
* value per WebSocket frame, no envelope. No reconnect: a dropped socket
* stays dropped. */
export function connect(url: string): Socket {
const ws = new WebSocket(url);
const socket: Socket = {
onOpen: () => {},
onMessage: () => {},
send: (message) => ws.send(JSON.stringify(message)),
close: () => ws.close(),
};
ws.addEventListener('open', () => socket.onOpen());
ws.addEventListener('message', (event) => {
let message: ToRuntimeMessage;
try {
const parsed: unknown = JSON.parse(String(event.data));
if (!isRuntimeMessage(parsed)) throw new Error('invalid message');
message = parsed;
} catch {
console.error('[socket] ignoring invalid upstream message', event.data);
return;
}
socket.onMessage(message);
});
ws.addEventListener('close', (event) => {
console.warn('[socket] closed', { code: event.code, reason: event.reason });
});
ws.addEventListener('error', (event) => {
console.error('[socket] error', event);
});
return socket;
}
function isRuntimeMessage(value: unknown): value is ToRuntimeMessage {
return (
typeof value === 'object' &&
value !== null &&
(value as { type?: unknown }).type === 'acp'
);
}