@mnemom/aip-otel-exporter 0.1.0

package/dashboards/grafana-aip-overview.json

@@ -0,0 +1,431 @@
+{
+  "__inputs": [
+    {
+      "name": "DS_PROMETHEUS",
+      "label": "Prometheus",
+      "description": "",
+      "type": "datasource",
+      "pluginId": "prometheus",
+      "pluginName": "Prometheus"
+    }
+  ],
+  "__requires": [
+    {
+      "type": "grafana",
+      "id": "grafana",
+      "name": "Grafana",
+      "version": "10.0.0"
+    },
+    {
+      "type": "datasource",
+      "id": "prometheus",
+      "name": "Prometheus",
+      "version": "1.0.0"
+    },
+    {
+      "type": "panel",
+      "id": "piechart",
+      "name": "Pie chart",
+      "version": ""
+    },
+    {
+      "type": "panel",
+      "id": "timeseries",
+      "name": "Time series",
+      "version": ""
+    },
+    {
+      "type": "panel",
+      "id": "gauge",
+      "name": "Gauge",
+      "version": ""
+    },
+    {
+      "type": "panel",
+      "id": "barchart",
+      "name": "Bar chart",
+      "version": ""
+    },
+    {
+      "type": "panel",
+      "id": "histogram",
+      "name": "Histogram",
+      "version": ""
+    },
+    {
+      "type": "panel",
+      "id": "stat",
+      "name": "Stat",
+      "version": ""
+    }
+  ],
+  "id": null,
+  "uid": "aip-otel-overview",
+  "title": "AIP Integrity Overview",
+  "description": "Overview dashboard for AIP integrity checks and AAP verification results exported via @mnemom/aip-otel-exporter.",
+  "tags": ["aip", "integrity", "otel", "aap"],
+  "timezone": "browser",
+  "editable": true,
+  "graphTooltip": 1,
+  "refresh": "30s",
+  "schemaVersion": 39,
+  "version": 1,
+  "time": {
+    "from": "now-6h",
+    "to": "now"
+  },
+  "templating": {
+    "list": [
+      {
+        "name": "agent_id",
+        "type": "query",
+        "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+        "query": "label_values(aip_integrity_checks_total, agent_id)",
+        "refresh": 2,
+        "includeAll": true,
+        "allValue": ".*",
+        "current": { "text": "All", "value": "$__all" },
+        "multi": true,
+        "sort": 1
+      },
+      {
+        "name": "time_range",
+        "type": "interval",
+        "query": "1m,5m,15m,30m,1h,6h,12h,1d",
+        "current": { "text": "5m", "value": "5m" },
+        "auto": false
+      }
+    ]
+  },
+  "panels": [
+    {
+      "title": "Integrity Checks",
+      "type": "row",
+      "gridPos": { "h": 1, "w": 24, "x": 0, "y": 0 },
+      "collapsed": false,
+      "panels": []
+    },
+    {
+      "title": "Integrity Verdict Distribution",
+      "type": "piechart",
+      "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+      "gridPos": { "h": 8, "w": 8, "x": 0, "y": 1 },
+      "fieldConfig": {
+        "defaults": {
+          "color": { "mode": "palette-classic" },
+          "custom": { "hideFrom": { "legend": false, "tooltip": false, "viz": false } }
+        },
+        "overrides": [
+          {
+            "matcher": { "id": "byName", "options": "clear" },
+            "properties": [{ "id": "color", "value": { "fixedColor": "green", "mode": "fixed" } }]
+          },
+          {
+            "matcher": { "id": "byName", "options": "review_needed" },
+            "properties": [{ "id": "color", "value": { "fixedColor": "yellow", "mode": "fixed" } }]
+          },
+          {
+            "matcher": { "id": "byName", "options": "boundary_violation" },
+            "properties": [{ "id": "color", "value": { "fixedColor": "red", "mode": "fixed" } }]
+          }
+        ]
+      },
+      "options": {
+        "legend": { "displayMode": "list", "placement": "right" },
+        "pieType": "pie",
+        "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false },
+        "tooltip": { "mode": "single" }
+      },
+      "targets": [
+        {
+          "expr": "sum by (verdict) (increase(aip_integrity_checks_total{agent_id=~\"$agent_id\"}[$time_range]))",
+          "legendFormat": "{{verdict}}",
+          "refId": "A"
+        }
+      ]
+    },
+    {
+      "title": "Integrity Checks per Minute",
+      "type": "timeseries",
+      "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+      "gridPos": { "h": 8, "w": 8, "x": 8, "y": 1 },
+      "fieldConfig": {
+        "defaults": {
+          "color": { "mode": "palette-classic" },
+          "custom": {
+            "axisBorderShow": false,
+            "axisCenteredZero": false,
+            "axisLabel": "checks/min",
+            "drawStyle": "line",
+            "fillOpacity": 20,
+            "lineInterpolation": "smooth",
+            "lineWidth": 2,
+            "pointSize": 5,
+            "showPoints": "auto",
+            "spanNulls": false,
+            "stacking": { "group": "A", "mode": "none" }
+          },
+          "unit": "cpm"
+        },
+        "overrides": []
+      },
+      "options": {
+        "legend": { "displayMode": "list", "placement": "bottom" },
+        "tooltip": { "mode": "multi", "sort": "desc" }
+      },
+      "targets": [
+        {
+          "expr": "sum by (verdict) (rate(aip_integrity_checks_total{agent_id=~\"$agent_id\"}[5m]) * 60)",
+          "legendFormat": "{{verdict}}",
+          "refId": "A"
+        }
+      ]
+    },
+    {
+      "title": "Integrity Ratio",
+      "type": "gauge",
+      "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+      "gridPos": { "h": 8, "w": 8, "x": 16, "y": 1 },
+      "fieldConfig": {
+        "defaults": {
+          "color": { "mode": "thresholds" },
+          "thresholds": {
+            "mode": "absolute",
+            "steps": [
+              { "color": "red", "value": null },
+              { "color": "orange", "value": 0.7 },
+              { "color": "yellow", "value": 0.85 },
+              { "color": "green", "value": 0.95 }
+            ]
+          },
+          "min": 0,
+          "max": 1,
+          "unit": "percentunit"
+        },
+        "overrides": []
+      },
+      "options": {
+        "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false },
+        "showThresholdLabels": false,
+        "showThresholdMarkers": true,
+        "orientation": "auto"
+      },
+      "targets": [
+        {
+          "expr": "histogram_quantile(0.5, sum(rate(aip_window_integrity_ratio_bucket{agent_id=~\"$agent_id\"}[5m])) by (le))",
+          "legendFormat": "Median integrity ratio",
+          "refId": "A"
+        }
+      ]
+    },
+    {
+      "title": "Concerns & Analysis",
+      "type": "row",
+      "gridPos": { "h": 1, "w": 24, "x": 0, "y": 9 },
+      "collapsed": false,
+      "panels": []
+    },
+    {
+      "title": "Concerns by Category",
+      "type": "barchart",
+      "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+      "gridPos": { "h": 8, "w": 8, "x": 0, "y": 10 },
+      "fieldConfig": {
+        "defaults": {
+          "color": { "mode": "palette-classic" },
+          "custom": {
+            "axisBorderShow": false,
+            "axisCenteredZero": false,
+            "fillOpacity": 80,
+            "gradientMode": "none",
+            "lineWidth": 1
+          }
+        },
+        "overrides": []
+      },
+      "options": {
+        "barWidth": 0.7,
+        "groupWidth": 0.7,
+        "legend": { "displayMode": "list", "placement": "bottom" },
+        "orientation": "horizontal",
+        "tooltip": { "mode": "single" },
+        "xTickLabelRotation": 0,
+        "stacking": "none"
+      },
+      "targets": [
+        {
+          "expr": "sum by (category) (increase(aip_concerns_total{agent_id=~\"$agent_id\"}[$time_range]))",
+          "legendFormat": "{{category}}",
+          "refId": "A"
+        }
+      ]
+    },
+    {
+      "title": "Concerns by Severity",
+      "type": "barchart",
+      "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+      "gridPos": { "h": 8, "w": 8, "x": 8, "y": 10 },
+      "fieldConfig": {
+        "defaults": {
+          "color": { "mode": "palette-classic" },
+          "custom": {
+            "axisBorderShow": false,
+            "axisCenteredZero": false,
+            "fillOpacity": 80,
+            "gradientMode": "none",
+            "lineWidth": 1
+          }
+        },
+        "overrides": [
+          {
+            "matcher": { "id": "byName", "options": "critical" },
+            "properties": [{ "id": "color", "value": { "fixedColor": "red", "mode": "fixed" } }]
+          },
+          {
+            "matcher": { "id": "byName", "options": "high" },
+            "properties": [{ "id": "color", "value": { "fixedColor": "orange", "mode": "fixed" } }]
+          },
+          {
+            "matcher": { "id": "byName", "options": "medium" },
+            "properties": [{ "id": "color", "value": { "fixedColor": "yellow", "mode": "fixed" } }]
+          },
+          {
+            "matcher": { "id": "byName", "options": "low" },
+            "properties": [{ "id": "color", "value": { "fixedColor": "blue", "mode": "fixed" } }]
+          }
+        ]
+      },
+      "options": {
+        "barWidth": 0.7,
+        "groupWidth": 0.7,
+        "legend": { "displayMode": "list", "placement": "bottom" },
+        "orientation": "horizontal",
+        "tooltip": { "mode": "single" },
+        "xTickLabelRotation": 0,
+        "stacking": "none"
+      },
+      "targets": [
+        {
+          "expr": "sum by (severity) (increase(aip_concerns_total{agent_id=~\"$agent_id\"}[$time_range]))",
+          "legendFormat": "{{severity}}",
+          "refId": "A"
+        }
+      ]
+    },
+    {
+      "title": "Analysis Duration Distribution",
+      "type": "histogram",
+      "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+      "gridPos": { "h": 8, "w": 8, "x": 16, "y": 10 },
+      "fieldConfig": {
+        "defaults": {
+          "color": { "mode": "palette-classic" },
+          "custom": {
+            "fillOpacity": 80,
+            "gradientMode": "scheme",
+            "lineWidth": 1
+          },
+          "unit": "ms"
+        },
+        "overrides": []
+      },
+      "options": {
+        "bucketOffset": 0,
+        "combine": false,
+        "fillOpacity": 80,
+        "gradientMode": "scheme",
+        "legend": { "displayMode": "list", "placement": "bottom" },
+        "tooltip": { "mode": "single" }
+      },
+      "targets": [
+        {
+          "expr": "sum(rate(aip_analysis_duration_ms_bucket{agent_id=~\"$agent_id\"}[5m])) by (le)",
+          "legendFormat": "Analysis duration",
+          "refId": "A",
+          "format": "heatmap"
+        }
+      ]
+    },
+    {
+      "title": "AAP Verification",
+      "type": "row",
+      "gridPos": { "h": 1, "w": 24, "x": 0, "y": 18 },
+      "collapsed": false,
+      "panels": []
+    },
+    {
+      "title": "AAP Verification Pass Rate",
+      "type": "stat",
+      "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+      "gridPos": { "h": 8, "w": 8, "x": 0, "y": 19 },
+      "fieldConfig": {
+        "defaults": {
+          "color": { "mode": "thresholds" },
+          "thresholds": {
+            "mode": "absolute",
+            "steps": [
+              { "color": "red", "value": null },
+              { "color": "orange", "value": 0.7 },
+              { "color": "yellow", "value": 0.9 },
+              { "color": "green", "value": 0.98 }
+            ]
+          },
+          "unit": "percentunit",
+          "min": 0,
+          "max": 1
+        },
+        "overrides": []
+      },
+      "options": {
+        "colorMode": "background",
+        "graphMode": "area",
+        "justifyMode": "auto",
+        "orientation": "auto",
+        "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false },
+        "textMode": "auto"
+      },
+      "targets": [
+        {
+          "expr": "sum(increase(aap_verifications_total{verified=\"true\"}[$time_range])) / sum(increase(aap_verifications_total[$time_range]))",
+          "legendFormat": "Pass rate",
+          "refId": "A"
+        }
+      ]
+    },
+    {
+      "title": "Violations by Type",
+      "type": "barchart",
+      "datasource": { "type": "prometheus", "uid": "${DS_PROMETHEUS}" },
+      "gridPos": { "h": 8, "w": 16, "x": 8, "y": 19 },
+      "fieldConfig": {
+        "defaults": {
+          "color": { "mode": "palette-classic" },
+          "custom": {
+            "axisBorderShow": false,
+            "axisCenteredZero": false,
+            "fillOpacity": 80,
+            "gradientMode": "none",
+            "lineWidth": 1
+          }
+        },
+        "overrides": []
+      },
+      "options": {
+        "barWidth": 0.7,
+        "groupWidth": 0.7,
+        "legend": { "displayMode": "list", "placement": "bottom" },
+        "orientation": "vertical",
+        "tooltip": { "mode": "multi", "sort": "desc" },
+        "xTickLabelRotation": -45,
+        "stacking": "normal"
+      },
+      "targets": [
+        {
+          "expr": "sum by (type, severity) (increase(aap_violations_total[$time_range]))",
+          "legendFormat": "{{type}} ({{severity}})",
+          "refId": "A"
+        }
+      ]
+    }
+  ]
+}

