@mnemom/aip-otel-exporter 0.1.0

package/dist/auto/aap-instrumentation.js

@@ -0,0 +1,112 @@
+/**
+ * Auto-instrumentation for AAP verification functions.
+ *
+ * Wraps verifyTrace, checkCoherence, and detectDrift exports to
+ * automatically record OTel spans. Node.js only.
+ */
+import { trace } from "@opentelemetry/api";
+import { recordVerification } from "../manual/record-verification.js";
+import { recordCoherence } from "../manual/record-coherence.js";
+import { recordDrift } from "../manual/record-drift.js";
+const state = {
+    originalVerifyTrace: null,
+    originalCheckCoherence: null,
+    originalDetectDrift: null,
+    aapModule: null,
+    patched: false,
+};
+function wrapAsync(original, recorder, tracer) {
+    return function wrappedFn(...args) {
+        const result = original.call(this, ...args);
+        if (result && typeof result.then === "function") {
+            return result.then((value) => {
+                if (value && typeof value === "object") {
+                    try {
+                        recorder(tracer, value);
+                    }
+                    catch {
+                        // Never break the application
+                    }
+                }
+                return value;
+            });
+        }
+        if (result && typeof result === "object") {
+            try {
+                recorder(tracer, result);
+            }
+            catch {
+                // Never break the application
+            }
+        }
+        return result;
+    };
+}
+/**
+ * Instrument AAP verification functions to auto-record spans.
+ *
+ * Attempts to require `@mnemom/agent-alignment-protocol` and wrap:
+ * - verifyTrace → recordVerification
+ * - checkCoherence → recordCoherence
+ * - detectDrift → recordDrift
+ */
+export function instrumentAAP(options) {
+    if (state.patched)
+        return;
+    const tracer = options?.tracerProvider
+        ? options.tracerProvider.getTracer("@mnemom/aip-otel-exporter", "0.1.0")
+        : trace.getTracer("@mnemom/aip-otel-exporter", "0.1.0");
+    let aapModule;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        aapModule = require("@mnemom/agent-alignment-protocol");
+    }
+    catch {
+        return;
+    }
+    state.aapModule = aapModule;
+    if (typeof aapModule.verifyTrace === "function") {
+        state.originalVerifyTrace = aapModule.verifyTrace;
+        aapModule.verifyTrace = wrapAsync(state.originalVerifyTrace, recordVerification, tracer);
+    }
+    if (typeof aapModule.checkCoherence === "function") {
+        state.originalCheckCoherence = aapModule.checkCoherence;
+        aapModule.checkCoherence = wrapAsync(state.originalCheckCoherence, recordCoherence, tracer);
+    }
+    if (typeof aapModule.detectDrift === "function") {
+        state.originalDetectDrift = aapModule.detectDrift;
+        aapModule.detectDrift = wrapAsync(state.originalDetectDrift, (tracer, result) => {
+            // detectDrift returns an array of alerts
+            if (Array.isArray(result)) {
+                recordDrift(tracer, result);
+            }
+            else if (result &&
+                typeof result === "object" &&
+                "alerts" in result) {
+                const r = result;
+                recordDrift(tracer, r.alerts, r.traces_analyzed);
+            }
+        }, tracer);
+    }
+    state.patched = true;
+}
+/** Remove AAP instrumentation, restoring original functions. */
+export function uninstrumentAAP() {
+    if (!state.patched || !state.aapModule)
+        return;
+    if (state.originalVerifyTrace) {
+        state.aapModule.verifyTrace = state.originalVerifyTrace;
+    }
+    if (state.originalCheckCoherence) {
+        state.aapModule.checkCoherence = state.originalCheckCoherence;
+    }
+    if (state.originalDetectDrift) {
+        state.aapModule.detectDrift = state.originalDetectDrift;
+    }
+    state.originalVerifyTrace = null;
+    state.originalCheckCoherence = null;
+    state.originalDetectDrift = null;
+    state.aapModule = null;
+    state.patched = false;
+}
+//# sourceMappingURL=aap-instrumentation.js.map

package/dist/auto/aap-instrumentation.js.map

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

