@metrevals/inspect-scout-viewer 0.3.153-beta.1765542109 → 0.4.4-beta.20251223202036

package/lib/types/index.d.ts

@@ -1,8 +1,4 @@
 import { ChatMessageAssistant, ChatMessageSystem, ChatMessageTool, ChatMessageUser, ContentImage, ContentText, Events } from './log';
-export interface Scans {
-    results_dir: string;
-    scans: Status[];
-}
 export interface Status {
     complete: boolean;
     spec: ScanSpec;
@@ -32,12 +28,6 @@ export interface Model {
     config: Record<string, unknown>;
     args: Record<string, unknown>;
 }
-export interface Transcript {
-    type: string;
-    count: number;
-    data: string;
-    fields: Array<Record<string, string>>;
-}
 export interface ScanSpec {
     scan_file?: string;
     scan_id: string;
@@ -50,7 +40,12 @@ export interface ScanSpec {
     packages?: Record<string, unknown>;
     revision?: Record<string, unknown>;
     scanners: Record<string, Scanner>;
-    transcripts?: Transcript;
+    transcripts?: {
+        type: string;
+        location?: string;
+        transcript_ids: Record<string, string | null>;
+        count?: number;
+    };
 }
 export interface Scanner {
     name: string;
@@ -64,6 +59,7 @@ export interface ScannerSummary {
     tokens: number;
     model_usage: Record<string, ModelUsage>;
     validations: Array<boolean | Record<string, boolean>>;
+    metrics: Record<string, Record<string, number>>;
 }
 export interface ModelUsage {
     input_tokens: number;
@@ -75,25 +71,44 @@ export interface ModelUsage {
 }
 export type ChatMessages = ChatMessage[];
 export type ChatMessage = ChatMessageSystem | ChatMessageUser | ChatMessageAssistant | ChatMessageTool;
-export interface Transcript {
+export interface TranscriptInfo {
     id: string;
     source_id: string;
-    source_url: string;
+    source_uri: string;
+    source_type: string;
+    filename?: string;
+    date?: string;
+    task_set?: string;
+    task_id?: string;
+    task_repeat?: number;
+    agent?: string;
+    agent_args?: string;
+    model?: string;
+    model_options?: string;
+    score?: string;
+    success?: boolean;
+    total_time?: number;
+    total_tokens?: number;
+    error?: string;
+    limit?: string;
+    metadata: TranscriptMetadata;
+}
+export interface Transcript extends TranscriptInfo {
     messages: ChatMessages;
     events: Events;
-    metadata: TranscriptMetadata;
 }
 export interface TranscriptMetadata {
-    sample_id: string;
-    id: string | number;
-    epoch: number;
-    eval_id: string;
-    log: string;
-    eval_created: string;
-    eval_metadata: Record<string, unknown>;
-    task_name: string;
-    model: string;
-    score: string;
+    sample_id?: string;
+    id?: string | number;
+    epoch?: number;
+    eval_id?: string;
+    log?: string;
+    date?: string;
+    eval_metadata?: Record<string, unknown>;
+    task?: string;
+    task_name?: string;
+    model?: string;
+    score?: string;
     [key: string]: unknown;
 }
 export interface ContentTool {

package/lib/utils/asyncData.d.ts

@@ -0,0 +1,66 @@
+import { Brand } from './brand';
+/**
+ * AsyncData represents the possible states of some asynchronous operation like
+ * a network request to an API. When the request is first made, it's `loading`, but
+ * once we get a response, it will either represent the requested `data` or maybe
+ * the operation failed due to an `error`.
+ *
+ * @typeParam T - the data that will be returned
+ */
+export type AsyncData<T> = AsyncDataLoading | AsyncDataNotLoading<T>;
+export type AsyncDataLoading = Brand<{
+    data?: undefined;
+    loading: true;
+    error?: undefined;
+}, "_please_use_AsyncData.loading_rather_than_your_own_instance_of_this_type_">;
+/**
+ * The different states the async data can be in when loading is finished.
+ *
+ * @typeParam T - the data type that can be returned when error is undefined
+ */
+export type AsyncDataNotLoading<T> = {
+    data: T;
+    loading: false;
+    error?: undefined;
+} | {
+    data?: undefined;
+    loading: false;
+    error: Error;
+};
+type AsyncDataMap<Mapping> = {
+    [K in keyof Mapping]: AsyncData<Mapping[K]>;
+};
+/**
+ * The `compose` function allows a set of `AsyncData` values to be combined into
+ * a single `AsyncData`. The complex type of the function represents a transformation
+ * from an argument like this...
+ *
+ * ```typescript
+ *   { a: AsyncData<A>, b: AsyncData<B>, c: AsyncData<C> }
+ *```
+ * ...to a return value like this...
+ *```
+ *   AsyncData<{ a: A, b: B, c: C }>
+ *```
+ *
+ * In practice, this can be used to create hooks that depend on multiple API
+ * calls.
+ *
+ */
+export declare function compose<Mapping>(hooks: AsyncDataMap<Mapping>): AsyncData<Mapping>;
+/**
+ * The `data` function wraps the provided data in an `AsyncData` object, indicating
+ * that the data is not loading and there is no error.
+ *
+ * @template T - The type of the data
+ * @param {T} data - The data to wrap
+ * @returns {AsyncData<T>} - An `AsyncData` object with `loading` set to `false`
+ * and `data` set to the provided data
+ */
+export declare function data<T>(data: T): AsyncData<T>;
+/**
+ * The `loading` constant is an instance of `AsyncDataLoading` that can be shared
+ * to provide identity stability. It represents the state when the data is loading.
+ */
+export declare const loading: AsyncDataLoading;
+export {};

package/lib/utils/asyncDataFromQuery.d.ts

@@ -0,0 +1,13 @@
+import { QueryKey, UseQueryOptions } from '@tanstack/react-query';
+import { AsyncData } from './asyncData';
+/**
+ * Custom hook that retrieves data using `useQuery` from the `@tanstack/react-query`
+ * library. It wraps the `QueryResult` from the hook in a simpler `AsyncData`.
+ *
+ * @param options - An object of type `UseQueryOptions`.
+ * @returns An object of type `AsyncData`. If the query is pending, it returns a
+ * loading state. If there's an error, it returns an object with the error and loading
+ * state as false. If the query is successful, it returns the data and loading state
+ * as false.
+ */
+export declare function useAsyncDataFromQuery<TQueryFnData = unknown, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey>(options: UseQueryOptions<TQueryFnData, Error, TData, TQueryKey>): AsyncData<TData>;

package/lib/utils/brand.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Branded types for nominal typing in TypeScript.
+ *
+ * Branded types create distinct types from the same base type,
+ * preventing accidental misuse at compile time with zero runtime overhead.
+ *
+ * @example
+ * ```ts
+ * type UserId = Brand<number, "UserId">;
+ * type PostId = Brand<number, "PostId">;
+ *
+ * const makeUserId = make<UserId>();
+ * const makePostId = make<PostId>();
+ *
+ * const userId = makeUserId(42);
+ * const postId = makePostId(42);
+ * getUser(postId);  // ✗ compile error - PostId !== UserId
+ * ```
+ *
+ * @module
+ */
+declare const __brand: unique symbol;
+/**
+ * Creates a branded type from a base type.
+ *
+ * The brand exists only at compile time—no runtime overhead.
+ *
+ * @typeParam Base - The underlying primitive or object type
+ * @typeParam Branding - A unique type used to distinguish this brand (often the entity type itself)
+ *
+ * @example
+ * ```ts
+ * type UserId = Brand<number, User>;
+ * type PostId = Brand<number, Post>;
+ * // UserId and PostId are incompatible even though both are numbers
+ * ```
+ */
+export type Brand<Base, Branding> = Base & {
+    [__brand]: Branding;
+};
+/**
+ * Extracts the base type from a branded type.
+ *
+ * @typeParam B - A branded type
+ * @returns The underlying base type without the brand
+ *
+ * @example
+ * ```ts
+ * type UserId = Brand<number, User>;
+ * type Base = BaseOf<UserId>;  // number
+ * ```
+ */
+type BaseOf<B extends Brand<unknown, unknown>> = Omit<B, typeof __brand>;
+/** A function that converts a base value into a branded value. */
+type Brander<B extends Brand<unknown, unknown>> = (value: BaseOf<B>) => B;
+/**
+ * Creates a brander function for a given branded type.
+ *
+ * @typeParam B - The branded type to produce
+ * @returns A function that casts base values to the branded type
+ *
+ * @example
+ * ```ts
+ * type UserId = Brand<number, "UserId">;
+ * const makeUserId = make<UserId>();
+ * const id = makeUserId(42);
+ * ```
+ */
+export declare function make<B extends Brand<unknown, unknown>>(): Brander<B>;
+export {};

package/lib/utils/path.d.ts

@@ -13,11 +13,14 @@ export declare const dirname: (path: string) => string;
 export declare const isInDirectory: (path: string, directory: string) => boolean;
 export declare const ensureTrailingSlash: (path?: string) => string;
 /**
- * Converts an absolute path to a relative path based on the results directory.
- * Handles nested subdirectories within the results directory.
- * For example: "/Users/user/scans/subdir/scan_id=123" -> "subdir/scan_id=123"
+ * Converts an absolute path to a relative path based on the basePath directory.
+ * Handles nested subdirectories within the basePath directory.
+ * For example:
+ * ```
+ * toRelativePath("/Users/user/scans/subdir/scan_id=123", "/Users/user/scans") === "subdir/scan_id=123"
+ * ```
  */
-export declare const toRelativePath: (absolutePath: string, basePath: string) => string;
+export declare const toRelativePath: (absolutePath: string | undefined, basePath: string | undefined) => string;
 /**
  * Converts a relative path to an absolute path based on the results directory.
  * For example: "subdir/scan_id=123" + "/Users/user/scans/" -> "/Users/user/scans/subdir/scan_id=123"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metrevals/inspect-scout-viewer",
-  "version": "0.3.153-beta.1765542109",
+  "version": "0.4.4-beta.20251223202036",
   "description": "Inspect Scout viewer for evaluation logs.",
   "license": "MIT",
   "type": "module",
@@ -14,25 +14,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/METR/inspect_scout",
+    "url": "https://github.com/meridianlabs-ai/inspect_scout",
     "directory": "src/inspect_scout/_view/www"
   },
-  "packageManager": "pnpm@10.20.0",
-  "scripts": {
-    "build": "npm run build:app",
-    "build:lib": "vite build --mode library",
-    "build:app": "vite build --mode development",
-    "watch": "vite build --watch",
-    "watch:dev": "NODE_ENV=development vite build --watch --mode development",
-    "dev": "vite",
-    "prepublishOnly": "pnpm build:lib",
-    "preview": "vite preview",
-    "lint": "eslint . --max-warnings 0",
-    "lint:fix": "eslint . --fix --max-warnings 0",
-    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,css,md}\"",
-    "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx,json,css,md}\"",
-    "typecheck": "tsc --noEmit",
-    "check": "pnpm lint:fix && pnpm format && pnpm typecheck"
+  "engines": {
+    "node": "22.21.1",
+    "pnpm": ">=9.0.0"
   },
   "exports": {
     ".": {
@@ -42,11 +29,13 @@
     "./styles/index.css": "./lib/styles/index.css"
   },
   "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",
+    "@testing-library/react": "^16.3.1",
     "@types/bootstrap": "^5.2.10",
     "@types/css-modules": "^1.0.5",
     "@types/eslint__js": "^9.14.0",
@@ -64,6 +53,7 @@
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
+    "jsdom": "^27.3.0",
     "postcss-url": "^10.1.3",
     "prettier": "^3.6.2",
     "react": "^19.2.0",
@@ -73,8 +63,11 @@
     "typescript": "^5.7.3",
     "typescript-eslint": "^8.46.2",
     "typescript-plugin-css-modules": "^5.2.0",
+    "@tanstack/react-query": "^5.90.12",
+    "@tanstack/react-query-devtools": "^5.91.1",
     "vite": "^7.1.5",
-    "vite-plugin-dts": "^4.3.0"
+    "vite-plugin-dts": "^4.3.0",
+    "vitest": "^4.0.16"
   },
   "dependencies": {
     "@popperjs/core": "^2.11.8",
@@ -100,9 +93,21 @@
     "react-virtuoso": "^4.14.1",
     "zustand": "^5.0.8"
   },
-  "pnpm": {
-    "overrides": {
-      "yaml": "^2.4.2"
-    }
+  "scripts": {
+    "build": "npm run build:app",
+    "build:lib": "vite build --mode library",
+    "build:app": "vite build --mode development",
+    "watch": "vite build --watch",
+    "watch:dev": "NODE_ENV=development vite build --watch --mode development",
+    "dev": "vite",
+    "preview": "vite preview",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix --max-warnings 0",
+    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,css,md}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx,json,css,md}\"",
+    "typecheck": "tsc --noEmit",
+    "check": "pnpm lint:fix && pnpm format && pnpm typecheck",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}

package/lib/app/result/ScanResultHeader.d.ts

@@ -1,7 +0,0 @@
-import { FC } from 'react';
-import { ScannerData } from '../types';
-interface ScanResultHeaderProps {
-    result?: ScannerData;
-}
-export declare const ScanResultHeader: FC<ScanResultHeaderProps>;
-export {};

package/lib/app/result/input/InputPanel.d.ts

@@ -1,6 +0,0 @@
-import { FC } from 'react';
-import { ScannerData } from '../../types';
-export interface InputPanelProps {
-    result?: ScannerData;
-}
-export declare const InputPanel: FC<InputPanelProps>;

package/lib/app/scanner/ScannerPanel.d.ts

@@ -1,2 +0,0 @@
-import { default as React } from 'react';
-export declare const ScannerPanel: React.FC;

package/lib/app/scanner/ScannerPanelBody.d.ts

@@ -1,3 +0,0 @@
-export declare const kSegmentList = "list";
-export declare const kSegmentDataframe = "dataframe";
-export declare const ScannerPanelBody: React.FC;

package/lib/app/scanner/ScannerPanelTitle.d.ts

@@ -1,2 +0,0 @@
-import { FC } from 'react';
-export declare const ScannerPanelTitle: FC;

package/lib/app/scanner/info/ScanInfo.d.ts

@@ -1,2 +0,0 @@
-import { FC } from 'react';
-export declare const ScanInfo: FC;

package/lib/app/scanner/results/ScanResultsBody.d.ts

@@ -1,2 +0,0 @@
-import { FC } from 'react';
-export declare const ScanResultsBody: FC;

package/lib/app/scanner/results/ScanResultsOutline.d.ts

@@ -1,2 +0,0 @@
-import { FC } from 'react';
-export declare const ScanResultsOutline: FC;

package/lib/app/scanner/results/ScanResultsPanel.d.ts

@@ -1,2 +0,0 @@
-import { FC } from 'react';
-export declare const ScanResultsPanel: FC;

package/lib/app/values/Explanation.d.ts

@@ -1,7 +0,0 @@
-import { FC } from 'react';
-import { ScannerCore } from '../types';
-interface ExplanationProps {
-    result?: ScannerCore;
-}
-export declare const Explanation: FC<ExplanationProps>;
-export {};

package/lib/app/values/Value.d.ts

@@ -1,10 +0,0 @@
-import { FC } from 'react';
-import { ScannerCore } from '../types';
-interface ValueProps {
-    result: ScannerCore;
-    style: "inline" | "block";
-    maxTableSize?: number;
-    interactive?: boolean;
-}
-export declare const Value: FC<ValueProps>;
-export {};