@athenaintel/react 0.10.32 → 0.10.34

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { AssistantRuntime } from '@assistant-ui/react';
+import { CaptureOptions } from 'posthog-js';
+import { CaptureResult } from 'posthog-js';
 import { ClassProp } from 'class-variance-authority/types';
-import { ClassValue } from 'clsx';
+import { cn } from 'cnfast';
 import { Collapsible as Collapsible_2 } from 'radix-ui';
 import { ComponentProps } from 'react';
 import { ComponentPropsWithRef } from 'react';
@@ -13,6 +15,8 @@ import { JSXElementConstructor } from 'react';
 import { LangChainMessage } from '@assistant-ui/react-langgraph';
 import { MessagePrimitive } from '@assistant-ui/react';
 import { PersistOptions } from 'zustand/middleware';
+import { PostHog } from 'posthog-js';
+import { Properties } from 'posthog-js';
 import * as React_2 from 'react';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
@@ -593,6 +597,8 @@ export declare const autoCloseInFlightSubgraphMessages: (msgs: readonly unknown[
 
 export declare const BrowseToolUI: ToolCallMessagePartComponent;
 
+export declare function buildCoalescedCaptureProperties(payload: CoalescedCapturePayload): Properties;
+
 export declare function Button({ className, variant, size, asChild, ...props }: React_2.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
     asChild?: boolean;
 }): JSX.Element;
@@ -602,9 +608,61 @@ export declare const buttonVariants: (props?: ({
     size?: "default" | "icon" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+declare interface CaptureGateConfig {
+    globalMaxPerWindow: number;
+    globalWindowMs: number;
+    criticalReservePerWindow: number;
+    defaultEventMaxPerWindow: number;
+    defaultEventWindowMs: number;
+    defaultDedupeWindowMs: number;
+    /** Flush coalesced buckets on this interval (ms). */
+    flushIntervalMs: number;
+    /** Flush a bucket early once it reaches this many suppressed occurrences. */
+    flushCoalesceThreshold: number;
+    eventOverrides: Record<string, CaptureGateEventOverride>;
+}
+
+declare interface CaptureGateEventOverride {
+    maxPerWindow: number;
+    windowMs: number;
+    dedupeWindowMs?: number;
+}
+
+declare type CaptureGateOutcome = {
+    action: 'emit';
+} | {
+    action: 'coalesce';
+    reason: CaptureGateSuppressReason;
+    bucketKey: string;
+};
+
+export declare interface CaptureGateSnapshot {
+    coalescedPending: number;
+    coalescedPendingByEvent: Record<string, number>;
+    emittedTotal: number;
+    coalescedTotal: number;
+    flushedCoalescedTotal: number;
+}
+
+declare type CaptureGateSuppressReason = 'global_budget' | 'event_budget' | 'dedupe';
+
+export declare function capturePosthogEvent(client: PosthogCaptureClient | null | undefined, event: string, properties?: Properties, options?: CaptureOptions): void;
+
+export declare function capturePosthogException(client: PosthogCaptureClient | null | undefined, error: Error, properties?: Properties, options?: CaptureOptions): void;
+
 export declare function clearAutoOpenedAssets(): void;
 
-export declare function cn(...inputs: ClassValue[]): string;
+export { cn }
+
+export declare interface CoalescedCapturePayload {
+    bucketKey: string;
+    event: string;
+    properties: Properties;
+    coalescedCount: number;
+    firstAt: number;
+    lastAt: number;
+    suppressionReason: CaptureGateSuppressReason;
+}
 
 export declare function Collapsible({ ...props }: React.ComponentProps<typeof Collapsible_2.Root>): JSX.Element;
 
@@ -719,6 +777,8 @@ export declare function getAssetInfo(assetId: string): {
 
 export declare const GetDatabaseTableSchemaToolUI: ToolCallMessagePartComponent;
 
+export declare function getPosthogCaptureGate(): PosthogCaptureGate;
+
 export declare function getPostHogInstance<TClient = unknown>(): TClient | null;
 
 /**
@@ -734,6 +794,8 @@ export declare const isAthenaCitationUrl: ({ href, appUrl, }: {
     appUrl?: string | null;
 }) => boolean;
 
+export declare function isCriticalPosthogEvent(event: string): boolean;
+
 /** Item cache: deduplicates items by ID, tracks scope membership */
 declare interface ItemCache {
     items: Map<string, MenuItem>;
@@ -793,6 +855,8 @@ export declare function normalizeResult(result: unknown): Record<string, unknown
 
 export declare const OpenAssetToolUI: ToolCallMessagePartComponent;
 
+export declare const OpenBrowserToolUI: ToolCallMessagePartComponent;
+
 declare interface ParentBridgeOptions {
     /**
      * Exact parent origins that are allowed to send auth/config via postMessage.
@@ -828,6 +892,34 @@ export declare interface ParsedAthenaCitationLink {
 
 declare type PartsComponents = ComponentProps<typeof MessagePrimitive.Parts>["components"];
 
+declare type PosthogCaptureClient = Pick<PostHog, 'capture'> & {
+    captureException?: (error: unknown, additionalProperties?: Properties) => CaptureResult | undefined;
+};
+
+declare class PosthogCaptureGate {
+    private readonly config;
+    private readonly globalWindow;
+    private readonly eventWindows;
+    private readonly activeDedupe;
+    private readonly coalesceBuckets;
+    private emittedTotal;
+    private coalescedTotal;
+    private flushedCoalescedTotal;
+    constructor(config?: CaptureGateConfig);
+    resetForTests(): void;
+    getSnapshot(): CaptureGateSnapshot;
+    evaluateCapture(event: string, properties?: Properties, options?: CaptureOptions, now?: number): CaptureGateOutcome;
+    /** Returns payloads ready to flush (does not mutate buckets until caller confirms). */
+    collectFlushCandidates(now?: number): CoalescedCapturePayload[];
+    /** Remove flushed bucket keys after successful emit. */
+    acknowledgeFlushed(payloads: CoalescedCapturePayload[]): void;
+    /** After coalescing, flush immediately if the bucket crossed the early threshold. */
+    takeBucketIfReady(bucketKey: string, now?: number): CoalescedCapturePayload | null;
+    /** Force-flush every pending bucket (e.g. page hide). */
+    collectAllPending(): CoalescedCapturePayload[];
+    private recordCoalesce;
+}
+
 export declare interface PostHogConfig {
     /** PostHog API key. When falsy, PostHog is disabled and the provider is a no-op. */
     apiKey?: string;
@@ -1164,6 +1256,8 @@ export declare const Toolkits: {
     readonly WEB_SEARCH: "web_search_browse_toolkit";
     /** SQL query execution. */
     readonly SQL: "sql_toolkit";
+    /** Azure Blob Storage catalog file operations. */
+    readonly AZURE_BLOB_STORAGE: "azure_blob_storage_toolkit";
     /** Document comments and collaboration. */
     readonly COMMENTS: "comments_toolkit";
     /** Visual canvas creation. */
@@ -1444,4 +1538,8 @@ export declare interface WelcomeSuggestion {
     prompt: string;
 }
 
+export declare function withCaptureGateBypass(options?: CaptureOptions): CaptureOptions;
+
+export declare function wrapPosthogClient<TClient extends PosthogCaptureClient>(client: TClient): TClient;
+
 export { }