package/dist/auto/aip-instrumentation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Auto-instrumentation for AIP client.
+ *
+ * Wraps AIPClient.prototype.check() to automatically record integrity
+ * check spans after each call. Node.js only.
+ */
+import { type Tracer } from "@opentelemetry/api";
+/**
+ * Instrument the AIP client to auto-record integrity checks.
+ *
+ * Attempts to require/import `@mnemom/agent-integrity-protocol` and
+ * monkey-patch `AIPClient.prototype.check` to call `recordIntegrityCheck`
+ * after each invocation.
+ */
+export declare function instrumentAIP(options?: {
+    tracerProvider?: {
+        getTracer: (name: string, version?: string) => Tracer;
+    };
+}): void;
+/** Remove AIP instrumentation, restoring original methods. */
+export declare function uninstrumentAIP(): void;
+//# sourceMappingURL=aip-instrumentation.d.ts.map

package/dist/auto/aip-instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aip-instrumentation.d.ts","sourceRoot":"","sources":["../../src/auto/aip-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAS,MAAM,oBAAoB,CAAC;AAexD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IACtC,cAAc,CAAC,EAAE;QAAE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;CAC5E,GAAG,IAAI,CA4DP;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,IAAI,IAAI,CAgBtC"}

package/dist/auto/aip-instrumentation.js

@@ -0,0 +1,87 @@
+/**
+ * Auto-instrumentation for AIP client.
+ *
+ * Wraps AIPClient.prototype.check() to automatically record integrity
+ * check spans after each call. Node.js only.
+ */
+import { trace } from "@opentelemetry/api";
+import { recordIntegrityCheck } from "../manual/record-integrity-check.js";
+const state = {
+    originalCheck: null,
+    patched: false,
+};
+/**
+ * Instrument the AIP client to auto-record integrity checks.
+ *
+ * Attempts to require/import `@mnemom/agent-integrity-protocol` and
+ * monkey-patch `AIPClient.prototype.check` to call `recordIntegrityCheck`
+ * after each invocation.
+ */
+export function instrumentAIP(options) {
+    if (state.patched)
+        return;
+    const tracer = options?.tracerProvider
+        ? options.tracerProvider.getTracer("@mnemom/aip-otel-exporter", "0.1.0")
+        : trace.getTracer("@mnemom/aip-otel-exporter", "0.1.0");
+    let AIPClient;
+    try {
+        // Dynamic require for Node.js — won't work in CF Workers (expected)
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const aipModule = require("@mnemom/agent-integrity-protocol");
+        AIPClient = aipModule.AIPClient ?? aipModule.default?.AIPClient;
+    }
+    catch {
+        // Package not installed — nothing to instrument
+        return;
+    }
+    if (!AIPClient?.prototype?.check)
+        return;
+    state.originalCheck = AIPClient.prototype.check;
+    const originalCheck = state.originalCheck;
+    AIPClient.prototype.check = function wrappedCheck(...args) {
+        const result = originalCheck.call(this, ...args);
+        // Handle both sync and async results
+        if (result && typeof result.then === "function") {
+            return result.then((signal) => {
+                if (signal && typeof signal === "object") {
+                    try {
+                        recordIntegrityCheck(tracer, signal);
+                    }
+                    catch {
+                        // Never let instrumentation break the application
+                    }
+                }
+                return signal;
+            });
+        }
+        if (result && typeof result === "object") {
+            try {
+                recordIntegrityCheck(tracer, result);
+            }
+            catch {
+                // Never let instrumentation break the application
+            }
+        }
+        return result;
+    };
+    state.patched = true;
+}
+/** Remove AIP instrumentation, restoring original methods. */
+export function uninstrumentAIP() {
+    if (!state.patched || !state.originalCheck)
+        return;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const aipModule = require("@mnemom/agent-integrity-protocol");
+        const AIPClient = aipModule.AIPClient ?? aipModule.default?.AIPClient;
+        if (AIPClient?.prototype) {
+            AIPClient.prototype.check = state.originalCheck;
+        }
+    }
+    catch {
+        // Package not available
+    }
+    state.originalCheck = null;
+    state.patched = false;
+}
+//# sourceMappingURL=aip-instrumentation.js.map

package/dist/auto/aip-instrumentation.js.map

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

