Logging, audit trails, and explainability

Request

GET /api/logs?limit=50&cursor=... HTTP/1.1
Host: omegaengine.ai
Authorization: Bearer OMEGAENGINE_API_KEY
Content-Type: application/json

Example · cURL

curl -X GET "https://omegaengine.ai/api/logs?limit=20" \
  -H "Authorization: Bearer $OMEGAENGINE_API_KEY" \
  -H "Content-Type: application/json"

Example · TypeScript (Node)

const OMEGAENGINE_API_KEY = process.env.OMEGAENGINE_API_KEY!;

type RequestLog = {
  id: string;
  createdAt: string;
  scenario: string | null;
  topic: string | null;
  riskLevel: "LOW" | "MEDIUM" | "HIGH" | null;
  riskScore: number | null;
  safetyScore: number | null;
  probabilityOfSuccess: number | null;
  probabilityOfRegret: number | null;
  policyOutcome: string | null;
  needsHumanReview: boolean | null;
  ethicsConcern: boolean | null;
  // ...plus all other fields
};

async function fetchRecentDecisions(limit = 50): Promise<RequestLog[]> {
  const res = await fetch(
    `https://omegaengine.ai/api/logs?limit=${limit}`,
    {
      headers: {
        "Authorization": `Bearer ${OMEGAENGINE_API_KEY}`,
        "Content-Type": "application/json",
      },
    }
  );

  if (!res.ok) {
    throw new Error(`Failed to fetch logs: ${res.status}`);
  }

  const json = await res.json();
  // depending on the version, you may get { data: RequestLog[] }
  return Array.isArray(json) ? json : (json.data ?? []);
}

fetchRecentDecisions()
  .then((rows) => {
      "Latest high-risk decisions:",
      rows.filter((r) => r.riskLevel === "HIGH")
    );
  })
  .catch(console.error);

Example pattern · daily export job

// Pseudo-code: run this as a cron to ship OmegaEngine logs
// from /api/logs into your SIEM or data warehouse.

async function exportOmegaLogsSince(timestamp: string) {
  const res = await fetch(
    `https://omegaengine.ai/api/logs?limit=500&since=${encodeURIComponent(timestamp)}`,
    {
      headers: {
        "Authorization": `Bearer ${process.env.OMEGAENGINE_API_KEY}`,
        "Content-Type": "application/json",
      },
    }
  );

  const data = await res.json();
  const rows = Array.isArray(data) ? data : (data.data ?? []);

  // 1) Normalize / map only fields you care about
  const events = rows.map((row) => ({
    ts: row.createdAt,
    scenario: row.scenario,
    topic: row.topic,
    risk_level: row.riskLevel,
    risk_score: row.riskScore,
    safety_score: row.safetyScore,
    policy_outcome: row.policyOutcome,
    needs_human_review: row.needsHumanReview,
    ethics_concern: row.ethicsConcern,
    model: row.model,
    latency_ms: row.latencyMs,
    tokens_used: row.tokensUsed,
    endpoint: row.endpoint,
    client_tag: row.clientTag,
  }));

  // 2) Push into your SIEM / warehouse of choice
  await sendToDatadog(events);
  // or sendToSplunk(events), sendToS3(events), sendToSnowflake(events)...
}