Stack integration
Stack integration
Section titled “Stack integration”The stack reaches Atlas through four node types. Each is reached over Atlas’s
public HTTP API (the engine-node pattern, like codex.*) — not a storage
driver. Every node self-skips (empty outputs + a warning) when
ATLAS_BASE_URL is unset, so a workflow that includes an Atlas step still runs
on a host where Atlas isn’t wired.
Environment
Section titled “Environment”| Variable | Purpose |
|---|---|
ATLAS_BASE_URL | Atlas service base URL. Unset → nodes self-skip. |
ATLAS_AUTH_TOKEN | Per-tenant JWT for the read / write-back surface. |
ATLAS_INGEST_ENDPOINT_ID | Default ingest endpoint id (single-source fallback). |
ATLAS_INGEST_SECRET | Default ingest HMAC secret (single-source fallback). |
atlas.resolve
Section titled “atlas.resolve”Read a canonical entity and its cross-system view.
- Inputs:
entity_type(string, required),entity_id(string, required). - Outputs:
entity(json),cross_references(json).
Reads are system-agnostic — the canonical entity is already reconciled across whatever sources fed it, so no source selector is needed.
atlas.ingest
Section titled “atlas.ingest”Deliver a source event/envelope to an ingest endpoint (signs the body for you).
- Inputs:
payload(json, required). - Config:
endpoint_id,secret(fall back to theATLAS_INGEST_*envs). - Outputs:
envelope_id(string),duplicate(boolean).
The endpoint id + secret are per source MIS — set them in node config to pick which source a workflow is feeding. See Ingest.
atlas.map
Section titled “atlas.map”Dry-run a mapping of a source document onto a canonical entity.
- Inputs:
document(json, required),mapping_id(string, optional). - Config:
spec(inlineMappingSpec, alternative tomapping_id). - Outputs:
ok(boolean),output(json).
Provide exactly one of mapping_id or spec (Atlas 422s otherwise). See
Mapping.
atlas.write
Section titled “atlas.write”Push a canonical entity out to a source system (the multi-system replacement for
the retired single-MIS_BASE_URL write nodes).
- Inputs:
system(string, required),entity_type(string, required),entity_id(string, required). - Outputs:
external_id(string),created(boolean),lane(string).
The system input selects which connected MIS/ERP Atlas writes to; Atlas gates
the push on that connector’s write-lane.