package/dist/auto/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Auto-instrumentation entry point.
+ *
+ * Usage:
+ *   import { instrument } from '@mnemom/aip-otel-exporter/auto';
+ *   instrument();
+ */
+import type { Tracer } from "@opentelemetry/api";
+export interface InstrumentOptions {
+    tracerProvider?: {
+        getTracer: (name: string, version?: string) => Tracer;
+    };
+}
+/** Instrument both AIP and AAP for automatic span recording. */
+export declare function instrument(options?: InstrumentOptions): void;
+/** Remove all instrumentation. */
+export declare function uninstrument(): void;
+export { instrumentAIP, uninstrumentAIP } from "./aip-instrumentation.js";
+export { instrumentAAP, uninstrumentAAP } from "./aap-instrumentation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/auto/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auto/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAIjD,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE;QAAE,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;CAC5E;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAG5D;AAED,kCAAkC;AAClC,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/auto/index.js

@@ -0,0 +1,22 @@
+/**
+ * Auto-instrumentation entry point.
+ *
+ * Usage:
+ *   import { instrument } from '@mnemom/aip-otel-exporter/auto';
+ *   instrument();
+ */
+import { instrumentAIP, uninstrumentAIP } from "./aip-instrumentation.js";
+import { instrumentAAP, uninstrumentAAP } from "./aap-instrumentation.js";
+/** Instrument both AIP and AAP for automatic span recording. */
+export function instrument(options) {
+    instrumentAIP(options);
+    instrumentAAP(options);
+}
+/** Remove all instrumentation. */
+export function uninstrument() {
+    uninstrumentAIP();
+    uninstrumentAAP();
+}
+export { instrumentAIP, uninstrumentAIP } from "./aip-instrumentation.js";
+export { instrumentAAP, uninstrumentAAP } from "./aap-instrumentation.js";
+//# sourceMappingURL=index.js.map

