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
SDK documentation
Start here
src/render.ts: the shared TypeDoc conversion and Markdown/HTML outputs.scripts/generate.ts: renders Markdown and HTML into ignoreddist/docs/.README.md: local documentation preview commands.
Scope
- Owns the public SDK reference and static documentation worker.
- SDK behavior and source comments belong in
../sdk. - Consumers may package canonical Markdown; keep Deno bundles, tool catalogs and backend artifacts in their own build packages.
Checks
bun run type-checkbun run testrenders fresh build outputs and tests linked public contracts.bun run docs:devserves the generated HTML for browser verification.
Gotchas
- Nothing generated is committed:
dist/docs/{markdown,html}are build outputs. Edit the SDK source; retain links to generated API request/response types. @routingand@agentare agent-only block tags:renderSdkDocsreturns them asAgentNotesforpackages/code-mode-sdkand removes them before writing any output, so the public reference never shows them.- TypeDoc and its Markdown plugin must use the same TypeDoc runtime instance.
The workspace also contains other versions; preserve the peer resolution in
src/render.tsand test actual generation after dependency changes. - Use TypeDoc's reflection and Markdown plugin for signatures and visibility; do not add a separate TypeScript declaration parser.
- Keep
expandObjectsenabled so object alias declarations show concrete fields. CLAUDE.mdis a symlink to this guide.