mojentic 1.0.0

package/dist/tracer/tracerSystem.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * TracerSystem module for coordinating tracer events.
+ *
+ * This provides a central system for recording, filtering, and querying tracer events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracerSystem = void 0;
+const eventStore_1 = require("./eventStore");
+const tracerEvents_1 = require("./tracerEvents");
+/**
+ * Central system for capturing and querying tracer events.
+ *
+ * The TracerSystem is responsible for recording events related to LLM calls,
+ * tool usage, and agent interactions, providing a way to trace through the
+ * major events of the system.
+ *
+ * @example
+ * ```typescript
+ * const tracer = new TracerSystem();
+ *
+ * tracer.recordLlmCall('gpt-4', [Message.user('Hello')], 0.7, undefined, 'corr-123');
+ * tracer.recordLlmResponse('gpt-4', 'Hi there!', undefined, 150, 'corr-123');
+ *
+ * const events = tracer.getEvents();
+ * console.log(`Recorded ${events.length} events`);
+ * ```
+ */
+class TracerSystem {
+    eventStore;
+    _enabled;
+    /**
+     * Initialize the tracer system.
+     *
+     * @param eventStore - The event store to use for storing events. If not provided, a new EventStore will be created.
+     * @param enabled - Whether the tracer system is enabled. If false, no events will be recorded.
+     */
+    constructor(eventStore, enabled = true) {
+        this.eventStore = eventStore || new eventStore_1.EventStore();
+        this._enabled = enabled;
+    }
+    /**
+     * Get whether the tracer system is enabled.
+     */
+    get enabled() {
+        return this._enabled;
+    }
+    /**
+     * Record a tracer event in the event store.
+     *
+     * @param event - The tracer event to record
+     */
+    recordEvent(event) {
+        if (!this._enabled) {
+            return;
+        }
+        this.eventStore.store(event);
+    }
+    /**
+     * Record an LLM call event.
+     *
+     * @param model - The name of the LLM model being called
+     * @param messages - The messages sent to the LLM
+     * @param temperature - The temperature setting for the LLM call
+     * @param tools - The tools available to the LLM, if any
+     * @param correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param source - The source of the event
+     */
+    recordLlmCall(model, messages, temperature = 1.0, tools, correlationId, source) {
+        if (!this._enabled) {
+            return;
+        }
+        const event = new tracerEvents_1.LLMCallTracerEvent(model, messages, temperature, tools, correlationId, source);
+        this.eventStore.store(event);
+    }
+    /**
+     * Record an LLM response event.
+     *
+     * @param model - The name of the LLM model that responded
+     * @param content - The content of the LLM response
+     * @param toolCalls - Any tool calls made by the LLM in its response
+     * @param callDurationMs - The duration of the LLM call in milliseconds
+     * @param correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param source - The source of the event
+     */
+    recordLlmResponse(model, content, toolCalls, callDurationMs, correlationId, source) {
+        if (!this._enabled) {
+            return;
+        }
+        const event = new tracerEvents_1.LLMResponseTracerEvent(model, content, toolCalls, callDurationMs, correlationId, source);
+        this.eventStore.store(event);
+    }
+    /**
+     * Record a tool call event.
+     *
+     * @param toolName - The name of the tool being called
+     * @param args - The arguments provided to the tool
+     * @param result - The result returned by the tool
+     * @param caller - The name of the agent or component calling the tool
+     * @param callDurationMs - The duration of the tool call in milliseconds
+     * @param correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param source - The source of the event
+     */
+    recordToolCall(toolName, args, result, caller, callDurationMs, correlationId, source) {
+        if (!this._enabled) {
+            return;
+        }
+        const event = new tracerEvents_1.ToolCallTracerEvent(toolName, args, result, caller, callDurationMs, correlationId, source);
+        this.eventStore.store(event);
+    }
+    /**
+     * Record an agent interaction event.
+     *
+     * @param fromAgent - The name of the agent sending the event
+     * @param toAgent - The name of the agent receiving the event
+     * @param eventType - The type of event being processed
+     * @param eventId - A unique identifier for the event
+     * @param correlationId - UUID string that is copied from cause-to-effect for tracing events
+     * @param source - The source of the event
+     */
+    recordAgentInteraction(fromAgent, toAgent, eventType, eventId, correlationId, source) {
+        if (!this._enabled) {
+            return;
+        }
+        const event = new tracerEvents_1.AgentInteractionTracerEvent(fromAgent, toAgent, eventType, eventId, correlationId, source);
+        this.eventStore.store(event);
+    }
+    /**
+     * Get tracer events from the store, optionally filtered.
+     *
+     * This is a convenience wrapper around the EventStore's getEvents method,
+     * specifically for tracer events.
+     *
+     * @param options - Filter options for querying events
+     * @returns Events that match the filter criteria
+     *
+     * @example
+     * ```typescript
+     * // Get all LLM call events
+     * const llmCalls = tracer.getEvents({ eventType: LLMCallTracerEvent });
+     *
+     * // Get events in a time range
+     * const recent = tracer.getEvents({
+     *   startTime: Date.now() - 60000,
+     *   endTime: Date.now()
+     * });
+     *
+     * // Get events with custom filter
+     * const filtered = tracer.getEvents({
+     *   filterFunc: (e) => e.correlationId === 'my-id'
+     * });
+     * ```
+     */
+    getEvents(options = {}) {
+        return this.eventStore.getEvents(options);
+    }
+    /**
+     * Get the last N tracer events, optionally filtered by type.
+     *
+     * @param n - Number of events to return
+     * @param eventType - Optional event type to filter by
+     * @returns The last N tracer events that match the filter criteria
+     *
+     * @example
+     * ```typescript
+     * // Get last 10 events
+     * const last10 = tracer.getLastNTracerEvents(10);
+     *
+     * // Get last 5 LLM response events
+     * const last5 = tracer.getLastNTracerEvents(5, LLMResponseTracerEvent);
+     * ```
+     */
+    getLastNTracerEvents(n, eventType) {
+        return this.eventStore.getLastNEvents(n, eventType);
+    }
+    /**
+     * Clear all events from the event store.
+     */
+    clear() {
+        this.eventStore.clear();
+    }
+    /**
+     * Enable the tracer system.
+     */
+    enable() {
+        this._enabled = true;
+    }
+    /**
+     * Disable the tracer system.
+     */
+    disable() {
+        this._enabled = false;
+    }
+}
+exports.TracerSystem = TracerSystem;
+//# sourceMappingURL=tracerSystem.js.map

