@ninelives/agent-governance-sdk 5.0.1

package/dist/mcp.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,123 @@
+export interface MetricEvent {
+    name: string;
+    value: number | string;
+    timestamp: string;
+    attributes: Record<string, unknown>;
+}
+export interface MetricSink {
+    record(event: MetricEvent): void;
+}
+export interface GovernanceMetricsConfig {
+    enabled?: boolean;
+    sinks?: MetricSink[];
+}
+export interface GovernanceMetricsSnapshot {
+    counters: Record<string, number>;
+    histograms: Record<string, number[]>;
+    gauges: Record<string, number>;
+    events: MetricEvent[];
+}
+export type SLOStatus = 'healthy' | 'warning' | 'critical' | 'exhausted';
+export type CircuitBreakerState = 'closed' | 'open' | 'half_open';
+export type TraceSpanStatus = 'ok' | 'error' | 'timeout';
+export type TraceSpanKind = 'agent_task' | 'tool_call' | 'llm_inference' | 'delegation' | 'policy_check' | 'internal';
+export interface ErrorBudgetSnapshot {
+    targetAvailability: number;
+    totalEvents: number;
+    errorEvents: number;
+    remainingPercent: number;
+    burnRate: number;
+    exhausted: boolean;
+}
+export interface TraceSpan {
+    spanId: string;
+    traceId: string;
+    parentId?: string;
+    name: string;
+    kind: TraceSpanKind;
+    status: TraceSpanStatus;
+    startTime: string;
+    endTime?: string;
+    durationMs?: number;
+    attributes: Record<string, unknown>;
+    input?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+    error?: string;
+}
+export interface ExecutionTrace {
+    traceId: string;
+    agentId: string;
+    taskInput: string;
+    taskOutput?: string;
+    startTime: string;
+    endTime?: string;
+    durationMs?: number;
+    totalCostUsd: number;
+    success?: boolean;
+    spans: TraceSpan[];
+    contentHash: string;
+}
+export declare class GovernanceMetrics {
+    readonly enabled: boolean;
+    private readonly sinks;
+    private readonly counters;
+    private readonly histograms;
+    private readonly gauges;
+    private readonly events;
+    private static readonly MAX_HISTOGRAM_SAMPLES;
+    private static readonly MAX_EVENTS;
+    constructor(config?: boolean | GovernanceMetricsConfig);
+    registerSink(sink: MetricSink): void;
+    recordPolicyDecision(decision: string, durationMs: number, attributes?: Record<string, unknown>): void;
+    recordTrustScore(agentId: string, score: number): void;
+    recordAuditEntry(seq: number): void;
+    recordToolCall(toolName: string, durationMs: number): void;
+    recordTrace(trace: ExecutionTrace): void;
+    getSnapshot(): GovernanceMetricsSnapshot;
+    private incrementCounter;
+    private recordHistogram;
+    private emit;
+}
+export declare class ErrorBudgetTracker {
+    private readonly targetAvailability;
+    private readonly windowSeconds;
+    private readonly events;
+    constructor(targetAvailability: number, windowSeconds?: number);
+    recordEvent(good: boolean, timestampMs?: number): void;
+    snapshot(windowSeconds?: number): ErrorBudgetSnapshot;
+}
+export declare class SLOTracker {
+    readonly name: string;
+    readonly budget: ErrorBudgetTracker;
+    constructor(name: string, targetAvailability: number, windowSeconds?: number);
+    recordEvent(good: boolean, timestampMs?: number): void;
+    evaluate(): SLOStatus;
+}
+export declare class CircuitBreaker {
+    private readonly failureThreshold;
+    private readonly resetTimeoutMs;
+    private failures;
+    private openedAt?;
+    private currentState;
+    constructor(failureThreshold?: number, resetTimeoutMs?: number);
+    get state(): CircuitBreakerState;
+    canExecute(): boolean;
+    onSuccess(): void;
+    onFailure(): void;
+}
+export declare class TraceCapture {
+    private readonly agentId;
+    private readonly taskInput;
+    private readonly traceId;
+    private readonly traceStart;
+    private readonly spans;
+    private readonly spanStarts;
+    private totalCostUsd;
+    constructor(agentId: string, taskInput?: string);
+    currentTraceId(): string;
+    startSpan(name: string, kind?: TraceSpanKind, input?: Record<string, unknown>, parentId?: string, attributes?: Record<string, unknown>): TraceSpan;
+    finishSpan(spanId: string, status?: TraceSpanStatus, output?: Record<string, unknown>, error?: string, costUsd?: number): void;
+    getSpanDuration(spanId: string): number | undefined;
+    finish(taskOutput?: string, success?: boolean): ExecutionTrace;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

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

package/dist/metrics.js

@@ -0,0 +1,289 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceCapture = exports.CircuitBreaker = exports.SLOTracker = exports.ErrorBudgetTracker = exports.GovernanceMetrics = void 0;
+const crypto_1 = require("crypto");
+class GovernanceMetrics {
+    enabled;
+    sinks;
+    counters = {};
+    histograms = {};
+    gauges = {};
+    events = [];
+    static MAX_HISTOGRAM_SAMPLES = 10_000;
+    static MAX_EVENTS = 50_000;
+    constructor(config = false) {
+        if (typeof config === 'boolean') {
+            this.enabled = config;
+            this.sinks = [];
+        }
+        else {
+            this.enabled = config.enabled ?? false;
+            this.sinks = config.sinks ?? [];
+        }
+    }
+    registerSink(sink) {
+        this.sinks.push(sink);
+    }
+    recordPolicyDecision(decision, durationMs, attributes = {}) {
+        this.incrementCounter(`policy.decision.${decision}`);
+        this.recordHistogram('policy.duration_ms', durationMs);
+        this.emit({
+            name: 'policy.decision',
+            value: decision,
+            timestamp: new Date().toISOString(),
+            attributes: {
+                durationMs,
+                ...attributes,
+            },
+        });
+    }
+    recordTrustScore(agentId, score) {
+        this.gauges[`trust.score.${agentId}`] = score;
+        this.emit({
+            name: 'trust.score',
+            value: score,
+            timestamp: new Date().toISOString(),
+            attributes: { agentId },
+        });
+    }
+    recordAuditEntry(seq) {
+        this.incrementCounter('audit.entries');
+        this.gauges.auditLastSequence = seq;
+        this.emit({
+            name: 'audit.entry',
+            value: seq,
+            timestamp: new Date().toISOString(),
+            attributes: {},
+        });
+    }
+    recordToolCall(toolName, durationMs) {
+        this.incrementCounter('tool.calls');
+        this.recordHistogram('tool.duration_ms', durationMs);
+        this.emit({
+            name: 'tool.call',
+            value: durationMs,
+            timestamp: new Date().toISOString(),
+            attributes: { toolName },
+        });
+    }
+    recordTrace(trace) {
+        this.incrementCounter('trace.captures');
+        this.recordHistogram('trace.duration_ms', trace.durationMs ?? 0);
+        this.emit({
+            name: 'trace.capture',
+            value: trace.traceId,
+            timestamp: new Date().toISOString(),
+            attributes: {
+                agentId: trace.agentId,
+                success: trace.success ?? false,
+                spanCount: trace.spans.length,
+            },
+        });
+    }
+    getSnapshot() {
+        return {
+            counters: { ...this.counters },
+            histograms: Object.fromEntries(Object.entries(this.histograms).map(([key, values]) => [key, [...values]])),
+            gauges: { ...this.gauges },
+            events: [...this.events],
+        };
+    }
+    incrementCounter(name) {
+        this.counters[name] = (this.counters[name] ?? 0) + 1;
+    }
+    recordHistogram(name, value) {
+        const samples = this.histograms[name] ?? [];
+        if (samples.length < GovernanceMetrics.MAX_HISTOGRAM_SAMPLES) {
+            samples.push(value);
+        }
+        else {
+            // Reservoir-style: overwrite a random older sample to bound memory.
+            samples[Math.floor(Math.random() * samples.length)] = value;
+        }
+        this.histograms[name] = samples;
+    }
+    emit(event) {
+        if (!this.enabled) {
+            return;
+        }
+        if (this.events.length >= GovernanceMetrics.MAX_EVENTS) {
+            this.events.splice(0, Math.floor(GovernanceMetrics.MAX_EVENTS / 4));
+        }
+        this.events.push(event);
+        for (const sink of this.sinks) {
+            sink.record(event);
+        }
+    }
+}
+exports.GovernanceMetrics = GovernanceMetrics;
+class ErrorBudgetTracker {
+    targetAvailability;
+    windowSeconds;
+    events = [];
+    constructor(targetAvailability, windowSeconds = 30 * 24 * 60 * 60) {
+        this.targetAvailability = targetAvailability;
+        this.windowSeconds = windowSeconds;
+    }
+    recordEvent(good, timestampMs = Date.now()) {
+        this.events.push({ good, timestamp: timestampMs });
+    }
+    snapshot(windowSeconds = 3600) {
+        const relevant = this.events.filter((event) => event.timestamp >= Date.now() - this.windowSeconds * 1000);
+        const totalEvents = relevant.length;
+        const errorEvents = relevant.filter((event) => !event.good).length;
+        const allowedErrorRate = 1 - this.targetAvailability;
+        const actualErrorRate = totalEvents > 0 ? errorEvents / totalEvents : 0;
+        const burnRate = allowedErrorRate > 0 ? actualErrorRate / allowedErrorRate : 0;
+        const recent = relevant.filter((event) => event.timestamp >= Date.now() - windowSeconds * 1000);
+        const recentErrors = recent.filter((event) => !event.good).length;
+        const recentRate = recent.length > 0 ? recentErrors / recent.length : 0;
+        return {
+            targetAvailability: this.targetAvailability,
+            totalEvents,
+            errorEvents,
+            remainingPercent: Math.max(0, (1 - (actualErrorRate / Math.max(allowedErrorRate, Number.EPSILON))) * 100),
+            burnRate: allowedErrorRate > 0 ? recentRate / allowedErrorRate : burnRate,
+            exhausted: actualErrorRate >= allowedErrorRate && totalEvents > 0,
+        };
+    }
+}
+exports.ErrorBudgetTracker = ErrorBudgetTracker;
+class SLOTracker {
+    name;
+    budget;
+    constructor(name, targetAvailability, windowSeconds) {
+        this.name = name;
+        this.budget = new ErrorBudgetTracker(targetAvailability, windowSeconds);
+    }
+    recordEvent(good, timestampMs) {
+        this.budget.recordEvent(good, timestampMs);
+    }
+    evaluate() {
+        const snapshot = this.budget.snapshot();
+        if (snapshot.exhausted) {
+            return 'exhausted';
+        }
+        if (snapshot.burnRate >= 10) {
+            return 'critical';
+        }
+        if (snapshot.burnRate >= 2) {
+            return 'warning';
+        }
+        return 'healthy';
+    }
+}
+exports.SLOTracker = SLOTracker;
+class CircuitBreaker {
+    failureThreshold;
+    resetTimeoutMs;
+    failures = 0;
+    openedAt;
+    currentState = 'closed';
+    constructor(failureThreshold = 5, resetTimeoutMs = 30_000) {
+        this.failureThreshold = failureThreshold;
+        this.resetTimeoutMs = resetTimeoutMs;
+    }
+    get state() {
+        if (this.currentState === 'open' && this.openedAt && Date.now() - this.openedAt >= this.resetTimeoutMs) {
+            this.currentState = 'half_open';
+        }
+        return this.currentState;
+    }
+    canExecute() {
+        return this.state !== 'open';
+    }
+    onSuccess() {
+        this.failures = 0;
+        this.currentState = 'closed';
+        this.openedAt = undefined;
+    }
+    onFailure() {
+        this.failures += 1;
+        if (this.failures >= this.failureThreshold) {
+            this.currentState = 'open';
+            this.openedAt = Date.now();
+        }
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+class TraceCapture {
+    agentId;
+    taskInput;
+    traceId = (0, crypto_1.randomUUID)().replace(/-/g, '');
+    traceStart = Date.now();
+    spans = [];
+    spanStarts = new Map();
+    totalCostUsd = 0;
+    constructor(agentId, taskInput = '') {
+        this.agentId = agentId;
+        this.taskInput = taskInput;
+    }
+    currentTraceId() {
+        return this.traceId;
+    }
+    startSpan(name, kind = 'internal', input, parentId, attributes = {}) {
+        const spanId = (0, crypto_1.randomUUID)().replace(/-/g, '').slice(0, 16);
+        const startedAt = Date.now();
+        this.spanStarts.set(spanId, startedAt);
+        const span = {
+            spanId,
+            traceId: this.traceId,
+            parentId,
+            name,
+            kind,
+            status: 'ok',
+            startTime: new Date(startedAt).toISOString(),
+            attributes,
+            input,
+        };
+        this.spans.push(span);
+        return span;
+    }
+    finishSpan(spanId, status = 'ok', output, error, costUsd = 0) {
+        const span = this.spans.find((item) => item.spanId === spanId);
+        const startedAt = this.spanStarts.get(spanId);
+        if (!span || startedAt === undefined) {
+            throw new Error(`Unknown span: ${spanId}`);
+        }
+        const endedAt = Date.now();
+        span.status = status;
+        span.endTime = new Date(endedAt).toISOString();
+        span.durationMs = endedAt - startedAt;
+        span.output = output;
+        span.error = error;
+        this.totalCostUsd += costUsd;
+        this.spanStarts.delete(spanId);
+    }
+    getSpanDuration(spanId) {
+        const span = this.spans.find((item) => item.spanId === spanId);
+        return span?.durationMs;
+    }
+    finish(taskOutput, success = true) {
+        const endedAt = Date.now();
+        const contentHash = (0, crypto_1.createHash)('sha256')
+            .update(JSON.stringify({
+            agentId: this.agentId,
+            taskInput: this.taskInput,
+            traceId: this.traceId,
+        }))
+            .digest('hex')
+            .slice(0, 16);
+        return {
+            traceId: this.traceId,
+            agentId: this.agentId,
+            taskInput: this.taskInput,
+            taskOutput,
+            startTime: new Date(this.traceStart).toISOString(),
+            endTime: new Date(endedAt).toISOString(),
+            durationMs: endedAt - this.traceStart,
+            totalCostUsd: this.totalCostUsd,
+            success,
+            spans: [...this.spans],
+            contentHash,
+        };
+    }
+}
+exports.TraceCapture = TraceCapture;
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/oci-manifest.d.ts

@@ -0,0 +1,49 @@
+import type { AgentIdentityJSON, AICard, OciDescriptor, OciManifest, OciPackageResult, PolicyRule } from './types';
+/**
+ * Converts AGT agent manifests to/from OCI manifest format with AI Card
+ * compatibility. Enables registry-based discovery and verification of
+ * agent metadata.
+ */
+export declare class OciManifestAdapter {
+    /**
+     * Convert an AGT agent identity to an AI Card.
+     */
+    identityToAICard(identity: AgentIdentityJSON, extra?: Partial<AICard>): AICard;
+    /**
+     * Convert an AI Card back to an AGT agent identity.
+     */
+    aiCardToIdentity(card: AICard, publicKey: string): AgentIdentityJSON;
+    /**
+     * Package an agent identity and optional policy rules into an OCI manifest.
+     */
+    package(identity: AgentIdentityJSON, policyRules?: PolicyRule[], extra?: Partial<AICard>): OciPackageResult;
+    /**
+     * Extract an AI Card from an OCI manifest's layers.
+     */
+    unpackAICard(layers: Array<{
+        descriptor: OciDescriptor;
+        content: string;
+    }>): AICard | null;
+    /**
+     * Extract policy rules from an OCI manifest's layers.
+     */
+    unpackPolicies(layers: Array<{
+        descriptor: OciDescriptor;
+        content: string;
+    }>): PolicyRule[];
+    /**
+     * Verify the integrity of an OCI manifest by checking layer digests.
+     */
+    verifyManifest(manifest: OciManifest, layers: Array<{
+        descriptor: OciDescriptor;
+        content: string;
+    }>, configContent?: string): {
+        valid: boolean;
+        errors: string[];
+    };
+    private createDescriptor;
+    private sha256Digest;
+    private capabilitiesToAICard;
+    private aiCardToCapabilities;
+}
+//# sourceMappingURL=oci-manifest.d.ts.map

package/dist/oci-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oci-manifest.d.ts","sourceRoot":"","sources":["../src/oci-manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,MAAM,EAGN,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,UAAU,EACX,MAAM,SAAS,CAAC;AAOjB;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAqB9E;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAiBpE;;OAEG;IACH,OAAO,CACL,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,CAAC,EAAE,UAAU,EAAE,EAC1B,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GACtB,gBAAgB;IA2CnB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM,GAAG,IAAI;IAW1F;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,UAAU,EAAE;IAY3F;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAC7D,aAAa,CAAC,EAAE,MAAM,GACrB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAqCvC,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,oBAAoB;CAI7B"}