plato-sandbox-sdk 1.1.46 → 1.1.48

package/dist/chronos/index.d.mts

@@ -33,6 +33,24 @@ interface AgentArtifactPath {
     path?: string | null;
 }
 
+/**
+ * AgentCostEntry
+ * Pre-computed cost breakdown for a single agent execution.
+ *
+ * Auto-generated - do not edit
+ */
+interface AgentCostEntry {
+    span_id: string;
+    name?: string | null;
+    version?: string | null;
+    model?: string | null;
+    cost_usd?: number | null;
+    prompt_tokens?: number | null;
+    completion_tokens?: number | null;
+    cache_read_tokens?: number | null;
+    cache_write_tokens?: number | null;
+}
+
 /**
  * AgentCostRecord
  *
@@ -280,6 +298,32 @@ interface AnalysisRecordOutput {
     report?: PerAgentReport | SessionReviewReportOutput | null;
 }
 
+/**
+ * AnalyticsTimeseriesBucketResponse
+ *
+ * Auto-generated - do not edit
+ */
+interface AnalyticsTimeseriesBucketResponse {
+    bucket: string;
+    group: string;
+    session_count?: number | null;
+    avg_cost_usd?: number | null;
+    total_cost_usd?: number | null;
+    avg_prompt_tokens?: number | null;
+    avg_completion_tokens?: number | null;
+    avg_io_ratio?: number | null;
+}
+
+/**
+ * AnalyticsTimeseriesResponse
+ *
+ * Auto-generated - do not edit
+ */
+
+interface AnalyticsTimeseriesResponse {
+    buckets: AnalyticsTimeseriesBucketResponse[];
+}
+
 /**
  * AnalyzerSessionRef
  *
@@ -394,6 +438,35 @@ interface Artifact {
     end_time_unix_nano?: number | null;
 }
 
+/**
+ * ArtifactBrowserNode
+ * Spins up an artifact and renders a live browser preview.
+ *
+ * Auto-generated - do not edit
+ */
+interface ArtifactBrowserNode {
+    type: string;
+    id: string;
+    artifact_id: string;
+    route: string;
+    plato_session_id?: string | null;
+}
+
+/**
+ * AssignmentAnalyticsResponse
+ * Analytics for the caller's org as an assignee.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface AssignmentAnalyticsResponse {
+    reviewers: ReviewerAnalytics[];
+    total_assignments: number;
+    total_completed: number;
+    total_reviews: number;
+    total_annotations: number;
+}
+
 /**
  * AssignmentListResponse
  * List of assignments.
@@ -413,7 +486,8 @@ interface AssignmentListResponse {
  */
 
 interface AssignmentPreviewItem {
-    scope: RouteScopeConfig | PageScopeConfig;
+    nodes?: NodeTreeOutput | null;
+    description?: string | null;
 }
 
 /**
@@ -436,16 +510,28 @@ interface AssignmentPreviewResponse {
 
 interface AssignmentResponse {
     public_id: string;
-    session_id: string;
-    scope: RouteScopeConfig | PageScopeConfig;
+    assignee_org_id?: number | null;
+    nodes?: NodeTreeOutput | null;
+    description?: string | null;
     status: string;
     annotation_count?: number | null;
-    session_tags?: string[] | null;
-    world_package?: string | null;
     created_at: string;
     updated_at: string;
 }
 
+/**
+ * AssignmentTypeInfo
+ * Metadata for an assignment type, served to the frontend.
+ *
+ * Auto-generated - do not edit
+ */
+interface AssignmentTypeInfo {
+    id: string;
+    label: string;
+    icon: string;
+    description_template: string;
+}
+
 /**
  * AuditEventCountsResponse
  * Per-span audit event counts for a session.
@@ -568,6 +654,8 @@ interface AuthSessionResponse {
     authenticated: boolean;
     user: PlatoUser | null;
     env?: string | null;
+    sso_token?: string | null;
+    api_key?: string | null;
 }
 
 /**
@@ -583,15 +671,41 @@ interface AuthStatusResponse {
     env: string;
 }
 
+/**
+ * AuthzCheckResponse
+ * Response for an authz check proxied to Plato.
+ *
+ * Auto-generated - do not edit
+ */
+interface AuthzCheckResponse {
+    allowed: boolean;
+}
+
+/**
+ * BatchAssignmentItem
+ * A single item in a batch assignment request (no assignee_org_id — own-org only).
+ *
+ * Auto-generated - do not edit
+ */
+
+interface BatchAssignmentItem {
+    /** Module tree defining the review layout */
+    nodes?: NodeTreeInput | null;
+    /** Short description shown on the assignments page */
+    description?: string | null;
+}
+
 /**
  * BatchCreateAssignmentsBody
- * Batch-create assignments in the caller's org.
+ * Batch-create assignments.
  *
  * Auto-generated - do not edit
  */
 
 interface BatchCreateAssignmentsBody {
-    assignments: CreateAssignmentBody[];
+    assignments: BatchAssignmentItem[];
+    /** Target org ID. Defaults to caller's org if not specified. */
+    assignee_org_id?: number | null;
 }
 
 /**
@@ -786,6 +900,19 @@ interface CloseSessionResponse {
     message: string;
 }
 
+/**
+ * CommentPanelNode
+ * Comment input + list, targeting a session resolved from a ValueRef.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface CommentPanelNode {
+    type: string;
+    id: string;
+    target_session_id: StaticValue | Ref;
+}
+
 /**
  * CompleteSessionRequest
  * Request to mark a session as completed.
@@ -1081,10 +1208,12 @@ interface CreateAnnotationRequest {
  */
 
 interface CreateAssignmentBody {
-    /** Public ID of the session to review */
-    session_id: string;
-    /** Review scope (discriminated by type) */
-    scope: RouteScopeConfig | PageScopeConfig;
+    /** Module tree defining the review layout */
+    nodes?: NodeTreeInput | null;
+    /** Short description shown on the assignments page */
+    description?: string | null;
+    /** Org ID of the org assigned to review this session */
+    assignee_org_id: number;
 }
 
 /**
@@ -1126,7 +1255,6 @@ interface CreateDatasetRequest {
  *
  * Auto-generated - do not edit
  */
