@assertion-runtime/sdk-node 0.1.0

package/README.md

@@ -0,0 +1,6 @@
+# Assertion Runtime Node SDK
+
+## Output lint
+
+Use `emitFinding(output, { endpoint, apiKey })` to lint an output string. The SDK applies simple heuristics, captures
+best-effort emission site metadata, and emits a finding only when the output looks risky.

package/dist/assertion-finding.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "assr://schemas/assertion-finding/1.0.0",
+  "title": "AssertionFinding",
+  "type": "object",
+  "required": [
+    "finding_id",
+    "output_excerpt",
+    "reason",
+    "created_at",
+    "emission_site"
+  ],
+  "properties": {
+    "finding_id": {
+      "type": "string",
+      "format": "uuid"
+    },
+    "output_excerpt": {
+      "type": "string"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "emission_site": {
+      "type": "object",
+      "required": ["file", "line", "runtime", "stack_hash"],
+      "properties": {
+        "file": { "type": "string" },
+        "line": { "type": "number" },
+        "function": { "type": "string" },
+        "runtime": { "type": "string" },
+        "stack_hash": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time"
+    }
+  },
+  "additionalProperties": false
+}

package/dist/cli.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+type Finding = {
+    finding_id: string;
+    output_excerpt: string;
+    reason: string;
+    file_path?: string | null;
+    line_number?: number | null;
+    created_at?: string;
+};
+declare function formatEmissionSite(finding: Finding): string;
+declare function formatCreatedAt(value?: string): string;
+declare function parseArgs(argv: string[]): {
+    command: string | undefined;
+    json: boolean;
+};
+declare function fetchFindings(endpoint: string, apiKey?: string): Promise<Finding[]>;
+declare function main(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,KAAK,OAAO,GAAG;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,iBAAS,kBAAkB,CAAC,OAAO,EAAE,OAAO,UAM3C;AAED,iBAAS,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,UAUtC;AAED,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE;;;EAKhC;AAED,iBAAe,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,sBAa7D;AAED,iBAAe,IAAI,kBAoClB"}

package/dist/cli.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+"use strict";
+function formatEmissionSite(finding) {
+    if (!finding.file_path)
+        return "-";
+    if (typeof finding.line_number === "number") {
+        return `${finding.file_path}:${finding.line_number}`;
+    }
+    return finding.file_path;
+}
+function formatCreatedAt(value) {
+    if (!value)
+        return "-";
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return new Intl.DateTimeFormat("en-US", {
+        month: "short",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+    }).format(date);
+}
+function parseArgs(argv) {
+    const args = [...argv];
+    const command = args[0] && !args[0].startsWith("-") ? args.shift() : "lint";
+    const json = args.includes("--json");
+    return { command, json };
+}
+async function fetchFindings(endpoint, apiKey) {
+    const url = `${endpoint.replace(/\/$/, "")}/findings?limit=200&offset=0`;
+    const response = await fetch(url, {
+        headers: {
+            ...(apiKey ? { authorization: `Bearer ${apiKey}` } : {}),
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Finding fetch failed (${response.status}): ${body}`);
+    }
+    const payload = (await response.json());
+    return Array.isArray(payload.findings) ? payload.findings : [];
+}
+async function main() {
+    const { command, json } = parseArgs(process.argv.slice(2));
+    if (command !== "lint") {
+        console.error("Usage: assertion-runtime lint [--json]");
+        process.exit(2);
+    }
+    const endpoint = process.env.ASSR_RUNTIME_API_URL || process.env.RUNTIME_API_URL || "http://localhost:4000";
+    const apiKey = process.env.ASSR_ADMIN_API_KEY || process.env.ASSR_API_KEY;
+    try {
+        const findings = await fetchFindings(endpoint, apiKey);
+        if (json) {
+            process.stdout.write(`${JSON.stringify({ findings }, null, 2)}\n`);
+            process.exit(findings.length > 0 ? 1 : 0);
+        }
+        if (findings.length === 0) {
+            console.log("No risky outputs detected.");
+            process.exit(0);
+        }
+        console.log(`${findings.length} risky outputs detected:`);
+        for (const finding of findings) {
+            console.log(`- ${finding.finding_id.slice(0, 8)}  ${finding.output_excerpt}`);
+            console.log(`  ${finding.reason}`);
+            console.log(`  Emitted from: ${formatEmissionSite(finding)}`);
+            console.log(`  Created: ${formatCreatedAt(finding.created_at)}`);
+            console.log("");
+        }
+        process.exit(1);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : "CLI failed");
+        process.exit(2);
+    }
+}
+void main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+export interface EmitOptions {
+    endpoint?: string;
+    apiKey?: string;
+}
+export interface EmissionSite {
+    file?: string;
+    line?: number;
+    function?: string;
+    runtime?: string;
+    stack_hash?: string;
+}
+export interface AssertionFinding {
+    finding_id: string;
+    output_excerpt: string;
+    reason: string;
+    emission_site?: EmissionSite;
+    created_at: string;
+}
+export declare function lintOutput(output: string): {
+    reason: string;
+} | null;
+export declare function buildFinding(output: string): AssertionFinding | null;
+export declare function emitFinding(output: string, options?: EmitOptions): Promise<unknown>;
+export interface SdkDiagnosticEvent {
+    diagnostic_id: string;
+    project_id: string;
+    sdk: {
+        language: "node" | "python";
+        version: string;
+        runtime?: string;
+        platform?: string;
+    };
+    window: {
+        start: string;
+        end: string;
+        duration_sec?: number;
+    };
+    counters: Record<string, number>;
+    buffer: {
+        backend?: "file" | "sqlite" | "memory";
+        current_depth: number;
+        max_depth?: number;
+        oldest_event_age_sec?: number;
+    };
+    latency_ms?: Record<string, number>;
+    flags?: Record<string, boolean>;
+    timestamp: string;
+    schema_version: string;
+    extensions?: Record<string, unknown>;
+}
+export interface DiagnosticsOptions {
+    endpoint: string;
+    apiKey?: string;
+    projectId: string;
+    sdkVersion: string;
+    runtime?: string;
+    platform?: string;
+    schemaVersion?: string;
+}
+export declare class DiagnosticsEmitter {
+    private options;
+    private windowStart;
+    private counters;
+    private bufferState;
+    private latency;
+    private flags;
+    private flushInFlight;
+    private flushOnExitBound;
+    constructor(options: DiagnosticsOptions);
+    increment(counter: string, value?: number): void;
+    setBufferState(state: SdkDiagnosticEvent["buffer"]): void;
+    setLatency(metrics: Record<string, number>): void;
+    setFlags(flags: Record<string, boolean>): void;
+    emit(): Promise<unknown>;
+    registerShutdownHooks(): void;
+    unregisterShutdownHooks(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuBD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAsGD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM;;SAOxC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAapE;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,oBAyC1E;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE;QACH,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACvC,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAkB;IASjB,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,WAAW,CAAwD;IAC3E,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAA6B;gBAEjC,OAAO,EAAE,kBAAkB;IAE/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI;IAIpC,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC;IAIlD,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC,IAAI;IAmDV,qBAAqB;IAYrB,uBAAuB;CAOxB"}

package/dist/index.js

@@ -0,0 +1,273 @@
+import crypto from "node:crypto";
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const currentDir = dirname(fileURLToPath(import.meta.url));
+const diagnosticSchemaPath = join(currentDir, "sdk-diagnostic.schema.json");
+const findingSchemaPath = join(currentDir, "assertion-finding.schema.json");
+const diagnosticSchema = JSON.parse(readFileSync(diagnosticSchemaPath, "utf-8"));
+const findingSchema = JSON.parse(readFileSync(findingSchemaPath, "utf-8"));
+const ajv = new Ajv({ allErrors: true, strict: false });
+addFormats(ajv);
+const validateDiagnostic = ajv.compile(diagnosticSchema);
+const validateFinding = ajv.compile(findingSchema);
+function validateDiagnosticEvent(event) {
+    const ok = validateDiagnostic(event);
+    if (!ok) {
+        const error = new Error("invalid_diagnostic");
+        error.details = validateDiagnostic.errors ?? [];
+        throw error;
+    }
+}
+const seenFindings = new Set();
+function validateFindingEvent(event) {
+    const ok = validateFinding(event);
+    if (!ok) {
+        const error = new Error("invalid_finding");
+        error.details = validateFinding.errors ?? [];
+        throw error;
+    }
+}
+function summarizeOutput(output, maxLength = 140) {
+    const trimmed = output.trim();
+    if (trimmed.length <= maxLength)
+        return trimmed;
+    return `${trimmed.slice(0, maxLength - 1)}…`;
+}
+function hashStackLocation(params) {
+    const payload = `${params.file}:${params.line}:${params.functionName ?? ""}`;
+    return crypto.createHash("sha256").update(payload).digest("hex");
+}
+function parseStackLine(line) {
+    const stripFileUrl = (value) => {
+        if (!value.startsWith("file://"))
+            return value;
+        try {
+            return fileURLToPath(value);
+        }
+        catch {
+            return value;
+        }
+    };
+    const withFunc = line.match(/^at\s+(?:async\s+)?(.+?)\s+\((.+):(\d+):(\d+)\)$/);
+    if (withFunc) {
+        return {
+            function: withFunc[1],
+            file: stripFileUrl(withFunc[2]),
+            line: Number(withFunc[3]),
+        };
+    }
+    const withoutFunc = line.match(/^at\s+(?:async\s+)?(.+):(\d+):(\d+)$/);
+    if (withoutFunc) {
+        return {
+            file: stripFileUrl(withoutFunc[1]),
+            line: Number(withoutFunc[2]),
+        };
+    }
+    return null;
+}
+function captureEmissionSite() {
+    const stack = new Error().stack;
+    if (!stack)
+        return undefined;
+    const lines = stack.split("\n").map((line) => line.trim());
+    const skipPatterns = ["node:internal", "/node_modules/", "assr_sdk", "sdk-node", "internal/process"];
+    const candidate = lines
+        .slice(1)
+        .map((line) => ({ line, parsed: parseStackLine(line) }))
+        .find((entry) => entry.parsed && !skipPatterns.some((pattern) => entry.line.includes(pattern)));
+    if (!candidate?.parsed) {
+        return undefined;
+    }
+    return {
+        file: candidate.parsed.file,
+        line: candidate.parsed.line,
+        function: candidate.parsed.function,
+        runtime: `node${process.version}`,
+        stack_hash: hashStackLocation({
+            file: candidate.parsed.file,
+            line: candidate.parsed.line,
+            functionName: candidate.parsed.function,
+        }),
+    };
+}
+function hasQualifier(output) {
+    return /\b(estimate|approximately|approx|may|might|likely|suggests|early data|could)\b/i.test(output);
+}
+function isDebugLog(output) {
+    return /^(?:\s*\[?(?:debug|trace|info|warn|error)\]?:\s*|\s*(?:fetched|loaded|processing|queued|executed|query|cache|http)\b)/i.test(output);
+}
+function isForwardLooking(output) {
+    return /\b(q1|next quarter|will|predicts|expected)\b/i.test(output);
+}
+function isClaimCandidate(output) {
+    if (hasQualifier(output))
+        return false;
+    if (isDebugLog(output))
+        return false;
+    if (output.length <= 10)
+        return false;
+    return true;
+}
+function isDeclarative(output) {
+    return !hasQualifier(output);
+}
+export function lintOutput(output) {
+    const trimmed = output.trim();
+    if (!trimmed)
+        return null;
+    if (!isClaimCandidate(trimmed))
+        return null;
+    if (!isForwardLooking(trimmed))
+        return null;
+    if (!isDeclarative(trimmed))
+        return null;
+    return { reason: "Forward-looking claim without sufficient supporting context" };
+}
+export function buildFinding(output) {
+    const lint = lintOutput(output);
+    if (!lint)
+        return null;
+    const findingId = crypto.randomUUID();
+    const emissionSite = captureEmissionSite();
+    if (!emissionSite?.stack_hash || !emissionSite.file || typeof emissionSite.line !== "number")
+        return null;
+    return {
+        finding_id: findingId,
+        output_excerpt: summarizeOutput(output),
+        reason: lint.reason,
+        emission_site: emissionSite,
+        created_at: new Date().toISOString(),
+    };
+}
+export async function emitFinding(output, options = {}) {
+    const finding = buildFinding(output);
+    if (!finding) {
+        return { status: "skipped", reason: "not_risky" };
+    }
+    const stackHash = finding.emission_site?.stack_hash;
+    const key = stackHash ? `${stackHash}::${finding.output_excerpt}` : null;
+    if (key && seenFindings.has(key)) {
+        return { status: "skipped", reason: "deduped" };
+    }
+    if (key) {
+        seenFindings.add(key);
+    }
+    validateFindingEvent(finding);
+    if (!options.endpoint) {
+        throw new Error("Missing endpoint; provide endpoint.");
+    }
+    try {
+        const response = await fetch(`${options.endpoint}/findings`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...(options.apiKey ? { authorization: `Bearer ${options.apiKey}` } : {}),
+            },
+            body: JSON.stringify(finding),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            return { status: "skipped", reason: "fail_open", error: `Finding emit failed (${response.status}): ${body}` };
+        }
+        return response.json();
+    }
+    catch (error) {
+        return {
+            status: "skipped",
+            reason: "fail_open",
+            error: error instanceof Error ? error.message : "finding_emit_failed",
+        };
+    }
+}
+export class DiagnosticsEmitter {
+    constructor(options) {
+        this.options = options;
+        this.windowStart = new Date();
+        this.counters = {};
+        this.bufferState = { current_depth: 0 };
+        this.flushInFlight = false;
+        this.flushOnExitBound = null;
+    }
+    increment(counter, value = 1) {
+        this.counters[counter] = (this.counters[counter] ?? 0) + value;
+    }
+    setBufferState(state) {
+        this.bufferState = state;
+    }
+    setLatency(metrics) {
+        this.latency = metrics;
+    }
+    setFlags(flags) {
+        this.flags = flags;
+    }
+    async emit() {
+        if (this.flushInFlight) {
+            return { status: "skipped", reason: "in_flight" };
+        }
+        this.flushInFlight = true;
+        const windowEnd = new Date();
+        const payload = {
+            diagnostic_id: crypto.randomUUID(),
+            project_id: this.options.projectId,
+            sdk: {
+                language: "node",
+                version: this.options.sdkVersion,
+                runtime: this.options.runtime,
+                platform: this.options.platform,
+            },
+            window: {
+                start: this.windowStart.toISOString(),
+                end: windowEnd.toISOString(),
+                duration_sec: Math.max(1, Math.floor((windowEnd.getTime() - this.windowStart.getTime()) / 1000)),
+            },
+            counters: this.counters,
+            buffer: this.bufferState,
+            latency_ms: this.latency,
+            flags: this.flags,
+            timestamp: windowEnd.toISOString(),
+            schema_version: this.options.schemaVersion ?? "1.0.0",
+        };
+        validateDiagnosticEvent(payload);
+        const response = await fetch(`${this.options.endpoint}/sdk-diagnostics`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...(this.options.apiKey ? { authorization: `Bearer ${this.options.apiKey}` } : {}),
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            this.flushInFlight = false;
+            throw new Error(`Diagnostics emit failed (${response.status}): ${body}`);
+        }
+        this.windowStart = windowEnd;
+        this.counters = {};
+        this.flushInFlight = false;
+        return response.json();
+    }
+    registerShutdownHooks() {
+        if (this.flushOnExitBound)
+            return;
+        this.flushOnExitBound = () => {
+            void this.emit().catch(() => {
+                // Best-effort on shutdown; never throw.
+            });
+        };
+        process.on("beforeExit", this.flushOnExitBound);
+        process.on("SIGTERM", this.flushOnExitBound);
+        process.on("SIGINT", this.flushOnExitBound);
+    }
+    unregisterShutdownHooks() {
+        if (!this.flushOnExitBound)
+            return;
+        process.off("beforeExit", this.flushOnExitBound);
+        process.off("SIGTERM", this.flushOnExitBound);
+        process.off("SIGINT", this.flushOnExitBound);
+        this.flushOnExitBound = null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/sdk-diagnostic.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "SDK Diagnostic Event",
+  "type": "object",
+  "required": [
+    "diagnostic_id",
+    "project_id",
+    "sdk",
+    "window",
+    "counters",
+    "buffer",
+    "timestamp",
+    "schema_version"
+  ],
+  "properties": {
+    "diagnostic_id": { "type": "string", "format": "uuid" },
+    "project_id": { "type": "string", "format": "uuid" },
+    "sdk": {
+      "type": "object",
+      "required": ["language", "version"],
+      "properties": {
+        "language": { "enum": ["node", "python"] },
+        "version": { "type": "string" },
+        "runtime": { "type": "string" },
+        "platform": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "window": {
+      "type": "object",
+      "required": ["start", "end"],
+      "properties": {
+        "start": { "type": "string", "format": "date-time" },
+        "end": { "type": "string", "format": "date-time" },
+        "duration_sec": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "counters": {
+      "type": "object",
+      "additionalProperties": { "type": "number" }
+    },
+    "buffer": {
+      "type": "object",
+      "required": ["current_depth"],
+      "properties": {
+        "backend": { "enum": ["file", "sqlite", "memory"] },
+        "current_depth": { "type": "number" },
+        "max_depth": { "type": "number" },
+        "oldest_event_age_sec": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "latency_ms": {
+      "type": "object",
+      "additionalProperties": { "type": "number" }
+    },
+    "flags": {
+      "type": "object",
+      "additionalProperties": { "type": "boolean" }
+    },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "schema_version": { "type": "string" },
+    "extensions": { "type": "object" }
+  },
+  "additionalProperties": false
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@assertion-runtime/sdk-node",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "assertion-runtime": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json && cp src/*.json dist/"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^2.1.1"
+  }
+}