package/dist/auto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auto/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAM1E,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,OAA2B;IACpD,aAAa,CAAC,OAAO,CAAC,CAAC;IACvB,aAAa,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,YAAY;IAC1B,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;AACpB,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @mnemom/aip-otel-exporter
+ *
+ * OpenTelemetry exporter for AIP integrity checkpoints and AAP verification results.
+ *
+ * Three layers:
+ * 1. Manual API (this import) — works everywhere including CF Workers with OTel SDK
+ * 2. Auto-instrumentation — import from '@mnemom/aip-otel-exporter/auto'
+ * 3. CF Workers adapter — import from '@mnemom/aip-otel-exporter/workers'
+ */
+import type { AIPOTelRecorderConfig, AIPOTelRecorder } from "./types.js";
+/**
+ * Create an AIP OTel Recorder instance.
+ *
+ * @example
+ * ```ts
+ * import { createAIPOTelRecorder } from '@mnemom/aip-otel-exporter';
+ * const recorder = createAIPOTelRecorder({ tracerProvider });
+ * recorder.recordIntegrityCheck(signal);
+ * recorder.recordVerification(result);
+ * ```
+ */
+export declare function createAIPOTelRecorder(config?: AIPOTelRecorderConfig): AIPOTelRecorder;
+export type { AIPOTelRecorderConfig, AIPOTelRecorder, IntegritySignalInput, VerificationResultInput, CoherenceResultInput, DriftAlertInput, ConcernInput, ViolationInput, WarningInput, WindowSummaryInput, CheckpointInput, ConscienceContextInput, AnalysisMetadataInput, VerificationMetadataInput, ValueAlignmentInput, DriftAnalysisInput, IntegrityDriftAlertInput, WorkersExporterConfig, WorkersOTelExporter, } from "./types.js";
+export * from "./attributes.js";
+export { recordIntegrityCheck } from "./manual/record-integrity-check.js";
+export { recordVerification } from "./manual/record-verification.js";
+export { recordCoherence } from "./manual/record-coherence.js";
+export { recordDrift } from "./manual/record-drift.js";
+export { buildSpan } from "./manual/span-builder.js";
+export { createAIPMetrics, recordIntegrityMetrics, recordVerificationMetrics, recordCoherenceMetrics, recordDriftMetrics, } from "./metrics/integrity-metrics.js";
+export type { AIPMetrics } from "./metrics/integrity-metrics.js";
+//# 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":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EAKhB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,eAAe,CAsBjB;AAGD,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+/**
+ * @mnemom/aip-otel-exporter
+ *
+ * OpenTelemetry exporter for AIP integrity checkpoints and AAP verification results.
+ *
+ * Three layers:
+ * 1. Manual API (this import) — works everywhere including CF Workers with OTel SDK
+ * 2. Auto-instrumentation — import from '@mnemom/aip-otel-exporter/auto'
+ * 3. CF Workers adapter — import from '@mnemom/aip-otel-exporter/workers'
+ */
+import { trace } from "@opentelemetry/api";
+import { recordIntegrityCheck } from "./manual/record-integrity-check.js";
+import { recordVerification } from "./manual/record-verification.js";
+import { recordCoherence } from "./manual/record-coherence.js";
+import { recordDrift } from "./manual/record-drift.js";
+/**
+ * Create an AIP OTel Recorder instance.
+ *
+ * @example
+ * ```ts
+ * import { createAIPOTelRecorder } from '@mnemom/aip-otel-exporter';
+ * const recorder = createAIPOTelRecorder({ tracerProvider });
+ * recorder.recordIntegrityCheck(signal);
+ * recorder.recordVerification(result);
+ * ```
+ */
+export function createAIPOTelRecorder(config) {
+    const tracerName = config?.tracerName ?? "@mnemom/aip-otel-exporter";
+    const tracerVersion = config?.tracerVersion ?? "0.1.0";
+    const tracer = config?.tracerProvider
+        ? config.tracerProvider.getTracer(tracerName, tracerVersion)
+        : trace.getTracer(tracerName, tracerVersion);
+    return {
+        recordIntegrityCheck(signal) {
+            recordIntegrityCheck(tracer, signal);
+        },
+        recordVerification(result) {
+            recordVerification(tracer, result);
+        },
+        recordCoherence(result) {
+            recordCoherence(tracer, result);
+        },
+        recordDrift(alerts, tracesAnalyzed) {
+            recordDrift(tracer, alerts, tracesAnalyzed);
+        },
+    };
+}
+// Re-export attribute constants
+export * from "./attributes.js";
+// Re-export manual API functions (for advanced use)
+export { recordIntegrityCheck } from "./manual/record-integrity-check.js";
+export { recordVerification } from "./manual/record-verification.js";
+export { recordCoherence } from "./manual/record-coherence.js";
+export { recordDrift } from "./manual/record-drift.js";
+export { buildSpan } from "./manual/span-builder.js";
+// Re-export metrics
+export { createAIPMetrics, recordIntegrityMetrics, recordVerificationMetrics, recordCoherenceMetrics, recordDriftMetrics, } from "./metrics/integrity-metrics.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAe,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAUvD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAA8B;IAE9B,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,2BAA2B,CAAC;IACrE,MAAM,aAAa,GAAG,MAAM,EAAE,aAAa,IAAI,OAAO,CAAC;IAEvD,MAAM,MAAM,GAAW,MAAM,EAAE,cAAc;QAC3C,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,CAAC;QAC5D,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAE/C,OAAO;QACL,oBAAoB,CAAC,MAA4B;YAC/C,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QACD,kBAAkB,CAAC,MAA+B;YAChD,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,eAAe,CAAC,MAA4B;YAC1C,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,WAAW,CAAC,MAAyB,EAAE,cAAuB;YAC5D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC;AAyBD,gCAAgC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,oDAAoD;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,gCAAgC,CAAC"}

package/dist/manual/record-coherence.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Records an AAP CoherenceResult as an OpenTelemetry span.
+ *
+ * Maps 5 attributes: compatible, score, proceed, matched_count, conflict_count.
+ */
+import type { Span, Tracer } from "@opentelemetry/api";
+import type { CoherenceResultInput } from "../types.js";
+/**
+ * Record a CoherenceResult as an OTel span with 5 attributes.
+ */
+export declare function recordCoherence(tracer: Tracer, result: CoherenceResultInput): Span;
+//# sourceMappingURL=record-coherence.d.ts.map

package/dist/manual/record-coherence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-coherence.d.ts","sourceRoot":"","sources":["../../src/manual/record-coherence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAaxD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CAUN"}

package/dist/manual/record-coherence.js

