@contractspec/lib.observability 3.3.0 → 3.4.1

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @contractspec/lib.observability
 
+## 3.4.1
+
+### Patch Changes
+
+- 8f47829: fix: circular import issue
+- Updated dependencies [8f47829]
+  - @contractspec/lib.contracts-integrations@3.4.1
+  - @contractspec/lib.contracts-spec@3.4.1
+  - @contractspec/lib.lifecycle@3.4.1
+
+## 3.4.0
+
+### Minor Changes
+
+- 0ee467a: feat: improve ai and customization
+
+### Patch Changes
+
+- Updated dependencies [0ee467a]
+- Updated dependencies [56ee8e6]
+  - @contractspec/lib.contracts-integrations@3.4.0
+  - @contractspec/lib.contracts-spec@3.4.0
+  - @contractspec/lib.lifecycle@3.4.0
+
 ## 3.3.0
 
 ### Minor Changes

package/dist/index.js

@@ -148,7 +148,7 @@ class RootCauseAnalyzer {
   }
 }
 
-// src/tracing/index.ts
+// src/tracing/core.ts
 import {
   SpanStatusCode,
   trace
@@ -217,7 +217,6 @@ async function traceModelSelection(fn, input) {
     return result;
   });
 }
-
 // src/telemetry/model-selection-telemetry.ts
 class ModelSelectionTelemetry {
   provider;

package/dist/node/index.js

@@ -147,7 +147,7 @@ class RootCauseAnalyzer {
   }
 }
 
-// src/tracing/index.ts
+// src/tracing/core.ts
 import {
   SpanStatusCode,
   trace
@@ -216,7 +216,6 @@ async function traceModelSelection(fn, input) {
     return result;
   });
 }