package/dist/attributes.d.ts

@@ -0,0 +1,70 @@
+/**
+ * OpenTelemetry attribute name constants for AIP and AAP spans.
+ *
+ * Primary namespace: aip.* and aap.* (vendor-specific).
+ * Forward-compat aliases: gen_ai.evaluation.* for future OTel GenAI SIG alignment.
+ */
+export declare const AIP_INTEGRITY_CHECKPOINT_ID = "aip.integrity.checkpoint_id";
+export declare const AIP_INTEGRITY_VERDICT = "aip.integrity.verdict";
+export declare const AIP_INTEGRITY_PROCEED = "aip.integrity.proceed";
+export declare const AIP_INTEGRITY_RECOMMENDED_ACTION = "aip.integrity.recommended_action";
+export declare const AIP_INTEGRITY_CONCERNS_COUNT = "aip.integrity.concerns_count";
+export declare const AIP_INTEGRITY_AGENT_ID = "aip.integrity.agent_id";
+export declare const AIP_INTEGRITY_CARD_ID = "aip.integrity.card_id";
+export declare const AIP_INTEGRITY_SESSION_ID = "aip.integrity.session_id";
+export declare const AIP_INTEGRITY_THINKING_HASH = "aip.integrity.thinking_hash";
+export declare const AIP_INTEGRITY_ANALYSIS_MODEL = "aip.integrity.analysis_model";
+export declare const AIP_INTEGRITY_ANALYSIS_DURATION_MS = "aip.integrity.analysis_duration_ms";
+export declare const AIP_INTEGRITY_THINKING_TOKENS = "aip.integrity.thinking_tokens";
+export declare const AIP_INTEGRITY_TRUNCATED = "aip.integrity.truncated";
+export declare const AIP_INTEGRITY_EXTRACTION_CONFIDENCE = "aip.integrity.extraction_confidence";
+export declare const AIP_CONSCIENCE_CONSULTATION_DEPTH = "aip.conscience.consultation_depth";
+export declare const AIP_CONSCIENCE_VALUES_CHECKED_COUNT = "aip.conscience.values_checked_count";
+export declare const AIP_CONSCIENCE_CONFLICTS_COUNT = "aip.conscience.conflicts_count";
+export declare const AIP_WINDOW_SIZE = "aip.window.size";
+export declare const AIP_WINDOW_INTEGRITY_RATIO = "aip.window.integrity_ratio";
+export declare const AIP_WINDOW_DRIFT_ALERT_ACTIVE = "aip.window.drift_alert_active";
+export declare const GEN_AI_EVALUATION_VERDICT = "gen_ai.evaluation.verdict";
+export declare const GEN_AI_EVALUATION_SCORE = "gen_ai.evaluation.score";
+export declare const AAP_VERIFICATION_RESULT = "aap.verification.result";
+export declare const AAP_VERIFICATION_SIMILARITY_SCORE = "aap.verification.similarity_score";
+export declare const AAP_VERIFICATION_VIOLATIONS_COUNT = "aap.verification.violations_count";
+export declare const AAP_VERIFICATION_WARNINGS_COUNT = "aap.verification.warnings_count";
+export declare const AAP_VERIFICATION_TRACE_ID = "aap.verification.trace_id";
+export declare const AAP_VERIFICATION_CARD_ID = "aap.verification.card_id";
+export declare const AAP_VERIFICATION_DURATION_MS = "aap.verification.duration_ms";
+export declare const AAP_VERIFICATION_CHECKS_PERFORMED = "aap.verification.checks_performed";
+export declare const AAP_COHERENCE_COMPATIBLE = "aap.coherence.compatible";
+export declare const AAP_COHERENCE_SCORE = "aap.coherence.score";
+export declare const AAP_COHERENCE_PROCEED = "aap.coherence.proceed";
+export declare const AAP_COHERENCE_MATCHED_COUNT = "aap.coherence.matched_count";
+export declare const AAP_COHERENCE_CONFLICT_COUNT = "aap.coherence.conflict_count";
+export declare const AAP_DRIFT_ALERTS_COUNT = "aap.drift.alerts_count";
+export declare const AAP_DRIFT_TRACES_ANALYZED = "aap.drift.traces_analyzed";
+export declare const AIP_DRIFT_ALERT_ID = "aip.drift.alert_id";
+export declare const AIP_DRIFT_AGENT_ID = "aip.drift.agent_id";
+export declare const AIP_DRIFT_SESSION_ID = "aip.drift.session_id";
+export declare const AIP_DRIFT_INTEGRITY_SIMILARITY = "aip.drift.integrity_similarity";
+export declare const AIP_DRIFT_SUSTAINED_CHECKS = "aip.drift.sustained_checks";
+export declare const AIP_DRIFT_SEVERITY = "aip.drift.severity";
+export declare const AIP_DRIFT_DIRECTION = "aip.drift.drift_direction";
+export declare const AIP_DRIFT_MESSAGE = "aip.drift.message";
+export declare const SPAN_AIP_INTEGRITY_CHECK = "aip.integrity_check";
+export declare const SPAN_AAP_VERIFY_TRACE = "aap.verify_trace";
+export declare const SPAN_AAP_CHECK_COHERENCE = "aap.check_coherence";
+export declare const SPAN_AAP_DETECT_DRIFT = "aap.detect_drift";
+export declare const EVENT_AIP_CONCERN = "aip.concern";
+export declare const EVENT_AIP_DRIFT_ALERT = "aip.drift_alert";
+export declare const EVENT_AAP_VIOLATION = "aap.violation";
+export declare const EVENT_AAP_DRIFT_ALERT = "aap.drift_alert";
+export declare const METRIC_AIP_INTEGRITY_CHECKS_TOTAL = "aip.integrity_checks.total";
+export declare const METRIC_AIP_INTEGRITY_CHECKS_BY_VERDICT = "aip.integrity_checks.by_verdict";
+export declare const METRIC_AIP_CONCERNS_TOTAL = "aip.concerns.total";
+export declare const METRIC_AIP_ANALYSIS_DURATION = "aip.analysis.duration_ms";
+export declare const METRIC_AIP_WINDOW_INTEGRITY_RATIO = "aip.window.integrity_ratio";
+export declare const METRIC_AIP_DRIFT_ALERTS_TOTAL = "aip.drift_alerts.total";
+export declare const METRIC_AAP_VERIFICATIONS_TOTAL = "aap.verifications.total";
+export declare const METRIC_AAP_VIOLATIONS_TOTAL = "aap.violations.total";
+export declare const METRIC_AAP_VERIFICATION_DURATION = "aap.verification.duration_ms";
+export declare const METRIC_AAP_COHERENCE_SCORE = "aap.coherence.score";
+//# sourceMappingURL=attributes.d.ts.map