@@ -0,0 +1,21 @@
+/**
+ * Records an AAP CoherenceResult as an OpenTelemetry span.
+ *
+ * Maps 5 attributes: compatible, score, proceed, matched_count, conflict_count.
+ */
+import { SPAN_AAP_CHECK_COHERENCE, AAP_COHERENCE_COMPATIBLE, AAP_COHERENCE_SCORE, AAP_COHERENCE_PROCEED, AAP_COHERENCE_MATCHED_COUNT, AAP_COHERENCE_CONFLICT_COUNT, } from "../attributes.js";
+import { buildSpan } from "./span-builder.js";
+/**
+ * Record a CoherenceResult as an OTel span with 5 attributes.
+ */
+export function recordCoherence(tracer, result) {
+    const attributes = {
+        [AAP_COHERENCE_COMPATIBLE]: result?.compatible,
+        [AAP_COHERENCE_SCORE]: result?.score,
+        [AAP_COHERENCE_PROCEED]: result?.proceed,
+        [AAP_COHERENCE_MATCHED_COUNT]: result?.value_alignment?.matched?.length,
+        [AAP_COHERENCE_CONFLICT_COUNT]: result?.value_alignment?.conflicts?.length,
+    };
+    return buildSpan(tracer, SPAN_AAP_CHECK_COHERENCE, attributes);
+}
+//# sourceMappingURL=record-coherence.js.map

package/dist/manual/record-coherence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-coherence.js","sourceRoot":"","sources":["../../src/manual/record-coherence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,MAA4B;IAE5B,MAAM,UAAU,GAA4B;QAC1C,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,UAAU;QAC9C,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK;QACpC,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,OAAO;QACxC,CAAC,2BAA2B,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;QACvE,CAAC,4BAA4B,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM;KAC3E,CAAC;IAEF,OAAO,SAAS,CAAC,MAAM,EAAE,wBAAwB,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC"}

package/dist/manual/record-drift.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Records AAP drift detection as an OpenTelemetry span.
+ *
+ * Sets alerts_count and traces_analyzed as span attributes, then emits one
+ * EVENT_AAP_DRIFT_ALERT event per alert with type, agent, card, similarity,
+ * direction, and recommendation.
+ */
+import type { Span, Tracer } from "@opentelemetry/api";
+import type { DriftAlertInput } from "../types.js";
+/**
+ * Record drift detection as an OTel span with per-alert events.
+ */
+export declare function recordDrift(tracer: Tracer, alerts: DriftAlertInput[], tracesAnalyzed?: number): Span;
+//# sourceMappingURL=record-drift.d.ts.map

package/dist/manual/record-drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-drift.d.ts","sourceRoot":"","sources":["../../src/manual/record-drift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAc,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnD;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,EAAE,EACzB,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CAqCN"}

package/dist/manual/record-drift.js

@@ -0,0 +1,48 @@
+/**
+ * Records AAP drift detection as an OpenTelemetry span.
+ *
+ * Sets alerts_count and traces_analyzed as span attributes, then emits one
+ * EVENT_AAP_DRIFT_ALERT event per alert with type, agent, card, similarity,
+ * direction, and recommendation.
+ */
+import { SPAN_AAP_DETECT_DRIFT, EVENT_AAP_DRIFT_ALERT, AAP_DRIFT_ALERTS_COUNT, AAP_DRIFT_TRACES_ANALYZED, } from "../attributes.js";
+import { buildSpan } from "./span-builder.js";
+/**
+ * Record drift detection as an OTel span with per-alert events.
+ */
+export function recordDrift(tracer, alerts, tracesAnalyzed) {
+    const attributes = {
+        [AAP_DRIFT_ALERTS_COUNT]: alerts?.length,
+        [AAP_DRIFT_TRACES_ANALYZED]: tracesAnalyzed,
+    };
+    const events = [];
+    if (alerts) {
+        for (const alert of alerts) {
+            events.push({
+                name: EVENT_AAP_DRIFT_ALERT,
+                attributes: {
+                    ...(alert?.alert_type !== undefined &&
+                        alert?.alert_type !== null && { alert_type: alert.alert_type }),
+                    ...(alert?.agent_id !== undefined &&
+                        alert?.agent_id !== null && { agent_id: alert.agent_id }),
+                    ...(alert?.card_id !== undefined &&
+                        alert?.card_id !== null && { card_id: alert.card_id }),
+                    ...(alert?.analysis?.similarity_score !== undefined &&
+                        alert?.analysis?.similarity_score !== null && {
+                        similarity_score: alert.analysis.similarity_score,
+                    }),
+                    ...(alert?.analysis?.drift_direction !== undefined &&
+                        alert?.analysis?.drift_direction !== null && {
+                        drift_direction: alert.analysis.drift_direction,
+                    }),
+                    ...(alert?.recommendation !== undefined &&
+                        alert?.recommendation !== null && {
+                        recommendation: alert.recommendation,
+                    }),
+                },
+            });
+        }
+    }
+    return buildSpan(tracer, SPAN_AAP_DETECT_DRIFT, attributes, events);
+}
+//# sourceMappingURL=record-drift.js.map