package/dist/tracer/tracerSystem.js.map

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

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "mojentic",
+  "version": "1.0.0",
+  "description": "Modern LLM integration framework for TypeScript with tool support and structured output generation",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint 'src/**/*.ts' 'examples/**/*.ts' --max-warnings 0",
+    "lint:fix": "eslint 'src/**/*.ts' 'examples/**/*.ts' --fix",
+    "format": "prettier --write 'src/**/*.ts' 'examples/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts' 'examples/**/*.ts'",
+    "audit": "npm audit --omit=dev --audit-level=moderate",
+    "audit:fix": "npm audit fix",
+    "quality": "npm run lint && npm run format:check && npm run test:coverage && npm run audit",
+    "example:simple": "ts-node examples/simple_llm.ts",
+    "example:structured": "ts-node examples/structured_output.ts",
+    "example:tool": "ts-node examples/tool_usage.ts",
+    "example:streaming": "ts-node examples/streaming.ts",
+    "example:image": "ts-node examples/image_analysis.ts",
+    "example:broker": "ts-node examples/broker_examples.ts",
+    "example:broker-as-tool": "ts-node examples/broker_as_tool.ts",
+    "example:tracer": "ts-node examples/tracer-demo.ts",
+    "example:async-llm": "ts-node examples/async-llm.ts",
+    "example:iterative-solver": "ts-node examples/iterative-solver.ts",
+    "example:recursive-agent": "ts-node examples/recursive-agent.ts",
+    "example:pull-model": "ts-node examples/pull_model.ts",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "keywords": [
+    "llm",
+    "ai",
+    "openai",
+    "ollama",
+    "anthropic",
+    "typescript",
+    "agents"
+  ],
+  "author": "Stacey Vetzal <stacey@mojility.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.6",
+    "@typescript-eslint/eslint-plugin": "^6.17.0",
+    "@typescript-eslint/parser": "^6.17.0",
+    "eslint": "^8.56.0",
+    "eslint-plugin-security": "^3.0.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.1",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3",
+    "vitepress": "^1.0.0-rc.31"
+  },
+  "dependencies": {
+    "tiktoken": "^1.0.22",
+    "zod": "^3.22.4"
+  },
+  "overrides": {
+    "js-yaml": "3.14.2",
+    "esbuild": "0.27.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/svetzal/mojentic-ts.git"
+  },
+  "homepage": "https://github.com/svetzal/mojentic-ts#readme",
+  "bugs": {
+    "url": "https://github.com/svetzal/mojentic-ts/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}