@adjudicate/observability 0.1.0

package/dist/semconv.js

@@ -0,0 +1,74 @@
+/**
+ * Semantic conventions for adjudicate's OTLP attribute names.
+ *
+ * The names are namespaced under `adjudicate.*` so they don't collide with
+ * upstream OpenTelemetry semconv (`http.*`, `db.*`, …) or with adopter-defined
+ * attributes. We commit to keeping these names stable across minor versions —
+ * dashboards, alerts, and SIEM rules built on top of them MUST NOT break when
+ * `@adjudicate/observability` bumps its minor.
+ *
+ * If a new attribute is needed, ADD a new key here; do NOT rename existing
+ * ones. Removal is a breaking change and goes through the deprecation
+ * calendar (see `docs/release/deprecations.md`).
+ */
+export const SEMCONV = {
+    /** Envelope kind — e.g. "vacation.request", "pix.charge.refund". */
+    INTENT_KIND: "adjudicate.intent.kind",
+    /** Decision.kind — one of EXECUTE/REFUSE/ESCALATE/REQUEST_CONFIRMATION/REWRITE/DEFER. */
+    DECISION_KIND: "adjudicate.decision.kind",
+    /** Taint level on the originating envelope — UNTRUSTED | TRUSTED | SYSTEM. */
+    TAINT: "adjudicate.taint",
+    /** Adopter-supplied policy bundle version (e.g. semver of the Pack). */
+    POLICY_VERSION: "adjudicate.policy.version",
+    /** Adopter-supplied Pack identifier, when known. */
+    PACK_ID: "adjudicate.pack.id",
+    /** Wall-clock duration of the adjudication itself, in milliseconds. */
+    LATENCY_MS: "adjudicate.latency.ms",
+    /** Audit-stable intent hash — useful for cross-correlating spans with audit rows. */
+    INTENT_HASH: "adjudicate.intent.hash",
+    /** Matched-guard identifier (see ADR-105). Omitted for non-guard phases. */
+    GUARD_ID: "adjudicate.guard.id",
+    /**
+     * Source of a propagated transition (kill-switch, deferred resume, …).
+     * Low cardinality: `pubsub | poll | boot | external`. Lets dashboards
+     * separate "operator initiated trip" from "boot-time resync".
+     */
+    TRANSITION_SOURCE: "adjudicate.transition.source",
+    /**
+     * Lifecycle phase for the adapter loop. Low cardinality:
+     * `started | iteration | tool_use | decision | completed | paused`.
+     */
+    ADAPTER_PHASE: "adjudicate.adapter.phase",
+    /**
+     * Adapter iteration counter within a single `.send()` call. Bounded
+     * by `maxIterations` (default 8) — safe for low-cardinality histograms.
+     */
+    ADAPTER_ITERATION: "adjudicate.adapter.iteration",
+    /**
+     * Adapter outcome kind. Low cardinality: matches `AgentOutcome.kind`
+     * (`completed | deferred | awaiting_confirmation | escalated | max_iterations_exceeded`).
+     */
+    ADAPTER_OUTCOME: "adjudicate.adapter.outcome",
+    /**
+     * Provider identifier supplied by the bridge. Adopter-controlled
+     * vocabulary (e.g., `anthropic | openai | vercel-ai | bedrock`). Kept
+     * low-cardinality by adopter discipline; the framework does not enforce
+     * a fixed enum here because adopters add their own providers.
+     */
+    PROVIDER_ID: "adjudicate.provider.id",
+    /**
+     * Defer/confirm lifecycle phase: `parked | resumed | confirmed | declined | expired`.
+     */
+    PAUSE_PHASE: "adjudicate.pause.phase",
+    /**
+     * Defer signal vocabulary entry. Controlled by the Pack's declared
+     * `signals` list — Packs are expected to keep this list small.
+     */
+    DEFER_SIGNAL: "adjudicate.defer.signal",
+    /**
+     * Kill-switch state. Low cardinality: `active | normal`.
+     * Use {@link TRANSITION_SOURCE} alongside for the trigger.
+     */
+    KILL_SWITCH_STATE: "adjudicate.kill_switch.state",
+};
+//# sourceMappingURL=semconv.js.map

package/dist/semconv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semconv.js","sourceRoot":"","sources":["../src/semconv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,oEAAoE;IACpE,WAAW,EAAE,wBAAwB;IACrC,yFAAyF;IACzF,aAAa,EAAE,0BAA0B;IACzC,8EAA8E;IAC9E,KAAK,EAAE,kBAAkB;IACzB,wEAAwE;IACxE,cAAc,EAAE,2BAA2B;IAC3C,oDAAoD;IACpD,OAAO,EAAE,oBAAoB;IAC7B,uEAAuE;IACvE,UAAU,EAAE,uBAAuB;IACnC,qFAAqF;IACrF,WAAW,EAAE,wBAAwB;IACrC,4EAA4E;IAC5E,QAAQ,EAAE,qBAAqB;IAC/B;;;;OAIG;IACH,iBAAiB,EAAE,8BAA8B;IACjD;;;OAGG;IACH,aAAa,EAAE,0BAA0B;IACzC;;;OAGG;IACH,iBAAiB,EAAE,8BAA8B;IACjD;;;OAGG;IACH,eAAe,EAAE,4BAA4B;IAC7C;;;;;OAKG;IACH,WAAW,EAAE,wBAAwB;IACrC;;OAEG;IACH,WAAW,EAAE,wBAAwB;IACrC;;;OAGG;IACH,YAAY,EAAE,yBAAyB;IACvC;;;OAGG;IACH,iBAAiB,EAAE,8BAA8B;CACzC,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@adjudicate/observability",
+  "version": "0.1.0",
+  "description": "OTLP-native observability for @adjudicate — sinks that adapt kernel metrics, learning events, and audit records onto OpenTelemetry signals. Optional plumbing; never affects Decision outcomes.",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@adjudicate/core": "1.0.0"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0",
+    "@adjudicate/core": "1.0.0"
+  },
+  "scripts": {
+    "build": "tsc --outDir dist",
+    "lint": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}