Documentation

Consumer Integration Guide

Integration Reference • Wiring LaoGPT, EvergreenAI, X360, and XTransfer into XVantage


1. Overview

XTND XVantage provides specialized integration patterns tailored to each application in the XTND DYNAMICS family:

Application Integration Strategy Primary Vantage Subsystems
LaoGPT.com Zero-modification edge interceptor + Sonar AI proxy VantageEdgeInterceptor, xtnd-sonar-api, Radar SDK
EvergreenAI.la Multi-model proxy + enterprise quota gating xtnd-sonar-api, Sonar SDK, Sentinel Breaker
X360 Task Command Embeddable UI dashboard widgets + client analytics Argus SDK, Radar SDK
XTND Transfer Gateway request timing + circuit breaker failovers VantageEdgeInterceptor, Sentinel Breaker

2. LaoGPT.com Integration

LaoGPT utilizes a dual integration: transparent edge request capture and reverse-proxied LLM calls.

flowchart LR
    User["LaoGPT Visitor"] --> CFEdge["Cloudflare Worker\n(VantageEdgeInterceptor)"]
    CFEdge --> Origin["LaoGPT Origin Server"]
    Origin --> Sonar["Sonar AI Gateway\n(api.sonar.vantage.xgi.io)"]
    Sonar --> Claude["Anthropic Claude 3.7 Sonnet"]

2.1 Edge Worker Wrapper (src/worker.ts)

import { MemoryStorageAdapter } from '@xtnd/vantage-storage-local';
import { VantageStorageManager, VantageHttpTransport } from '@xtnd/vantage-sync-manager';
import { VantageEdgeInterceptor } from '@xtnd/vantage-radar';

const storageManager = new VantageStorageManager({
  storageAdapter: new MemoryStorageAdapter(),
  transport: new VantageHttpTransport({ endpoint: 'https://api.vantage.xgi.io' }),
});

const interceptor = new VantageEdgeInterceptor(storageManager);

export default {
  async fetch(request: Request, env: any, ctx: ExecutionContext): Promise<Response> {
    return interceptor.handleRequest(
      request,
      (req) => fetch(req), // Origin fetch
      { cf: request.cf, waitUntil: (p) => ctx.waitUntil(p) }
    );
  },
};

2.2 LLM Proxy Call in LaoGPT Backend

// Point Anthropic SDK to Sonar Gateway
const anthropic = new Anthropic({
  baseURL: 'https://api.sonar.vantage.xgi.io/v1/proxy/anthropic',
  apiKey: env.ANTHROPIC_API_KEY,
});

3. EvergreenAI.la Integration

3.1 The website: XRADAR

The Evergreen AI website reports to XVANTAGE with XRADAR (radar-sdk.md). The site's configuration and every tracking point are in EvergreenAI-LA/EvergreenAI-LA-WWW, src/app/core/radar.ts. It runs on the site's three addresses (evergreenai.la, www.evergreenai.la, www.everlao.com), which the Radar gateway's ALLOWED_ORIGINS lists. The site keeps no copy of that list. The visits are seen in Argus under Websites.

// src/main.ts: XRADAR loads as its own chunk alongside the app
void import('./app/core/radar').then((m) => m.startTracking());

3.2 AI budgets and loop protection

EvergreenAI enforces strict per-account budget caps and runaway loop protection.

import { sonar } from '@xtnd-dynamics/xtnd-sonar-sdk';
import { VantageCircuitBreaker } from '@xtnd/vantage-sentinel';

// 1. Check account budget before dispatching agent
const quota = sonar.quotas.getQuota('openai');
if (quota && quota.remainingPercent < 1.0) {
  throw new Error('EvergreenAI Monthly AI Budget Exhausted. Upgrade plan to continue.');
}

// 2. Wrap autonomous agent loops
const breaker = new VantageCircuitBreaker(storageManager, {
  maxAgentSteps: 20,
  maxCostPerSessionUsd: 3.00,
});

for (let step = 1; step <= maxSteps; step++) {
  if (!breaker.canExecute()) break;
  
  const output = await executeAgentAction(step);
  breaker.recordAgentStep(step, output.stepCostUsd);
}

4. X360 Task Command Integration

X360 Task Command embeds live Argus status badges and quota cards inside its operations command deck:

import { renderQuotaWidget, renderStatusWidget } from '@xtnd-dynamics/xtnd-argus-sdk';
import { radar } from '@xtnd-dynamics/xtnd-radar-sdk';

// Initialize UX telemetry
radar.initPage({ appName: 'X360 Task Command', route: '/ops' });

// Render live widgets in UI
function mountCommandCenter() {
  document.getElementById('ops-status-container')!.innerHTML = `
    ${renderStatusWidget({ serviceName: 'Vantage Exchange', status: 'OPERATIONAL', latencyMs: 19 })}
    ${renderQuotaWidget({
      provider: 'Anthropic Claude',
      monthlyLimitUsd: 1500,
      currentSpendUsd: 620,
      remainingCreditsUsd: 880,
      remainingPercent: 58.6,
      renewsInDays: 12
    })}
  `;
}