The open-source agent harness - the runtime layer that turns an LLM into a working agent.
'use client';
import { createContext, useCallback, useContext, useEffect, useMemo, type ReactNode } from 'react';
import { bindSdkHttpTimeoutTracking } from './trackSdkHttpTimeout.js';
import type { AnalyticsEventProps, TrackAnalytics } from './types.js';
// Host owns vendor identify/group/gating; SDK only forwards (name, props) and no-ops when unset
// so tests and embeds work without a host analytics sink.
const AnalyticsContext = createContext<TrackAnalytics | null>(null);
const noopTrack: TrackAnalytics = () => {};
export function AnalyticsProvider({ track, children }: { track?: TrackAnalytics; children: ReactNode }) {
const stableTrack = useCallback<TrackAnalytics>(
(eventName, data) => {
// Fire sites call this right before the product action; a broken sink must not block it.
try {
track?.(eventName, data);
} catch (error) {
console.error('[trueforge-ui] analytics track failed', error);
}
},
[track],
);
const value = useMemo(() => (track == null ? null : stableTrack), [stableTrack, track]);
// API calls run outside React and can't read this context. Hand them the host's
// `track` here so any request that times out can send an analytics event; clear it on unmount.
useEffect(() => {
bindSdkHttpTimeoutTracking(value);
return () => bindSdkHttpTimeoutTracking(null);
}, [value]);
return <AnalyticsContext.Provider value={value}>{children}</AnalyticsContext.Provider>;
}
/** Always-safe tracker: host `track` when mounted, otherwise a no-op. */
export function useTrackAnalytics(): TrackAnalytics {
return useContext(AnalyticsContext) ?? noopTrack;
}
export type { AnalyticsEventProps, TrackAnalytics };