@analytix402/sdk 0.1.1 → 0.1.2

package/dist/types-C67qDpYb.d.mts

@@ -0,0 +1,290 @@
+/**
+ * Analytix402 SDK Types
+ */
+interface Analytix402Config {
+    /**
+     * Your Analytix402 API key (starts with ax_live_ or ax_test_)
+     */
+    apiKey: string;
+    /**
+     * Base URL for the Analytix402 API
+     * @default "https://analytix402.com"
+     */
+    baseUrl?: string;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Maximum number of events to batch before sending
+     * @default 100
+     */
+    batchSize?: number;
+    /**
+     * Maximum time (ms) to wait before flushing events
+     * @default 5000
+     */
+    flushInterval?: number;
+    /**
+     * Maximum number of retry attempts for failed requests
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Maximum events to queue when offline
+     * @default 1000
+     */
+    maxQueueSize?: number;
+    /**
+     * Request timeout in milliseconds
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * Paths to exclude from tracking (supports wildcards)
+     * @default ["/health", "/healthz", "/ready", "/metrics"]
+     */
+    excludePaths?: string[];
+    /**
+     * Custom function to extract endpoint name from request
+     */
+    getEndpointName?: (req: RequestInfo) => string;
+    /**
+     * Custom function to determine if request should be tracked
+     */
+    shouldTrack?: (req: RequestInfo) => boolean;
+    /**
+     * Agent identifier for multi-agent tracking
+     */
+    agentId?: string;
+    /**
+     * Agent friendly name
+     */
+    agentName?: string;
+    /**
+     * Automatically send a heartbeat on client creation to register
+     * the agent in the dashboard immediately.
+     * @default false
+     */
+    autoConnect?: boolean;
+    /**
+     * Interval in milliseconds to send periodic heartbeats.
+     * Set to 0 to disable. Requires agentId.
+     * @default 0
+     */
+    heartbeatIntervalMs?: number;
+}
+interface RequestEvent {
+    type: 'request';
+    method: string;
+    path: string;
+    endpoint?: string;
+    statusCode: number;
+    responseTimeMs: number;
+    payment?: PaymentInfo;
+    /** Agent identifier */
+    agentId?: string;
+    /** Task identifier for grouping actions */
+    taskId?: string;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+    ip?: string;
+    userAgent?: string;
+}
+interface PaymentInfo {
+    /** Payment amount */
+    amount: string;
+    /** Currency (e.g., "USDC") */
+    currency: string;
+    /** Payer wallet address */
+    wallet: string;
+    /** Payment status */
+    status: 'success' | 'failed' | 'pending';
+    /** Transaction hash if available */
+    txHash?: string;
+    /** Facilitator URL */
+    facilitator?: string;
+}
+interface HeartbeatEvent {
+    type: 'heartbeat';
+    agentId: string;
+    status: 'healthy' | 'degraded' | 'error';
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+}
+interface TaskOutcome {
+    type: 'task_outcome';
+    agentId?: string;
+    taskId: string;
+    success: boolean;
+    durationMs?: number;
+    cost?: number;
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+}
+interface LLMUsageEvent {
+    type: 'llm_usage';
+    agentId?: string;
+    taskId?: string;
+    model: string;
+    provider: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd?: number;
+    durationMs?: number;
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+}
+interface BatchPayload {
+    events: (RequestEvent | HeartbeatEvent | TaskOutcome | LLMUsageEvent)[];
+    sdk: {
+        name: string;
+        version: string;
+    };
+    sentAt: string;
+}
+interface RequestInfo {
+    method: string;
+    path: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    ip?: string;
+}
+interface ResponseInfo {
+    statusCode: number;
+    headers: Record<string, string | string[] | undefined>;
+}
+interface Analytix402Client {
+    /**
+     * Track a request event
+     */
+    track(event: RequestEvent): void;
+    /**
+     * Flush all queued events immediately
+     */
+    flush(): Promise<void>;
+    /**
+     * Shutdown the client gracefully
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Send a heartbeat signal
+     */
+    heartbeat(status?: 'healthy' | 'degraded' | 'error', metadata?: Record<string, unknown>): void;
+    /**
+     * Report a task outcome
+     */
+    reportOutcome(taskId: string, success: boolean, options?: {
+        durationMs?: number;
+        cost?: number;
+        metadata?: Record<string, unknown>;
+    }): void;
+    /**
+     * Start a task and return a task tracker
+     */
+    startTask(taskId?: string): TaskTracker;
+    /** Track LLM token usage */
+    trackLLM(usage: {
+        model: string;
+        provider: string;
+        inputTokens: number;
+        outputTokens: number;
+        costUsd?: number;
+        durationMs?: number;
+        taskId?: string;
+        metadata?: Record<string, unknown>;
+    }): void;
+}
+interface TaskTracker {
+    taskId: string;
+    /** End the task and report outcome */
+    end(success: boolean, metadata?: Record<string, unknown>): void;
+}
+interface ExpressRequest {
+    method: string;
+    path: string;
+    originalUrl: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    ip?: string;
+    get(name: string): string | undefined;
+}
+interface ExpressResponse {
+    statusCode: number;
+    getHeader(name: string): string | number | string[] | undefined;
+    on(event: string, callback: () => void): void;
+}
+type ExpressNextFunction = (err?: unknown) => void;
+type ExpressMiddleware = (req: ExpressRequest, res: ExpressResponse, next: ExpressNextFunction) => void;
+type AgentStatus = 'active' | 'paused' | 'killed';
+type BreakerType = 'spend_limit' | 'rate_limit' | 'error_limit';
+type BreakerAction = 'block' | 'alert' | 'throttle';
+type TransactionType = 'deposit' | 'withdrawal' | 'spend' | 'earning' | 'allocation';
+type TransactionStatus = 'pending' | 'confirmed' | 'failed';
+interface AgentRow {
+    id: string;
+    user_id: string;
+    agent_id: string;
+    name: string | null;
+    description: string | null;
+    status: AgentStatus;
+    balance: number;
+    total_requests: number;
+    total_spent: number;
+    error_rate: number;
+    avg_response_time: number;
+    last_seen_at: string | null;
+    first_seen_at: string;
+    created_at: string;
+    updated_at: string;
+    metadata: Record<string, unknown>;
+}
+interface AgentActionRow {
+    id: string;
+    user_id: string;
+    agent_db_id: string;
+    action_type: string;
+    task_id: string | null;
+    details: Record<string, unknown>;
+    created_at: string;
+}
+interface AgentHeartbeatRow {
+    id: string;
+    user_id: string;
+    agent_db_id: string;
+    status: 'healthy' | 'degraded' | 'error';
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+interface CircuitBreakerRow {
+    id: string;
+    user_id: string;
+    agent_db_id: string | null;
+    breaker_type: BreakerType;
+    threshold: number;
+    window_minutes: number;
+    action: BreakerAction;
+    enabled: boolean;
+    tripped: boolean;
+    tripped_at: string | null;
+    reset_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface TransactionRow {
+    id: string;
+    user_id: string;
+    type: TransactionType;
+    amount: number;
+    description: string | null;
+    agent_id: string | null;
+    tx_hash: string | null;
+    chain: string | null;
+    status: TransactionStatus;
+    created_at: string;
+}
+
+export type { Analytix402Config as A, BatchPayload as B, CircuitBreakerRow as C, ExpressMiddleware as E, HeartbeatEvent as H, LLMUsageEvent as L, PaymentInfo as P, RequestEvent as R, TaskOutcome as T, Analytix402Client as a, AgentActionRow as b, AgentHeartbeatRow as c, AgentRow as d, AgentStatus as e, BreakerAction as f, BreakerType as g, ExpressNextFunction as h, ExpressRequest as i, ExpressResponse as j, RequestInfo as k, ResponseInfo as l, TaskTracker as m, TransactionRow as n, TransactionStatus as o, TransactionType as p };

package/dist/types-C67qDpYb.d.ts

@@ -0,0 +1,290 @@
+/**
+ * Analytix402 SDK Types
+ */
+interface Analytix402Config {
+    /**
+     * Your Analytix402 API key (starts with ax_live_ or ax_test_)
+     */
+    apiKey: string;
+    /**
+     * Base URL for the Analytix402 API
+     * @default "https://analytix402.com"
+     */
+    baseUrl?: string;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Maximum number of events to batch before sending
+     * @default 100
+     */
+    batchSize?: number;
+    /**
+     * Maximum time (ms) to wait before flushing events
+     * @default 5000
+     */
+    flushInterval?: number;
+    /**
+     * Maximum number of retry attempts for failed requests
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Maximum events to queue when offline
+     * @default 1000
+     */
+    maxQueueSize?: number;
+    /**
+     * Request timeout in milliseconds
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * Paths to exclude from tracking (supports wildcards)
+     * @default ["/health", "/healthz", "/ready", "/metrics"]
+     */
+    excludePaths?: string[];
+    /**
+     * Custom function to extract endpoint name from request
+     */
+    getEndpointName?: (req: RequestInfo) => string;
+    /**
+     * Custom function to determine if request should be tracked
+     */
+    shouldTrack?: (req: RequestInfo) => boolean;
+    /**
+     * Agent identifier for multi-agent tracking
+     */
+    agentId?: string;
+    /**
+     * Agent friendly name
+     */
+    agentName?: string;
+    /**
+     * Automatically send a heartbeat on client creation to register
+     * the agent in the dashboard immediately.
+     * @default false
+     */
+    autoConnect?: boolean;
+    /**
+     * Interval in milliseconds to send periodic heartbeats.
+     * Set to 0 to disable. Requires agentId.
+     * @default 0
+     */
+    heartbeatIntervalMs?: number;
+}
+interface RequestEvent {
+    type: 'request';
+    method: string;
+    path: string;
+    endpoint?: string;
+    statusCode: number;
+    responseTimeMs: number;
+    payment?: PaymentInfo;
+    /** Agent identifier */
+    agentId?: string;
+    /** Task identifier for grouping actions */
+    taskId?: string;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+    ip?: string;
+    userAgent?: string;
+}
+interface PaymentInfo {
+    /** Payment amount */
+    amount: string;
+    /** Currency (e.g., "USDC") */
+    currency: string;
+    /** Payer wallet address */
+    wallet: string;
+    /** Payment status */
+    status: 'success' | 'failed' | 'pending';
+    /** Transaction hash if available */
+    txHash?: string;
+    /** Facilitator URL */
+    facilitator?: string;
+}
+interface HeartbeatEvent {
+    type: 'heartbeat';
+    agentId: string;
+    status: 'healthy' | 'degraded' | 'error';
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+}
+interface TaskOutcome {
+    type: 'task_outcome';
+    agentId?: string;
+    taskId: string;
+    success: boolean;
+    durationMs?: number;
+    cost?: number;
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+}
+interface LLMUsageEvent {
+    type: 'llm_usage';
+    agentId?: string;
+    taskId?: string;
+    model: string;
+    provider: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costUsd?: number;
+    durationMs?: number;
+    metadata?: Record<string, unknown>;
+    timestamp: string;
+}
+interface BatchPayload {
+    events: (RequestEvent | HeartbeatEvent | TaskOutcome | LLMUsageEvent)[];
+    sdk: {
+        name: string;
+        version: string;
+    };
+    sentAt: string;
+}
+interface RequestInfo {
+    method: string;
+    path: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    ip?: string;
+}
+interface ResponseInfo {
+    statusCode: number;
+    headers: Record<string, string | string[] | undefined>;
+}
+interface Analytix402Client {
+    /**
+     * Track a request event
+     */
+    track(event: RequestEvent): void;
+    /**
+     * Flush all queued events immediately
+     */
+    flush(): Promise<void>;
+    /**
+     * Shutdown the client gracefully
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Send a heartbeat signal
+     */
+    heartbeat(status?: 'healthy' | 'degraded' | 'error', metadata?: Record<string, unknown>): void;
+    /**
+     * Report a task outcome
+     */
+    reportOutcome(taskId: string, success: boolean, options?: {
+        durationMs?: number;
+        cost?: number;
+        metadata?: Record<string, unknown>;
+    }): void;
+    /**
+     * Start a task and return a task tracker
+     */
+    startTask(taskId?: string): TaskTracker;
+    /** Track LLM token usage */
+    trackLLM(usage: {
+        model: string;
+        provider: string;
+        inputTokens: number;
+        outputTokens: number;
+        costUsd?: number;
+        durationMs?: number;
+        taskId?: string;
+        metadata?: Record<string, unknown>;
+    }): void;
+}
+interface TaskTracker {
+    taskId: string;
+    /** End the task and report outcome */
+    end(success: boolean, metadata?: Record<string, unknown>): void;
+}
+interface ExpressRequest {
+    method: string;
+    path: string;
+    originalUrl: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    ip?: string;
+    get(name: string): string | undefined;
+}
+interface ExpressResponse {
+    statusCode: number;
+    getHeader(name: string): string | number | string[] | undefined;
+    on(event: string, callback: () => void): void;
+}
+type ExpressNextFunction = (err?: unknown) => void;
+type ExpressMiddleware = (req: ExpressRequest, res: ExpressResponse, next: ExpressNextFunction) => void;
+type AgentStatus = 'active' | 'paused' | 'killed';
+type BreakerType = 'spend_limit' | 'rate_limit' | 'error_limit';
+type BreakerAction = 'block' | 'alert' | 'throttle';
+type TransactionType = 'deposit' | 'withdrawal' | 'spend' | 'earning' | 'allocation';
+type TransactionStatus = 'pending' | 'confirmed' | 'failed';
+interface AgentRow {
+    id: string;
+    user_id: string;
+    agent_id: string;
+    name: string | null;
+    description: string | null;
+    status: AgentStatus;
+    balance: number;
+    total_requests: number;
+    total_spent: number;
+    error_rate: number;
+    avg_response_time: number;
+    last_seen_at: string | null;
+    first_seen_at: string;
+    created_at: string;
+    updated_at: string;
+    metadata: Record<string, unknown>;
+}
+interface AgentActionRow {
+    id: string;
+    user_id: string;
+    agent_db_id: string;
+    action_type: string;
+    task_id: string | null;
+    details: Record<string, unknown>;
+    created_at: string;
+}
+interface AgentHeartbeatRow {
+    id: string;
+    user_id: string;
+    agent_db_id: string;
+    status: 'healthy' | 'degraded' | 'error';
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+interface CircuitBreakerRow {
+    id: string;
+    user_id: string;
+    agent_db_id: string | null;
+    breaker_type: BreakerType;
+    threshold: number;
+    window_minutes: number;
+    action: BreakerAction;
+    enabled: boolean;
+    tripped: boolean;
+    tripped_at: string | null;
+    reset_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface TransactionRow {
+    id: string;
+    user_id: string;
+    type: TransactionType;
+    amount: number;
+    description: string | null;
+    agent_id: string | null;
+    tx_hash: string | null;
+    chain: string | null;
+    status: TransactionStatus;
+    created_at: string;
+}
+
+export type { Analytix402Config as A, BatchPayload as B, CircuitBreakerRow as C, ExpressMiddleware as E, HeartbeatEvent as H, LLMUsageEvent as L, PaymentInfo as P, RequestEvent as R, TaskOutcome as T, Analytix402Client as a, AgentActionRow as b, AgentHeartbeatRow as c, AgentRow as d, AgentStatus as e, BreakerAction as f, BreakerType as g, ExpressNextFunction as h, ExpressRequest as i, ExpressResponse as j, RequestInfo as k, ResponseInfo as l, TaskTracker as m, TransactionRow as n, TransactionStatus as o, TransactionType as p };

package/dist/wrappers/anthropic.d.mts

@@ -0,0 +1,67 @@
+import { A as Analytix402Config, a as Analytix402Client } from '../types-C67qDpYb.mjs';
+
+/**
+ * Analytix402 Anthropic Wrapper
+ *
+ * Auto-instruments Anthropic SDK calls to track LLM usage,
+ * costs, and latency through Analytix402.
+ *
+ * @example
+ * ```typescript
+ * import Anthropic from '@anthropic-ai/sdk';
+ * import { withAnalytix } from '@analytix402/sdk/anthropic';
+ *
+ * const anthropic = withAnalytix(new Anthropic(), {
+ *   apiKey: 'ax_live_your_key_here',
+ * });
+ *
+ * // All calls are now auto-tracked
+ * const msg = await anthropic.messages.create({
+ *   model: 'claude-sonnet-4-5-20250929',
+ *   max_tokens: 1024,
+ *   messages: [{ role: 'user', content: 'Hello' }],
+ * });
+ * ```
+ */
+
+/** Minimal Anthropic SDK shape — avoids hard dependency on the @anthropic-ai/sdk package. */
+interface AnthropicUsage {
+    input_tokens: number;
+    output_tokens: number;
+}
+interface AnthropicMessage {
+    id?: string;
+    model?: string;
+    type?: string;
+    usage?: AnthropicUsage;
+    [key: string]: unknown;
+}
+interface AnthropicMessages {
+    create(body: Record<string, unknown>, options?: Record<string, unknown>): Promise<AnthropicMessage>;
+}
+interface AnthropicLike {
+    messages: AnthropicMessages;
+    [key: string]: unknown;
+}
+interface AnthropicWrapperOptions extends Analytix402Config {
+    /**
+     * Override cost table (USD per 1 million tokens).
+     * Keys are model names; values have `input` and `output` fields.
+     */
+    costPerMillionTokens?: Record<string, {
+        input: number;
+        output: number;
+    }>;
+}
+/**
+ * Wrap an Anthropic SDK instance to auto-track LLM usage via Analytix402.
+ *
+ * Returns a proxied instance — the original is not mutated.
+ */
+declare function withAnalytix<T extends AnthropicLike>(anthropic: T, options: AnthropicWrapperOptions): T;
+/**
+ * Access the Analytix402 client from a wrapped Anthropic instance.
+ */
+declare function getAnalytixClient(anthropic: AnthropicLike): Analytix402Client | undefined;
+
+export { type AnthropicWrapperOptions, getAnalytixClient, withAnalytix };

package/dist/wrappers/anthropic.d.ts

@@ -0,0 +1,67 @@
+import { A as Analytix402Config, a as Analytix402Client } from '../types-C67qDpYb.js';
+
+/**
+ * Analytix402 Anthropic Wrapper
+ *
+ * Auto-instruments Anthropic SDK calls to track LLM usage,
+ * costs, and latency through Analytix402.
+ *
+ * @example
+ * ```typescript
+ * import Anthropic from '@anthropic-ai/sdk';
+ * import { withAnalytix } from '@analytix402/sdk/anthropic';
+ *
+ * const anthropic = withAnalytix(new Anthropic(), {
+ *   apiKey: 'ax_live_your_key_here',
+ * });
+ *
+ * // All calls are now auto-tracked
+ * const msg = await anthropic.messages.create({
+ *   model: 'claude-sonnet-4-5-20250929',
+ *   max_tokens: 1024,
+ *   messages: [{ role: 'user', content: 'Hello' }],
+ * });
+ * ```
+ */
+
+/** Minimal Anthropic SDK shape — avoids hard dependency on the @anthropic-ai/sdk package. */
+interface AnthropicUsage {
+    input_tokens: number;
+    output_tokens: number;
+}
+interface AnthropicMessage {
+    id?: string;
+    model?: string;
+    type?: string;
+    usage?: AnthropicUsage;
+    [key: string]: unknown;
+}
+interface AnthropicMessages {
+    create(body: Record<string, unknown>, options?: Record<string, unknown>): Promise<AnthropicMessage>;
+}
+interface AnthropicLike {
+    messages: AnthropicMessages;
+    [key: string]: unknown;
+}
+interface AnthropicWrapperOptions extends Analytix402Config {
+    /**
+     * Override cost table (USD per 1 million tokens).
+     * Keys are model names; values have `input` and `output` fields.
+     */
+    costPerMillionTokens?: Record<string, {
+        input: number;
+        output: number;
+    }>;
+}
+/**
+ * Wrap an Anthropic SDK instance to auto-track LLM usage via Analytix402.
+ *
+ * Returns a proxied instance — the original is not mutated.
+ */
+declare function withAnalytix<T extends AnthropicLike>(anthropic: T, options: AnthropicWrapperOptions): T;
+/**
+ * Access the Analytix402 client from a wrapped Anthropic instance.
+ */
+declare function getAnalytixClient(anthropic: AnthropicLike): Analytix402Client | undefined;
+
+export { type AnthropicWrapperOptions, getAnalytixClient, withAnalytix };