@illuma-ai/observability-langchain 0.1.0

package/dist/callback-handler.d.ts

@@ -0,0 +1,196 @@
+import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
+import type { Serialized } from '@langchain/core/load/serializable';
+import type { LLMResult } from '@langchain/core/outputs';
+import type { Document } from '@langchain/core/documents';
+import type { ObserveClient, ObserveClientOptions } from '@illuma-ai/observe-sdk';
+/**
+ * Options for constructing the ObservabilityCallbackHandler.
+ * Provide either a pre-configured `client` instance, or `clientOptions`
+ * to have the handler create one internally.
+ */
+export interface ObservabilityCallbackHandlerOptions {
+    /** Pre-configured ObserveClient instance */
+    client?: ObserveClient;
+    /** Options to construct an ObserveClient (used if `client` is not provided) */
+    clientOptions?: ObserveClientOptions;
+    /** Optional trace name override (default: "langchain-run") */
+    traceName?: string;
+    /** Optional user ID to associate with the trace */
+    userId?: string;
+    /** Optional session ID to associate with the trace */
+    sessionId?: string;
+    /** Optional tags for the trace */
+    tags?: string[];
+    /** Optional metadata for the trace */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * LangChain callback handler that sends trace data to Illuma Observe.
+ *
+ * The handler maps LangChain's run hierarchy to Illuma Observe's trace model:
+ * - The first (root) run lazily creates a **trace**
+ * - LLM runs create **generation** observations (with updates on end/error)
+ * - Chain, tool, and retriever runs create **span** observations (with updates on end/error)
+ * - Parent/child relationships are preserved via `parentObservationId`
+ *
+ * @example
+ * ```ts
+ * import { ObservabilityCallbackHandler } from '@illuma-ai/observability-langchain';
+ * import { ObserveClient } from '@illuma-ai/observe-sdk';
+ *
+ * const client = new ObserveClient({
+ *   publicKey: 'pk-...',
+ *   secretKey: 'sk-...',
+ *   baseUrl: 'https://observe.illuma.ai',
+ * });
+ *
+ * const handler = new ObservabilityCallbackHandler({ client });
+ * const result = await chain.invoke({ input: 'Hello' }, { callbacks: [handler] });
+ *
+ * await client.shutdown(); // flush all pending events
+ * ```
+ */
+export declare class ObservabilityCallbackHandler extends BaseCallbackHandler {
+    name: string;
+    private client;
+    private ownsClient;
+    /** Trace-level configuration */
+    private traceName;
+    private userId?;
+    private sessionId?;
+    private traceTags?;
+    private traceMetadata?;
+    /**
+     * Maps LangChain runId -> internal run state.
+     * Used to correlate start/end/error callbacks for the same run.
+     */
+    private runs;
+    /**
+     * The root trace ID for this handler instance.
+     * Created lazily on the first root-level run.
+     */
+    private rootTraceId;
+    constructor(options: ObservabilityCallbackHandlerOptions);
+    /**
+     * Called when an LLM call starts. Creates a generation-create event.
+     * @param llm - Serialized LLM descriptor
+     * @param prompts - The prompt strings sent to the LLM
+     * @param runId - Unique ID for this LangChain run
+     * @param parentRunId - Parent run ID if this is a nested call
+     */
+    handleLLMStart(llm: Serialized, prompts: string[], runId: string, parentRunId?: string, _extraParams?: Record<string, unknown>, _tags?: string[], _metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Called when an LLM call completes. Creates a generation-update event
+     * with the model output and token usage.
+     * @param output - The LLM result containing generations and metadata
+     * @param runId - The run ID matching the preceding handleLLMStart
+     */
+    handleLLMEnd(output: LLMResult, runId: string): Promise<void>;
+    /**
+     * Called when an LLM call errors. Creates a generation-update with error status.
+     * @param err - The error that occurred
+     * @param runId - The run ID matching the preceding handleLLMStart
+     */
+    handleLLMError(err: Error, runId: string): Promise<void>;
+    /**
+     * Called when a chain starts. Creates a span-create event.
+     * If this is the first callback, the root trace is also created.
+     * @param chain - Serialized chain descriptor
+     * @param inputs - The input object passed to the chain
+     * @param runId - Unique ID for this LangChain run
+     * @param parentRunId - Parent run ID if this is a nested call
+     */
+    handleChainStart(chain: Serialized, inputs: Record<string, unknown>, runId: string, parentRunId?: string): Promise<void>;
+    /**
+     * Called when a chain completes. Creates a span-update with the outputs.
+     * @param outputs - The output object returned by the chain
+     * @param runId - The run ID matching the preceding handleChainStart
+     */
+    handleChainEnd(outputs: Record<string, unknown>, runId: string): Promise<void>;
+    /**
+     * Called when a chain errors. Creates a span-update with error status.
+     * @param err - The error that occurred
+     * @param runId - The run ID matching the preceding handleChainStart
+     */
+    handleChainError(err: Error, runId: string): Promise<void>;
+    /**
+     * Called when a tool invocation starts. Creates a span-create event
+     * with the tool name and input.
+     * @param tool - Serialized tool descriptor
+     * @param input - The input string passed to the tool
+     * @param runId - Unique ID for this LangChain run
+     * @param parentRunId - Parent run ID if this is a nested call
+     */
+    handleToolStart(tool: Serialized, input: string, runId: string, parentRunId?: string): Promise<void>;
+    /**
+     * Called when a tool invocation completes. Creates a span-update with the output.
+     * @param output - The output string returned by the tool
+     * @param runId - The run ID matching the preceding handleToolStart
+     */
+    handleToolEnd(output: string, runId: string): Promise<void>;
+    /**
+     * Called when a tool invocation errors. Creates a span-update with error status.
+     * @param err - The error that occurred
+     * @param runId - The run ID matching the preceding handleToolStart
+     */
+    handleToolError(err: Error, runId: string): Promise<void>;
+    /**
+     * Called when a retriever query starts. Creates a span-create event
+     * for the retrieval operation.
+     * @param retriever - Serialized retriever descriptor
+     * @param query - The search query string
+     * @param runId - Unique ID for this LangChain run
+     * @param parentRunId - Parent run ID if this is a nested call
+     */
+    handleRetrieverStart(retriever: Serialized, query: string, runId: string, parentRunId?: string): Promise<void>;
+    /**
+     * Called when a retriever query completes. Creates a span-update
+     * with the retrieved documents.
+     * @param documents - The retrieved Document objects
+     * @param runId - The run ID matching the preceding handleRetrieverStart
+     */
+    handleRetrieverEnd(documents: Document[], runId: string): Promise<void>;
+    /**
+     * Called when a retriever query errors. Creates a span-update with error status.
+     * @param err - The error that occurred
+     * @param runId - The run ID matching the preceding handleRetrieverStart
+     */
+    handleRetrieverError(err: Error, runId: string): Promise<void>;
+    /**
+     * Returns the trace ID for this handler instance, or null if no trace
+     * has been created yet (i.e., no callbacks have fired).
+     */
+    getTraceId(): string | null;
+    /**
+     * Flush all pending events to the Illuma Observe API.
+     * Delegates to the underlying ObserveClient.flush().
+     */
+    flushAsync(): Promise<void>;
+    /**
+     * Shut down the handler. If the handler owns the client (created via
+     * `clientOptions`), the client is fully shut down. Otherwise, only a
+     * flush is performed to avoid disrupting a shared client.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Lazily creates the root trace on the first callback.
+     * Subsequent calls return the existing trace ID.
+     *
+     * @param input - Optional input to record on the trace (from the first chain)
+     * @returns The trace ID for this handler instance
+     */
+    private ensureTrace;
+    /**
+     * Push a raw ingestion event into the ObserveClient's internal queue.
+     *
+     * The SDK's public API (TraceClient.generation/span) only supports *-create
+     * events, but our callback handler needs *-update events as well.
+     * Since both packages are owned by Illuma, we access the client's internal
+     * queue directly. The queue is a simple array that gets drained on flush.
+     *
+     * @param type - The ingestion event type (e.g., 'generation-create', 'span-update')
+     * @param body - The event body payload
+     */
+    private pushEvent;
+}
+//# sourceMappingURL=callback-handler.d.ts.map

package/dist/callback-handler.d.ts.map

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

package/dist/callback-handler.js

@@ -0,0 +1,469 @@
+import { randomUUID } from 'node:crypto';
+import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
+/**
+ * LangChain callback handler that sends trace data to Illuma Observe.
+ *
+ * The handler maps LangChain's run hierarchy to Illuma Observe's trace model:
+ * - The first (root) run lazily creates a **trace**
+ * - LLM runs create **generation** observations (with updates on end/error)
+ * - Chain, tool, and retriever runs create **span** observations (with updates on end/error)
+ * - Parent/child relationships are preserved via `parentObservationId`
+ *
+ * @example
+ * ```ts
+ * import { ObservabilityCallbackHandler } from '@illuma-ai/observability-langchain';
+ * import { ObserveClient } from '@illuma-ai/observe-sdk';
+ *
+ * const client = new ObserveClient({
+ *   publicKey: 'pk-...',
+ *   secretKey: 'sk-...',
+ *   baseUrl: 'https://observe.illuma.ai',
+ * });
+ *
+ * const handler = new ObservabilityCallbackHandler({ client });
+ * const result = await chain.invoke({ input: 'Hello' }, { callbacks: [handler] });
+ *
+ * await client.shutdown(); // flush all pending events
+ * ```
+ */
+export class ObservabilityCallbackHandler extends BaseCallbackHandler {
+    name = 'ObservabilityCallbackHandler';
+    client;
+    ownsClient;
+    /** Trace-level configuration */
+    traceName;
+    userId;
+    sessionId;
+    traceTags;
+    traceMetadata;
+    /**
+     * Maps LangChain runId -> internal run state.
+     * Used to correlate start/end/error callbacks for the same run.
+     */
+    runs = new Map();
+    /**
+     * The root trace ID for this handler instance.
+     * Created lazily on the first root-level run.
+     */
+    rootTraceId = null;
+    constructor(options) {
+        super();
+        if (options.client) {
+            this.client = options.client;
+            this.ownsClient = false;
+        }
+        else if (options.clientOptions) {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { ObserveClient: ClientCtor } = require('@illuma-ai/observe-sdk');
+            this.client = new ClientCtor(options.clientOptions);
+            this.ownsClient = true;
+        }
+        else {
+            throw new Error('ObservabilityCallbackHandler requires either a `client` or `clientOptions`.');
+        }
+        this.traceName = options.traceName ?? 'langchain-run';
+        this.userId = options.userId;
+        this.sessionId = options.sessionId;
+        this.traceTags = options.tags;
+        this.traceMetadata = options.metadata;
+    }
+    // ---------------------------------------------------------------------------
+    // LLM callbacks
+    // ---------------------------------------------------------------------------
+    /**
+     * Called when an LLM call starts. Creates a generation-create event.
+     * @param llm - Serialized LLM descriptor
+     * @param prompts - The prompt strings sent to the LLM
+     * @param runId - Unique ID for this LangChain run
+     * @param parentRunId - Parent run ID if this is a nested call
+     */
+    async handleLLMStart(llm, prompts, runId, parentRunId, _extraParams, _tags, _metadata) {
+        const traceId = this.ensureTrace();
+        const observationId = randomUUID();
+        const startTime = new Date().toISOString();
+        const name = llm.id?.[llm.id.length - 1] ?? 'LLM';
+        this.runs.set(runId, {
+            observationId,
+            traceId,
+            parentObservationId: parentRunId ? this.runs.get(parentRunId)?.observationId : undefined,
+            startTime,
+            type: 'generation',
+            name,
+        });
+        this.pushEvent('generation-create', {
+            id: observationId,
+            traceId,
+            parentObservationId: parentRunId ? this.runs.get(parentRunId)?.observationId : undefined,
+            name,
+            startTime,
+            input: prompts,
+            metadata: {
+                langchainRunId: runId,
+                serializedLlm: llm,
+            },
+        });
+    }
+    /**
+     * Called when an LLM call completes. Creates a generation-update event
+     * with the model output and token usage.
+     * @param output - The LLM result containing generations and metadata
+     * @param runId - The run ID matching the preceding handleLLMStart
+     */
+    async handleLLMEnd(output, runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        const endTime = new Date().toISOString();
+        const generation = output.generations?.[0]?.[0];
+        // Extract token usage from LLM response metadata.
+        // Different LLM providers place usage stats in different fields.
+        const llmOutput = output.llmOutput;
+        const tokenUsage = (llmOutput?.tokenUsage ?? llmOutput?.usage ?? {});
+        this.pushEvent('generation-update', {
+            id: run.observationId,
+            traceId: run.traceId,
+            endTime,
+            output: generation?.text ?? output.generations,
+            model: (llmOutput?.modelName ?? llmOutput?.model ?? undefined),
+            usage: {
+                promptTokens: (tokenUsage.promptTokens ?? tokenUsage.prompt_tokens),
+                completionTokens: (tokenUsage.completionTokens ?? tokenUsage.completion_tokens),
+                totalTokens: (tokenUsage.totalTokens ?? tokenUsage.total_tokens),
+            },
+        });
+        this.runs.delete(runId);
+    }
+    /**
+     * Called when an LLM call errors. Creates a generation-update with error status.
+     * @param err - The error that occurred
+     * @param runId - The run ID matching the preceding handleLLMStart
+     */
+    async handleLLMError(err, runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        this.pushEvent('generation-update', {
+            id: run.observationId,
+            traceId: run.traceId,
+            endTime: new Date().toISOString(),
+            level: 'ERROR',
+            statusMessage: err.message,
+            metadata: { error: err.stack ?? err.message },
+        });
+        this.runs.delete(runId);
+    }
+    // ---------------------------------------------------------------------------
+    // Chain callbacks
+    // ---------------------------------------------------------------------------
+    /**
+     * Called when a chain starts. Creates a span-create event.
+     * If this is the first callback, the root trace is also created.
+     * @param chain - Serialized chain descriptor
+     * @param inputs - The input object passed to the chain
+     * @param runId - Unique ID for this LangChain run
+     * @param parentRunId - Parent run ID if this is a nested call
+     */
+    async handleChainStart(chain, inputs, runId, parentRunId) {
+        const traceId = this.ensureTrace(inputs);
+        const observationId = randomUUID();
+        const startTime = new Date().toISOString();
+        const name = chain.id?.[chain.id.length - 1] ?? 'Chain';
+        this.runs.set(runId, {
+            observationId,
+            traceId,
+            parentObservationId: parentRunId ? this.runs.get(parentRunId)?.observationId : undefined,
+            startTime,
+            type: 'span',
+            name,
+        });
+        this.pushEvent('span-create', {
+            id: observationId,
+            traceId,
+            parentObservationId: parentRunId ? this.runs.get(parentRunId)?.observationId : undefined,
+            name,
+            startTime,
+            input: inputs,
+            metadata: {
+                langchainRunId: runId,
+            },
+        });
+    }
+    /**
+     * Called when a chain completes. Creates a span-update with the outputs.
+     * @param outputs - The output object returned by the chain
+     * @param runId - The run ID matching the preceding handleChainStart
+     */
+    async handleChainEnd(outputs, runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        this.pushEvent('span-update', {
+            id: run.observationId,
+            traceId: run.traceId,
+            endTime: new Date().toISOString(),
+            output: outputs,
+        });
+        this.runs.delete(runId);
+    }
+    /**
+     * Called when a chain errors. Creates a span-update with error status.
+     * @param err - The error that occurred
+     * @param runId - The run ID matching the preceding handleChainStart
+     */
+    async handleChainError(err, runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        this.pushEvent('span-update', {
+            id: run.observationId,
+            traceId: run.traceId,
+            endTime: new Date().toISOString(),
+            level: 'ERROR',
+            statusMessage: err.message,
+            metadata: { error: err.stack ?? err.message },
+        });
+        this.runs.delete(runId);
+    }
+    // ---------------------------------------------------------------------------
+    // Tool callbacks
+    // ---------------------------------------------------------------------------
+    /**
+     * Called when a tool invocation starts. Creates a span-create event
+     * with the tool name and input.
+     * @param tool - Serialized tool descriptor
+     * @param input - The input string passed to the tool
+     * @param runId - Unique ID for this LangChain run
+     * @param parentRunId - Parent run ID if this is a nested call
+     */
+    async handleToolStart(tool, input, runId, parentRunId) {
+        const traceId = this.ensureTrace();
+        const observationId = randomUUID();
+        const startTime = new Date().toISOString();
+        const name = tool.id?.[tool.id.length - 1] ?? 'Tool';
+        this.runs.set(runId, {
+            observationId,
+            traceId,
+            parentObservationId: parentRunId ? this.runs.get(parentRunId)?.observationId : undefined,
+            startTime,
+            type: 'span',
+            name,
+        });
+        this.pushEvent('span-create', {
+            id: observationId,
+            traceId,
+            parentObservationId: parentRunId ? this.runs.get(parentRunId)?.observationId : undefined,
+            name: `Tool: ${name}`,
+            startTime,
+            input,
+            metadata: {
+                langchainRunId: runId,
+                observationType: 'tool',
+            },
+        });
+    }
+    /**
+     * Called when a tool invocation completes. Creates a span-update with the output.
+     * @param output - The output string returned by the tool
+     * @param runId - The run ID matching the preceding handleToolStart
+     */
+    async handleToolEnd(output, runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        this.pushEvent('span-update', {
+            id: run.observationId,
+            traceId: run.traceId,
+            endTime: new Date().toISOString(),
+            output,
+        });
+        this.runs.delete(runId);
+    }
+    /**
+     * Called when a tool invocation errors. Creates a span-update with error status.
+     * @param err - The error that occurred
+     * @param runId - The run ID matching the preceding handleToolStart
+     */
+    async handleToolError(err, runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        this.pushEvent('span-update', {
+            id: run.observationId,
+            traceId: run.traceId,
+            endTime: new Date().toISOString(),
+            level: 'ERROR',
+            statusMessage: err.message,
+            metadata: { error: err.stack ?? err.message },
+        });
+        this.runs.delete(runId);
+    }
+    // ---------------------------------------------------------------------------
+    // Retriever callbacks
+    // ---------------------------------------------------------------------------
+    /**
+     * Called when a retriever query starts. Creates a span-create event
+     * for the retrieval operation.
+     * @param retriever - Serialized retriever descriptor
+     * @param query - The search query string
+     * @param runId - Unique ID for this LangChain run
+     * @param parentRunId - Parent run ID if this is a nested call
+     */
+    async handleRetrieverStart(retriever, query, runId, parentRunId) {
+        const traceId = this.ensureTrace();
+        const observationId = randomUUID();
+        const startTime = new Date().toISOString();
+        const name = retriever.id?.[retriever.id.length - 1] ?? 'Retriever';
+        this.runs.set(runId, {
+            observationId,
+            traceId,
+            parentObservationId: parentRunId ? this.runs.get(parentRunId)?.observationId : undefined,
+            startTime,
+            type: 'span',
+            name,
+        });
+        this.pushEvent('span-create', {
+            id: observationId,
+            traceId,
+            parentObservationId: parentRunId ? this.runs.get(parentRunId)?.observationId : undefined,
+            name: `Retriever: ${name}`,
+            startTime,
+            input: query,
+            metadata: {
+                langchainRunId: runId,
+                observationType: 'retriever',
+            },
+        });
+    }
+    /**
+     * Called when a retriever query completes. Creates a span-update
+     * with the retrieved documents.
+     * @param documents - The retrieved Document objects
+     * @param runId - The run ID matching the preceding handleRetrieverStart
+     */
+    async handleRetrieverEnd(documents, runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        // Serialize documents to a lightweight format for observability
+        const serializedDocs = documents.map((doc) => ({
+            pageContent: doc.pageContent,
+            metadata: doc.metadata,
+        }));
+        this.pushEvent('span-update', {
+            id: run.observationId,
+            traceId: run.traceId,
+            endTime: new Date().toISOString(),
+            output: serializedDocs,
+            metadata: {
+                documentCount: documents.length,
+            },
+        });
+        this.runs.delete(runId);
+    }
+    /**
+     * Called when a retriever query errors. Creates a span-update with error status.
+     * @param err - The error that occurred
+     * @param runId - The run ID matching the preceding handleRetrieverStart
+     */
+    async handleRetrieverError(err, runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        this.pushEvent('span-update', {
+            id: run.observationId,
+            traceId: run.traceId,
+            endTime: new Date().toISOString(),
+            level: 'ERROR',
+            statusMessage: err.message,
+            metadata: { error: err.stack ?? err.message },
+        });
+        this.runs.delete(runId);
+    }
+    // ---------------------------------------------------------------------------
+    // Public helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Returns the trace ID for this handler instance, or null if no trace
+     * has been created yet (i.e., no callbacks have fired).
+     */
+    getTraceId() {
+        return this.rootTraceId;
+    }
+    /**
+     * Flush all pending events to the Illuma Observe API.
+     * Delegates to the underlying ObserveClient.flush().
+     */
+    async flushAsync() {
+        await this.client.flush();
+    }
+    /**
+     * Shut down the handler. If the handler owns the client (created via
+     * `clientOptions`), the client is fully shut down. Otherwise, only a
+     * flush is performed to avoid disrupting a shared client.
+     */
+    async shutdown() {
+        if (this.ownsClient) {
+            await this.client.shutdown();
+        }
+        else {
+            await this.client.flush();
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Lazily creates the root trace on the first callback.
+     * Subsequent calls return the existing trace ID.
+     *
+     * @param input - Optional input to record on the trace (from the first chain)
+     * @returns The trace ID for this handler instance
+     */
+    ensureTrace(input) {
+        if (this.rootTraceId) {
+            return this.rootTraceId;
+        }
+        this.rootTraceId = randomUUID();
+        this.pushEvent('trace-create', {
+            id: this.rootTraceId,
+            name: this.traceName,
+            userId: this.userId,
+            sessionId: this.sessionId,
+            tags: this.traceTags,
+            metadata: this.traceMetadata,
+            input,
+        });
+        return this.rootTraceId;
+    }
+    /**
+     * Push a raw ingestion event into the ObserveClient's internal queue.
+     *
+     * The SDK's public API (TraceClient.generation/span) only supports *-create
+     * events, but our callback handler needs *-update events as well.
+     * Since both packages are owned by Illuma, we access the client's internal
+     * queue directly. The queue is a simple array that gets drained on flush.
+     *
+     * @param type - The ingestion event type (e.g., 'generation-create', 'span-update')
+     * @param body - The event body payload
+     */
+    pushEvent(type, body) {
+        const event = {
+            id: randomUUID(),
+            type,
+            timestamp: new Date().toISOString(),
+            body,
+        };
+        // Access the client's internal queue and flush threshold.
+        // SCALE: This is O(1) per event - just an array push.
+        const internal = this.client;
+        if (internal.stopped) {
+            return;
+        }
+        internal.queue.push(event);
+        // Trigger auto-flush if batch size threshold is reached
+        if (internal.queue.length >= internal.flushAt) {
+            void internal.flush();
+        }
+    }
+}
+//# sourceMappingURL=callback-handler.js.map

package/dist/callback-handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ObservabilityCallbackHandler } from './callback-handler.js';
+export type { ObservabilityCallbackHandlerOptions } from './callback-handler.js';
+//# 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":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { ObservabilityCallbackHandler } from './callback-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@illuma-ai/observability-langchain",
+  "version": "0.1.0",
+  "description": "LangChain callback handler for Illuma Observability",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": { ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" } },
+  "files": ["dist"],
+  "scripts": { "build": "tsc", "prepublishOnly": "npm run build" },
+  "dependencies": { "@illuma-ai/observe-sdk": "^0.1.0" },
+  "peerDependencies": { "@langchain/core": ">=0.1.0" },
+  "devDependencies": { "typescript": "^5.4.5", "@types/node": "^20.14.2", "@langchain/core": "^0.3.0" },
+  "publishConfig": { "access": "public" },
+  "repository": { "type": "git", "url": "https://github.com/illuma-ai/observability.git", "directory": "packages/observability-langchain" },
+  "license": "MIT"
+}