-
 interface CreateReviewRequest {
     /** Public ID of the session being reviewed */
     session_id: string;
@@ -1146,8 +1274,6 @@ interface CreateReviewRequest {
     analyzer_session_id?: string | null;
     /** Score dict keyed by aggregation method, e.g. {'pass_rate': 0.8, 'mean_score': 0.75} */
     scores?: Record<string, number> | null;
-    /** Scope of the review — discriminated union keyed by 'type' (e.g. route, screenshot, task) */
-    scope?: RouteScopeConfig | PageScopeConfig | null;
     /** Whether this review contains authoritative ground-truth annotations */
     is_ground_truth?: boolean | null;
 }
@@ -1771,6 +1897,7 @@ type FeedbackWidget = 'text' | 'textarea' | 'select' | 'boolean' | 'rating' | 'a
  */
 interface FindOrCreateReviewBody {
     session_id: string;
+    assignment_id?: string | null;
 }
 
 /**
@@ -2151,6 +2278,28 @@ interface NavigateAnchorSessionRequest {
     target_url: string;
 }
 
+/**
+ * NodeTreeInput
+ * Root container for the node tree.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface NodeTreeInput {
+    root: SplitNodeInput | ArtifactBrowserNode | ScreenshotCarouselNode | TextNode | CommentPanelNode;
+}
+
+/**
+ * NodeTreeOutput
+ * Root container for the node tree.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface NodeTreeOutput {
+    root: SplitNodeOutput | ArtifactBrowserNode | ScreenshotCarouselNode | TextNode | CommentPanelNode;
+}
+
 /**
  * OAuthRefreshResponse
  * Response with refreshed OAuth credentials.
@@ -2231,20 +2380,6 @@ interface OTelTraceResponse {
     cursor?: string | null;
 }
 
-/**
- * PageScopeConfig
- * Compare a reference screenshot against the live route.
- *
- * Auto-generated - do not edit
- */
-interface PageScopeConfig {
-    type: string;
-    /** Route path within the sim */
-    route: string;
-    /** URL of the reference screenshot to compare against */
-    screenshot_url: string;
-}
-
 /**
  * PerAgentReport
  *
@@ -2273,6 +2408,8 @@ interface PlatoUser {
     email: string;
     name?: string | null;
     organization_id?: number | null;
+    org_public_id?: string | null;
+    is_admin?: boolean | null;
 }
 
 /**
@@ -2339,6 +2476,18 @@ interface PublishedNoteRecord {
     provenance?: AnalysisProvenance | null;
 }
 
+/**
+ * Ref
+ * A reference to another node's runtime field.
+ *
+ * Auto-generated - do not edit
+ */
+interface Ref {
+    type: string;
+    node_id: string;
+    field: string;
+}
+
 /**
  * RegistryAgentListResponse
  * List of agents from registry.
@@ -2410,6 +2559,56 @@ interface RegistryWorldInfo {
  */
 type RenderWidget = 'score_bar' | 'pass_fail_badge' | 'severity_badge' | 'code_snippet' | 'markdown' | 'json_tree' | 'link' | 'tag_list' | 'image' | 'diff' | 'table' | 'hidden';
 
+/**
+ * ReportStageRequest
+ * Report a stage lifecycle event (started, completed, or failed).
+ *
+ * Auto-generated - do not edit
+ */
+interface ReportStageRequest {
+    /** Chronos session public ID */
+    session_public_id: string;
+    /** Function or task name */
+    stage_name: string;
+    /** Whether this is a @durable function or an orchestrator sub-task */
+    stage_type: string;
+    /** Return type name (durable only) */
+    output_type?: string | null;
+    /** Stage lifecycle status */
+    status: string;
+    /** When the stage started executing */
+    started_at: string;
+    /** When the stage finished */
+    completed_at?: string | null;
+    /** Wall-clock duration */
+    elapsed_seconds?: number | null;
+    /** Resolved durable path on disk */
+    base_path?: string | null;
+    /** Serializable subset of function arguments */
+    args_snapshot?: Record<string, unknown> | null;
+    /** Public ID of the parent durable stage (for orchestrator tasks) */
+    parent_stage_public_id?: string | null;
+    /** OTel trace ID for linking to trajectory viewer */
+    trace_id?: string | null;
+    /** OTel span ID for linking to trajectory viewer */
+    span_id?: string | null;
+    /** Error details on failure */
+    error_message?: string | null;
+    /** Extensible metadata (agent_id, merged, branch_name, etc.) */
+    metadata?: Record<string, unknown> | null;
+}
+
+/**
+ * ReportStageResponse
+ * Response from reporting a stage event.
+ *
+ * Auto-generated - do not edit
+ */
+interface ReportStageResponse {
+    /** Public ID of the created/updated stage record */
+    public_id: string;
+}
+
 /**
  * RerunPreviewResponse
  * Preview of a rerun showing original and modified configs.
@@ -2488,7 +2687,7 @@ interface ReviewListResponse {
 
 interface ReviewResponse {
     public_id: string;
-    session_id: string;
+    session_id?: string | null;
     assignment_id?: string | null;
     name?: string | null;
     description?: string | null;
@@ -2499,7 +2698,7 @@ interface ReviewResponse {
     created_at: string;
     analyzer_session_id?: string | null;
     scores?: Record<string, number> | null;
-    scope?: Record<string, unknown> | null;
+    nodes?: NodeTreeOutput | null;
     is_ground_truth?: boolean | null;
     annotation_count?: number | null;
     session?: SessionSummary | null;
@@ -2520,15 +2719,19 @@ interface ReviewWidgetSchemaResponse {
 }
 
 /**
- * RouteScopeConfig
- * Review a specific route in the live sim.
+ * ReviewerAnalytics
+ * Per-reviewer analytics for a single annotator user.
  *
  * Auto-generated - do not edit
  */
-interface RouteScopeConfig {
-    type: string;
-    /** Route path within the sim (e.g. '/customers', '/billing') */
-    route: string;
+interface ReviewerAnalytics {
+    user_id: string | null;
+    user_email: string | null;
+    user_name: string | null;
+    assignment_count: number;
+    completed_count: number;
+    review_count: number;
+    annotation_count: number;
 }
 
 /**
@@ -2634,6 +2837,33 @@ interface SavedSessionFilters {
     status?: string | null;
 }
 
+/**
+ * ScreenshotCarouselNode
+ * Displays a carousel of screenshots from the session workspace.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ScreenshotCarouselNode {
+    type: string;
+    id: string;
+    session_id: string;
+    repo_name: string;
+    screenshots?: ScreenshotRef[] | null;
+}
+
+/**
+ * ScreenshotRef
+ * Reference to a single screenshot in a DVC-managed workspace.
+ *
+ * Auto-generated - do not edit
+ */
+interface ScreenshotRef {
+    file_hash: string;
+    file_path: string;
+    repo_name?: string | null;
+}
+
 /**
  * ScreenshotResponse
  * Response from taking a screenshot.
@@ -2902,6 +3132,7 @@ interface SessionResponse {
     trajectory?: Record<string, JsonValue> | null;
     result?: Record<string, JsonValue> | null;
     total_cost_usd?: number | null;
+    agent_costs?: AgentCostEntry[] | null;
     logs_url?: string | null;
     tags?: string[] | null;
     notes?: SessionNotesPayloadOutput | null;
@@ -3051,6 +3282,17 @@ interface SessionReviewerSpanNote {
     provenance?: AnalysisProvenance | null;
 }
 
+/**
+ * SessionStagesResponse
+ * All stages for a session.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SessionStagesResponse {
+    stages: StageResponse[];
+}
+
 /**
  * SessionStatusResponse
  * Lightweight status response for a session.
@@ -3162,6 +3404,61 @@ interface SlackLookupResponse {
     error?: string | null;
 }
 
+/**
+ * SplitNodeInput
+ * Layout node: arranges children horizontally or vertically.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SplitNodeInput {
+    type: string;
+    id: string;
+    direction: string;
+    children: SplitNodeInput | ArtifactBrowserNode | ScreenshotCarouselNode | TextNode | CommentPanelNode[];
+    sizes?: number[] | null;
+}
+
+/**
+ * SplitNodeOutput
+ * Layout node: arranges children horizontally or vertically.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SplitNodeOutput {
+    type: string;
+    id: string;
+    direction: string;
+    children: SplitNodeOutput | ArtifactBrowserNode | ScreenshotCarouselNode | TextNode | CommentPanelNode[];
+    sizes?: number[] | null;
+}
+
+/**
+ * StageResponse
+ * Single stage record returned by the API.
+ *
+ * Auto-generated - do not edit
+ */
+interface StageResponse {
+    public_id: string;
+    stage_name: string;
+    stage_type: string;
+    output_type?: string | null;
+    status: string;
+    started_at: string;
+    completed_at?: string | null;
+    elapsed_seconds?: number | null;
+    base_path?: string | null;
+    args_snapshot?: Record<string, unknown> | null;
+    parent_stage_public_id?: string | null;
+    trace_id?: string | null;
+    span_id?: string | null;
+    error_message?: string | null;
+    metadata?: Record<string, unknown> | null;
+    created_at: string;
+}
+
 /**
  * StarredCheckpointCreate
  * Request to star a checkpoint.
@@ -3220,6 +3517,17 @@ interface StarredCheckpointUpdate {
     note?: string | null;
 }
 
+/**
+ * StaticValue
+ * A literal value set at assignment creation time.
+ *
+ * Auto-generated - do not edit
+ */
+interface StaticValue {
+    type: string;
+    value: string;
+}
+
 /**
  * StatusResponse
  * Overall status response.
@@ -3309,6 +3617,18 @@ interface TestRunListResponse {
     test_runs: ExperimentTestRunResponse[];
 }
 
+/**
+ * TextNode
+ * Displays a static block of instructional or informational text.
+ *
+ * Auto-generated - do not edit
+ */
+interface TextNode {
+    type: string;
+    id: string;
+    content: string;
+}
+
 /**
  * TokenSummaryRecord
  *
@@ -3508,6 +3828,17 @@ interface UpdateFileResponse {
     new_manifest_hash: string;
 }
 
+/**
+ * UpdateNodeRequest
+ * Request to update fields on a node tree node.
+ *
+ * Auto-generated - do not edit
+ */
+interface UpdateNodeRequest {
+    /** Fields to update on the node */
+    values: Record<string, string>;
+}
+
 /**
  * UpdateNotesRequest
  * Request to update session notes.
@@ -3530,7 +3861,6 @@ interface UpdateNotesRequest {
  *
  * Auto-generated - do not edit
  */
-
 interface UpdateReviewRequest {
     /** Updated name */
     name?: string | null;
@@ -3540,8 +3870,6 @@ interface UpdateReviewRequest {
     tags?: string[] | null;
     /** Updated scores */
     scores?: Record<string, number> | null;
-    /** Updated scope */
-    scope?: RouteScopeConfig | PageScopeConfig | null;
     /** Updated ground truth flag */
     is_ground_truth?: boolean | null;
 }
@@ -4377,6 +4705,7 @@ declare class AgentsApi {
 interface ListAnnotationsApiAnnotationsGetParams {
     sessionId?: string;
     reviewId?: string;
+    assignmentId?: string;
     xApiKey?: string;
 }
 interface CreateAnnotationApiAnnotationsPostParams {
@@ -4410,7 +4739,7 @@ declare class AnnotationsApi {
     constructor(client: ApiClient);
     /**
      * List Annotations
-     * List annotations, filtered by session and/or review.
+     * List annotations, filtered by session, review, and/or assignment.
      */
     listAnnotationsApiAnnotationsGet(params: ListAnnotationsApiAnnotationsGetParams, options?: RequestOptions): Promise<AnnotationListResponse>;
     /**
@@ -4430,12 +4759,12 @@ declare class AnnotationsApi {
     getAnnotationApiAnnotationsAnnotationPublicIdGet(params: GetAnnotationApiAnnotationsAnnotationPublicIdGetParams, options?: RequestOptions): Promise<AnnotationResponse>;
     /**
      * Update Annotation
-     * Update an annotation. Author only.
+     * Update an annotation. Author only (admin can update any).
      */
     updateAnnotationApiAnnotationsAnnotationPublicIdPut(params: UpdateAnnotationApiAnnotationsAnnotationPublicIdPutParams, options?: RequestOptions): Promise<AnnotationResponse>;
     /**
      * Delete Annotation
-     * Delete an annotation and descendants. Author only.
+     * Delete an annotation and descendants. Author only (admin can delete any).
      */
     deleteAnnotationApiAnnotationsAnnotationPublicIdDelete(params: DeleteAnnotationApiAnnotationsAnnotationPublicIdDeleteParams, options?: RequestOptions): Promise<void>;
     /**
@@ -4451,8 +4780,10 @@ declare class AnnotationsApi {
  * Auto-generated - do not edit
  */
 
+interface ListAssignmentTypesParams {
+    xApiKey?: string;
+}
 interface ListAssignmentsApiAssignmentsGetParams {
-    sessionId?: string;
     status?: string;
     xApiKey?: string;
 }
@@ -4460,6 +4791,9 @@ interface CreateAssignmentApiAssignmentsPostParams {
     xApiKey?: string;
     body: CreateAssignmentBody;
 }
+interface GetAssignmentAnalyticsParams {
+    xApiKey?: string;
+}
 interface GetAssignmentApiAssignmentsAssignmentIdGetParams {
     assignmentId: string;
     xApiKey?: string;
@@ -4475,7 +4809,13 @@ interface AutoCreateAssignmentsParams {
 }
 interface PreviewAssignmentsParams {
     sessionPublicId: string;
-    scopeType: string;
+    artifactId?: string;
+    xApiKey?: string;
+}
+interface StreamPreviewAssignmentsParams {
+    sessionPublicId: string;
+    artifactId?: string;
+    assignmentType?: string;
     xApiKey?: string;
 }
 interface BatchCreateAssignmentsParams {
@@ -4485,6 +4825,11 @@ interface BatchCreateAssignmentsParams {
 declare class AssignmentsApi {
     private client;
     constructor(client: ApiClient);
+    /**
+     * Get Assignment Types
+     * List available assignment types with metadata for the frontend.
+     */
+    listAssignmentTypes(params: ListAssignmentTypesParams, options?: RequestOptions): Promise<AssignmentTypeInfo[]>;
     /**
      * List Assignments
      * List assignments for your org.
@@ -4495,6 +4840,19 @@ declare class AssignmentsApi {
      * Create a new assignment for a session.
      */
     createAssignmentApiAssignmentsPost(params: CreateAssignmentApiAssignmentsPostParams, options?: RequestOptions): Promise<AssignmentResponse>;
+    /**
+     * Get Assignment Analytics
+     * Per-reviewer stats for all assignments assigned to the caller's org.
+  
+  Returns, for each distinct reviewer (user who created reviews):
+  - assignment_count: number of assignments this reviewer has reviewed
+  - completed_count: assignments marked completed
+  - review_count: total reviews created by this user
+  - annotation_count: total annotations by this user
+  
+  Assignments with no reviews yet appear as a null-reviewer bucket.
+     */
+    getAssignmentAnalytics(params: GetAssignmentAnalyticsParams, options?: RequestOptions): Promise<AssignmentAnalyticsResponse>;
     /**
      * Get Assignment
      * Get a single assignment.
@@ -4513,10 +4871,16 @@ declare class AssignmentsApi {
     /**
      * Preview Assignments
      * Preview assignments that would be created for a session without persisting them.
-  
-  scope_type: "route" | "page"
      */
     previewAssignments(params: PreviewAssignmentsParams, options?: RequestOptions): Promise<AssignmentPreviewResponse>;
+    /**
+     * Stream Preview Assignments Route
+     * Stream assignment preview items as NDJSON as they are discovered from S3.
+  
+  assignment_type: layout type for generated assignments (default: "browser").
+  Valid values: "browser", "browser_with_screenshots".
+     */
+    streamPreviewAssignments(params: StreamPreviewAssignmentsParams, options?: RequestOptions): Promise<void>;
     /**
      * Batch Create Assignments
      * Create multiple assignments at once in the caller's org.
@@ -4543,6 +4907,10 @@ interface RefreshOauthApiAuthRefreshOauthPostParams {
     xApiKey?: string;
     body: ClaudeCodeOAuthRefreshRequest;
 }
+interface AuthzCheckApiAuthAuthzCheckGetParams {
+    role: string;
+    xApiKey?: string;
+}
 declare class AuthApi {
     private client;
     constructor(client: ApiClient);
@@ -4583,6 +4951,13 @@ declare class AuthApi {
   row as a lock. If another agent already refreshed, returns cached creds.
      */
     refreshOauthApiAuthRefreshOauthPost(params: RefreshOauthApiAuthRefreshOauthPostParams, options?: RequestOptions): Promise<OAuthRefreshResponse>;
+    /**
+     * Authz Check
+     * Proxy an authz check to Plato using the current principal's SSO auth.
+  
+  Checks whether the current principal has the given role on their org.
+     */
+    authzCheckApiAuthAuthzCheckGet(params: AuthzCheckApiAuthAuthzCheckGetParams, options?: RequestOptions): Promise<AuthzCheckResponse>;
     /**
      * Debug Auth
      * Debug endpoint to see what auth info is being received.
@@ -5471,6 +5846,12 @@ interface CopyAnnotationsToReviewApiReviewsReviewPublicIdCopyFromSourceReviewPub
     xApiKey?: string;
     body: CopyAnnotationsRequest;
 }
+interface UpdateReviewNodeParams {
+    reviewPublicId: string;
+    nodeId: string;
+    xApiKey?: string;
+    body: UpdateNodeRequest;
+}
 declare class ReviewsApi {
     private client;
     constructor(client: ApiClient);
@@ -5501,12 +5882,12 @@ declare class ReviewsApi {
     getReviewApiReviewsReviewPublicIdGet(params: GetReviewApiReviewsReviewPublicIdGetParams, options?: RequestOptions): Promise<ReviewResponse>;
     /**
      * Update Review
-     * Update a review. Author only.
+     * Update a review. Author only (admin can update any).
      */
     updateReviewApiReviewsReviewPublicIdPut(params: UpdateReviewApiReviewsReviewPublicIdPutParams, options?: RequestOptions): Promise<ReviewResponse>;
     /**
      * Delete Review
-     * Delete a review and its annotations. Author only.
+     * Delete a review and its annotations. Author only (admin can delete any).
      */
     deleteReviewApiReviewsReviewPublicIdDelete(params: DeleteReviewApiReviewsReviewPublicIdDeleteParams, options?: RequestOptions): Promise<void>;
     /**
@@ -5514,6 +5895,11 @@ declare class ReviewsApi {
      * Copy top-level annotations from a source review.
      */
     copyAnnotationsToReviewApiReviewsReviewPublicIdCopyFromSourceReviewPublicIdPost(params: CopyAnnotationsToReviewApiReviewsReviewPublicIdCopyFromSourceReviewPublicIdPostParams, options?: RequestOptions): Promise<AnnotationResponse[]>;
+    /**
+     * Update Review Node
+     * Update runtime values on a node tree node.
+     */
+    updateReviewNode(params: UpdateReviewNodeParams, options?: RequestOptions): Promise<NodeTreeOutput>;
 }
 
 /**
@@ -5610,6 +5996,22 @@ interface GetUsageStatsParams {
     excludeTags?: string[];
     xApiKey?: string;
 }
+interface GetAnalyticsTimeseriesParams {
+    days?: number;
+    bucket?: string;
+    groupBy?: string;
+    /** Include sessions with any of these tags */
+    tags?: string[];
+    /** Exclude sessions with any of these tags */
+    excludeTags?: string[];
+    /** Filter by world package names */
+    worlds?: string[];
+    /** Filter by session status */
+    statuses?: string[];
+    /** Filter by user emails */
+    users?: string[];
+    xApiKey?: string;
+}
 interface GetSessionCostSummaryParams {
     /** Filter by exact tags (repeat query param, e.g. ?tags=foo&tags=bar) */
     tags?: string[];
@@ -5623,6 +6025,10 @@ interface GetSessionParams {
     revealSecrets?: boolean;
     xApiKey?: string;
 }
+interface BackfillSessionCostsParams {
+    publicId: string;
+    xApiKey?: string;
+}
 interface GetSessionStatusParams {
     publicId: string;
     xApiKey?: string;
@@ -5815,6 +6221,11 @@ declare class SessionsApi {
      * Get org-wide usage stats for the leaderboard dashboard.
      */
     getUsageStats(params: GetUsageStatsParams, options?: RequestOptions): Promise<UsageStatsResponse>;
+    /**
+     * Get Analytics Timeseries Endpoint
+     * Get analytics timeseries data for charting. Combines PG session data with ClickHouse token metrics.
+     */
+    getAnalyticsTimeseries(params: GetAnalyticsTimeseriesParams, options?: RequestOptions): Promise<AnalyticsTimeseriesResponse>;
     /**
      * Get Session Cost Summary
      * Return lightweight cost data for all matching sessions (no pagination limit).
@@ -5833,6 +6244,11 @@ declare class SessionsApi {
       reveal_secrets: If true, decrypt and return actual secret values
      */
     getSession(params: GetSessionParams, options?: RequestOptions): Promise<SessionResponse>;
+    /**
+     * Backfill Session Costs
+     * Compute and persist agent_costs for a legacy session missing pre-computed costs.
+     */
+    backfillSessionCosts(params: BackfillSessionCostsParams, options?: RequestOptions): Promise<SessionResponse>;
     /**
      * Get Session Status
      * Get just the status of a session (lightweight endpoint).
@@ -6065,6 +6481,35 @@ declare class SlackApi {
     sendSlackMessage(params: SendSlackMessageParams, options?: RequestOptions): Promise<SendSlackMessageResponse>;
 }
 
+/**
+ * stages API
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ReportStageParams {
+    xApiKey?: string;
+    body: ReportStageRequest;
+}
+interface ListSessionStagesParams {
+    sessionPublicId: string;
+    xApiKey?: string;
+}
+declare class StagesApi {
+    private client;
+    constructor(client: ApiClient);
+    /**
+     * Report Stage
+     * Report a durable stage lifecycle event (started, completed, or failed).
+     */
+    reportStage(params: ReportStageParams, options?: RequestOptions): Promise<ReportStageResponse>;
+    /**
+     * List Session Stages
+     * List all stages for a session, ordered by start time.
+     */
+    listSessionStages(params: ListSessionStagesParams, options?: RequestOptions): Promise<SessionStagesResponse>;
+}
+
 /**
  * starred_checkpoints API
  *
@@ -6532,6 +6977,7 @@ declare class ChronosClient {
     readonly sessions: SessionsApi;
     readonly settings: SettingsApi;
     readonly slack: SlackApi;
+    readonly stages: StagesApi;
     readonly starredCheckpoints: StarredCheckpointsApi;
     readonly status: StatusApi;
     readonly workspaceRepos: WorkspaceReposApi;
@@ -6543,4 +6989,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 AnchorSessionResponse, type AnnotationListResponse, type AnnotationMetricsResponse, type AnnotationResponse, type AnnotationTarget, AnnotationsApi, type AppConfigResponse, type Artifact, type AssignmentListResponse, type AssignmentPreviewItem, type AssignmentPreviewResponse, type AssignmentResponse, AssignmentsApi, type AuditEventCountsResponse, type AuditEventInput, type AuditEventResponse, type AuditEventsListResponse, type AuditSummaryEntry, type AuditSummaryResponse, AuthApi, type AuthSessionResponse, type AuthStatusResponse, type BatchCreateAssignmentsBody, type BranchInfo, type BranchListResponse, BrowserApi, type BulkRefAuditEventsRequest, type CheckpointListItem, type CheckpointListResponse, CheckpointsApi, type ChildSessionSummary, type ChildWorldConfig, ApiClient as ChronosApiClient, type ChronosApiDatasetsFoldersListResponse, type ChronosApiDatasetsRenameFolderRequest, type ChronosApiDatasetsRenameFolderResponse, ApiError as ChronosApiError, type ChronosApiExperimentsFoldersListResponse, type ChronosApiExperimentsRenameFolderRequest, type ChronosApiExperimentsRenameFolderResponse, 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 CreateAnchorSessionRequest, type CreateAnnotationRequest, type CreateAssignmentBody, type CreateBranchRequest, type CreateBranchResponse, type CreateDatasetRequest, type CreateReviewRequest, type CreateSessionRequest, type CreateSessionResponse, type CreateStepFile, type CreateStepRequest, type CreateStepResponse, type CreateTestRunRequest, type CreateWorkspaceRefRequest, type CreatorsListResponse, type DVCManifestEntry, type DailyUsageBucketResponse, type DatasetColumn, type DatasetColumnType, type DatasetDetailResponse, type DatasetFileCreateRequest, type DatasetFileListResponse, type DatasetFileResponse, type DatasetFileUpdateRequest, type DatasetResponse, type DatasetSessionSummary, type DatasetVersionCreateRequest, type DatasetVersionResponse, type DatasetVersionUpdateRequest, DatasetsApi, 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 ExperimentTestRunResponse, type ExperimentVersionResponse, ExperimentsApi, type FeatureFlagCheckResult, type FeedbackWidget, type FindOrCreateReviewBody, type FullLineageNode, type FullLineageResponse, type HTTPValidationError, HillclimbApi, type HillclimbIterationResponse, type HillclimbRunDetailResponse, type HillclimbRunResponse, type IssueReference, type IterationOutcome, type IterationSessionIcon, type IterationSessionResponse, JobsApi, type JsonValue, type LaunchExperimentRequest, type LaunchExperimentResponse, type LaunchExperimentSessionResult, type LaunchHillclimbRunRequest, type LaunchHillclimbRunResponse, type LaunchJobRequest, type LaunchJobResponse, type LinkPlatoSessionRequest, type LiveLogsResponse, type LogCoverageRuleSet, type LogScopePartitioning, type LogsDownloadResponse, type ModelRef, type NavigateAnchorSessionRequest, type OAuthRefreshResponse, type OTelMetricDataPoint, type OTelSpanListResponse, type OTelSpanSchema, type OTelTraceResponse, OtelApi, type PageScopeConfig, 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 RenderWidget, type RerunPreviewResponse, type RerunWithConfigRequest, type RetryConfig, type ReviewIssue, type ReviewListResponse, type ReviewResponse, type ReviewWidgetSchemaResponse, ReviewsApi, type RouteScopeConfig, type RunLifecycle, type RunProgress, type RunReviewsResponse, type SSOLoginRequest, type SavedFilterCreate, type SavedFilterListResponse, type SavedFilterResponse, SavedFiltersApi, type SavedSessionFilters, type ScreenshotResponse, type SendSlackMessageRequest, type SendSlackMessageResponse, type ServiceStatuses, type SessionCheckpointInfoResponse, type SessionCostEntry, type SessionCostSummaryResponse, type SessionCreator, type SessionEnvsResponse, type SessionLaunchConfig, type SessionLineageEntry, type SessionLineageResponse, type SessionListResponse, type SessionLogsResponse, type SessionLogsStreamEvent, 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, SlackApi, type SlackLookupResponse, type StarredCheckpointCreate, type StarredCheckpointListResponse, type StarredCheckpointResponse, type StarredCheckpointUpdate, StarredCheckpointsApi, StatusApi, type StatusResponse, type SyncAllResult, type SyncResult, type TagsListResponse, type TargetReviewSpec, type TargetSessionRef, type TestRunListResponse, type TokenSummaryRecord, type ToolStat, type ToolUsageCount, type TrajectoryAgentInfo, type TrajectoryMetrics, type TrajectoryObservation, type TrajectoryObservationResult, type TrajectorySandboxInfo, type TrajectoryToolCall, type TrajectoryWorldInfo, type UpdateAnnotationRequest, type UpdateAssignmentBody, type UpdateDatasetRequest, type UpdateFileRequest, type UpdateFileResponse, type UpdateNotesRequest, type UpdateReviewRequest, type UpdateRunRequest, type UpdateSettingRequest, type UpdateSpanNoteRequest, type UpdateStatusRequest, type UpdateTagsRequest, type UpdateTestRunRequest, type UpsertIterationRequest, type UpsertIterationSessionRequest, type UsageStatsResponse, type UserInfo, type UserLeaderboardEntry, type UserWorldStatsEntry, type VMResources, type ValidationError, type VersionResponse, type WorkspaceFilesResponse, type WorkspaceRefEntry, 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 };
+export { type ActiveAnalysis, type AddSessionsRequest, AdminApi, type AgentArtifactPath, type AgentCostEntry, 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 AnalyticsTimeseriesBucketResponse, type AnalyticsTimeseriesResponse, type AnalyzerSessionRef, type AnchorSessionResponse, type AnnotationListResponse, type AnnotationMetricsResponse, type AnnotationResponse, type AnnotationTarget, AnnotationsApi, type AppConfigResponse, type Artifact, type ArtifactBrowserNode, type AssignmentAnalyticsResponse, type AssignmentListResponse, type AssignmentPreviewItem, type AssignmentPreviewResponse, type AssignmentResponse, type AssignmentTypeInfo, AssignmentsApi, type AuditEventCountsResponse, type AuditEventInput, type AuditEventResponse, type AuditEventsListResponse, type AuditSummaryEntry, type AuditSummaryResponse, AuthApi, type AuthSessionResponse, type AuthStatusResponse, type AuthzCheckResponse, type BatchAssignmentItem, type BatchCreateAssignmentsBody, type BranchInfo, type BranchListResponse, BrowserApi, type BulkRefAuditEventsRequest, type CheckpointListItem, type CheckpointListResponse, CheckpointsApi, type ChildSessionSummary, type ChildWorldConfig, ApiClient as ChronosApiClient, type ChronosApiDatasetsFoldersListResponse, type ChronosApiDatasetsRenameFolderRequest, type ChronosApiDatasetsRenameFolderResponse, ApiError as ChronosApiError, type ChronosApiExperimentsFoldersListResponse, type ChronosApiExperimentsRenameFolderRequest, type ChronosApiExperimentsRenameFolderResponse, type ApiRequest as ChronosApiRequest, ChronosClient, type ClientConfig as ChronosClientConfig, type RequestOptions as ChronosRequestOptions, type ClaudeCodeOAuthRefreshRequest, type ClearDbResult, type CloseSessionResponse, type CommentPanelNode, 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 CreateAnchorSessionRequest, type CreateAnnotationRequest, type CreateAssignmentBody, type CreateBranchRequest, type CreateBranchResponse, type CreateDatasetRequest, type CreateReviewRequest, type CreateSessionRequest, type CreateSessionResponse, type CreateStepFile, type CreateStepRequest, type CreateStepResponse, type CreateTestRunRequest, type CreateWorkspaceRefRequest, type CreatorsListResponse, type DVCManifestEntry, type DailyUsageBucketResponse, type DatasetColumn, type DatasetColumnType, type DatasetDetailResponse, type DatasetFileCreateRequest, type DatasetFileListResponse, type DatasetFileResponse, type DatasetFileUpdateRequest, type DatasetResponse, type DatasetSessionSummary, type DatasetVersionCreateRequest, type DatasetVersionResponse, type DatasetVersionUpdateRequest, DatasetsApi, 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 ExperimentTestRunResponse, type ExperimentVersionResponse, ExperimentsApi, type FeatureFlagCheckResult, type FeedbackWidget, type FindOrCreateReviewBody, type FullLineageNode, type FullLineageResponse, type HTTPValidationError, HillclimbApi, type HillclimbIterationResponse, type HillclimbRunDetailResponse, type HillclimbRunResponse, type IssueReference, type IterationOutcome, type IterationSessionIcon, type IterationSessionResponse, JobsApi, type JsonValue, type LaunchExperimentRequest, type LaunchExperimentResponse, type LaunchExperimentSessionResult, type LaunchHillclimbRunRequest, type LaunchHillclimbRunResponse, type LaunchJobRequest, type LaunchJobResponse, type LinkPlatoSessionRequest, type LiveLogsResponse, type LogCoverageRuleSet, type LogScopePartitioning, type LogsDownloadResponse, type ModelRef, type NavigateAnchorSessionRequest, type NodeTreeInput, type NodeTreeOutput, 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 Ref, type RegistryAgentListResponse, type RegistryAgentSchemaResponse, type RegistryAgentVersionInfo, type RegistryAgentVersionsResponse, RegistryApi, type RegistryWorldInfo, type RenderWidget, type ReportStageRequest, type ReportStageResponse, type RerunPreviewResponse, type RerunWithConfigRequest, type RetryConfig, type ReviewIssue, type ReviewListResponse, type ReviewResponse, type ReviewWidgetSchemaResponse, type ReviewerAnalytics, ReviewsApi, type RunLifecycle, type RunProgress, type RunReviewsResponse, type SSOLoginRequest, type SavedFilterCreate, type SavedFilterListResponse, type SavedFilterResponse, SavedFiltersApi, type SavedSessionFilters, type ScreenshotCarouselNode, type ScreenshotRef, type ScreenshotResponse, type SendSlackMessageRequest, type SendSlackMessageResponse, type ServiceStatuses, type SessionCheckpointInfoResponse, type SessionCostEntry, type SessionCostSummaryResponse, type SessionCreator, type SessionEnvsResponse, type SessionLaunchConfig, type SessionLineageEntry, type SessionLineageResponse, type SessionListResponse, type SessionLogsResponse, type SessionLogsStreamEvent, 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 SessionStagesResponse, type SessionStatusResponse, type SessionStoredWorldConfig, type SessionSummary, type SessionToolSummary, type SessionTrajectory, type SessionWorldInfo, SessionsApi, type SettingResponse, SettingsApi, SlackApi, type SlackLookupResponse, type SplitNodeInput, type SplitNodeOutput, type StageResponse, StagesApi, type StarredCheckpointCreate, type StarredCheckpointListResponse, type StarredCheckpointResponse, type StarredCheckpointUpdate, StarredCheckpointsApi, type StaticValue, StatusApi, type StatusResponse, type SyncAllResult, type SyncResult, type TagsListResponse, type TargetReviewSpec, type TargetSessionRef, type TestRunListResponse, type TextNode, type TokenSummaryRecord, type ToolStat, type ToolUsageCount, type TrajectoryAgentInfo, type TrajectoryMetrics, type TrajectoryObservation, type TrajectoryObservationResult, type TrajectorySandboxInfo, type TrajectoryToolCall, type TrajectoryWorldInfo, type UpdateAnnotationRequest, type UpdateAssignmentBody, type UpdateDatasetRequest, type UpdateFileRequest, type UpdateFileResponse, type UpdateNodeRequest, type UpdateNotesRequest, type UpdateReviewRequest, type UpdateRunRequest, type UpdateSettingRequest, type UpdateSpanNoteRequest, type UpdateStatusRequest, type UpdateTagsRequest, type UpdateTestRunRequest, type UpsertIterationRequest, type UpsertIterationSessionRequest, type UsageStatsResponse, type UserInfo, type UserLeaderboardEntry, type UserWorldStatsEntry, type VMResources, type ValidationError, type VersionResponse, type WorkspaceFilesResponse, type WorkspaceRefEntry, 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 };