plato-sandbox-sdk 1.1.26 → 1.1.28

package/dist/chronos/index.d.mts

@@ -497,9 +497,10 @@ interface AuditSummaryResponse {
  *
  * Auto-generated - do not edit
  */
+
 interface AuthSessionResponse {
     authenticated: boolean;
-    user?: Record<string, unknown> | null;
+    user: PlatoUser | null;
     env?: string | null;
     api_key?: string | null;
 }
@@ -510,9 +511,10 @@ interface AuthSessionResponse {
  *
  * Auto-generated - do not edit
  */
+
 interface AuthStatusResponse {
     authenticated: boolean;
-    user?: Record<string, unknown> | null;
+    user: PlatoUser | null;
     env: string;
 }
 
@@ -590,6 +592,20 @@ interface ChildSessionSummary {
     total_cost_usd?: number | null;
 }
 
+/**
+ * ClaudeCodeOAuthRefreshRequest
+ * OAuth refresh request for Claude Code (Anthropic OAuth).
+ *
+ * Auto-generated - do not edit
+ */
+interface ClaudeCodeOAuthRefreshRequest {
+    refresh_token: string;
+    scopes: string[];
+    current_expires_at: number;
+    provider?: string | null;
+    client_id?: string | null;
+}
+
 /**
  * ClearDbResult
  * Result of clearing the database.
@@ -619,6 +635,7 @@ interface CloseSessionResponse {
  *
  * Auto-generated - do not edit
  */
+
 interface CompleteSessionRequest {
     /** Final status: 'completed', 'failed', or 'needs_human_annotation' */
     status: string;
@@ -627,7 +644,7 @@ interface CompleteSessionRequest {
     /** Error message if failed */
     error_message?: string | null;
     /** Final observation/result data from the world */
-    result?: Record<string, unknown> | null;
+    result?: Record<string, JsonValue> | null;
 }
 
 /**
@@ -1034,6 +1051,7 @@ interface CreateWorkspaceRefRequest {
     source_step_name?: string | null;
     changed?: boolean | null;
     content_hash?: string | null;
+    trigger_span_id?: string | null;
     git_hash?: string | null;
     branch?: string | null;
 }
@@ -1284,6 +1302,41 @@ interface ExperimentFileVersionUpdateRequest {
     notes?: string | null;
 }
 
+/**
+ * ExperimentLaunchConfig
+ * Structured config stored with an experiment version.
+
+Inherits all fields from LaunchJobRequest (world, tags, allow_prerelease,
+parent_session_id, preview) so the two schemas stay in sync. Adds
+extra="allow" for forward-compatibility with stored configs and a
+metadata field for experiment-specific data.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ExperimentLaunchConfig {
+    world?: WorldConfigOutput | null;
+    /** Tags for organizing/filtering sessions */
+    tags?: string[] | null;
+    /** Allow prerelease versions (dev, alpha, beta, rc) for packages */
+    allow_prerelease?: boolean | null;
+    /** Parent session ID for nested sessions */
+    parent_session_id?: string | null;
+    /** Optional preview-mode launch settings */
+    preview?: PreviewLaunchConfig | null;
+    metadata?: Record<string, JsonValue> | null;
+}
+
+/**
+ * ExperimentSessionCountResponse
+ *
+ * Auto-generated - do not edit
+ */
+interface ExperimentSessionCountResponse {
+    total_experiment_sessions?: number | null;
+    experiments_with_sessions?: number | null;
+}
+
 /**
  * ExperimentSessionSummary
  * Session attached to an experiment file version.
@@ -1315,7 +1368,7 @@ interface ExperimentVersionResponse {
     created_at: string;
     created_by?: UserInfo | null;
     attached_session_count?: number | null;
-    config_json?: Record<string, unknown> | null;
+    config_json?: ExperimentLaunchConfig | null;
     attached_sessions?: ExperimentSessionSummary[] | null;
 }
 
@@ -1331,6 +1384,14 @@ interface FeatureFlagCheckResult {
     org_id: number;
 }
 
+/**
+ * FeedbackWidget
+ * Available feedback input widgets for review model feedback fields.
+ *
+ * Auto-generated - do not edit
+ */
+type FeedbackWidget = 'text' | 'textarea' | 'select' | 'boolean' | 'rating' | 'agree_disagree';
+
 /**
  * FindOrCreateReviewRequest
  *
@@ -1350,6 +1411,16 @@ interface HTTPValidationError {
     detail?: ValidationError[] | null;
 }
 
+/**
+ * JsonValue
+ * Recursive JSON-compatible value type.
+ *
+ * Auto-generated - do not edit
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+
 /**
  * HillclimbRunResponse
  *
@@ -1379,6 +1450,19 @@ interface IssueReference {
     url?: string | null;
 }
 
+/**
+ * LaunchExperimentRequest
+ * Request to launch a session from an experiment version.
+
+The full config (including world.runtime and tags) is pulled from the experiment
+version's config_json in the database. No frontend logic needed - just pass the
+version ID.
+ *
+ * Auto-generated - do not edit
+ */
+interface LaunchExperimentRequest {
+}
+
 /**
  * LaunchJobRequest
  * Request to launch a job directly (image-based, no runtime artifacts).
@@ -1388,7 +1472,7 @@ interface IssueReference {
 
 interface LaunchJobRequest {
     /** World package, image, and configuration */
-    world: WorldConfig;
+    world: WorldConfigInput;
     /** Tags for organizing/filtering sessions */
     tags?: string[] | null;
     /** Allow prerelease versions (dev, alpha, beta, rc) for packages */
@@ -1469,6 +1553,37 @@ interface ModelRef {
     model?: string | null;
 }
 
+/**
+ * OAuthRefreshResponse
+ * Response with refreshed OAuth credentials.
+ *
+ * Auto-generated - do not edit
+ */
+interface OAuthRefreshResponse {
+    access_token: string;
+    refresh_token: string;
+    expires_at: number;
+    scopes: string[];
+    already_refreshed?: boolean | null;
+}
+
+/**
+ * OTelMetricDataPoint
+ * One OTLP metric datapoint returned by Chronos.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface OTelMetricDataPoint {
+    name: string;
+    unit: string;
+    env_alias: string | null;
+    job_id: string;
+    value: number | null;
+    time_unix_nano: string | null;
+    attributes: Record<string, JsonValue>;
+}
+
 /**
  * OTelSpanListResponse
  * List of OTel spans.
@@ -1535,6 +1650,22 @@ interface PerAgentReport {
     model_recommendation?: string | null;
 }
 
+/**
+ * PlatoUser
+ * User from Plato API.
+ *
+ * Auto-generated - do not edit
+ */
+interface PlatoUser {
+    id: number;
+    public_id: string;
+    email: string;
+    name?: string | null;
+    organization_id?: number | null;
+    organization_name?: string | null;
+    is_org_key?: boolean | null;
+}
+
 /**
  * PreservationRuleSet
  *
@@ -1671,6 +1802,14 @@ interface RejectRunRequest {
     reason?: string | null;
 }
 
+/**
+ * RenderWidget
+ * Available render widgets for review model fields.
+ *
+ * Auto-generated - do not edit
+ */
+type RenderWidget = 'score_bar' | 'pass_fail_badge' | 'severity_badge' | 'code_snippet' | 'markdown' | 'json_tree' | 'link' | 'tag_list' | 'image' | 'diff' | 'table' | 'hidden';
+
 /**
  * ReviewIssue
  *
@@ -1722,6 +1861,20 @@ interface ReviewResponse {
     session?: SessionSummary | null;
 }
 
+/**
+ * ReviewWidgetSchemaResponse
+ * Schema of available widgets for review models.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ReviewWidgetSchemaResponse {
+    /** Available render widgets for display fields */
+    render_widgets: RenderWidget[];
+    /** Available feedback input widgets */
+    feedback_widgets: FeedbackWidget[];
+}
+
 /**
  * RunLifecycle
  *
@@ -1764,9 +1917,10 @@ interface SSOLoginRequest {
  *
  * Auto-generated - do not edit
  */
+
 interface SavedFilterCreate {
     name: string;
-    filters: Record<string, string | string[] | null>;
+    filters: SavedSessionFilters;
 }
 
 /**
@@ -1786,13 +1940,33 @@ interface SavedFilterListResponse {
  *
  * Auto-generated - do not edit
  */
+
 interface SavedFilterResponse {
     id: number;
     name: string;
-    filters: Record<string, string | string[] | null>;
+    filters: SavedSessionFilters;
     created_at: string;
 }
 
+/**
+ * SavedSessionFilters
+ * Structured saved filters for session list views.
+
+Uses ``extra="allow"`` so that filters stored in the database with
+additional keys (e.g. future filter fields) do not cause validation
+errors when read back.
+ *
+ * Auto-generated - do not edit
+ */
+interface SavedSessionFilters {
+    tag?: string | null;
+    tags?: string[] | null;
+    tags_mode?: string | null;
+    exclude_tags?: string[] | null;
+    created_by?: string | null;
+    status?: string | null;
+}
+
 /**
  * ServiceStatuses
  * Status of connected services.
@@ -1805,6 +1979,21 @@ interface ServiceStatuses {
     plato: string;
 }
 
+/**
+ * SessionCheckpointInfoResponse
+ * Checkpoint metadata and snapshots for a session.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SessionCheckpointInfoResponse {
+    session_id: string;
+    workspaces: Record<string, string>;
+    snapshots: WorkspaceSnapshotInfo[];
+    resumable_steps: number[];
+    state_keys: string[];
+}
+
 /**
  * SessionCostEntry
  * Lightweight session entry for cost aggregation.
@@ -1855,6 +2044,20 @@ interface SessionEnvsResponse {
     envs: EnvInfoResponse[];
 }
 
+/**
+ * SessionLaunchConfig
+ * Explicit launch config projection for frontend consumers.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SessionLaunchConfig {
+    package: string;
+    version?: string | null;
+    config?: Record<string, JsonValue> | null;
+    runtime?: Record<string, JsonValue> | null;
+}
+
 /**
  * SessionLineageEntry
  * One entry in a session lineage chain.
@@ -1908,6 +2111,18 @@ interface SessionLogsResponse {
     audit_events?: Record<string, AuditEventResponse[]> | null;
 }
 
+/**
+ * SessionMetricsResponse
+ * OTel metrics response for a session.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SessionMetricsResponse {
+    session_id: string;
+    data_points: OTelMetricDataPoint[];
+}
+
 /**
  * SessionNoteUserRef
  *
@@ -1965,9 +2180,10 @@ interface SessionResponse {
     ended_at: string | null;
     created_at: string;
     world?: SessionWorldInfo | null;
-    world_config?: Record<string, unknown> | null;
-    trajectory?: Record<string, unknown> | null;
-    result?: Record<string, unknown> | null;
+    launch_config?: SessionLaunchConfig | null;
+    world_config?: SessionStoredWorldConfig | null;
+    trajectory?: Record<string, JsonValue> | null;
+    result?: Record<string, JsonValue> | null;
     total_cost_usd?: number | null;
     logs_url?: string | null;
     tags?: string[] | null;
@@ -2101,7 +2317,7 @@ interface SessionReviewerSpanNote {
     source?: string | null;
     atif_step_id?: number | null;
     model_name?: string | null;
-    metadata?: Record<string, unknown> | null;
+    metadata?: Record<string, JsonValue> | null;
     created_at?: string | null;
     updated_at?: string | null;
     created_by?: SessionNoteUserRef | null;
@@ -2129,6 +2345,21 @@ interface SessionStatusResponse {
     status_reason?: string | null;
 }
 
+/**
+ * SessionStoredWorldConfig
+ * Stored session world config shape used in session responses.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SessionStoredWorldConfig {
+    package?: string | null;
+    version?: string | null;
+    config?: Record<string, JsonValue> | null;
+    runtime?: Record<string, JsonValue> | null;
+    preview?: Record<string, JsonValue> | null;
+}
+
 /**
  * SessionSummary
  * Lightweight session info embedded in review responses.
@@ -2179,11 +2410,12 @@ interface SessionTrajectory {
  *
  * Auto-generated - do not edit
  */
+
 interface SessionWorldInfo {
     name: string;
     package_name: string;
     version?: string | null;
-    config_schema?: Record<string, unknown> | null;
+    config_schema?: WorldConfigSchema | null;
 }
 
 /**
@@ -2450,7 +2682,7 @@ interface TrajectoryToolCall {
 interface TrajectoryWorldInfo {
     name?: string | null;
     version?: string | null;
-    config?: Record<string, unknown> | null;
+    config?: Record<string, JsonValue> | null;
     observation?: string | null;
     steps?: WorldStep[] | null;
 }
@@ -2560,6 +2792,7 @@ interface UpdateSettingRequest {
  *
  * Auto-generated - do not edit
  */
+
 interface UpdateSpanNoteRequest {
     /** User-authored note text. Empty/null removes the span note. */
     note?: string | null;
@@ -2574,7 +2807,7 @@ interface UpdateSpanNoteRequest {
     /** LLM model name when available */
     model_name?: string | null;
     /** Additional structured metadata for later querying */
-    metadata?: Record<string, unknown> | null;
+    metadata?: Record<string, JsonValue> | null;
 }
 
 /**
@@ -2607,7 +2840,10 @@ interface UpdateTagsRequest {
 
 interface UsageStatsResponse {
     leaderboard: UserLeaderboardEntry[];
+    world_leaderboard: WorldLeaderboardEntry[];
     daily_usage: DailyUsageBucketResponse[];
+    experiment_sessions: ExperimentSessionCountResponse;
+    user_world_stats?: UserWorldStatsEntry[] | null;
 }
 
 /**
@@ -2647,6 +2883,22 @@ interface UserLeaderboardEntry {
     last_session_at?: string | null;
 }
 
+/**
+ * UserWorldStatsEntry
+ *
+ * Auto-generated - do not edit
+ */
+interface UserWorldStatsEntry {
+    user_id: string;
+    world_package: string;
+    world_version?: string | null;
+    total_sessions?: number | null;
+    completed_sessions?: number | null;
+    failed_sessions?: number | null;
+    total_cost_usd?: number | null;
+    total_vm_hours?: number | null;
+}
+
 /**
  * VMResources
  * VM resource configuration.
@@ -2720,6 +2972,7 @@ interface WorkspaceRefResponse {
     changed?: boolean | null;
     content_hash?: string | null;
     dvc_files?: Record<string, string> | null;
+    trigger_span_id?: string | null;
     git_hash?: string | null;
     branch?: string | null;
     created_at: string;
@@ -2835,6 +3088,43 @@ interface WorkspaceRepoSizeResponse {
     object_count: number;
 }
 
+/**
+ * WorkspaceSnapshotInfo
+ * Single checkpoint snapshot entry.
+ *
+ * Auto-generated - do not edit
+ */
+interface WorkspaceSnapshotInfo {
+    workspace: string;
+    step: number;
+    timestamp: string;
+}
+
+/**
+ * WorldCatalogDetailResponse
+ * All worlds within a package (catalog format or single-world).
+ *
+ * Auto-generated - do not edit
+ */
+
+interface WorldCatalogDetailResponse {
+    package_name: string;
+    version?: string | null;
+    worlds: WorldCatalogEntry[];
+}
+
+/**
+ * WorldCatalogEntry
+ * Single world entry within a package catalog.
+ *
+ * Auto-generated - do not edit
+ */
+interface WorldCatalogEntry {
+    name: string;
+    description?: string | null;
+    has_review_schemas?: boolean | null;
+}
+
 /**
  * WorldCatalogResponse
  * Catalog of world packages.
@@ -2847,13 +3137,25 @@ interface WorldCatalogResponse {
 }
 
 /**
- * WorldConfig
+ * WorldConfigAgentEntry
+ * Agent entry in a world schema.
+ *
+ * Auto-generated - do not edit
+ */
+interface WorldConfigAgentEntry {
+    name: string;
+    description?: string | null;
+    image?: string | null;
+}
+
+/**
+ * WorldConfigInput
  * World configuration for launch.
  *
  * Auto-generated - do not edit
  */
 
-interface WorldConfig {
+interface WorldConfigInput {
     /** World package name with optional version (e.g., plato-world-structured-execution:0.1.17) */
     package: string;
     /** World name for multi-world packages. If the package registers multiple worlds, this selects which one to run. If omitted and the package has only one world, it is used automatically. */
@@ -2861,7 +3163,49 @@ interface WorldConfig {
     /** VM runtime configuration */
     runtime?: WorldRuntimeConfig | null;
     /** World configuration - passed directly to world runner */
-    config?: Record<string, unknown> | null;
+    config?: Record<string, JsonValue> | null;
+}
+
+/**
+ * WorldConfigNamedEntry
+ * Named world schema entry.
+ *
+ * Auto-generated - do not edit
+ */
+interface WorldConfigNamedEntry {
+    name: string;
+    description?: string | null;
+}
+
+/**
+ * WorldConfigOutput
+ * World configuration for launch.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface WorldConfigOutput {
+    /** World package name with optional version (e.g., plato-world-structured-execution:0.1.17) */
+    package: string;
+    /** World name for multi-world packages. If the package registers multiple worlds, this selects which one to run. If omitted and the package has only one world, it is used automatically. */
+    world_name?: string | null;
+    /** VM runtime configuration */
+    runtime?: WorldRuntimeConfig | null;
+    /** World configuration - passed directly to world runner */
+    config?: Record<string, JsonValue> | null;
+}
+
+/**
+ * WorldConfigSchema
+ * Structured world config schema surfaced to the frontend.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface WorldConfigSchema {
+    agents?: WorldConfigAgentEntry[] | null;
+    secrets?: WorldConfigNamedEntry[] | null;
+    envs?: WorldConfigNamedEntry[] | null;
 }
 
 /**
@@ -2870,14 +3214,32 @@ interface WorldConfig {
  *
  * Auto-generated - do not edit
  */
+
 interface WorldCreate {
     name: string;
     package_name: string;
     version?: string | null;
-    config_schema?: Record<string, unknown> | null;
+    config_schema?: WorldConfigSchema | null;
     description?: string | null;
 }
 
+/**
+ * WorldLeaderboardEntry
+ *
+ * Auto-generated - do not edit
+ */
+interface WorldLeaderboardEntry {
+    world_package: string;
+    world_version?: string | null;
+    total_sessions?: number | null;
+    running_sessions?: number | null;
+    completed_sessions?: number | null;
+    failed_sessions?: number | null;
+    total_cost_usd?: number | null;
+    total_vm_hours?: number | null;
+    experiment_sessions?: number | null;
+}
+
 /**
  * WorldListResponse
  * List of worlds response.
@@ -2895,12 +3257,13 @@ interface WorldListResponse {
  *
  * Auto-generated - do not edit
  */
+
 interface WorldResponse {
     public_id: string;
     name: string;
     package_name: string;
     version: string | null;
-    config_schema: Record<string, unknown> | null;
+    config_schema: WorldConfigSchema | null;
     description: string | null;
     created_at: string;
     archived_at: string | null;
@@ -2926,13 +3289,14 @@ interface WorldRuntimeConfig {
  *
  * Auto-generated - do not edit
  */
+
 interface WorldSchemaResponse {
     name?: string | null;
     description?: string | null;
     version?: string | null;
-    config_schema?: Record<string, unknown> | null;
+    config_schema?: WorldConfigSchema | null;
     secrets_schema?: Record<string, unknown> | null;
-    agents?: Record<string, unknown>[] | null;
+    agents?: WorldConfigAgentEntry[] | null;
     image?: string | null;
     resolved_world_name?: string | null;
 }
@@ -3144,6 +3508,10 @@ interface GetCurrentUserRouteApiAuthMeGetParams {
 interface CreateSessionApiAuthSessionPostParams {
     body: SSOLoginRequest;
 }
+interface RefreshOauthApiAuthRefreshOauthPostParams {
+    xApiKey?: string;
+    body: ClaudeCodeOAuthRefreshRequest;
+}
 declare class AuthApi {
     private client;
     constructor(client: ApiClient);
@@ -3160,7 +3528,7 @@ declare class AuthApi {
   
   Requires X-API-Key header or SSO cookie.
      */
-    getCurrentUserRouteApiAuthMeGet(params: GetCurrentUserRouteApiAuthMeGetParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    getCurrentUserRouteApiAuthMeGet(params: GetCurrentUserRouteApiAuthMeGetParams, options?: RequestOptions): Promise<PlatoUser>;
     /**
      * Get Session
      * Get the current session from cookie.
@@ -3176,6 +3544,14 @@ declare class AuthApi {
      * Clear the session cookie (logout).
      */
     deleteSessionApiAuthSessionDelete(options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * Refresh Oauth
+     * Refresh OAuth credentials with DB-based distributed lock.
+  
+  Prevents concurrent refreshes from multiple agents by using an OrgSetting
+  row as a lock. If another agent already refreshed, returns cached creds.
+     */
+    refreshOauthApiAuthRefreshOauthPost(params: RefreshOauthApiAuthRefreshOauthPostParams, options?: RequestOptions): Promise<OAuthRefreshResponse>;
     /**
      * Debug Auth
      * Debug endpoint to see what auth info is being received.
@@ -3511,6 +3887,11 @@ interface RerunJobParams {
     publicId: string;
     xApiKey?: string;
 }
+interface LaunchExperimentParams {
+    versionPublicId: string;
+    xApiKey?: string;
+    body: LaunchExperimentRequest;
+}
 declare class JobsApi {
     private client;
     constructor(client: ApiClient);
@@ -3527,6 +3908,15 @@ declare class JobsApi {
      * Re-run a previous session with the same stored config and runtime settings.
      */
     rerunJob(params: RerunJobParams, options?: RequestOptions): Promise<LaunchJobResponse>;
+    /**
+     * Launch Experiment
+     * Launch a session from an experiment version.
+  
+  This endpoint pulls the full config (including world.runtime) from the
+  experiment version's config_json in the database, ensuring no fields are
+  dropped. The session is automatically linked to the experiment version.
+     */
+    launchExperiment(params: LaunchExperimentParams, options?: RequestOptions): Promise<LaunchJobResponse>;
 }
 
 /**
@@ -3584,7 +3974,7 @@ declare class OtelApi {
   
   Returns raw metric data points, optionally filtered by env_alias.
      */
-    getSessionMetricsApiOtelSessionsSessionIdMetricsGet(params: GetSessionMetricsApiOtelSessionsSessionIdMetricsGetParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    getSessionMetricsApiOtelSessionsSessionIdMetricsGet(params: GetSessionMetricsApiOtelSessionsSessionIdMetricsGetParams, options?: RequestOptions): Promise<SessionMetricsResponse>;
     /**
      * Get Session Traces
      * Get parsed traces for a session with cursor-based pagination.
@@ -3613,6 +4003,11 @@ interface GetWorldVersionsApiRegistryWorldsPackageNameVersionsGetParams {
     packageName: string;
     allowPrerelease?: boolean;
 }
+interface GetWorldCatalogApiRegistryWorldsPackageNameCatalogGetParams {
+    packageName: string;
+    version?: string;
+    allowPrerelease?: boolean;
+}
 interface GetWorldSchemaApiRegistryWorldsPackageNameSchemaGetParams {
     packageName: string;
     version?: string;
@@ -3649,6 +4044,14 @@ declare class RegistryApi {
      * Get versions for a world package from the registry.
      */
     getWorldVersionsApiRegistryWorldsPackageNameVersionsGet(params: GetWorldVersionsApiRegistryWorldsPackageNameVersionsGetParams, options?: RequestOptions): Promise<WorldVersionsResponse>;
+    /**
+     * Get World Catalog
+     * List all worlds within a package.
+  
+  For catalog-format packages (multiple worlds), returns each world entry.
+  For single-world packages, returns a list with one entry.
+     */
+    getWorldCatalogApiRegistryWorldsPackageNameCatalogGet(params: GetWorldCatalogApiRegistryWorldsPackageNameCatalogGetParams, options?: RequestOptions): Promise<WorldCatalogDetailResponse>;
     /**
      * Get World Schema
      * Get schema for a world package from the registry.
@@ -3753,6 +4156,13 @@ declare class ReviewsApi {
      * Find the current user's human review for a session, or create one.
      */
     findOrCreateReviewApiReviewsFindOrCreatePost(params: FindOrCreateReviewApiReviewsFindOrCreatePostParams, options?: RequestOptions): Promise<ReviewResponse>;
+    /**
+     * Get Review Widget Schema
+     * Return the available render and feedback widgets for review models.
+  
+  Used by SDK codegen to keep widget type definitions in sync.
+     */
+    getReviewWidgetSchemaApiReviewsSchemaWidgetsGet(options?: RequestOptions): Promise<ReviewWidgetSchemaResponse>;
     /**
      * Get Review
      * Get a single review.
@@ -3896,6 +4306,8 @@ interface ListSessionCreatorsParams {
 }
 interface GetUsageStatsParams {
     days?: number;
+    /** Tags to exclude from stats (repeat param, e.g. ?exclude_tags=ci.test&exclude_tags=ci.nightly) */
+    excludeTags?: string[];
     xApiKey?: string;
 }
 interface GetSessionCostSummaryParams {
@@ -4176,7 +4588,7 @@ declare class SessionsApi {
   Downloads state.json from S3 and returns workspace snapshot info
   so callers can see which steps are available for resume.
      */
-    getSessionCheckpointInfo(params: GetSessionCheckpointInfoParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    getSessionCheckpointInfo(params: GetSessionCheckpointInfoParams, options?: RequestOptions): Promise<SessionCheckpointInfoResponse>;
     /**
      * Get Session Bash Logs Download
      * Download the session's bash/execution logs directly.
@@ -4514,7 +4926,7 @@ declare class WorkspaceReposApi {
   Files are streamed directly from S3 through the ZIP compressor to the
   client — only one file chunk (~8 MB) is held in memory at a time.
      */
-    downloadWorkspaceFiles(params: DownloadWorkspaceFilesParams, options?: RequestOptions): Promise<unknown>;
+    downloadWorkspaceFiles(params: DownloadWorkspaceFilesParams, options?: RequestOptions): Promise<Uint8Array>;
     /**
      * Get Workspace File Content
      * Proxy a DVC-cached file from S3 to the browser (avoids CORS issues).
@@ -4716,4 +5128,4 @@ declare class ChronosClient {
     getApiClient(): ApiClient;
 }
 
-export { type ActiveAnalysis, type AddSessionsRequest, AdminApi, type AgentArtifactPath, type AgentCostRecord, type AgentCreate, type AgentInfo, type AgentIssue, type AgentListResponse, type AgentLookupResponse, type AgentResponse, type AgentSchemaResponse, type AgentStep, type AgentStepMetrics, type AgentTrace, type AgentTrajectory, type AgentVersionInfo, type AgentVersionsResponse, AgentsApi, type AnalysisProvenance, type AnalysisRecordInput, type AnalysisRecordOutput, type AnalyzerSessionRef, type AnnotationListResponse, type AnnotationMetricsResponse, type AnnotationResponse, type AnnotationTarget, type AppConfigResponse, type ApproveRunRequest, type Artifact, type AuditEventInput, type AuditEventResponse, type AuditEventsListResponse, type AuditSummaryEntry, type AuditSummaryResponse, AuthApi, type AuthSessionResponse, type AuthStatusResponse, type BranchInfo, type BranchListResponse, type BulkRefAuditEventsRequest, type CheckpointListItem, type CheckpointListResponse, CheckpointsApi, type ChildSessionSummary, ApiClient as ChronosApiClient, ApiError as ChronosApiError, type ApiRequest as ChronosApiRequest, ChronosClient, type ClientConfig as ChronosClientConfig, type RequestOptions as ChronosRequestOptions, type ClearDbResult, type CloseSessionResponse, type CompleteSessionRequest, type CompressionArtifactInventory, type CompressionArtifactRecord, type CompressionChunkRecord, type CompressionClusterRef, type CompressionCoverageInput, type CompressionCoverageOutput, type CompressionManifestInput, type CompressionManifestOutput, type CompressionMetrics, type CompressionNoteCounts, type CompressionRunRecordInput, type CompressionRunRecordOutput, type CopyAnnotationsRequest, type CostAnalysisRecordInput, type CostAnalysisRecordOutput, type CreateAnnotationRequest, type CreateBranchRequest, type CreateBranchResponse, type CreateDatasetRequest, type CreateHillclimbRunRequest, type CreateReviewRequest, type CreateSessionRequest, type CreateSessionResponse, type CreateStepFile, type CreateStepRequest, type CreateStepResponse, type CreateWorkspaceRefRequest, type CreatorsListResponse, type DVCManifestEntry, type DailyUsageBucketResponse, type DatasetDetailResponse, type DatasetResponse, type DatasetSessionSummary, DefaultApi, type DeleteSessionResult, type DirectoryListing, type DownstreamSessionEntry, type DownstreamSessionsResponse, type EnvInfo, type EnvInfoResponse, EventsApi, type ExperimentFileCreateRequest, type ExperimentFileListResponse, type ExperimentFileResponse, type ExperimentFileUpdateRequest, type ExperimentFileVersionCreateRequest, type ExperimentFileVersionUpdateRequest, type ExperimentSessionSummary, type ExperimentVersionResponse, ExperimentsApi, type FeatureFlagCheckResult, type FindOrCreateReviewRequest, type HTTPValidationError, HillclimbApi, type HillclimbRunResponse, type IssueReference, JobsApi, type LaunchJobRequest, type LaunchJobResponse, type LiveLogsResponse, type LogCoverageRuleSet, type LogScopePartitioning, type LogsDownloadResponse, type ModelRef, type OTelSpanListResponse, type OTelSpanSchema, type OTelTraceResponse, OtelApi, type PerAgentReport, type PreservationRuleSet, type PreviewLaunchConfig, type PreviewResponse, type PromoteBranchRequest, type PublishedNoteRecord, type RegistryAgentListResponse, type RegistryAgentSchemaResponse, type RegistryAgentVersionInfo, type RegistryAgentVersionsResponse, RegistryApi, type RegistryWorldInfo, type RejectRunRequest, type ReviewIssue, type ReviewListResponse, type ReviewResponse, ReviewsApi, type RunLifecycle, type RunProgress, type SSOLoginRequest, type SavedFilterCreate, type SavedFilterListResponse, type SavedFilterResponse, SavedFiltersApi, type ServiceStatuses, type SessionCostEntry, type SessionCostSummaryResponse, type SessionCreator, type SessionEnvsResponse, type SessionLineageEntry, type SessionLineageResponse, type SessionListResponse, type SessionLogsResponse, type SessionNoteUserRef, type SessionNotesPayloadInput, type SessionNotesPayloadOutput, type SessionResponse, type SessionReviewReportInput, type SessionReviewReportOutput, type SessionReviewerNotesInput, type SessionReviewerNotesOutput, type SessionReviewerRunRecordInput, type SessionReviewerRunRecordOutput, type SessionReviewerSpanNote, type SessionStatusResponse, type SessionSummary, type SessionToolSummary, type SessionTrajectory, type SessionWorldInfo, SessionsApi, type SettingResponse, SettingsApi, type SlackLookupResponse, type StarredCheckpointCreate, type StarredCheckpointListResponse, type StarredCheckpointResponse, type StarredCheckpointUpdate, StarredCheckpointsApi, StatusApi, type StatusResponse, type SyncAllResult, type SyncResult, type TagsListResponse, type TargetSessionRef, type TokenSummaryRecord, type ToolStat, type ToolUsageCount, type TrajectoryAgentInfo, type TrajectoryMetrics, type TrajectoryObservation, type TrajectoryObservationResult, type TrajectorySandboxInfo, type TrajectoryToolCall, type TrajectoryWorldInfo, type UpdateAnnotationRequest, type UpdateDatasetRequest, type UpdateFileRequest, type UpdateFileResponse, type UpdateNotesRequest, type UpdateReviewRequest, type UpdateSettingRequest, type UpdateSpanNoteRequest, type UpdateStatusRequest, type UpdateTagsRequest, type UsageStatsResponse, type UserInfo, type UserLeaderboardEntry, type VMResources, type ValidationError, type VersionResponse, type WorkspaceFilesResponse, type WorkspaceRefResponse, type WorkspaceRefSearchResponse, type WorkspaceRefSearchResult, type WorkspaceRefsListResponse, type WorkspaceRepoCredentialsResponse, type WorkspaceRepoListItem, type WorkspaceRepoListResponse, type WorkspaceRepoResolveRequest, type WorkspaceRepoResolveResponse, type WorkspaceRepoSizeResponse, WorkspaceReposApi, type WorldCatalogResponse, type WorldConfig, type WorldCreate, type WorldListResponse, type WorldResponse, type WorldRuntimeConfig, type WorldSchemaResponse, type WorldStep, type WorldVersionsResponse, WorldsApi };
+export { type ActiveAnalysis, type AddSessionsRequest, AdminApi, type AgentArtifactPath, type AgentCostRecord, type AgentCreate, type AgentInfo, type AgentIssue, type AgentListResponse, type AgentLookupResponse, type AgentResponse, type AgentSchemaResponse, type AgentStep, type AgentStepMetrics, type AgentTrace, type AgentTrajectory, type AgentVersionInfo, type AgentVersionsResponse, AgentsApi, type AnalysisProvenance, type AnalysisRecordInput, type AnalysisRecordOutput, type AnalyzerSessionRef, type AnnotationListResponse, type AnnotationMetricsResponse, type AnnotationResponse, type AnnotationTarget, type AppConfigResponse, type ApproveRunRequest, type Artifact, type AuditEventInput, type AuditEventResponse, type AuditEventsListResponse, type AuditSummaryEntry, type AuditSummaryResponse, AuthApi, type AuthSessionResponse, type AuthStatusResponse, type BranchInfo, type BranchListResponse, type BulkRefAuditEventsRequest, type CheckpointListItem, type CheckpointListResponse, CheckpointsApi, type ChildSessionSummary, ApiClient as ChronosApiClient, ApiError as ChronosApiError, type ApiRequest as ChronosApiRequest, ChronosClient, type ClientConfig as ChronosClientConfig, type RequestOptions as ChronosRequestOptions, type ClaudeCodeOAuthRefreshRequest, type ClearDbResult, type CloseSessionResponse, type CompleteSessionRequest, type CompressionArtifactInventory, type CompressionArtifactRecord, type CompressionChunkRecord, type CompressionClusterRef, type CompressionCoverageInput, type CompressionCoverageOutput, type CompressionManifestInput, type CompressionManifestOutput, type CompressionMetrics, type CompressionNoteCounts, type CompressionRunRecordInput, type CompressionRunRecordOutput, type CopyAnnotationsRequest, type CostAnalysisRecordInput, type CostAnalysisRecordOutput, type CreateAnnotationRequest, type CreateBranchRequest, type CreateBranchResponse, type CreateDatasetRequest, type CreateHillclimbRunRequest, type CreateReviewRequest, type CreateSessionRequest, type CreateSessionResponse, type CreateStepFile, type CreateStepRequest, type CreateStepResponse, type CreateWorkspaceRefRequest, type CreatorsListResponse, type DVCManifestEntry, type DailyUsageBucketResponse, type DatasetDetailResponse, type DatasetResponse, type DatasetSessionSummary, DefaultApi, type DeleteSessionResult, type DirectoryListing, type DownstreamSessionEntry, type DownstreamSessionsResponse, type EnvInfo, type EnvInfoResponse, EventsApi, type ExperimentFileCreateRequest, type ExperimentFileListResponse, type ExperimentFileResponse, type ExperimentFileUpdateRequest, type ExperimentFileVersionCreateRequest, type ExperimentFileVersionUpdateRequest, type ExperimentLaunchConfig, type ExperimentSessionCountResponse, type ExperimentSessionSummary, type ExperimentVersionResponse, ExperimentsApi, type FeatureFlagCheckResult, type FeedbackWidget, type FindOrCreateReviewRequest, type HTTPValidationError, HillclimbApi, type HillclimbRunResponse, type IssueReference, JobsApi, type JsonValue, type LaunchExperimentRequest, type LaunchJobRequest, type LaunchJobResponse, type LiveLogsResponse, type LogCoverageRuleSet, type LogScopePartitioning, type LogsDownloadResponse, type ModelRef, type OAuthRefreshResponse, type OTelMetricDataPoint, type OTelSpanListResponse, type OTelSpanSchema, type OTelTraceResponse, OtelApi, type PerAgentReport, type PlatoUser, type PreservationRuleSet, type PreviewLaunchConfig, type PreviewResponse, type PromoteBranchRequest, type PublishedNoteRecord, type RegistryAgentListResponse, type RegistryAgentSchemaResponse, type RegistryAgentVersionInfo, type RegistryAgentVersionsResponse, RegistryApi, type RegistryWorldInfo, type RejectRunRequest, type RenderWidget, type ReviewIssue, type ReviewListResponse, type ReviewResponse, type ReviewWidgetSchemaResponse, ReviewsApi, type RunLifecycle, type RunProgress, type SSOLoginRequest, type SavedFilterCreate, type SavedFilterListResponse, type SavedFilterResponse, SavedFiltersApi, type SavedSessionFilters, type ServiceStatuses, type SessionCheckpointInfoResponse, type SessionCostEntry, type SessionCostSummaryResponse, type SessionCreator, type SessionEnvsResponse, type SessionLaunchConfig, type SessionLineageEntry, type SessionLineageResponse, type SessionListResponse, type SessionLogsResponse, type SessionMetricsResponse, type SessionNoteUserRef, type SessionNotesPayloadInput, type SessionNotesPayloadOutput, type SessionResponse, type SessionReviewReportInput, type SessionReviewReportOutput, type SessionReviewerNotesInput, type SessionReviewerNotesOutput, type SessionReviewerRunRecordInput, type SessionReviewerRunRecordOutput, type SessionReviewerSpanNote, type SessionStatusResponse, type SessionStoredWorldConfig, type SessionSummary, type SessionToolSummary, type SessionTrajectory, type SessionWorldInfo, SessionsApi, type SettingResponse, SettingsApi, type SlackLookupResponse, type StarredCheckpointCreate, type StarredCheckpointListResponse, type StarredCheckpointResponse, type StarredCheckpointUpdate, StarredCheckpointsApi, StatusApi, type StatusResponse, type SyncAllResult, type SyncResult, type TagsListResponse, type TargetSessionRef, type TokenSummaryRecord, type ToolStat, type ToolUsageCount, type TrajectoryAgentInfo, type TrajectoryMetrics, type TrajectoryObservation, type TrajectoryObservationResult, type TrajectorySandboxInfo, type TrajectoryToolCall, type TrajectoryWorldInfo, type UpdateAnnotationRequest, type UpdateDatasetRequest, type UpdateFileRequest, type UpdateFileResponse, type UpdateNotesRequest, type UpdateReviewRequest, type UpdateSettingRequest, type UpdateSpanNoteRequest, type UpdateStatusRequest, type UpdateTagsRequest, type UsageStatsResponse, type UserInfo, type UserLeaderboardEntry, type UserWorldStatsEntry, type VMResources, type ValidationError, type VersionResponse, type WorkspaceFilesResponse, type WorkspaceRefResponse, type WorkspaceRefSearchResponse, type WorkspaceRefSearchResult, type WorkspaceRefsListResponse, type WorkspaceRepoCredentialsResponse, type WorkspaceRepoListItem, type WorkspaceRepoListResponse, type WorkspaceRepoResolveRequest, type WorkspaceRepoResolveResponse, type WorkspaceRepoSizeResponse, WorkspaceReposApi, type WorkspaceSnapshotInfo, type WorldCatalogDetailResponse, type WorldCatalogEntry, type WorldCatalogResponse, type WorldConfigAgentEntry, type WorldConfigInput, type WorldConfigNamedEntry, type WorldConfigOutput, type WorldConfigSchema, type WorldCreate, type WorldLeaderboardEntry, type WorldListResponse, type WorldResponse, type WorldRuntimeConfig, type WorldSchemaResponse, type WorldStep, type WorldVersionsResponse, WorldsApi };