-
 // src/telemetry/model-selection-telemetry.ts
 class ModelSelectionTelemetry {
   provider;

package/dist/node/tracing/core.js

@@ -0,0 +1,52 @@
+// src/tracing/core.ts
+import {
+  SpanStatusCode,
+  trace
+} from "@opentelemetry/api";
+var DEFAULT_TRACER_NAME = "@contractspec/lib.observability";
+function getTracer(name = DEFAULT_TRACER_NAME) {
+  return trace.getTracer(name);
+}
+async function traceAsync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, async (span) => {
+    try {
+      const result = await fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+function traceSync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, (span) => {
+    try {
+      const result = fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+export {
+  traceSync,
+  traceAsync,
+  getTracer
+};

package/dist/node/tracing/index.js

@@ -0,0 +1,75 @@
+// src/tracing/core.ts
+import {
+  SpanStatusCode,
+  trace
+} from "@opentelemetry/api";
+var DEFAULT_TRACER_NAME = "@contractspec/lib.observability";
+function getTracer(name = DEFAULT_TRACER_NAME) {
+  return trace.getTracer(name);
+}
+async function traceAsync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, async (span) => {
+    try {
+      const result = await fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+function traceSync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, (span) => {
+    try {
+      const result = fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+
+// src/tracing/model-selection.span.ts
+async function traceModelSelection(fn, input) {
+  const startMs = performance.now();
+  return traceAsync("model.selection", async (span) => {
+    const result = await fn();
+    const durationMs = performance.now() - startMs;
+    span.setAttribute("model.selected", input.modelId);
+    span.setAttribute("model.provider", input.providerKey);
+    span.setAttribute("model.score", input.score);
+    span.setAttribute("model.alternatives_count", input.alternativesCount);
+    span.setAttribute("model.selection_duration_ms", durationMs);
+    span.setAttribute("model.reason", input.reason);
+    if (input.dimension) {
+      span.setAttribute("model.dimension", input.dimension);
+    }
+    if (input.constraints) {
+      span.setAttribute("model.constraints", JSON.stringify(input.constraints));
+    }
+    return result;
+  });
+}
+export {
+  traceSync,
+  traceModelSelection,
+  traceAsync,
+  getTracer
+};

package/dist/node/tracing/middleware.js

@@ -1,4 +1,4 @@
-// src/tracing/index.ts
+// src/tracing/core.ts
 import {
   SpanStatusCode,
   trace
@@ -67,7 +67,6 @@ async function traceModelSelection(fn, input) {
     return result;
   });
 }
-
 // src/metrics/index.ts
 import {
   metrics

package/dist/node/tracing/model-selection.span.js

@@ -1,4 +1,4 @@
-// src/tracing/index.ts
+// src/tracing/core.ts
 import {
   SpanStatusCode,
   trace

package/dist/tracing/core.d.ts

@@ -0,0 +1,4 @@
+import { type Span, type Tracer } from '@opentelemetry/api';
+export declare function getTracer(name?: string): Tracer;
+export declare function traceAsync<T>(name: string, fn: (span: Span) => Promise<T>, tracerName?: string): Promise<T>;
+export declare function traceSync<T>(name: string, fn: (span: Span) => T, tracerName?: string): T;

package/dist/tracing/core.js

@@ -0,0 +1,53 @@
+// @bun
+// src/tracing/core.ts
+import {
+  SpanStatusCode,
+  trace
+} from "@opentelemetry/api";
+var DEFAULT_TRACER_NAME = "@contractspec/lib.observability";
+function getTracer(name = DEFAULT_TRACER_NAME) {
+  return trace.getTracer(name);
+}
+async function traceAsync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, async (span) => {
+    try {
+      const result = await fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+function traceSync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, (span) => {
+    try {
+      const result = fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+export {
+  traceSync,
+  traceAsync,
+  getTracer
+};

package/dist/tracing/index.d.ts

@@ -1,5 +1,2 @@
-import { type Span, type Tracer } from '@opentelemetry/api';
+export { getTracer, traceAsync, traceSync } from './core';
 export * from './model-selection.span';
-export declare function getTracer(name?: string): Tracer;
-export declare function traceAsync<T>(name: string, fn: (span: Span) => Promise<T>, tracerName?: string): Promise<T>;
-export declare function traceSync<T>(name: string, fn: (span: Span) => T, tracerName?: string): T;

package/dist/tracing/index.js

@@ -0,0 +1,76 @@
+// @bun
+// src/tracing/core.ts
+import {
+  SpanStatusCode,
+  trace
+} from "@opentelemetry/api";
+var DEFAULT_TRACER_NAME = "@contractspec/lib.observability";
+function getTracer(name = DEFAULT_TRACER_NAME) {
+  return trace.getTracer(name);
+}
+async function traceAsync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, async (span) => {
+    try {
+      const result = await fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+function traceSync(name, fn, tracerName) {
+  const tracer = getTracer(tracerName);
+  return tracer.startActiveSpan(name, (span) => {
+    try {
+      const result = fn(span);
+      span.setStatus({ code: SpanStatusCode.OK });
+      return result;
+    } catch (error) {
+      span.recordException(error);
+      span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: error instanceof Error ? error.message : String(error)
+      });
+      throw error;
+    } finally {
+      span.end();
+    }
+  });
+}
+
+// src/tracing/model-selection.span.ts
+async function traceModelSelection(fn, input) {
+  const startMs = performance.now();
+  return traceAsync("model.selection", async (span) => {
+    const result = await fn();
+    const durationMs = performance.now() - startMs;
+    span.setAttribute("model.selected", input.modelId);
+    span.setAttribute("model.provider", input.providerKey);
+    span.setAttribute("model.score", input.score);
+    span.setAttribute("model.alternatives_count", input.alternativesCount);
+    span.setAttribute("model.selection_duration_ms", durationMs);
+    span.setAttribute("model.reason", input.reason);
+    if (input.dimension) {
+      span.setAttribute("model.dimension", input.dimension);
+    }
+    if (input.constraints) {
+      span.setAttribute("model.constraints", JSON.stringify(input.constraints));
+    }
+    return result;
+  });
+}
+export {
+  traceSync,
+  traceModelSelection,
+  traceAsync,
+  getTracer
+};

package/dist/tracing/middleware.js

@@ -1,5 +1,5 @@
 // @bun
-// src/tracing/index.ts
+// src/tracing/core.ts
 import {
   SpanStatusCode,
   trace
@@ -68,7 +68,6 @@ async function traceModelSelection(fn, input) {
     return result;
   });
 }
-
 // src/metrics/index.ts
 import {
   metrics

package/dist/tracing/model-selection.span.js

@@ -1,5 +1,5 @@
 // @bun
-// src/tracing/index.ts
+// src/tracing/core.ts
 import {
   SpanStatusCode,
   trace

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.observability",
-  "version": "3.3.0",
+  "version": "3.4.1",
   "description": "OpenTelemetry-based observability primitives",
   "keywords": [
     "contractspec",
@@ -27,17 +27,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.lifecycle": "3.3.0",
-    "@contractspec/lib.contracts-spec": "3.3.0",
-    "@contractspec/lib.contracts-integrations": "3.3.0"
+    "@contractspec/lib.lifecycle": "3.4.1",
+    "@contractspec/lib.contracts-spec": "3.4.1",
+    "@contractspec/lib.contracts-integrations": "3.4.1"
   },
   "peerDependencies": {
     "@opentelemetry/api": "*"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.3.0",
+    "@contractspec/tool.typescript": "3.4.1",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.3.0"
+    "@contractspec/tool.bun": "3.4.1"
   },
   "exports": {
     ".": {
@@ -142,6 +142,12 @@
       "node": "./dist/node/tracing/index.js",
       "default": "./dist/tracing/index.js"
     },
+    "./tracing/core": {
+      "types": "./dist/tracing/core.d.ts",
+      "bun": "./dist/tracing/core.js",
+      "node": "./dist/node/tracing/core.js",
+      "default": "./dist/tracing/core.js"
+    },
     "./tracing/index": {
       "types": "./dist/tracing/index.d.ts",
       "bun": "./dist/tracing/index.js",
@@ -266,6 +272,12 @@
         "node": "./dist/node/tracing/index.js",
         "default": "./dist/tracing/index.js"
       },
+      "./tracing/core": {
+        "types": "./dist/tracing/core.d.ts",
+        "bun": "./dist/tracing/core.js",
+        "node": "./dist/node/tracing/core.js",
+        "default": "./dist/tracing/core.js"
+      },
       "./tracing/index": {
         "types": "./dist/tracing/index.d.ts",
         "bun": "./dist/tracing/index.js",