@elsium-ai/observe 0.1.6

package/dist/audit.d.ts

@@ -0,0 +1,53 @@
+import type { Middleware } from '@elsium-ai/core';
+export type AuditEventType = 'llm_call' | 'tool_execution' | 'security_violation' | 'budget_alert' | 'policy_violation' | 'auth_event' | 'approval_request' | 'approval_decision' | 'config_change';
+export interface AuditEvent {
+    id: string;
+    sequenceId: number;
+    type: AuditEventType;
+    timestamp: number;
+    actor?: string;
+    traceId?: string;
+    data: Record<string, unknown>;
+    hash: string;
+    previousHash: string;
+}
+export interface AuditStorageAdapter {
+    append(event: AuditEvent): void | Promise<void>;
+    query(filter: AuditQueryFilter): AuditEvent[] | Promise<AuditEvent[]>;
+    count(): number | Promise<number>;
+    verifyIntegrity(): AuditIntegrityResult | Promise<AuditIntegrityResult>;
+    getLastHash?(): string | Promise<string>;
+}
+export interface AuditQueryFilter {
+    type?: AuditEventType | AuditEventType[];
+    actor?: string;
+    traceId?: string;
+    fromTimestamp?: number;
+    toTimestamp?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface AuditIntegrityResult {
+    valid: boolean;
+    totalEvents: number;
+    brokenAt?: number;
+    chainComplete?: boolean;
+}
+export interface AuditTrailConfig {
+    storage?: AuditStorageAdapter | 'memory';
+    hashChain?: boolean;
+    maxEvents?: number;
+    onError?: (error: unknown) => void;
+}
+export interface AuditTrail {
+    log(type: AuditEventType, data: Record<string, unknown>, options?: {
+        actor?: string;
+        traceId?: string;
+    }): void;
+    query(filter: AuditQueryFilter): Promise<AuditEvent[]>;
+    verifyIntegrity(): Promise<AuditIntegrityResult>;
+    readonly count: number;
+}
+export declare function createAuditTrail(config?: AuditTrailConfig): AuditTrail;
+export declare function auditMiddleware(auditTrail: AuditTrail): Middleware;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAqC,MAAM,iBAAiB,CAAA;AAEpF,MAAM,MAAM,cAAc,GACvB,UAAU,GACV,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,GAClB,YAAY,GACZ,kBAAkB,GAClB,mBAAmB,GACnB,eAAe,CAAA;AAElB,MAAM,WAAW,UAAU;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,cAAc,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACrE,KAAK,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACjC,eAAe,IAAI,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACvE,WAAW,CAAC,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACxC;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAA;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,EAAE,mBAAmB,GAAG,QAAQ,CAAA;IACxC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,UAAU;IAC1B,GAAG,CACF,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,IAAI,CAAA;IACP,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACtD,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAyFD,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAuEtE;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CA0ClE"}

package/dist/cost-engine.d.ts

@@ -0,0 +1,74 @@
+import type { LLMResponse, Middleware } from '@elsium-ai/core';
+export interface BudgetConfig {
+    totalBudget?: number;
+    dailyBudget?: number;
+    perUser?: number;
+    perFeature?: number;
+    perAgent?: number;
+}
+export interface LoopDetectionConfig {
+    maxCallsPerMinute?: number;
+    maxCostPerMinute?: number;
+}
+export interface CostAlert {
+    type: 'threshold' | 'loop_detected' | 'budget_exceeded' | 'projection_warning';
+    dimension: string;
+    currentValue: number;
+    limit: number;
+    message: string;
+    timestamp: number;
+}
+export interface CostDimension {
+    totalCost: number;
+    totalTokens: number;
+    callCount: number;
+    firstCallAt: number;
+    lastCallAt: number;
+}
+export interface CostIntelligenceReport {
+    totalSpend: number;
+    totalTokens: number;
+    totalCalls: number;
+    projectedDailySpend: number;
+    projectedMonthlySpend: number;
+    byModel: Record<string, CostDimension>;
+    byAgent: Record<string, CostDimension>;
+    byUser: Record<string, CostDimension>;
+    byFeature: Record<string, CostDimension>;
+    recommendations: string[];
+    alerts: CostAlert[];
+}
+export interface ModelSuggestion {
+    currentModel: string;
+    suggestedModel: string;
+    estimatedSavings: number;
+    reason: string;
+}
+export interface CostEngineConfig {
+    totalBudget?: number;
+    dailyBudget?: number;
+    perUser?: number;
+    perFeature?: number;
+    perAgent?: number;
+    loopDetection?: LoopDetectionConfig;
+    onAlert?: (alert: CostAlert) => void;
+    alertThresholds?: number[];
+}
+export interface CostEngine {
+    middleware(): Middleware;
+    getReport(): CostIntelligenceReport;
+    suggestModel(currentModel: string, inputTokens: number): ModelSuggestion | null;
+    trackCall(response: LLMResponse, dimensions?: {
+        agent?: string;
+        user?: string;
+        feature?: string;
+    }): void;
+    reset(): void;
+}
+export interface ModelTierEntry {
+    tier: 'low' | 'mid' | 'high';
+    costPerMToken: number;
+}
+export declare function registerModelTier(model: string, entry: ModelTierEntry): void;
+export declare function createCostEngine(config?: CostEngineConfig): CostEngine;
+//# sourceMappingURL=cost-engine.d.ts.map

package/dist/cost-engine.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { createSpan } from './span';
+export type { Span, SpanData, SpanEvent, SpanKind, SpanStatus, SpanHandler } from './span';
+export { createCostEngine, registerModelTier } from './cost-engine';
+export type { CostEngine, CostEngineConfig, BudgetConfig, LoopDetectionConfig, CostAlert, CostDimension, CostIntelligenceReport, ModelSuggestion, ModelTierEntry, } from './cost-engine';
+export { observe } from './tracer';
+export type { Tracer, TracerConfig, TracerOutput, TracerExporter, CostReport } from './tracer';
+export { createMetrics } from './metrics';
+export type { MetricsCollector, MetricEntry } from './metrics';
+export { createAuditTrail, auditMiddleware } from './audit';
+export type { AuditEventType, AuditEvent, AuditStorageAdapter, AuditQueryFilter, AuditIntegrityResult, AuditTrailConfig, AuditTrail, } from './audit';
+export { createProvenanceTracker } from './provenance';
+export type { ProvenanceRecord, ProvenanceTracker } from './provenance';
+export { toOTelSpan, toOTelExportRequest, toTraceparent, parseTraceparent, injectTraceContext, extractTraceContext, createOTLPExporter, } from './otel';
+export type { OTelSpan, OTelSpanKind, OTelStatusCode, OTelAttribute, OTelAttributeValue, OTelEvent, OTelResource, OTelExportRequest, TraceContext, OTLPExporterConfig, } from './otel';
+//# 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":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAG1F,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACnE,YAAY,EACX,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,cAAc,GACd,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAClC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG9F,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAG9D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC3D,YAAY,EACX,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,GACV,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACtD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGvE,OAAO,EACN,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GAClB,MAAM,QAAQ,CAAA;AACf,YAAY,EACX,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GAClB,MAAM,QAAQ,CAAA"}