package/dist/manual/record-drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-drift.js","sourceRoot":"","sources":["../../src/manual/record-drift.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,MAAyB,EACzB,cAAuB;IAEvB,MAAM,UAAU,GAA4B;QAC1C,CAAC,sBAAsB,CAAC,EAAE,MAAM,EAAE,MAAM;QACxC,CAAC,yBAAyB,CAAC,EAAE,cAAc;KAC5C,CAAC;IAEF,MAAM,MAAM,GAAoD,EAAE,CAAC;IAEnE,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,qBAAqB;gBAC3B,UAAU,EAAE;oBACV,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,SAAS;wBACjC,KAAK,EAAE,UAAU,KAAK,IAAI,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;oBACjE,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,SAAS;wBAC/B,KAAK,EAAE,QAAQ,KAAK,IAAI,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;oBAC3D,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS;wBAC9B,KAAK,EAAE,OAAO,KAAK,IAAI,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;oBACxD,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,KAAK,SAAS;wBACjD,KAAK,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,IAAI;wBAC5C,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,gBAAgB;qBAClD,CAAC;oBACJ,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,KAAK,SAAS;wBAChD,KAAK,EAAE,QAAQ,EAAE,eAAe,KAAK,IAAI,IAAI;wBAC3C,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe;qBAChD,CAAC;oBACJ,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS;wBACrC,KAAK,EAAE,cAAc,KAAK,IAAI,IAAI;wBAChC,cAAc,EAAE,KAAK,CAAC,cAAc;qBACrC,CAAC;iBACL;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC"}

package/dist/manual/record-integrity-check.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Records an AIP IntegritySignal as an OpenTelemetry span.
+ *
+ * Maps all 22 planned attributes from the checkpoint, signal, analysis_metadata,
+ * conscience_context, and window_summary onto a single INTERNAL span.
+ * Concerns are emitted as individual span events, and a drift alert event is
+ * added when the window summary indicates active drift.
+ */
+import type { Span, Tracer } from "@opentelemetry/api";
+import type { IntegritySignalInput } from "../types.js";
+/**
+ * Record an IntegritySignal as an OTel span with all 22 attributes, concern
+ * events, and an optional drift alert event.
+ *
+ * All inputs are duck-typed -- every field is accessed via optional chaining so
+ * missing data is silently skipped rather than throwing.
+ */
+export declare function recordIntegrityCheck(tracer: Tracer, signal: IntegritySignalInput): Span;
+//# sourceMappingURL=record-integrity-check.d.ts.map

package/dist/manual/record-integrity-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-integrity-check.d.ts","sourceRoot":"","sources":["../../src/manual/record-integrity-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAc,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA6CxD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CAuEN"}

package/dist/manual/record-integrity-check.js

