Open-source AI Security Operations Center: alert fusion, LLM-agent triage, MITRE ATT&CK investigation, and a replayable decision ledger for every agent step. Self-hostable, runs with no API keys, MIT licensed. Ships an MCP server for Claude, Cursor and Continue.
Python agentic-aiai-securityalert-triageblue-teamcybersecuritydetection-engineeringincident-responselanggraphllm-agentsmcpmitre-attackmodel-context-protocolpurple-teamsecurity-operationsself-hostedsiemsoarsocthreat-detectionthreat-intelligence
/**
* Client + server helpers for the public investigation-replay page (`/r/<slug>`).
*
* The snapshot shape mirrors `services/api/app/services/replay_redaction.py`.
* Everything here is already redacted server-side, so it is safe to render
* publicly and to embed in OG cards.
*/
export interface ReplayStepDecision {
reason?: string | null;
tool?: string | null;
confidence?: number | null;
}
export interface ReplayStep {
seq: number;
kind: string;
agent: string;
summary: string;
durationMs: number;
decision?: ReplayStepDecision | null;
}
export interface ReplayEvidenceCard {
seq: number;
summary: string;
source: string;
}
export interface ReplayGraphNode {
id: string;
label: string;
kind: string;
}
export interface ReplayGraphEdge {
source: string;
target: string;
label?: string;
}
export interface ReplaySnapshot {
schemaVersion: number;
caseId: string;
title: string;
verdict: string;
model: string;
elapsedMs: number;
stepCount: number;
toolCallCount: number;
llmCallCount: number;
evidenceSourceCount: number;
techniques: string[];
steps: ReplayStep[];
evidenceCards: ReplayEvidenceCard[];
attackGraph: { nodes: ReplayGraphNode[]; edges: ReplayGraphEdge[] };
}
export interface PublicReplay {
slug: string;
title: string;
case_id: string;
snapshot: ReplaySnapshot;
view_count: number;
created_at: string;
}
/** Internal API origin for server-side fetches (mirrors next.config rewrites). */
function apiBase(): string {
return (
process.env.API_URL ||
process.env.INTERNAL_API_URL ||
process.env.NEXT_PUBLIC_API_URL ||
"http://localhost:8000"
).replace(/\/$/, "");
}
/**
* "This replay does not exist" and "we could not reach the API" are different
* answers, and the page renders a different page for each. Collapsing both
* into `null` meant a 500, a 502 or a DNS failure reached `notFound()`, so an
* operator whose API was down was told their link was wrong.
*/
export type PublicReplayResult =
| { kind: "ok"; replay: PublicReplay }
| { kind: "missing" }
| { kind: "unavailable"; status: number | null };
/** Server-side fetch of a published replay. */
export async function fetchPublicReplay(slug: string): Promise<PublicReplayResult> {
let res: Response;
try {
res = await fetch(`${apiBase()}/api/v1/r/${encodeURIComponent(slug)}`, {
// Public, cacheable content; revalidate periodically at the edge.
next: { revalidate: 300 },
});
} catch {
// No response at all: DNS failure, connection refused, timeout.
return { kind: "unavailable", status: null };
}
if (res.status === 404 || res.status === 410) return { kind: "missing" };
if (!res.ok) return { kind: "unavailable", status: res.status };
try {
return { kind: "ok", replay: (await res.json()) as PublicReplay };
} catch {
return { kind: "unavailable", status: res.status };
}
}