package/dist/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../src/attributes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AACzE,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,gCAAgC,qCACT,CAAC;AACrC,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAC3E,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AACzE,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAC3E,eAAO,MAAM,kCAAkC,uCACT,CAAC;AACvC,eAAO,MAAM,6BAA6B,kCAAkC,CAAC;AAC7E,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AACjE,eAAO,MAAM,mCAAmC,wCACT,CAAC;AAIxC,eAAO,MAAM,iCAAiC,sCACT,CAAC;AACtC,eAAO,MAAM,mCAAmC,wCACT,CAAC;AACxC,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAI/E,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,6BAA6B,kCAAkC,CAAC;AAI7E,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AAIjE,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AACjE,eAAO,MAAM,iCAAiC,sCACT,CAAC;AACtC,eAAO,MAAM,iCAAiC,sCACT,CAAC;AACtC,eAAO,MAAM,+BAA+B,oCACT,CAAC;AACpC,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAC3E,eAAO,MAAM,iCAAiC,sCACT,CAAC;AAItC,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AACzD,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AACzE,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAI3E,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAIrE,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,8BAA8B,mCACT,CAAC;AACnC,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAC/D,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAIrD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAIxD,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AACnD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAIvD,eAAO,MAAM,iCAAiC,+BAChB,CAAC;AAC/B,eAAO,MAAM,sCAAsC,oCAChB,CAAC;AACpC,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAC9D,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AACvE,eAAO,MAAM,iCAAiC,+BAChB,CAAC;AAC/B,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AACtE,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AACxE,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,gCAAgC,iCACb,CAAC;AACjC,eAAO,MAAM,0BAA0B,wBAAwB,CAAC"}