@@ -0,0 +1,92 @@
+/**
+ * Records an AIP IntegritySignal as an OpenTelemetry span.
+ *
+ * Maps all 22 planned attributes from the checkpoint, signal, analysis_metadata,
+ * conscience_context, and window_summary onto a single INTERNAL span.
+ * Concerns are emitted as individual span events, and a drift alert event is
+ * added when the window summary indicates active drift.
+ */
+import { 
+// Span & event names
+SPAN_AIP_INTEGRITY_CHECK, EVENT_AIP_CONCERN, EVENT_AIP_DRIFT_ALERT, 
+// Checkpoint attributes
+AIP_INTEGRITY_CHECKPOINT_ID, AIP_INTEGRITY_VERDICT, AIP_INTEGRITY_AGENT_ID, AIP_INTEGRITY_CARD_ID, AIP_INTEGRITY_SESSION_ID, AIP_INTEGRITY_THINKING_HASH, 
+// Signal-level attributes
+AIP_INTEGRITY_PROCEED, AIP_INTEGRITY_RECOMMENDED_ACTION, AIP_INTEGRITY_CONCERNS_COUNT, 
+// Analysis metadata attributes
+AIP_INTEGRITY_ANALYSIS_MODEL, AIP_INTEGRITY_ANALYSIS_DURATION_MS, AIP_INTEGRITY_THINKING_TOKENS, AIP_INTEGRITY_TRUNCATED, AIP_INTEGRITY_EXTRACTION_CONFIDENCE, 
+// Conscience context attributes
+AIP_CONSCIENCE_CONSULTATION_DEPTH, AIP_CONSCIENCE_VALUES_CHECKED_COUNT, AIP_CONSCIENCE_CONFLICTS_COUNT, 
+// Window summary attributes
+AIP_WINDOW_SIZE, AIP_WINDOW_INTEGRITY_RATIO, AIP_WINDOW_DRIFT_ALERT_ACTIVE, 
+// GenAI forward-compat aliases
+GEN_AI_EVALUATION_VERDICT, GEN_AI_EVALUATION_SCORE, } from "../attributes.js";
+import { buildSpan } from "./span-builder.js";
+/**
+ * Record an IntegritySignal as an OTel span with all 22 attributes, concern
+ * events, and an optional drift alert event.
+ *
+ * All inputs are duck-typed -- every field is accessed via optional chaining so
+ * missing data is silently skipped rather than throwing.
+ */
+export function recordIntegrityCheck(tracer, signal) {
+    const cp = signal?.checkpoint;
+    const meta = cp?.analysis_metadata;
+    const conscience = cp?.conscience_context;
+    const win = signal?.window_summary;
+    // --- Attributes (22 domain + 2 GenAI aliases) ---
+    const attributes = {
+        // Checkpoint
+        [AIP_INTEGRITY_CHECKPOINT_ID]: cp?.checkpoint_id,
+        [AIP_INTEGRITY_VERDICT]: cp?.verdict,
+        [AIP_INTEGRITY_AGENT_ID]: cp?.agent_id,
+        [AIP_INTEGRITY_CARD_ID]: cp?.card_id,
+        [AIP_INTEGRITY_SESSION_ID]: cp?.session_id,
+        [AIP_INTEGRITY_THINKING_HASH]: cp?.thinking_block_hash,
+        // Signal
+        [AIP_INTEGRITY_PROCEED]: signal?.proceed,
+        [AIP_INTEGRITY_RECOMMENDED_ACTION]: signal?.recommended_action,
+        [AIP_INTEGRITY_CONCERNS_COUNT]: cp?.concerns?.length,
+        // Analysis metadata
+        [AIP_INTEGRITY_ANALYSIS_MODEL]: meta?.analysis_model,
+        [AIP_INTEGRITY_ANALYSIS_DURATION_MS]: meta?.analysis_duration_ms,
+        [AIP_INTEGRITY_THINKING_TOKENS]: meta?.thinking_tokens_original,
+        [AIP_INTEGRITY_TRUNCATED]: meta?.truncated,
+        [AIP_INTEGRITY_EXTRACTION_CONFIDENCE]: meta?.extraction_confidence,
+        // Conscience context
+        [AIP_CONSCIENCE_CONSULTATION_DEPTH]: conscience?.consultation_depth,
+        [AIP_CONSCIENCE_VALUES_CHECKED_COUNT]: conscience?.values_checked?.length,
+        [AIP_CONSCIENCE_CONFLICTS_COUNT]: conscience?.conflicts?.length,
+        // Window summary
+        [AIP_WINDOW_SIZE]: win?.size,
+        [AIP_WINDOW_INTEGRITY_RATIO]: win?.integrity_ratio,
+        [AIP_WINDOW_DRIFT_ALERT_ACTIVE]: win?.drift_alert_active,
+        // GenAI SIG forward-compat aliases
+        [GEN_AI_EVALUATION_VERDICT]: cp?.verdict,
+        [GEN_AI_EVALUATION_SCORE]: win?.integrity_ratio,
+    };
+    // --- Events ---
+    const events = [];
+    // One event per concern
+    if (cp?.concerns) {
+        for (const concern of cp.concerns) {
+            events.push({
+                name: EVENT_AIP_CONCERN,
+                attributes: {
+                    category: concern.category,
+                    severity: concern.severity,
+                    description: concern.description,
+                },
+            });
+        }
+    }
+    // Drift alert event when drift is active
+    if (win?.drift_alert_active) {
+        events.push({
+            name: EVENT_AIP_DRIFT_ALERT,
+            attributes: {},
+        });
+    }
+    return buildSpan(tracer, SPAN_AIP_INTEGRITY_CHECK, attributes, events);
+}
+//# sourceMappingURL=record-integrity-check.js.map

package/dist/manual/record-integrity-check.js.map

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