ARES - authorized red-team engagement automation with dashboard, campaign scope, module orchestration, OPSEC controls, encrypted vault, and reporting.
Python active-directorycloud-securitydefensive-validationfastapigood-first-issuemitre-attackopsecreactred-teamreportingsecurity
ci: stabilize first release workflow
Mafifrizi277a33c111a9
diff --git a/.github/dependabot.yml b/.github/dependabot.ymlindex b3b023f..c52ae5a 100644--- a/.github/dependabot.yml+++ b/.github/dependabot.yml@@ -1,6 +1,5 @@version: 2updates:- # Python dependencies- package-ecosystem: pipdirectory: /schedule:@@ -8,47 +7,17 @@ updates:day: mondaytime: "09:00"timezone: UTC- open-pull-requests-limit: 10- reviewers:- - ares-framework/maintainers+ open-pull-requests-limit: 3labels:- dependencies- - security- # Group non-security updates to reduce PR noise- groups:- core-deps:- patterns:- - "fastapi"- - "pydantic*"- - "uvicorn"- - "structlog"- - "cryptography"- - "PyJWT"- ad-deps:- patterns:- - "impacket"- - "ldap3"- cloud-deps:- patterns:- - "boto3"- - "botocore"- - "azure-*"- - "google-cloud-*"- - "msal"- # Security updates always open immediately regardless of groups- ignore:- # Skip major version bumps — review manually- - dependency-name: "impacket"- update-types: ["version-update:semver-major"]- - dependency-name: "pydantic"- update-types: ["version-update:semver-major"]- # GitHub Actions- - package-ecosystem: github-actions- directory: /+ - package-ecosystem: npm+ directory: /frontendschedule:interval: weeklyday: monday+ time: "09:00"+ timezone: UTC+ open-pull-requests-limit: 3labels:- dependencies- - cidiff --git a/.github/workflows/ci.yml b/.github/workflows/ci.ymlindex ba65063..be89ca7 100644--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@ -2,212 +2,44 @@ name: ARES CIon:push:- branches: [main, develop]+ branches: [main]pull_request:branches: [main]-# Sane defaults for all jobsdefaults:run:shell: bash+env:+ ARES_SECRET_KEY: "ci-secret-key-placeholder-min32chars!!"+ ARES_ENCRYPTION_KEY: "ci-encryption-key-placeholder-32chars"+ ARES_DEFAULT_ADMIN_PASSWORD: "CiAdmin1!-placeholder-secret99"+jobs:- lint:- name: Lint & Type Check+ backend:+ name: Backend Unit Testsruns-on: ubuntu-lateststeps:- - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2- - uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0- with: { python-version: "3.11" }+ - uses: actions/checkout@v4+ - uses: actions/setup-python@v5+ with:+ python-version: "3.13"+ - run: python -m pip install --upgrade pip- run: pip install -e ".[dev]"- - run: ruff check .- - run: black --check .- - run: mypy ares --ignore-missing-imports+ - run: python -m compileall ares tests+ - run: pytest tests/unit -q --tb=short --timeout=60 --timeout-method=thread --maxfail=1frontend:- name: Frontend Lint, Test & Build+ name: Frontend Buildruns-on: ubuntu-lateststeps:- - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2- - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0+ - uses: actions/checkout@v4+ - uses: actions/setup-node@v4with:node-version: "22"cache: npmcache-dependency-path: frontend/package-lock.json- run: npm ciworking-directory: frontend- - run: npm run lint- working-directory: frontend- - run: npm run typecheck- working-directory: frontend- - run: npm run test- working-directory: frontend- run: npm run buildworking-directory: frontend-- test:- name: Tests (Python ${{ matrix.python-version }})- runs-on: ubuntu-latest- strategy:- matrix:- python-version: ["3.10", "3.11", "3.12", "3.13"]- env:- # Required by AresSettings — safe placeholder values for CI only- ARES_SECRET_KEY: "ci-secret-key-placeholder-min32chars!!"- ARES_ENCRYPTION_KEY: "ci-encryption-key-placeholder-32chars"- ARES_DEFAULT_ADMIN_PASSWORD: "CiAdmin1!-placeholder-secret99"- CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}- steps:- - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2- - uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0- with: { python-version: "${{ matrix.python-version }}" }- - run: pip install -e ".[dev]"- - name: Compile Python sources- run: python -m compileall .- - name: Collect tests- run: pytest --collect-only- - name: Unit tests with coverage threshold- run: pytest tests/unit/ --cov=ares --cov-report=xml --cov-fail-under=85 # threshold: 80→82→85→90 — next target: 90 -v- - name: Upload coverage to Codecov- if: ${{ env.CODECOV_TOKEN != '' }}- uses: codecov/codecov-action@1e68e06f1dbfde0e4cefc87efeba9e4643565303 # v4.6.0- with:- token: ${{ env.CODECOV_TOKEN }}- fail_ci_if_error: false-- integration:- name: Integration Tests (dry-run)- runs-on: ubuntu-latest- needs: [test]- env:- ARES_SECRET_KEY: "ci-secret-key-placeholder-min32chars!!"- ARES_ENCRYPTION_KEY: "ci-encryption-key-placeholder-32chars"- ARES_DEFAULT_ADMIN_PASSWORD: "CiAdmin1!-placeholder-secret99"- steps:- - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2- - uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0- with: { python-version: "3.11" }- - run: pip install -e ".[dev]"- - name: Integration tests (dry-run mode — no real network)- run: pytest tests/integration/ -v --timeout=60 -m "not live"- - name: Simulation scenarios- run: pytest tests/simulation/ -v --timeout=120 -m "not live"-- security:- name: Security Scan- runs-on: ubuntu-latest- steps:- - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2- - uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0- with: { python-version: "3.11" }- - run: pip install bandit pip-audit- - name: Static security analysis (high/medium severity)- run: bandit -r ares/ -ll -x ares/tests- - name: Dependency vulnerability scan- run: pip-audit --format json --output pip-audit.json || true- - name: Fail on HIGH/CRITICAL CVEs (CVSS >= 7.0)- run: |- python3 -c "- import json, sys- with open('pip-audit.json') as f:- data = json.load(f)- all_vulns = data.get('vulnerabilities', [])- # Only fail on HIGH/CRITICAL (CVSS >= 7.0), not informational/low- critical = []- for pkg in all_vulns:- for v in pkg.get('vulns', []):- score = 0.0- for alias in v.get('aliases', []):- if isinstance(alias, dict):- score = max(score, alias.get('cvss_score', 0.0) or 0.0)- # If no CVSS score available, treat as high to be safe- if score == 0.0 or score >= 7.0:- critical.append((pkg.get('name','?'), pkg.get('version','?'), v.get('id','?'), score))- if critical:- print(f'FAIL: {len(critical)} HIGH/CRITICAL vuln(s) found (CVSS >= 7.0):')- for name, ver, vid, score in critical:- print(f' {name} {ver}: {vid} (CVSS {score})')- sys.exit(1)- skipped = len(all_vulns) - len(critical)- print(f'OK: 0 HIGH/CRITICAL vulns (skipped {skipped} low/informational)')- "-- secret-scan:- name: Secret Scanning- runs-on: ubuntu-latest- steps:- - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2- with:- fetch-depth: 0 # full history for trufflehog- - name: TruffleHog secret scan- uses: trufflesecurity/trufflehog@f42f04d34e7bfde88d026c273c5d00e0e7a7e3a4 # v3.88.1- with:- path: ./- base: ${{ github.event.repository.default_branch }}- extra_args: --only-verified-- lock-file:- name: Regenerate requirements-lock.txt- runs-on: ubuntu-latest- needs: [test]- if: github.ref == 'refs/heads/main' && github.event_name == 'push'- env:- ARES_SECRET_KEY: "ci-secret-key-placeholder-min32chars!!"- ARES_ENCRYPTION_KEY: "ci-encryption-key-placeholder-32chars"- ARES_DEFAULT_ADMIN_PASSWORD: "CiAdmin1!-placeholder-secret99"- steps:- - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2- - uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0- with: { python-version: "3.11" }- - name: Generate pinned lock file with pip freeze- run: |- pip install -e ".[full]"- pip freeze > requirements-lock.txt- # Prepend informational header- echo "# ARES v6 — Pinned lock file (auto-generated by CI on push to main)" > /tmp/header.txt- echo "# Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ) on Python $(python --version)" >> /tmp/header.txt- echo "# DO NOT EDIT MANUALLY — regenerated automatically on every push to main" >> /tmp/header.txt- echo "" >> /tmp/header.txt- cat /tmp/header.txt requirements-lock.txt > /tmp/lock_with_header.txt- mv /tmp/lock_with_header.txt requirements-lock.txt- - name: Commit updated lock file- uses: stefanzweifel/git-auto-commit-action@8621497c8c39c72f3e2a999a26b4ca1b5590a76b # v5.0.1- with:- commit_message: "chore: regenerate requirements-lock.txt [skip ci]"- file_pattern: requirements-lock.txt-- release:- name: Automated Release- runs-on: ubuntu-latest- needs: [lint, frontend, test, security, secret-scan]- if: startsWith(github.ref, 'refs/tags/v')- steps:- - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2- - uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0- with: { python-version: "3.11" }- - name: Build Docker image- run: |- docker build -f docker/Dockerfile.prod -t ares-redteam:${{ github.ref_name }} .- docker tag ares-redteam:${{ github.ref_name }} ares-redteam:latest- - name: Extract CHANGELOG entry for this version- id: changelog- run: |- VERSION=${{ github.ref_name }}- NOTES=$(python3 -c "- import re, sys- with open('CHANGELOG.md') as f: content = f.read()- pattern = rf'## \[{re.escape(VERSION[1:])}\].*?(?=## \[|\Z)'- m = re.search(pattern, content, re.DOTALL)- print(m.group(0).strip() if m else 'See CHANGELOG.md for details.')- ")- echo "notes<<EOF" >> $GITHUB_OUTPUT- echo "$NOTES" >> $GITHUB_OUTPUT- echo "EOF" >> $GITHUB_OUTPUT- - name: Create GitHub Release- uses: softprops/action-gh-release@c062e08bd532815e2082a85e87e3ef29c3e6d191 # v2.1.0- with:- tag_name: ${{ github.ref_name }}- name: ARES ${{ github.ref_name }}- body: ${{ steps.changelog.outputs.notes }}- draft: false- prerelease: ${{ contains(github.ref_name, '-rc') || contains(github.ref_name, '-beta') }}diff --git a/.gitignore b/.gitignoreindex 00c99b9..07b3ef6 100644--- a/.gitignore+++ b/.gitignore@@ -21,6 +21,8 @@ ares_redteam.egg-info/# Shadow module dirs — real code lives in ares/ package onlyapi/+!frontend/src/api/+!frontend/src/api/**artifact_intel/checkpoint/cli/diff --git a/frontend/src/api/client.test.ts b/frontend/src/api/client.test.tsnew file mode 100644index 0000000..8d58f1f--- /dev/null+++ b/frontend/src/api/client.test.ts@@ -0,0 +1,59 @@+import { beforeEach, describe, expect, it, vi } from "vitest";+import {+ buildModuleRunPayload,+ campaignEventsPath,+ clearTokens,+ getAccessToken,+ getRefreshToken,+ login+} from "./client";++describe("api client auth", () => {+ beforeEach(() => {+ clearTokens();+ sessionStorage.clear();+ vi.restoreAllMocks();+ });++ it("posts login as form-urlencoded and stores returned tokens", async () => {+ const fetchMock = vi.fn(async (_path: string, init?: RequestInit) => {+ const headers = new Headers(init?.headers);+ expect(headers.get("Content-Type")).toBe("application/x-www-form-urlencoded");+ expect(init?.body).toBeInstanceOf(URLSearchParams);+ expect(String(init?.body)).toContain("username=alice");+ return new Response(+ JSON.stringify({+ access_token: "access",+ refresh_token: "refresh",+ token_type: "bearer",+ expires_in: 3600,+ role: "operator"+ }),+ { status: 200 }+ );+ });+ vi.stubGlobal("fetch", fetchMock);+ await login("alice", "Secret123!");+ expect(fetchMock).toHaveBeenCalledWith("/auth/token", expect.any(Object));+ expect(getAccessToken()).toBe("access");+ expect(getRefreshToken()).toBe("refresh");+ });+});++describe("module execution helpers", () => {+ it("defaults UI module runs to dry_run true", () => {+ expect(buildModuleRunPayload("campaign-1", { target: "dc01" })).toEqual({+ campaign_id: "campaign-1",+ params: { target: "dc01" },+ dry_run: true+ });+ });+});++describe("live event helpers", () => {+ it("uses the backend campaign websocket route", () => {+ expect(campaignEventsPath("camp/one", "token value")).toBe(+ "/ws/campaigns/camp%2Fone/events?token=token%20value"+ );+ });+});diff --git a/frontend/src/api/client.ts b/frontend/src/api/client.tsnew file mode 100644index 0000000..ea5a237--- /dev/null+++ b/frontend/src/api/client.ts@@ -0,0 +1,256 @@+import type {+ ApiKeyMeta,+ Campaign,+ Finding,+ ModuleMeta,+ ReportItem,+ TemplateMeta,+ TokenResponse,+ UserProfile+} from "./types";++const REFRESH_TOKEN_KEY = "ares.refreshToken";++let accessToken: string | null = null;++export function setAccessToken(token: string | null): void {+ accessToken = token;+}++export function getAccessToken(): string | null {+ return accessToken;+}++export function setRefreshToken(token: string | null): void {+ if (token) {+ sessionStorage.setItem(REFRESH_TOKEN_KEY, token);+ return;+ }+ sessionStorage.removeItem(REFRESH_TOKEN_KEY);+}++export function getRefreshToken(): string | null {+ return sessionStorage.getItem(REFRESH_TOKEN_KEY);+}++export function clearTokens(): void {+ accessToken = null;+ setRefreshToken(null);+}++export class ApiError extends Error {+ readonly status: number;+ readonly detail: unknown;++ constructor(status: number, detail: unknown) {+ super(typeof detail === "string" ? detail : `Request failed with ${status}`);+ this.status = status;+ this.detail = detail;+ }+}++async function parseResponse(response: Response): Promise<unknown> {+ const text = await response.text();+ if (!text) {+ return null;+ }+ try {+ return JSON.parse(text);+ } catch {+ return text;+ }+}++async function refreshAccessToken(): Promise<boolean> {+ const refreshToken = getRefreshToken();+ if (!refreshToken) {+ return false;+ }+ const response = await fetch("/auth/refresh", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({ refresh_token: refreshToken })+ });+ if (!response.ok) {+ clearTokens();+ return false;+ }+ const token = (await response.json()) as TokenResponse;+ setAccessToken(token.access_token);+ setRefreshToken(token.refresh_token);+ return true;+}++export async function apiRequest<T>(+ path: string,+ init: RequestInit = {},+ retry = true+): Promise<T> {+ const headers = new Headers(init.headers);+ if (accessToken) {+ headers.set("Authorization", `Bearer ${accessToken}`);+ }+ const response = await fetch(path, { ...init, headers });+ if (response.status === 401 && retry && (await refreshAccessToken())) {+ return apiRequest<T>(path, init, false);+ }+ const body = await parseResponse(response);+ if (!response.ok) {+ throw new ApiError(response.status, (body as any)?.detail ?? body);+ }+ return body as T;+}++async function apiBlobRequest(+ path: string,+ init: RequestInit = {},+ retry = true+): Promise<Blob> {+ const headers = new Headers(init.headers);+ if (accessToken) {+ headers.set("Authorization", `Bearer ${accessToken}`);+ }+ const response = await fetch(path, { ...init, headers });+ if (response.status === 401 && retry && (await refreshAccessToken())) {+ return apiBlobRequest(path, init, false);+ }+ if (!response.ok) {+ const body = await parseResponse(response);+ throw new ApiError(response.status, (body as any)?.detail ?? body);+ }+ return response.blob();+}++export async function login(username: string, password: string): Promise<TokenResponse> {+ const body = new URLSearchParams();+ body.set("username", username);+ body.set("password", password);+ const token = await apiRequest<TokenResponse>(+ "/auth/token",+ {+ method: "POST",+ headers: { "Content-Type": "application/x-www-form-urlencoded" },+ body+ },+ false+ );+ setAccessToken(token.access_token);+ setRefreshToken(token.refresh_token);+ return token;+}++export async function logout(): Promise<void> {+ try {+ await apiRequest<{ status: string }>("/auth/logout", { method: "POST" }, false);+ } finally {+ clearTokens();+ }+}++export function campaignEventsPath(campaignId: string, token: string): string {+ return `/ws/campaigns/${encodeURIComponent(campaignId)}/events?token=${encodeURIComponent(token)}`;+}++export function buildModuleRunPayload(+ campaignId: string,+ params: Record<string, unknown>,+ dryRun = true+): { campaign_id: string; params: Record<string, unknown>; dry_run: boolean } {+ return { campaign_id: campaignId, params, dry_run: dryRun };+}++export const api = {+ me: () => apiRequest<UserProfile>("/auth/me"),+ health: () => apiRequest<Record<string, unknown>>("/health"),+ telemetry: () => apiRequest<Record<string, unknown>>("/telemetry"),+ campaigns: () => apiRequest<Campaign[]>("/campaigns"),+ createCampaign: (body: { name: string; client: string; targets: string[]; scope_cidrs: string[] }) =>+ apiRequest<Campaign>("/campaigns", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify(body)+ }),+ campaign: (id: string) => apiRequest<Campaign>(`/campaigns/${encodeURIComponent(id)}`),+ deleteCampaign: (id: string) =>+ apiRequest<Record<string, string>>(`/campaigns/${encodeURIComponent(id)}`, { method: "DELETE" }),+ findings: (id: string) => apiRequest<Finding[]>(`/campaigns/${encodeURIComponent(id)}/findings`),+ cvss: (id: string) => apiRequest<Record<string, unknown>>(`/campaigns/${encodeURIComponent(id)}/cvss`),+ restoreVault: (id: string) =>+ apiRequest<Record<string, unknown>>(`/campaigns/${encodeURIComponent(id)}/restore-vault`, { method: "POST" }),+ runCampaign: (id: string, body: Record<string, unknown>) =>+ apiRequest<Record<string, unknown>>(`/campaigns/${encodeURIComponent(id)}/run`, {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify(body)+ }),+ diffCampaign: (id: string, otherId: string) =>+ apiRequest<Record<string, unknown>>(+ `/campaigns/${encodeURIComponent(id)}/diff/${encodeURIComponent(otherId)}`+ ),+ modules: () => apiRequest<ModuleMeta[]>("/modules"),+ runModule: (moduleId: string, payload: ReturnType<typeof buildModuleRunPayload>) =>+ apiRequest<Record<string, unknown>>(`/modules/${encodeURIComponent(moduleId)}/run`, {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify(payload)+ }),+ generateReport: (campaignId: string, format: string) =>+ apiRequest<Record<string, string>>(+ `/reports/${encodeURIComponent(campaignId)}?fmt=${encodeURIComponent(format)}`,+ { method: "POST" }+ ),+ reports: (campaignId: string) =>+ apiRequest<{ campaign_id: string; reports: ReportItem[] }>(`/reports/${encodeURIComponent(campaignId)}`),+ reportDownloadUrl: (campaignId: string, filename: string) =>+ `/reports/${encodeURIComponent(campaignId)}/files/${encodeURIComponent(filename)}`,+ downloadReport: (campaignId: string, filename: string) =>+ apiBlobRequest(`/reports/${encodeURIComponent(campaignId)}/files/${encodeURIComponent(filename)}`),+ graph: (campaignId: string) => apiRequest<Record<string, any>>(`/graph/${encodeURIComponent(campaignId)}`),+ attackPaths: (campaignId: string) =>+ apiRequest<Record<string, any>>(`/graph/${encodeURIComponent(campaignId)}/attack-paths`),+ ingestBloodhound: (campaignId: string, jsonPath: string) =>+ apiRequest<Record<string, unknown>>(`/graph/${encodeURIComponent(campaignId)}/bloodhound`, {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({ json_path: jsonPath })+ }),+ templates: () => apiRequest<TemplateMeta[]>("/templates"),+ templatePlan: (name: string, globalParams: Record<string, unknown>) =>+ apiRequest<Record<string, unknown>>(`/templates/${encodeURIComponent(name)}/plan`, {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({ global_params: globalParams })+ }),+ activeStrategy: () => apiRequest<Record<string, unknown>>("/strategy/active"),+ engageStrategy: (body: Record<string, unknown>) =>+ apiRequest<Record<string, unknown>>("/strategy/engage", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify(body)+ }),+ changePassword: (body: { current_password: string; new_password: string }) =>+ apiRequest<Record<string, string>>("/auth/change-password", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify(body)+ }),+ apiKeys: () => apiRequest<ApiKeyMeta[]>("/auth/api-keys"),+ createApiKey: (body: { name: string; scopes: string; expires_days?: number }) =>+ apiRequest<Record<string, string>>("/auth/api-keys", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify(body)+ }),+ deleteApiKey: (id: string) => apiRequest<Record<string, string>>(`/auth/api-keys/${encodeURIComponent(id)}`, {+ method: "DELETE"+ }),+ securityAudit: () => apiRequest<Record<string, unknown>>("/security/audit"),+ users: () => apiRequest<Record<string, unknown>[]>("/security/users"),+ edrStats: () => apiRequest<Record<string, unknown>>("/edr/bypass/stats"),+ reportBypass: (body: Record<string, unknown>) =>+ apiRequest<Record<string, unknown>>("/edr/bypass/report", {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify(body)+ })+};diff --git a/frontend/src/api/types.ts b/frontend/src/api/types.tsnew file mode 100644index 0000000..9a5bc80--- /dev/null+++ b/frontend/src/api/types.ts@@ -0,0 +1,86 @@+export type Role = "team_lead" | "operator" | "recon" | "reporter" | string;++export interface TokenResponse {+ access_token: string;+ refresh_token: string;+ token_type: string;+ expires_in: number;+ role: Role;+}++export interface UserProfile {+ username: string;+ role: Role;+}++export interface Campaign {+ id: string;+ name: string;+ client?: string;+ operator?: string;+ targets?: string[];+ scope_cidrs?: string[];+ status?: string;+ created_at?: string;+ [key: string]: unknown;+}++export interface Finding {+ id?: string;+ title?: string;+ severity?: string;+ module_id?: string;+ host?: string;+ mitre_technique?: string;+ confidence?: number;+ [key: string]: unknown;+}++export interface ParamField {+ type: string;+ description: string;+ required: boolean;+ secret: boolean;+ min?: number;+ max?: number;+ min_len?: number;+ max_len?: number;+ pattern?: string;+}++export type ParamSchema = Record<string, ParamField>;++export interface ModuleMeta {+ id: string;+ name?: string;+ category?: string;+ description?: string;+ opsec_level?: string;+ mitre?: string;+ mitre_list?: string[];+ param_schema: ParamSchema;+ [key: string]: unknown;+}++export interface ReportItem {+ filename: string;+ format: string;+ size_bytes: number;+ modified_at: number;+}++export interface TemplateMeta {+ name?: string;+ description?: string;+ [key: string]: unknown;+}++export interface ApiKeyMeta {+ id: string;+ name?: string;+ prefix?: string;+ scopes?: string;+ created_at?: string;+ expires_at?: string;+ [key: string]: unknown;+}