Topolo Nexus

Documentation Map

• Application hub
• Application API surface
• Machine system JSON
• Machine application JSON
• applications/catalog
• API Key Scope Mismatches
• Auth Session and Role Drift
• Resource Binding Sync Failures
• CORS and Cross-Origin Failures
• Stale Deploy and Cache Issues

What It Is

AI gateway and usage-management layer for the Topolo platform.

Central AI gateway and management dashboard for all Topolo applications. Track usage, control spend, and manage API keys across your entire organization.

const nexus = new NexusClient({ gatewayUrl: 'https://nexus-gateway.topolo.io', authToken: userJwtToken, // From TopoloAuth appId: 'my-topolo-app', });

// Simple text completion const result = await nexus.text('Explain quantum computing'); console.log(result.text); console.log(`Tokens: ${result.usage?.total_tokens}`);

API Reference

Coverage: curated

Source: Applications/TopoloNexus/package.json

Source exists in repo: yes

Package description identifies Nexus as the central AI management gateway.

App API page: /reference/apps/topolo-nexus

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

No Auth service ID mapped in docs yet.

API key scopes

No API key scopes were found in the checked-in Auth catalog for this system.

Service permissions

No role/permission catalog rows were found in the checked-in Auth permissions seed.

Data Ownership

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

• Applications/TopoloNexus/apps/gateway/wrangler.toml -> topolo-nexus-gateway

Build and deploy commands

• deploy:gateway — Applications/TopoloNexus/package.json :: cd apps/gateway && npm run deploy
• deploy:dashboard — Applications/TopoloNexus/package.json :: cd apps/dashboard && npm run deploy
• build — Applications/TopoloNexus/apps/dashboard/package.json :: tsc && vite build
• preview — Applications/TopoloNexus/apps/dashboard/package.json :: vite preview
• deploy — Applications/TopoloNexus/apps/dashboard/package.json :: npm run build && wrangler pages deploy dist --project-name topolo-nexus-dashboard
• deploy — Applications/TopoloNexus/apps/gateway/package.json :: wrangler deploy
• build — Applications/TopoloNexus/packages/nexus-client/package.json :: tsup src/index.ts --format cjs,esm --dts

Failure Modes

• No Auth service ID is registered for this system.
• No primary host is registered in the system registry.

Debugging Runbooks

Start with these entrypoints:

• Applications/TopoloNexus/apps/gateway/wrangler.toml
• Applications/TopoloNexus/package.json
• Applications/TopoloNexus/README.md
• Applications/TopoloNexus/apps/dashboard/package.json
• Applications/TopoloNexus/apps/gateway/package.json
• Applications/TopoloNexus/packages/nexus-client/package.json

Linked runbooks

• API Key Scope Mismatches
• Auth Session and Role Drift
• Resource Binding Sync Failures
• CORS and Cross-Origin Failures
• Stale Deploy and Cache Issues

Change Log / Verification

Lifecycle: active

Last verified: 2026-03-29

Any code change to this system is expected to update the canonical docs in Websites/docs and refresh the verification date.