@elsium-ai/observe 0.1.6 → 0.2.0

package/README.md

@@ -0,0 +1,47 @@
+# @elsium-ai/observe
+
+Observability, tracing, cost tracking, and audit trail for [ElsiumAI](https://github.com/elsium-ai/elsium-ai).
+
+[![npm](https://img.shields.io/npm/v/@elsium-ai/observe.svg)](https://www.npmjs.com/package/@elsium-ai/observe)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/elsium-ai/elsium-ai/blob/main/LICENSE)
+
+## Install
+
+```bash
+npm install @elsium-ai/observe @elsium-ai/core
+```
+
+## What's Inside
+
+- **Tracing** — Span-based tracing with nested context propagation
+- **Cost Intelligence** — Budget tracking, projections, and loop detection
+- **Audit Trail** — SHA-256 hash-chained events with tamper-proof integrity verification
+- **Provenance Tracking** — Full lineage per traceId: prompt, model, config, input, output
+- **Audit Middleware** — Drop-in middleware for automatic event recording
+
+## Usage
+
+```typescript
+import { createAuditTrail, auditMiddleware, createProvenanceTracker, observe } from '@elsium-ai/observe'
+
+// Hash-chained audit trail
+const audit = createAuditTrail({ hashChain: true })
+
+// Provenance tracking
+const provenance = createProvenanceTracker()
+provenance.record({ prompt, model, config, input, output, traceId })
+
+// Tracing
+const tracer = observe({ output: [], samplingRate: 1.0 })
+const span = tracer.startSpan('request', 'llm-call')
+// ... do work ...
+span.end()
+```
+
+## Part of ElsiumAI
+
+This package is the observability layer of the [ElsiumAI](https://github.com/elsium-ai/elsium-ai) framework. See the [full documentation](https://github.com/elsium-ai/elsium-ai) for guides and examples.
+
+## License
+
+[MIT](https://github.com/elsium-ai/elsium-ai/blob/main/LICENSE)

package/dist/index.js

@@ -1,4 +1,3 @@
-// @bun
 // ../core/src/errors.ts
 class ElsiumError extends Error {
   code;
@@ -89,7 +88,7 @@ class ElsiumError extends Error {
   }
 }
 // ../core/src/utils.ts
-import { randomBytes } from "crypto";
+import { randomBytes } from "node:crypto";
 function cryptoHex(bytes) {
   return randomBytes(bytes).toString("hex");
 }
@@ -675,7 +674,7 @@ function createMetrics(options) {
   };
 }
 // src/audit.ts
-import { createHash } from "crypto";
+import { createHash } from "node:crypto";
 function computeEventHash(event, previousHash) {
   const content = JSON.stringify({
     id: event.id,
@@ -836,7 +835,7 @@ function auditMiddleware(auditTrail) {
   };
 }
 // src/provenance.ts
-import { createHash as createHash2 } from "crypto";
+import { createHash as createHash2 } from "node:crypto";
 function sha256(input) {
   return createHash2("sha256").update(input).digest("hex");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elsium-ai/observe",
-	"version": "0.1.6",
+	"version": "0.2.0",
 	"description": "Observability, tracing, and cost tracking for ElsiumAI",
 	"license": "MIT",
 	"author": "Eric Utrera <ebutrera9103@gmail.com>",
@@ -22,14 +22,13 @@
 		"dist"
 	],
 	"scripts": {
-		"build": "bun build ./src/index.ts --outdir ./dist --target bun && bun x tsc -p tsconfig.build.json --emitDeclarationOnly",
+		"build": "bun build ./src/index.ts --outdir ./dist --target node && bun x tsc -p tsconfig.build.json --emitDeclarationOnly",
 		"dev": "bun --watch src/index.ts"
 	},
 	"dependencies": {
 		"@elsium-ai/core": "workspace:*"
 	},
 	"devDependencies": {
-		"bun-types": "^1.3.0",
 		"typescript": "^5.7.0"
 	}
 }