Integration Examples

App backend

const upstream = await fetch(`${process.env.GENAUG_API_BASE_URL}/v1/responses`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GENAUG_API_KEY}`,
    "Content-Type": "application/json",
    "X-Idempotency-Key": requestId,
  },
  body: JSON.stringify({
    model: "hermes",
    agent: process.env.GENAUG_SUPPORT_AGENT_ID,
    user: authenticatedUser.id,
    input: message,
    stream: true,
  }),
});

const responseHeaders = new Headers();
for (const name of ["Content-Type", "Cache-Control", "X-Accel-Buffering", "Retry-After"]) {
  const value = upstream.headers.get(name);
  if (value) responseHeaders.set(name, value);
}
return new Response(upstream.body, {
  status: upstream.status,
  headers: responseHeaders,
});

Browser and mobile clients call this existing authenticated app boundary. They never hold the runtime key. Generate the request ID once per app message and reuse it across transport retries. Preserve the upstream streaming and Retry-After headers and relay the body without buffering.

Direct app capability

Hermes selects exact granted operation
  -> General Augment signs Project/user/session/Agent/release identity
  -> app verifies signature and replay protection
  -> app applies existing authorization
  -> app domain service

Agent replacement

Use one explicit server-side selector during Candidate proof. Do not dual-write or send one action through old and new Agent runtimes. Remove the legacy path only after Live acceptance.

Exact proof

genaug agent test support --user customer_123 --json
genaug run show <run-id> --json
genaug release diff <release-id>
genaug dashboard open

Evidence must be hosted and tied to the exact Candidate, Agent, and user.

Reference fixture gallery

The repository carries these framework-neutral OpenAPI fixtures for deterministic integration proof. Run their smoke prompt through genaug agent test; local output is not release evidence.

Fixture	OpenAPI source
Customer-success CRM	tests/fixtures/dummy_apps/customer_success_crm/openapi.yaml
Helpdesk triage	tests/fixtures/dummy_apps/helpdesk_triage/openapi.yaml
Commerce operations	tests/fixtures/dummy_apps/commerce_ops/openapi.yaml
Scheduling and calendar	tests/fixtures/sample_openapi_specs/calendar_api.yaml
Healthcare records	tests/fixtures/sample_openapi_specs/health_app_api.yaml
Field ops platform	tests/fixtures/dummy_apps/field_ops_platform/openapi.yaml