xray-sdk 0.1.0

package/dist/storage/MemoryStorage.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStorage = void 0;
+class MemoryStorage {
+    constructor() {
+        this.executions = new Map();
+    }
+    async saveExecution(execution) {
+        this.executions.set(execution.executionId, JSON.parse(JSON.stringify(execution)));
+        console.log(`[XRay Memory] ✅ Saved execution ${execution.executionId}`);
+    }
+    async getExecutionById(executionId) {
+        const execution = this.executions.get(executionId);
+        return execution ? JSON.parse(JSON.stringify(execution)) : undefined;
+    }
+    async getAllExecutions() {
+        return Array.from(this.executions.values()).map(e => JSON.parse(JSON.stringify(e)));
+    }
+    async updateStepReasoning(executionId, stepName, reasoning) {
+        const execution = this.executions.get(executionId);
+        if (!execution) {
+            throw new Error(`Execution ${executionId} not found`);
+        }
+        const step = execution.steps.find(s => s.name === stepName);
+        if (!step) {
+            throw new Error(`Step ${stepName} not found in execution ${executionId}`);
+        }
+        step.reasoning = reasoning;
+        console.log(`[XRay Memory] ✅ Updated reasoning for ${executionId}/${stepName}`);
+    }
+    clear() {
+        this.executions.clear();
+    }
+}
+exports.MemoryStorage = MemoryStorage;

package/dist/types/index.d.ts

@@ -0,0 +1,59 @@
+export interface Execution {
+    executionId: string;
+    projectId?: string;
+    startedAt: string;
+    endedAt?: string;
+    metadata?: Record<string, any>;
+    steps: Step[];
+    finalOutcome?: any;
+}
+export interface Step {
+    name: string;
+    input?: any;
+    output?: any;
+    error?: string;
+    timestamp?: string;
+    startedAt?: string;
+    endedAt?: string;
+    durationMs?: number;
+    reasoning?: string;
+    metadata?: Record<string, any>;
+}
+export interface ReasoningJob {
+    id: string;
+    executionId: string;
+    stepName: string;
+    attempt: number;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+    nextRetryAt?: string;
+}
+export interface QueueStats {
+    pending: number;
+    processing: number;
+    completed: number;
+    failed: number;
+    totalJobs: number;
+}
+export interface XRayConfig {
+    projectId?: string;
+    storage?: StorageProvider;
+    autoReasoning?: boolean;
+    reasoningConfig?: ReasoningConfig;
+}
+export interface ReasoningConfig {
+    autoProcess: boolean;
+    concurrency: number;
+    maxRetries: number;
+    retryDelays: number[];
+    debug: boolean;
+}
+export interface StorageProvider {
+    saveExecution(execution: Execution): Promise<void>;
+    getExecutionById(executionId: string): Promise<Execution | undefined>;
+    getAllExecutions(): Promise<Execution[]>;
+    updateStepReasoning(executionId: string, stepName: string, reasoning: string): Promise<void>;
+}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+// Core types for X-Ray SDK
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "xray-sdk",
+  "version": "0.1.0",
+  "description": "Lightweight execution tracing for LLM pipelines with automatic reasoning generation",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "observability",
+    "tracing",
+    "llm",
+    "pipeline",
+    "monitoring",
+    "xray",
+    "execution-tracking"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "p-queue": "^8.0.0"
+  },
+  "peerDependencies": {
+    "@prisma/client": "^5.22.0",
+    "openai": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@prisma/client": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0"
+  }
+}