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 { envsafe, str } from 'envsafe';
import type { CanvasBrowserConfig } from './canvas/render';
import type { D1Database } from './traces-db';
export type Bindings = CanvasBrowserConfig & {
/** Tags exported spans with deployment.environment (matches DD_ENV). */
ENVIRONMENT: string | undefined;
/** OTLP/HTTP traces endpoint; unset disables trace export. */
OTEL_EXPORTER_OTLP_ENDPOINT: string | undefined;
/** Datadog API key attached to trace exports when the endpoint is a
* Datadog intake; secret, set via `wrangler secret put DD_API_KEY`. */
DD_API_KEY: string | undefined;
ANTHROPIC_API_KEY: string | undefined;
CEREBRAS_API_KEY: string | undefined;
OPENAI_API_KEY: string | undefined;
/** Optional: only needed when a request names the `google` provider. */
GOOGLE_GENERATIVE_AI_API_KEY: string | undefined;
SYNC_WS_BASE: string;
/** D1 database storing edit-session traces. Absent in envs without the binding. */
TRACES_DB: D1Database | undefined;
/** Shared admin key gating the trace-read endpoint; validated via getEnv. */
TRACE_ADMIN_KEY: string | undefined;
/** Org internal service-to-service key; accepted on the trace endpoints via
* the `x-internal-auth-key` header (used by the delete-document worker). */
INTERNAL_API_KEY: string | undefined;
};
export type Env = ReturnType<typeof validateEnv>;
function validateEnv(rawEnv: Bindings) {
const {
ANTHROPIC_API_KEY,
CEREBRAS_API_KEY,
OPENAI_API_KEY,
GOOGLE_GENERATIVE_AI_API_KEY,
SYNC_WS_BASE,
TRACE_ADMIN_KEY,
INTERNAL_API_KEY,
} = rawEnv;
return envsafe(
{
ANTHROPIC_API_KEY: str({ allowEmpty: false }),
CEREBRAS_API_KEY: str({ allowEmpty: false }),
OPENAI_API_KEY: str({ allowEmpty: false }),
// Empty when unset; resolving a `google` model then fails loudly at
// request time instead of blocking every other request at boot.
GOOGLE_GENERATIVE_AI_API_KEY: str({ default: '', allowEmpty: true }),
SYNC_WS_BASE: str({ allowEmpty: false }),
// Empty when unset; the trace-read endpoint stays closed until it's set.
TRACE_ADMIN_KEY: str({ default: '', allowEmpty: true }),
// Empty when unset; internal-key trace access stays closed until it's set.
INTERNAL_API_KEY: str({ default: '', allowEmpty: true }),
},
{
env: {
ANTHROPIC_API_KEY,
CEREBRAS_API_KEY,
OPENAI_API_KEY,
GOOGLE_GENERATIVE_AI_API_KEY,
SYNC_WS_BASE,
TRACE_ADMIN_KEY,
INTERNAL_API_KEY,
},
}
);
}
let cachedEnv: Env | undefined;
export function getEnv(rawEnv: Bindings): Env {
if (cachedEnv === undefined) {
cachedEnv = validateEnv(rawEnv);
}
return cachedEnv;
}