@peakinfer/cli 1.0.133

package/dist/config.js

@@ -0,0 +1,158 @@
+/**
+ * Config Module (v1.6)
+ *
+ * Central configuration resolution for PeakInfer.
+ * Resolution chain: CLI flags → env vars → global config → local config → defaults
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { parse as parseYAML } from 'yaml';
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const GLOBAL_CONFIG_DIR = join(homedir(), '.peakinfer');
+const GLOBAL_CONFIG_FILE = join(GLOBAL_CONFIG_DIR, 'config.yaml');
+const LOCAL_CONFIG_FILE = 'peakinfer.yaml';
+// =============================================================================
+// DEFAULTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    provider: 'anthropic',
+    model: 'claude-sonnet-4-20250514',
+    analysisMode: 'agent',
+    maxFileSize: 1048576, // 1MB
+    historyRetentionDays: 90,
+    verbose: false,
+};
+// =============================================================================
+// LOADERS
+// =============================================================================
+/**
+ * Load global config from ~/.peakinfer/config.yaml
+ */
+function loadGlobalConfig() {
+    if (!existsSync(GLOBAL_CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        const content = readFileSync(GLOBAL_CONFIG_FILE, 'utf-8');
+        return parseYAML(content) || {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Load local config from ./peakinfer.yaml
+ */
+function loadLocalConfig() {
+    if (!existsSync(LOCAL_CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        const content = readFileSync(LOCAL_CONFIG_FILE, 'utf-8');
+        return parseYAML(content) || {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Get API key from environment variables
+ */
+function getEnvApiKey() {
+    // Check ANTHROPIC_API_KEY (Claude Agent SDK)
+    if (process.env.ANTHROPIC_API_KEY) {
+        return process.env.ANTHROPIC_API_KEY;
+    }
+    // Generic fallback
+    return process.env.PEAKINFER_API_KEY;
+}
+/**
+ * Get model from environment
+ */
+function getEnvModel() {
+    return process.env.PEAKINFER_MODEL;
+}
+// =============================================================================
+// RESOLUTION
+// =============================================================================
+/**
+ * Resolve configuration from all sources.
+ * Priority: CLI overrides → env vars → global config → local config → defaults
+ */
+export function resolveConfig(overrides = {}) {
+    const local = loadLocalConfig();
+    const global = loadGlobalConfig();
+    // Start with defaults
+    const config = { ...DEFAULT_CONFIG };
+    // Layer 1: Local config file (./peakinfer.yaml)
+    if (local.model)
+        config.model = local.model;
+    if (local.analysisMode)
+        config.analysisMode = local.analysisMode;
+    if (local.verbose !== undefined)
+        config.verbose = local.verbose;
+    if (local.maxFileSize)
+        config.maxFileSize = local.maxFileSize;
+    if (local.historyRetentionDays)
+        config.historyRetentionDays = local.historyRetentionDays;
+    if (local.apiKey)
+        config.apiKey = local.apiKey;
+    // Layer 2: Global config file (~/.peakinfer/config.yaml)
+    if (global.model)
+        config.model = global.model;
+    if (global.analysisMode)
+        config.analysisMode = global.analysisMode;
+    if (global.verbose !== undefined)
+        config.verbose = global.verbose;
+    if (global.maxFileSize)
+        config.maxFileSize = global.maxFileSize;
+    if (global.historyRetentionDays)
+        config.historyRetentionDays = global.historyRetentionDays;
+    if (global.apiKey)
+        config.apiKey = global.apiKey;
+    // Layer 3: Environment variables
+    const envApiKey = getEnvApiKey();
+    const envModel = getEnvModel();
+    const envVerbose = process.env.PEAKINFER_VERBOSE;
+    if (envApiKey)
+        config.apiKey = envApiKey;
+    if (envModel)
+        config.model = envModel;
+    if (envVerbose === '1' || envVerbose === 'true')
+        config.verbose = true;
+    // Layer 4: CLI overrides (highest priority)
+    if (overrides.apiKey)
+        config.apiKey = overrides.apiKey;
+    if (overrides.model)
+        config.model = overrides.model;
+    if (overrides.analysisMode)
+        config.analysisMode = overrides.analysisMode;
+    if (overrides.verbose !== undefined)
+        config.verbose = overrides.verbose;
+    return config;
+}
+/**
+ * Get the resolved API key (convenience function)
+ */
+export function getApiKey() {
+    return resolveConfig().apiKey;
+}
+/**
+ * Check if API key is configured
+ */
+export function hasApiKey() {
+    return !!getApiKey();
+}
+/**
+ * Get config file paths for reference
+ */
+export function getConfigPaths() {
+    return {
+        global: GLOBAL_CONFIG_FILE,
+        local: LOCAL_CONFIG_FILE,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/connectors/helicone.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Helicone API Connector
+ *
+ * Fetches LLM request logs from Helicone's API.
+ * Docs: https://docs.helicone.ai/rest/request/post-v1requestquery
+ */
+import { ConnectorConfig, ConnectorResult } from './types.js';
+export declare function fetchHeliconeEvents(config: ConnectorConfig): Promise<ConnectorResult>;
+//# sourceMappingURL=helicone.d.ts.map

package/dist/connectors/helicone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helicone.d.ts","sourceRoot":"","sources":["../../src/connectors/helicone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EAIhB,MAAM,YAAY,CAAC;AA0EpB,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CA0E1B"}

package/dist/connectors/helicone.js

@@ -0,0 +1,106 @@
+/**
+ * Helicone API Connector
+ *
+ * Fetches LLM request logs from Helicone's API.
+ * Docs: https://docs.helicone.ai/rest/request/post-v1requestquery
+ */
+import { ConnectorError, calculateSummary, } from './types.js';
+const HELICONE_API_URL = 'https://api.helicone.ai/v1/request/query';
+function normalizeHeliconeEvent(req) {
+    const isSuccess = req.response_status >= 200 && req.response_status < 400;
+    const isStreaming = req.request_body?.stream === true;
+    return {
+        id: req.request_id,
+        timestamp: req.created_at,
+        model: req.model || req.request_body?.model || 'unknown',
+        provider: normalizeProvider(req.provider),
+        latency_ms: req.latency_ms,
+        prompt_tokens: req.prompt_tokens,
+        completion_tokens: req.completion_tokens,
+        total_tokens: req.total_tokens,
+        cost_usd: req.cost_usd,
+        success: isSuccess,
+        error: !isSuccess ? req.response_body?.error?.message : undefined,
+        streaming: isStreaming,
+        request_path: req.request_path,
+        user_id: req.user_id,
+        raw: req,
+    };
+}
+function normalizeProvider(provider) {
+    const providerMap = {
+        'openai': 'openai',
+        'openai-azure': 'azure-openai',
+        'azure': 'azure-openai',
+        'anthropic': 'anthropic',
+        'google': 'google',
+        'vertex': 'google-vertex',
+        'aws': 'aws-bedrock',
+        'bedrock': 'aws-bedrock',
+        'together': 'together',
+        'fireworks': 'fireworks',
+        'groq': 'groq',
+        'deepseek': 'deepseek',
+    };
+    return providerMap[provider.toLowerCase()] || provider.toLowerCase();
+}
+export async function fetchHeliconeEvents(config) {
+    const limit = config.limit || 1000;
+    // Build filter
+    const filter = {};
+    if (config.startDate) {
+        filter.created_at = { gte: config.startDate };
+    }
+    if (config.filter?.model) {
+        filter.model = { equals: config.filter.model };
+    }
+    if (config.filter?.success !== undefined) {
+        filter.response_status = config.filter.success
+            ? { gte: 200, lt: 400 }
+            : { gte: 400 };
+    }
+    try {
+        const response = await fetch(HELICONE_API_URL, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${config.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                filter: Object.keys(filter).length > 0 ? filter : undefined,
+                limit,
+                sort: {
+                    created_at: 'desc',
+                },
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new ConnectorError(`Helicone API error: ${response.status} ${errorText}`, 'helicone', response.status);
+        }
+        const data = await response.json();
+        if (data.error) {
+            throw new ConnectorError(data.error, 'helicone');
+        }
+        const events = (data.data || []).map(normalizeHeliconeEvent);
+        const summary = calculateSummary(events);
+        return {
+            events,
+            summary,
+            metadata: {
+                source: 'helicone',
+                fetched_at: new Date().toISOString(),
+                total_fetched: events.length,
+                truncated: events.length >= limit,
+                api_version: 'v1',
+            },
+        };
+    }
+    catch (error) {
+        if (error instanceof ConnectorError) {
+            throw error;
+        }
+        throw new ConnectorError(`Failed to fetch from Helicone: ${error instanceof Error ? error.message : 'Unknown error'}`, 'helicone');
+    }
+}
+//# sourceMappingURL=helicone.js.map

package/dist/connectors/helicone.js.map

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

package/dist/connectors/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Runtime Data Connectors
+ *
+ * Unified interface for fetching LLM runtime data from various sources.
+ * Supports: Helicone, LangSmith
+ *
+ * Usage:
+ *   const result = await fetchRuntimeData({
+ *     source: 'helicone',
+ *     apiKey: process.env.HELICONE_API_KEY,
+ *     limit: 1000,
+ *   });
+ */
+import { ConnectorConfig, ConnectorResult } from './types.js';
+export type RuntimeSource = 'helicone' | 'langsmith';
+export interface FetchRuntimeOptions extends Omit<ConnectorConfig, 'apiKey'> {
+    source: RuntimeSource;
+    apiKey: string;
+}
+/**
+ * Fetch runtime data from the specified source
+ */
+export declare function fetchRuntimeData(options: FetchRuntimeOptions): Promise<ConnectorResult>;
+/**
+ * Get API key from environment for the given source
+ */
+export declare function getApiKeyFromEnv(source: RuntimeSource): string | undefined;
+/**
+ * Validate that the source is supported
+ */
+export declare function isValidSource(source: string): source is RuntimeSource;
+/**
+ * Get a human-readable description of the source
+ */
+export declare function getSourceDescription(source: RuntimeSource): string;
+export { ConnectorConfig, ConnectorResult, ConnectorError, NormalizedEvent, ConnectorSummary, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EACL,eAAe,EACf,eAAe,EAIhB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,WAAW,CAAC;AAErD,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC;IAC1E,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAc7F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAY1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,aAAa,CAErE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAMlE;AAGD,OAAO,EACL,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/connectors/index.js

@@ -0,0 +1,65 @@
+/**
+ * Runtime Data Connectors
+ *
+ * Unified interface for fetching LLM runtime data from various sources.
+ * Supports: Helicone, LangSmith
+ *
+ * Usage:
+ *   const result = await fetchRuntimeData({
+ *     source: 'helicone',
+ *     apiKey: process.env.HELICONE_API_KEY,
+ *     limit: 1000,
+ *   });
+ */
+import { fetchHeliconeEvents } from './helicone.js';
+import { fetchLangSmithTraces } from './langsmith.js';
+import { ConnectorError, } from './types.js';
+/**
+ * Fetch runtime data from the specified source
+ */
+export async function fetchRuntimeData(options) {
+    const { source, ...config } = options;
+    switch (source) {
+        case 'helicone':
+            return fetchHeliconeEvents(config);
+        case 'langsmith':
+            return fetchLangSmithTraces(config);
+        default:
+            throw new ConnectorError(`Unknown runtime source: ${source}. Supported sources: helicone, langsmith`, source);
+    }
+}
+/**
+ * Get API key from environment for the given source
+ */
+export function getApiKeyFromEnv(source) {
+    const envVarMap = {
+        helicone: ['HELICONE_API_KEY', 'HELICONE_KEY'],
+        langsmith: ['LANGSMITH_API_KEY', 'LANGCHAIN_API_KEY'],
+    };
+    const envVars = envVarMap[source] || [];
+    for (const envVar of envVars) {
+        const value = process.env[envVar];
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+/**
+ * Validate that the source is supported
+ */
+export function isValidSource(source) {
+    return source === 'helicone' || source === 'langsmith';
+}
+/**
+ * Get a human-readable description of the source
+ */
+export function getSourceDescription(source) {
+    const descriptions = {
+        helicone: 'Helicone LLM Observability',
+        langsmith: 'LangSmith Tracing',
+    };
+    return descriptions[source] || source;
+}
+// Re-export types
+export { ConnectorError, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/connectors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connectors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAGL,cAAc,GAGf,MAAM,YAAY,CAAC;AASpB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IACjE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAEtC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,WAAW;YACd,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACtC;YACE,MAAM,IAAI,cAAc,CACtB,2BAA2B,MAAM,0CAA0C,EAC3E,MAAuB,CACxB,CAAC;IACN,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,MAAM,SAAS,GAAoC;QACjD,QAAQ,EAAE,CAAC,kBAAkB,EAAE,cAAc,CAAC;QAC9C,SAAS,EAAE,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;KACtD,CAAC;IAEF,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACxC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,MAAM,YAAY,GAAkC;QAClD,QAAQ,EAAE,4BAA4B;QACtC,SAAS,EAAE,mBAAmB;KAC/B,CAAC;IACF,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;AACxC,CAAC;AAED,kBAAkB;AAClB,OAAO,EAGL,cAAc,GAGf,MAAM,YAAY,CAAC"}

package/dist/connectors/langsmith.d.ts

@@ -0,0 +1,9 @@
+/**
+ * LangSmith API Connector
+ *
+ * Fetches LLM traces from LangSmith's API.
+ * Docs: https://docs.smith.langchain.com/reference/api
+ */
+import { ConnectorConfig, ConnectorResult } from './types.js';
+export declare function fetchLangSmithTraces(config: ConnectorConfig): Promise<ConnectorResult>;
+//# sourceMappingURL=langsmith.d.ts.map

package/dist/connectors/langsmith.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langsmith.d.ts","sourceRoot":"","sources":["../../src/connectors/langsmith.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EAIhB,MAAM,YAAY,CAAC;AAgGpB,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,CAAC,CAmE1B"}

package/dist/connectors/langsmith.js

@@ -0,0 +1,122 @@
+/**
+ * LangSmith API Connector
+ *
+ * Fetches LLM traces from LangSmith's API.
+ * Docs: https://docs.smith.langchain.com/reference/api
+ */
+import { ConnectorError, calculateSummary, } from './types.js';
+const LANGSMITH_API_URL = 'https://api.smith.langchain.com';
+function normalizeProvider(runName, invocationParams) {
+    const nameLower = runName.toLowerCase();
+    if (nameLower.includes('openai') || nameLower.includes('gpt'))
+        return 'openai';
+    if (nameLower.includes('anthropic') || nameLower.includes('claude'))
+        return 'anthropic';
+    if (nameLower.includes('azure'))
+        return 'azure-openai';
+    if (nameLower.includes('bedrock'))
+        return 'aws-bedrock';
+    if (nameLower.includes('vertex') || nameLower.includes('palm') || nameLower.includes('gemini'))
+        return 'google';
+    if (nameLower.includes('together'))
+        return 'together';
+    if (nameLower.includes('fireworks'))
+        return 'fireworks';
+    if (nameLower.includes('groq'))
+        return 'groq';
+    // Check invocation params
+    const modelName = invocationParams?.model_name || invocationParams?.model;
+    if (typeof modelName === 'string') {
+        if (modelName.includes('gpt'))
+            return 'openai';
+        if (modelName.includes('claude'))
+            return 'anthropic';
+        if (modelName.includes('gemini'))
+            return 'google';
+    }
+    return 'unknown';
+}
+function normalizeLangSmithRun(run) {
+    // Only include LLM runs
+    if (run.run_type !== 'llm') {
+        return null;
+    }
+    const startTime = new Date(run.start_time).getTime();
+    const endTime = run.end_time ? new Date(run.end_time).getTime() : startTime;
+    const latencyMs = endTime - startTime;
+    const invocationParams = run.extra?.invocation_params;
+    const model = invocationParams?.model || invocationParams?.model_name || 'unknown';
+    const isStreaming = invocationParams?.stream === true;
+    const isSuccess = run.status === 'success' || run.status === 'completed';
+    return {
+        id: run.id,
+        timestamp: run.start_time,
+        model: typeof model === 'string' ? model : 'unknown',
+        provider: normalizeProvider(run.name, invocationParams),
+        latency_ms: Math.max(0, latencyMs),
+        prompt_tokens: run.prompt_tokens,
+        completion_tokens: run.completion_tokens,
+        total_tokens: run.total_tokens,
+        cost_usd: run.total_cost,
+        success: isSuccess,
+        error: run.error,
+        streaming: isStreaming,
+        trace_id: run.trace_id,
+        parent_span_id: run.parent_run_id,
+        session_id: run.session_id,
+        raw: run,
+    };
+}
+export async function fetchLangSmithTraces(config) {
+    const limit = config.limit || 1000;
+    // Build query params
+    const params = new URLSearchParams();
+    params.set('limit', limit.toString());
+    params.set('run_type', 'llm'); // Only fetch LLM runs
+    params.set('is_root', 'false'); // Include nested runs
+    if (config.startDate) {
+        params.set('start_time', config.startDate);
+    }
+    if (config.endDate) {
+        params.set('end_time', config.endDate);
+    }
+    if (config.filter?.success !== undefined) {
+        params.set('error', config.filter.success ? 'false' : 'true');
+    }
+    try {
+        const response = await fetch(`${LANGSMITH_API_URL}/runs?${params.toString()}`, {
+            method: 'GET',
+            headers: {
+                'X-API-Key': config.apiKey,
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new ConnectorError(`LangSmith API error: ${response.status} ${errorText}`, 'langsmith', response.status);
+        }
+        const data = await response.json();
+        const events = (data.runs || [])
+            .map(normalizeLangSmithRun)
+            .filter((e) => e !== null);
+        const summary = calculateSummary(events);
+        return {
+            events,
+            summary,
+            metadata: {
+                source: 'langsmith',
+                fetched_at: new Date().toISOString(),
+                total_fetched: events.length,
+                truncated: data.cursors?.next !== undefined,
+                api_version: 'v1',
+            },
+        };
+    }
+    catch (error) {
+        if (error instanceof ConnectorError) {
+            throw error;
+        }
+        throw new ConnectorError(`Failed to fetch from LangSmith: ${error instanceof Error ? error.message : 'Unknown error'}`, 'langsmith');
+    }
+}
+//# sourceMappingURL=langsmith.js.map

package/dist/connectors/langsmith.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langsmith.js","sourceRoot":"","sources":["../../src/connectors/langsmith.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,cAAc,EAEd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,iBAAiB,GAAG,iCAAiC,CAAC;AAoC5D,SAAS,iBAAiB,CAAC,OAAe,EAAE,gBAA0C;IACpF,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAExC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/E,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAC;IACxF,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,cAAc,CAAC;IACvD,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,aAAa,CAAC;IACxD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChH,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IACtD,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAC;IACxD,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAE9C,0BAA0B;IAC1B,MAAM,SAAS,GAAG,gBAAgB,EAAE,UAAU,IAAI,gBAAgB,EAAE,KAAK,CAAC;IAC1E,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC/C,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,WAAW,CAAC;QACrD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;IACpD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAiB;IAC9C,wBAAwB;IACxB,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAEtC,MAAM,gBAAgB,GAAG,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC;IACtD,MAAM,KAAK,GAAG,gBAAgB,EAAE,KAAK,IAAI,gBAAgB,EAAE,UAAU,IAAI,SAAS,CAAC;IACnF,MAAM,WAAW,GAAG,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC;IAEzE,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACpD,QAAQ,EAAE,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC;QACvD,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC;QAClC,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;QACxC,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,QAAQ,EAAE,GAAG,CAAC,UAAU;QACxB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,WAAW;QACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,cAAc,EAAE,GAAG,CAAC,aAAa;QACjC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,GAAG,EAAE,GAAyC;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAuB;IAEvB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;IAEnC,qBAAqB;IACrB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,sBAAsB;IACrD,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,sBAAsB;IAEtD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,iBAAiB,SAAS,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE;YAC7E,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,WAAW,EAAE,MAAM,CAAC,MAAM;gBAC1B,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,cAAc,CACtB,wBAAwB,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,EACtD,WAAW,EACX,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuB,CAAC;QAExD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;aAC7B,GAAG,CAAC,qBAAqB,CAAC;aAC1B,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAEnD,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAEzC,OAAO;YACL,MAAM;YACN,OAAO;YACP,QAAQ,EAAE;gBACR,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,aAAa,EAAE,MAAM,CAAC,MAAM;gBAC5B,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,SAAS;gBAC3C,WAAW,EAAE,IAAI;aAClB;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,cAAc,CACtB,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,EAC7F,WAAW,CACZ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/connectors/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Shared types for runtime data connectors
+ *
+ * These types define the normalized format for runtime events
+ * from various sources (Helicone, LangSmith, etc.)
+ */
+export interface NormalizedEvent {
+    id: string;
+    timestamp: string;
+    model: string;
+    provider: string;
+    latency_ms: number;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    cost_usd?: number;
+    success: boolean;
+    error?: string;
+    streaming?: boolean;
+    trace_id?: string;
+    span_id?: string;
+    parent_span_id?: string;
+    request_path?: string;
+    user_id?: string;
+    session_id?: string;
+    raw?: Record<string, unknown>;
+}
+export interface ConnectorSummary {
+    total_requests: number;
+    total_cost_usd: number;
+    avg_latency_ms: number;
+    p50_latency_ms: number;
+    p95_latency_ms: number;
+    p99_latency_ms: number;
+    error_rate: number;
+    streaming_rate: number;
+    by_model: Record<string, {
+        count: number;
+        cost: number;
+        avg_latency_ms: number;
+        p95_latency_ms: number;
+        error_rate: number;
+    }>;
+    by_provider: Record<string, {
+        count: number;
+        cost: number;
+    }>;
+    time_range: {
+        start: string;
+        end: string;
+    };
+}
+export interface ConnectorResult {
+    events: NormalizedEvent[];
+    summary: ConnectorSummary;
+    metadata: {
+        source: 'helicone' | 'langsmith';
+        fetched_at: string;
+        total_fetched: number;
+        truncated: boolean;
+        api_version?: string;
+    };
+}
+export interface ConnectorConfig {
+    apiKey: string;
+    limit?: number;
+    startDate?: string;
+    endDate?: string;
+    filter?: {
+        model?: string;
+        provider?: string;
+        success?: boolean;
+    };
+}
+export declare class ConnectorError extends Error {
+    readonly source: 'helicone' | 'langsmith';
+    readonly statusCode?: number | undefined;
+    readonly code?: string | undefined;
+    constructor(message: string, source: 'helicone' | 'langsmith', statusCode?: number | undefined, code?: string | undefined);
+}
+export declare function calculatePercentile(values: number[], percentile: number): number;
+export declare function calculateSummary(events: NormalizedEvent[]): ConnectorSummary;
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/connectors/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;QACjC,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,qBAAa,cAAe,SAAQ,KAAK;aAGrB,MAAM,EAAE,UAAU,GAAG,WAAW;aAChC,UAAU,CAAC,EAAE,MAAM;aACnB,IAAI,CAAC,EAAE,MAAM;gBAH7B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,UAAU,GAAG,WAAW,EAChC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAGD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,gBAAgB,CA6E5E"}