Skip to content
Python
2.8 KB
Raw Blame
export interface TraceAdapter {
  timeline(query: {
    sessionId: string;
    turnId: string;
    after?: number;
    through?: number;
    limit?: number;
  }): Promise<unknown>;
  summary(query: {
    sessionId: string;
    turnId: string;
    through?: number;
  }): Promise<unknown>;
  children?(query: { sessionId: string; turnId: string }): Promise<unknown>;
  subtreeSummary?(query: {
    sessionId: string;
    turnId: string;
  }): Promise<unknown>;
  evaluations?(query: {
    sessionId: string;
    turnId: string;
    limit?: number;
  }): Promise<unknown>;
}
export interface ChildLink {
  child_session_id: string;
  child_turn_id: string | null;
  agent_id: string;
  phase: string;
}
export function mountTurnTrace(
  root: HTMLElement,
  options: {
    adapter: TraceAdapter;
    sessionId: string;
    turnId: string;
    onChild?: (child: ChildLink) => void;
  },
): { refresh(): void; dispose(): void };
export function mountObservability(
  root: HTMLElement,
  options: {
    request: (path: string, signal?: AbortSignal) => Promise<any>;
    isAdmin?: boolean;
    initialRun?: { session_id: string; turn_id: string } | null;
    directory?: boolean;
    openSession?: boolean;
    children?: boolean;
  },
): () => void;

export interface SessionTracingAdapter {
  search?(
    query: { q?: string; after?: string },
    signal?: AbortSignal,
  ): Promise<{ runs: TraceRun[]; next_cursor: string | null }>;
  turns(
    query: { sessionId: string; after?: string | number },
    signal?: AbortSignal,
  ): Promise<{ turns: TraceRun[]; next_cursor: string | number | null }>;
  timeline(
    query: {
      sessionId: string;
      turnId: string;
      after?: number;
      through?: number;
      limit?: number;
    },
    signal?: AbortSignal,
  ): Promise<any>;
  summary(
    query: { sessionId: string; turnId: string },
    signal?: AbortSignal,
  ): Promise<any>;
  children?(
    query: { sessionId: string; turnId: string },
    signal?: AbortSignal,
  ): Promise<{ children: any[] }>;
  /** Backend-authorized, explicitly captured payloads, correlated to this exact span. */
  stepDetails?(
    query: {
      sessionId: string;
      turnId: string;
      traceId: string;
      spanId: string;
    },
    signal?: AbortSignal,
  ): Promise<{ input?: unknown; output?: unknown }>;
}
export interface TraceRun {
  session_id: string;
  turn_id: string;
  name?: string;
  agent?: string;
  status?: string;
  created_ms?: number;
  label?: string;
}
export function mountSessionTracing(
  root: HTMLElement,
  options: {
    adapter: SessionTracingAdapter;
    initialRun?: TraceRun;
    onOverview?: () => void;
  },
): { refresh(): Promise<void>; dispose(): void };
export function serviceTracingAdapter(
  request: (path: string, signal?: AbortSignal) => Promise<any>,
): SessionTracingAdapter;