package/dist/attributes.js

@@ -0,0 +1,81 @@
+/**
+ * OpenTelemetry attribute name constants for AIP and AAP spans.
+ *
+ * Primary namespace: aip.* and aap.* (vendor-specific).
+ * Forward-compat aliases: gen_ai.evaluation.* for future OTel GenAI SIG alignment.
+ */
+// --- AIP Integrity Check Attributes ---
+export const AIP_INTEGRITY_CHECKPOINT_ID = "aip.integrity.checkpoint_id";
+export const AIP_INTEGRITY_VERDICT = "aip.integrity.verdict";
+export const AIP_INTEGRITY_PROCEED = "aip.integrity.proceed";
+export const AIP_INTEGRITY_RECOMMENDED_ACTION = "aip.integrity.recommended_action";
+export const AIP_INTEGRITY_CONCERNS_COUNT = "aip.integrity.concerns_count";
+export const AIP_INTEGRITY_AGENT_ID = "aip.integrity.agent_id";
+export const AIP_INTEGRITY_CARD_ID = "aip.integrity.card_id";
+export const AIP_INTEGRITY_SESSION_ID = "aip.integrity.session_id";
+export const AIP_INTEGRITY_THINKING_HASH = "aip.integrity.thinking_hash";
+export const AIP_INTEGRITY_ANALYSIS_MODEL = "aip.integrity.analysis_model";
+export const AIP_INTEGRITY_ANALYSIS_DURATION_MS = "aip.integrity.analysis_duration_ms";
+export const AIP_INTEGRITY_THINKING_TOKENS = "aip.integrity.thinking_tokens";
+export const AIP_INTEGRITY_TRUNCATED = "aip.integrity.truncated";
+export const AIP_INTEGRITY_EXTRACTION_CONFIDENCE = "aip.integrity.extraction_confidence";
+// --- AIP Conscience Attributes ---
+export const AIP_CONSCIENCE_CONSULTATION_DEPTH = "aip.conscience.consultation_depth";
+export const AIP_CONSCIENCE_VALUES_CHECKED_COUNT = "aip.conscience.values_checked_count";
+export const AIP_CONSCIENCE_CONFLICTS_COUNT = "aip.conscience.conflicts_count";
+// --- AIP Window Attributes ---
+export const AIP_WINDOW_SIZE = "aip.window.size";
+export const AIP_WINDOW_INTEGRITY_RATIO = "aip.window.integrity_ratio";
+export const AIP_WINDOW_DRIFT_ALERT_ACTIVE = "aip.window.drift_alert_active";
+// --- GenAI SIG Forward-Compat Aliases ---
+export const GEN_AI_EVALUATION_VERDICT = "gen_ai.evaluation.verdict";
+export const GEN_AI_EVALUATION_SCORE = "gen_ai.evaluation.score";
+// --- AAP Verification Attributes ---
+export const AAP_VERIFICATION_RESULT = "aap.verification.result";
+export const AAP_VERIFICATION_SIMILARITY_SCORE = "aap.verification.similarity_score";
+export const AAP_VERIFICATION_VIOLATIONS_COUNT = "aap.verification.violations_count";
+export const AAP_VERIFICATION_WARNINGS_COUNT = "aap.verification.warnings_count";
+export const AAP_VERIFICATION_TRACE_ID = "aap.verification.trace_id";
+export const AAP_VERIFICATION_CARD_ID = "aap.verification.card_id";
+export const AAP_VERIFICATION_DURATION_MS = "aap.verification.duration_ms";
+export const AAP_VERIFICATION_CHECKS_PERFORMED = "aap.verification.checks_performed";
+// --- AAP Coherence Attributes ---
+export const AAP_COHERENCE_COMPATIBLE = "aap.coherence.compatible";
+export const AAP_COHERENCE_SCORE = "aap.coherence.score";
+export const AAP_COHERENCE_PROCEED = "aap.coherence.proceed";
+export const AAP_COHERENCE_MATCHED_COUNT = "aap.coherence.matched_count";
+export const AAP_COHERENCE_CONFLICT_COUNT = "aap.coherence.conflict_count";
+// --- AAP Drift Detection Attributes ---
+export const AAP_DRIFT_ALERTS_COUNT = "aap.drift.alerts_count";
+export const AAP_DRIFT_TRACES_ANALYZED = "aap.drift.traces_analyzed";
+// --- AIP Drift Alert Attributes (for events) ---
+export const AIP_DRIFT_ALERT_ID = "aip.drift.alert_id";
+export const AIP_DRIFT_AGENT_ID = "aip.drift.agent_id";
+export const AIP_DRIFT_SESSION_ID = "aip.drift.session_id";
+export const AIP_DRIFT_INTEGRITY_SIMILARITY = "aip.drift.integrity_similarity";
+export const AIP_DRIFT_SUSTAINED_CHECKS = "aip.drift.sustained_checks";
+export const AIP_DRIFT_SEVERITY = "aip.drift.severity";
+export const AIP_DRIFT_DIRECTION = "aip.drift.drift_direction";
+export const AIP_DRIFT_MESSAGE = "aip.drift.message";
+// --- Span Names ---
+export const SPAN_AIP_INTEGRITY_CHECK = "aip.integrity_check";
+export const SPAN_AAP_VERIFY_TRACE = "aap.verify_trace";
+export const SPAN_AAP_CHECK_COHERENCE = "aap.check_coherence";
+export const SPAN_AAP_DETECT_DRIFT = "aap.detect_drift";
+// --- Event Names ---
+export const EVENT_AIP_CONCERN = "aip.concern";
+export const EVENT_AIP_DRIFT_ALERT = "aip.drift_alert";
+export const EVENT_AAP_VIOLATION = "aap.violation";
+export const EVENT_AAP_DRIFT_ALERT = "aap.drift_alert";
+// --- Metric Names ---
+export const METRIC_AIP_INTEGRITY_CHECKS_TOTAL = "aip.integrity_checks.total";
+export const METRIC_AIP_INTEGRITY_CHECKS_BY_VERDICT = "aip.integrity_checks.by_verdict";
+export const METRIC_AIP_CONCERNS_TOTAL = "aip.concerns.total";
+export const METRIC_AIP_ANALYSIS_DURATION = "aip.analysis.duration_ms";
+export const METRIC_AIP_WINDOW_INTEGRITY_RATIO = "aip.window.integrity_ratio";
+export const METRIC_AIP_DRIFT_ALERTS_TOTAL = "aip.drift_alerts.total";
+export const METRIC_AAP_VERIFICATIONS_TOTAL = "aap.verifications.total";
+export const METRIC_AAP_VIOLATIONS_TOTAL = "aap.violations.total";
+export const METRIC_AAP_VERIFICATION_DURATION = "aap.verification.duration_ms";
+export const METRIC_AAP_COHERENCE_SCORE = "aap.coherence.score";
+//# sourceMappingURL=attributes.js.map

package/dist/attributes.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * Auto-instrumentation for AAP verification functions.
+ *
+ * Wraps verifyTrace, checkCoherence, and detectDrift exports to
+ * automatically record OTel spans. Node.js only.
+ */
+import { type Tracer } from "@opentelemetry/api";
+/**
+ * Instrument AAP verification functions to auto-record spans.
+ *
+ * Attempts to require `@mnemom/agent-alignment-protocol` and wrap:
+ * - verifyTrace → recordVerification
+ * - checkCoherence → recordCoherence
+ * - detectDrift → recordDrift
+ */
+export declare function instrumentAAP(options?: {
+    tracerProvider?: {
+        getTracer: (name: string, version?: string) => Tracer;
+    };
+}): void;
+/** Remove AAP instrumentation, restoring original functions. */
+export declare function uninstrumentAAP(): void;
+//# sourceMappingURL=aap-instrumentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aap-instrumentation.d.ts","sourceRoot":"","sources":["../../src/auto/aap-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAS,MAAM,oBAAoB,CAAC;AAuDxD;;;;;;;GAOG;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,CAyDP;AAED,gEAAgE;AAChE,wBAAgB,eAAe,IAAI,IAAI,CAkBtC"}