plato-sandbox-sdk 1.1.21 → 1.1.23

package/dist/chronos/index.d.mts

@@ -224,6 +224,7 @@ interface BranchInfo {
     last_step: string;
     num_refs: number;
     updated_at: string;
+    tags: string[];
 }
 
 /**
@@ -305,7 +306,7 @@ interface CloseSessionResponse {
  * Auto-generated - do not edit
  */
 interface CompleteSessionRequest {
-    /** Final status: 'completed' or 'failed' */
+    /** Final status: 'completed', 'failed', or 'needs_human_annotation' */
     status: string;
     /** Exit code from world runner */
     exit_code?: number | null;
@@ -377,6 +378,28 @@ interface CreatorsListResponse {
     creators: SessionCreator[];
 }
 
+/**
+ * DVCManifestEntry
+ * A single entry in a DVC .dir manifest JSON.
+
+This is the canonical schema for entries produced by the Python SDK
+(``DVCFileEntry``) and consumed by the API.  The raw manifest is
+returned to the frontend, which is responsible for filtering out
+directory entries (``isdir=True``) during rendering.
+ *
+ * Auto-generated - do not edit
+ */
+interface DVCManifestEntry {
+    relpath: string;
+    md5?: string | null;
+    size?: number | null;
+    mode?: number | null;
+    isdir?: boolean | null;
+    isexec?: boolean | null;
+    islink?: boolean | null;
+    symlink_target?: string | null;
+}
+
 /**
  * DirectoryListing
  * Files in a single DVC-tracked directory.
@@ -386,10 +409,35 @@ interface CreatorsListResponse {
 
 interface DirectoryListing {
     name: string;
-    files: FileEntry[];
+    entries: DVCManifestEntry[];
     total_size?: number | null;
 }
 
+/**
+ * DownstreamSessionEntry
+ * A session that consumed a given workspace ref.
+ *
+ * Auto-generated - do not edit
+ */
+interface DownstreamSessionEntry {
+    session_public_id: string;
+    step_name: string;
+    repo_name: string;
+    repo_id: string;
+    created_at: string;
+}
+
+/**
+ * DownstreamSessionsResponse
+ * Sessions that forked/resumed from a given ref.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface DownstreamSessionsResponse {
+    sessions: DownstreamSessionEntry[];
+}
+
 /**
  * EnvInfo
  * Information about an environment in the preview session.
@@ -418,15 +466,119 @@ interface EnvInfoResponse {
 }
 
 /**
- * FileEntry
- * A single file in a DVC-tracked directory.
+ * ExperimentFileCreateRequest
+ * Create a new experiment file and its first version.
  *
  * Auto-generated - do not edit
  */
-interface FileEntry {
-    relpath: string;
-    size?: number | null;
-    hash?: string | null;
+interface ExperimentFileCreateRequest {
+    name: string;
+    description?: string | null;
+    world_key?: string | null;
+    tags?: string[] | null;
+    notes?: string | null;
+    config_json?: Record<string, unknown> | null;
+}
+
+/**
+ * ExperimentFileListResponse
+ * List of experiment files.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ExperimentFileListResponse {
+    files: ExperimentFileResponse[];
+}
+
+/**
+ * ExperimentFileResponse
+ * Versioned experiment file payload.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ExperimentFileResponse {
+    public_id: string;
+    name: string;
+    description?: string | null;
+    world_key: string;
+    created_at: string;
+    updated_at: string;
+    created_by?: UserInfo | null;
+    latest_version?: ExperimentVersionResponse | null;
+    versions?: ExperimentVersionResponse[] | null;
+}
+
+/**
+ * ExperimentFileUpdateRequest
+ * Update top-level experiment file metadata.
+ *
+ * Auto-generated - do not edit
+ */
+interface ExperimentFileUpdateRequest {
+    name?: string | null;
+    description?: string | null;
+    world_key?: string | null;
+}
+
+/**
+ * ExperimentFileVersionCreateRequest
+ * Create a new immutable version for an experiment file.
+ *
+ * Auto-generated - do not edit
+ */
+interface ExperimentFileVersionCreateRequest {
+    tags?: string[] | null;
+    notes?: string | null;
+    config_json?: Record<string, unknown> | null;
+}
+
+/**
+ * ExperimentSessionSummary
+ * Session attached to an experiment file version.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ExperimentSessionSummary {
+    session_id: string;
+    status: string;
+    created_at: string;
+    tags?: string[] | null;
+    total_cost_usd?: number | null;
+    created_by?: UserInfo | null;
+}
+
+/**
+ * ExperimentVersionResponse
+ * Full experiment version payload for the frontend.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ExperimentVersionResponse {
+    public_id: string;
+    version_number: number;
+    tags?: string[] | null;
+    notes?: string | null;
+    created_at: string;
+    created_by?: UserInfo | null;
+    attached_session_count?: number | null;
+    config_json?: Record<string, unknown> | null;
+    attached_sessions?: ExperimentSessionSummary[] | null;
+}
+
+/**
+ * FeatureFlagCheckResult
+ * Result of checking a feature flag.
+ *
+ * Auto-generated - do not edit
+ */
+interface FeatureFlagCheckResult {
+    flag: string;
+    enabled: boolean;
+    org_id: number;
 }
 
 /**
@@ -455,6 +607,8 @@ interface LaunchJobRequest {
     allow_prerelease?: boolean | null;
     /** Parent session ID for nested sessions */
     parent_session_id?: string | null;
+    /** Optional preview-mode launch settings */
+    preview?: PreviewLaunchConfig | null;
 }
 
 /**
@@ -510,6 +664,7 @@ interface OTelSpan {
     end_time_unix_nano?: number | null;
     attributes?: Record<string, unknown> | null;
     status?: Record<string, unknown> | null;
+    is_error?: boolean | null;
 }
 
 /**
@@ -522,6 +677,7 @@ interface OTelSpan {
 interface OTelSpanListResponse {
     events: OTelSpan[];
     total_count?: number | null;
+    filtered_count?: number | null;
     has_more?: boolean | null;
     cursor?: string | null;
 }
@@ -537,10 +693,24 @@ interface OTelTraceResponse {
     session_id: string;
     spans: OTelSpan[];
     total_count?: number | null;
+    filtered_count?: number | null;
     has_more?: boolean | null;
     cursor?: string | null;
 }
 
+/**
+ * PreviewLaunchConfig
+ * Preview-specific launch settings.
+ *
+ * Auto-generated - do not edit
+ */
+interface PreviewLaunchConfig {
+    /** Run the world in preview mode with the preview entrypoint */
+    enabled?: boolean | null;
+    /** Preview lifetime in seconds (default: 10 minutes) */
+    timeout_seconds?: number | null;
+}
+
 /**
  * PreviewResponse
  * Response from launching a checkpoint preview.
@@ -640,6 +810,41 @@ interface SSOLoginRequest {
     token: string;
 }
 
+/**
+ * SavedFilterCreate
+ * Request to create a saved filter preset.
+ *
+ * Auto-generated - do not edit
+ */
+interface SavedFilterCreate {
+    name: string;
+    filters: Record<string, string | string[] | null>;
+}
+
+/**
+ * SavedFilterListResponse
+ * List of saved filter presets.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SavedFilterListResponse {
+    filters: SavedFilterResponse[];
+}
+
+/**
+ * SavedFilterResponse
+ * A single saved filter preset.
+ *
+ * Auto-generated - do not edit
+ */
+interface SavedFilterResponse {
+    id: number;
+    name: string;
+    filters: Record<string, string | string[] | null>;
+    created_at: string;
+}
+
 /**
  * ServiceStatuses
  * Status of connected services.
@@ -677,6 +882,32 @@ interface SessionEnvsResponse {
     envs: EnvInfoResponse[];
 }
 
+/**
+ * SessionLineageEntry
+ * One entry in a session lineage chain.
+ *
+ * Auto-generated - do not edit
+ */
+interface SessionLineageEntry {
+    session_public_id: string;
+    step_name: string;
+    repo_name: string;
+    repo_id: string;
+    ref_public_id?: string | null;
+    created_at: string;
+}
+
+/**
+ * SessionLineageResponse
+ * Ordered lineage chain for a session/workspace.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface SessionLineageResponse {
+    lineage: SessionLineageEntry[];
+}
+
 /**
  * SessionListResponse
  * List of sessions response.
@@ -694,9 +925,11 @@ interface SessionListResponse {
  *
  * Auto-generated - do not edit
  */
+
 interface SessionLogsResponse {
-    logs: unknown[];
+    logs: OTelSpan[];
     total_count?: number | null;
+    filtered_count?: number | null;
     has_more?: boolean | null;
     cursor?: string | null;
 }
@@ -723,6 +956,7 @@ interface SessionResponse {
     total_cost_usd?: number | null;
     logs_url?: string | null;
     tags?: string[] | null;
+    notes?: Record<string, unknown> | null;
     created_by?: UserInfo | null;
     parent_session_id?: string | null;
     child_sessions?: ChildSessionSummary[] | null;
@@ -771,6 +1005,64 @@ interface SessionWorldInfo {
     config_schema?: Record<string, unknown> | null;
 }
 
+/**
+ * StarredCheckpointCreate
+ * Request to star a checkpoint.
+ *
+ * Auto-generated - do not edit
+ */
+interface StarredCheckpointCreate {
+    session_id: string;
+    workspace: string;
+    step?: number | null;
+    step_name?: string | null;
+    ref_public_id?: string | null;
+    note?: string | null;
+}
+
+/**
+ * StarredCheckpointListResponse
+ * List of starred checkpoints.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface StarredCheckpointListResponse {
+    checkpoints: StarredCheckpointResponse[];
+}
+
+/**
+ * StarredCheckpointResponse
+ * A single starred checkpoint.
+ *
+ * Auto-generated - do not edit
+ */
+interface StarredCheckpointResponse {
+    id: number;
+    session_id: string;
+    workspace: string;
+    step: number | null;
+    step_name: string | null;
+    ref_public_id: string | null;
+    note: string | null;
+    session_tags?: string[] | null;
+    created_by?: Record<string, string | null> | null;
+    world_name?: string | null;
+    world_version?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+
+/**
+ * StarredCheckpointUpdate
+ * Request to update a starred checkpoint's note.
+ *
+ * Auto-generated - do not edit
+ */
+interface StarredCheckpointUpdate {
+    note?: string | null;
+}
+
 /**
  * StatusResponse
  * Overall status response.
@@ -912,6 +1204,40 @@ interface TrajectoryWorldInfo {
     steps?: WorldStep[] | null;
 }
 
+/**
+ * UpdateNotesRequest
+ * Request to update session notes (JSON blob).
+ *
+ * Auto-generated - do not edit
+ */
+interface UpdateNotesRequest {
+    /** Structured notes JSON */
+    notes?: Record<string, unknown> | null;
+}
+
+/**
+ * UpdateSpanNoteRequest
+ * Request to upsert a structured note for a specific trajectory span.
+ *
+ * Auto-generated - do not edit
+ */
+interface UpdateSpanNoteRequest {
+    /** User-authored note text. Empty/null removes the span note. */
+    note?: string | null;
+    /** Original span name */
+    span_name?: string | null;
+    /** Normalized display/type for the span */
+    span_type?: string | null;
+    /** Span source, such as agent/world/system */
+    source?: string | null;
+    /** ATIF step id when available */
+    atif_step_id?: number | null;
+    /** LLM model name when available */
+    model_name?: string | null;
+    /** Additional structured metadata for later querying */
+    metadata?: Record<string, unknown> | null;
+}
+
 /**
  * UpdateTagsRequest
  * Request to update session tags.
@@ -1015,6 +1341,33 @@ interface WorkspaceRefResponse {
     created_at: string;
 }
 
+/**
+ * WorkspaceRefSearchResponse
+ * Response for workspace ref search.
+ *
+ * Auto-generated - do not edit
+ */
+
+interface WorkspaceRefSearchResponse {
+    results: WorkspaceRefSearchResult[];
+}
+
+/**
+ * WorkspaceRefSearchResult
+ * Result of searching for a workspace ref by session:step format.
+ *
+ * Auto-generated - do not edit
+ */
+interface WorkspaceRefSearchResult {
+    repo_id: string;
+    repo_name: string;
+    session_public_id: string;
+    step_name: string;
+    ref_public_id: string;
+    direction: string;
+    created_at: string;
+}
+
 /**
  * WorkspaceRefsListResponse
  * List of workspace refs for a session.
@@ -1193,7 +1546,7 @@ interface WorldSchemaResponse {
     version?: string | null;
     config_schema?: Record<string, unknown> | null;
     secrets_schema?: Record<string, unknown> | null;
-    agent_slots?: Record<string, unknown>[] | null;
+    agents?: Record<string, unknown>[] | null;
     image?: string | null;
 }
 
@@ -1248,6 +1601,13 @@ interface SyncAllApiAdminSyncAllPostParams {
 interface ClearDatabaseApiAdminClearDbPostParams {
     xApiKey?: string;
 }
+interface ReloadFeatureFlagsApiAdminFeatureFlagsReloadPostParams {
+    xApiKey?: string;
+}
+interface CheckFeatureFlagApiAdminFeatureFlagsCheckFlagKeyGetParams {
+    flagKey: string;
+    xApiKey?: string;
+}
 declare class AdminApi {
     private client;
     constructor(client: ApiClient);
@@ -1271,6 +1631,16 @@ declare class AdminApi {
      * Clear ALL data from the database. Only available in local environment.
      */
     clearDatabaseApiAdminClearDbPost(params: ClearDatabaseApiAdminClearDbPostParams, options?: RequestOptions): Promise<ClearDbResult>;
+    /**
+     * Reload Feature Flags
+     * Force reload feature flag definitions from PostHog.
+     */
+    reloadFeatureFlagsApiAdminFeatureFlagsReloadPost(params: ReloadFeatureFlagsApiAdminFeatureFlagsReloadPostParams, options?: RequestOptions): Promise<Record<string, string>>;
+    /**
+     * Check Feature Flag
+     * Check the current value of a feature flag.
+     */
+    checkFeatureFlagApiAdminFeatureFlagsCheckFlagKeyGet(params: CheckFeatureFlagApiAdminFeatureFlagsCheckFlagKeyGetParams, options?: RequestOptions): Promise<FeatureFlagCheckResult>;
 }
 
 /**
@@ -1470,10 +1840,21 @@ interface ListSessionEventsParams {
     cursor?: string;
     /** Ignored, use cursor */
     offset?: number;
+    /** Search spans by keyword */
+    search?: string;
+    /** Only return error spans */
+    errorsOnly?: boolean;
+    /** Only return ATIF/agent spans */
+    atifOnly?: boolean;
+    /** Only return checkpoint spans */
+    checkpointOnly?: boolean;
+    /** Filter by plato.type attribute */
+    platoType?: string;
     xApiKey?: string;
 }
 interface GetSessionEventParams {
     spanId: string;
+    sessionPublicId?: string;
     xApiKey?: string;
 }
 declare class EventsApi {
@@ -1488,12 +1869,89 @@ declare class EventsApi {
      * Get Event
      * Get a span by ID.
   
-  Note: This requires scanning all batches, so it's not efficient.
-  Consider caching or indexing spans if this is used frequently.
+  Optionally pass session_public_id to narrow the search and verify org access.
+  Uses ClickHouse when available, falls back to scanning Postgres batches.
      */
     getSessionEvent(params: GetSessionEventParams, options?: RequestOptions): Promise<OTelSpan>;
 }
 
+/**
+ * experiments API
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ListExperimentFilesParams {
+    xApiKey?: string;
+}
+interface CreateExperimentFileParams {
+    xApiKey?: string;
+    body: ExperimentFileCreateRequest;
+}
+interface UpdateExperimentFileParams {
+    publicId: string;
+    xApiKey?: string;
+    body: ExperimentFileUpdateRequest;
+}
+interface DeleteExperimentFileParams {
+    publicId: string;
+    xApiKey?: string;
+}
+interface CreateExperimentFileVersionParams {
+    publicId: string;
+    xApiKey?: string;
+    body: ExperimentFileVersionCreateRequest;
+}
+interface AttachSessionToExperimentVersionParams {
+    publicId: string;
+    sessionPublicId: string;
+    xApiKey?: string;
+}
+interface DetachSessionFromExperimentVersionParams {
+    publicId: string;
+    sessionPublicId: string;
+    xApiKey?: string;
+}
+declare class ExperimentsApi {
+    private client;
+    constructor(client: ApiClient);
+    /**
+     * List Experiment Files
+     * List versioned experiment files for the current org.
+     */
+    listExperimentFiles(params: ListExperimentFilesParams, options?: RequestOptions): Promise<ExperimentFileListResponse>;
+    /**
+     * Create Experiment File
+     * Create a new experiment file and its initial version.
+     */
+    createExperimentFile(params: CreateExperimentFileParams, options?: RequestOptions): Promise<ExperimentFileResponse>;
+    /**
+     * Update Experiment File
+     * Update experiment file metadata without creating a new version.
+     */
+    updateExperimentFile(params: UpdateExperimentFileParams, options?: RequestOptions): Promise<ExperimentFileResponse>;
+    /**
+     * Delete Experiment File
+     * Delete an experiment file and all its versions and session links.
+     */
+    deleteExperimentFile(params: DeleteExperimentFileParams, options?: RequestOptions): Promise<void>;
+    /**
+     * Create Experiment File Version
+     * Create a new version for an experiment file.
+     */
+    createExperimentFileVersion(params: CreateExperimentFileVersionParams, options?: RequestOptions): Promise<ExperimentFileResponse>;
+    /**
+     * Attach Session To Experiment Version
+     * Attach an existing session to a specific experiment version.
+     */
+    attachSessionToExperimentVersion(params: AttachSessionToExperimentVersionParams, options?: RequestOptions): Promise<ExperimentFileResponse>;
+    /**
+     * Detach Session From Experiment Version
+     * Remove a session attachment from an experiment version.
+     */
+    detachSessionFromExperimentVersion(params: DetachSessionFromExperimentVersionParams, options?: RequestOptions): Promise<ExperimentFileResponse>;
+}
+
 /**
  * jobs API
  *
@@ -1504,19 +1962,30 @@ interface LaunchJobParams {
     xApiKey?: string;
     body: LaunchJobRequest;
 }
+interface LaunchPreviewJobParams {
+    xApiKey?: string;
+    body: LaunchJobRequest;
+}
+interface RerunJobParams {
+    publicId: string;
+    xApiKey?: string;
+}
 declare class JobsApi {
     private client;
     constructor(client: ApiClient);
     /**
      * Launch Job
-     * Launch a job with runtime package installation.
-  
-  This endpoint creates a VM from a base image and installs the world package
-  at runtime via uv. The base image comes from the world's schema.json.
-  
-  World and agent code is NOT baked into the image - it's installed at boot time.
      */
     launchJob(params: LaunchJobParams, options?: RequestOptions): Promise<LaunchJobResponse>;
+    /**
+     * Launch Preview Job
+     */
+    launchPreviewJob(params: LaunchPreviewJobParams, options?: RequestOptions): Promise<LaunchJobResponse>;
+    /**
+     * Rerun Job
+     * Re-run a previous session with the same stored config and runtime settings.
+     */
+    rerunJob(params: RerunJobParams, options?: RequestOptions): Promise<LaunchJobResponse>;
 }
 
 /**
@@ -1528,6 +1997,7 @@ declare class JobsApi {
 interface GetSessionMetricsApiOtelSessionsSessionIdMetricsGetParams {
     sessionId: string;
     envAlias?: string;
+    xApiKey?: string;
 }
 interface GetSessionTracesApiOtelSessionsSessionIdTracesGetParams {
     sessionId: string;
@@ -1536,6 +2006,17 @@ interface GetSessionTracesApiOtelSessionsSessionIdTracesGetParams {
     cursor?: string;
     /** Ignored, use cursor */
     offset?: number;
+    /** Search spans by keyword */
+    search?: string;
+    /** Only return error spans */
+    errorsOnly?: boolean;
+    /** Only return ATIF/agent spans */
+    atifOnly?: boolean;
+    /** Only return checkpoint spans */
+    checkpointOnly?: boolean;
+    /** Filter by plato.type attribute */
+    platoType?: string;
+    xApiKey?: string;
 }
 declare class OtelApi {
     private client;
@@ -1636,6 +2117,43 @@ declare class RegistryApi {
     getWorldSchemaApiRegistryWorldsPackageNameSchemaGet(params: GetWorldSchemaApiRegistryWorldsPackageNameSchemaGetParams, options?: RequestOptions): Promise<WorldSchemaResponse>;
 }
 
+/**
+ * saved_filters API
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ListSavedFiltersApiSavedFiltersGetParams {
+    xApiKey?: string;
+}
+interface CreateSavedFilterApiSavedFiltersPostParams {
+    xApiKey?: string;
+    body: SavedFilterCreate;
+}
+interface DeleteSavedFilterApiSavedFiltersFilterIdDeleteParams {
+    filterId: number;
+    xApiKey?: string;
+}
+declare class SavedFiltersApi {
+    private client;
+    constructor(client: ApiClient);
+    /**
+     * List Saved Filters
+     * List all saved filter presets for the current user.
+     */
+    listSavedFiltersApiSavedFiltersGet(params: ListSavedFiltersApiSavedFiltersGetParams, options?: RequestOptions): Promise<SavedFilterListResponse>;
+    /**
+     * Create Saved Filter
+     * Create a new saved filter preset.
+     */
+    createSavedFilterApiSavedFiltersPost(params: CreateSavedFilterApiSavedFiltersPostParams, options?: RequestOptions): Promise<SavedFilterResponse>;
+    /**
+     * Delete Saved Filter
+     * Delete a saved filter preset (must belong to current user).
+     */
+    deleteSavedFilterApiSavedFiltersFilterIdDelete(params: DeleteSavedFilterApiSavedFiltersFilterIdDeleteParams, options?: RequestOptions): Promise<void>;
+}
+
 /**
  * sessions API
  *
@@ -1647,6 +2165,8 @@ interface ListSessionsParams {
     tag?: string;
     /** Filter by exact tags (repeat query param, e.g. ?tags=foo&tags=bar) */
     tags?: string[];
+    /** How to combine repeated exact tags: 'or' matches any, 'and' requires all */
+    tagsMode?: string;
     /** Exclude sessions having ANY of these tags */
     excludeTags?: string[];
     /** Filter by creator user ID */
@@ -1692,6 +2212,17 @@ interface UpdateSessionTagsParams {
     xApiKey?: string;
     body: UpdateTagsRequest;
 }
+interface UpdateSessionNotesParams {
+    publicId: string;
+    xApiKey?: string;
+    body: UpdateNotesRequest;
+}
+interface UpdateSessionSpanNoteParams {
+    publicId: string;
+    spanId: string;
+    xApiKey?: string;
+    body: UpdateSpanNoteRequest;
+}
 interface CompleteSessionParams {
     publicId: string;
     xApiKey?: string;
@@ -1704,6 +2235,16 @@ interface GetSessionLogsParams {
     cursor?: string;
     /** Ignored, use cursor */
     offset?: number;
+    /** Search spans by keyword */
+    search?: string;
+    /** Only return error spans */
+    errorsOnly?: boolean;
+    /** Only return ATIF/agent spans */
+    atifOnly?: boolean;
+    /** Only return checkpoint spans */
+    checkpointOnly?: boolean;
+    /** Filter by plato.type attribute */
+    platoType?: string;
     xApiKey?: string;
 }
 interface GetSessionLogsDownloadParams {
@@ -1818,6 +2359,16 @@ declare class SessionsApi {
      * Update tags for a session.
      */
     updateSessionTags(params: UpdateSessionTagsParams, options?: RequestOptions): Promise<SessionResponse>;
+    /**
+     * Update Session Notes
+     * Update session-level notes while preserving structured sub-keys like span notes.
+     */
+    updateSessionNotes(params: UpdateSessionNotesParams, options?: RequestOptions): Promise<SessionResponse>;
+    /**
+     * Update Session Span Note
+     * Upsert or remove a structured note attached to a specific trajectory span.
+     */
+    updateSessionSpanNote(params: UpdateSessionSpanNoteParams, options?: RequestOptions): Promise<SessionResponse>;
     /**
      * Complete Session
      * Mark a session as completed or failed.
@@ -1916,6 +2467,55 @@ declare class SessionsApi {
     closeSession(params: CloseSessionParams, options?: RequestOptions): Promise<CloseSessionResponse>;
 }
 
+/**
+ * starred_checkpoints API
+ *
+ * Auto-generated - do not edit
+ */
+
+interface ListStarredCheckpointsApiStarredCheckpointsGetParams {
+    /** Filter by session ID */
+    sessionId?: string;
+    xApiKey?: string;
+}
+interface CreateStarredCheckpointApiStarredCheckpointsPostParams {
+    xApiKey?: string;
+    body: StarredCheckpointCreate;
+}
+interface UpdateStarredCheckpointApiStarredCheckpointsCheckpointIdPatchParams {
+    checkpointId: number;
+    xApiKey?: string;
+    body: StarredCheckpointUpdate;
+}
+interface DeleteStarredCheckpointApiStarredCheckpointsCheckpointIdDeleteParams {
+    checkpointId: number;
+    xApiKey?: string;
+}
+declare class StarredCheckpointsApi {
+    private client;
+    constructor(client: ApiClient);
+    /**
+     * List Starred Checkpoints
+     * List all starred checkpoints for the org, with session tags.
+     */
+    listStarredCheckpointsApiStarredCheckpointsGet(params: ListStarredCheckpointsApiStarredCheckpointsGetParams, options?: RequestOptions): Promise<StarredCheckpointListResponse>;
+    /**
+     * Create Starred Checkpoint
+     * Star a checkpoint (org-wide).
+     */
+    createStarredCheckpointApiStarredCheckpointsPost(params: CreateStarredCheckpointApiStarredCheckpointsPostParams, options?: RequestOptions): Promise<StarredCheckpointResponse>;
+    /**
+     * Update Starred Checkpoint
+     * Update a starred checkpoint's note.
+     */
+    updateStarredCheckpointApiStarredCheckpointsCheckpointIdPatch(params: UpdateStarredCheckpointApiStarredCheckpointsCheckpointIdPatchParams, options?: RequestOptions): Promise<StarredCheckpointResponse>;
+    /**
+     * Delete Starred Checkpoint
+     * Unstar a checkpoint.
+     */
+    deleteStarredCheckpointApiStarredCheckpointsCheckpointIdDelete(params: DeleteStarredCheckpointApiStarredCheckpointsCheckpointIdDeleteParams, options?: RequestOptions): Promise<void>;
+}
+
 /**
  * status API
  *
@@ -1951,6 +2551,11 @@ declare class StatusApi {
  * Auto-generated - do not edit
  */
 
+interface SearchWorkspaceRefsParams {
+    /** Search query. Supports session_id:step_name format for exact lookup, or a plain string to search across session IDs and step names. */
+    q: string;
+    xApiKey?: string;
+}
 interface ResolveWorkspaceRepoParams {
     xApiKey?: string;
     body: WorkspaceRepoResolveRequest;
@@ -1988,6 +2593,13 @@ interface ListWorkspaceFilesParams {
     refPublicId?: string;
     xApiKey?: string;
 }
+interface DownloadWorkspaceFilesParams {
+    sessionPublicId: string;
+    stepName: string;
+    repoName: string;
+    refPublicId?: string;
+    xApiKey?: string;
+}
 interface GetWorkspaceFileContentParams {
     sessionPublicId: string;
     repoName: string;
@@ -2000,6 +2612,16 @@ interface PromoteWorkspaceBranchParams {
     xApiKey?: string;
     body: PromoteBranchRequest;
 }
+interface GetSessionLineageParams {
+    sessionPublicId: string;
+    /** Workspace/repo name to trace lineage for */
+    workspace: string;
+    xApiKey?: string;
+}
+interface GetDownstreamSessionsParams {
+    refPublicId: string;
+    xApiKey?: string;
+}
 interface DeleteWorkspaceRepoParams {
     repoPublicId: string;
     xApiKey?: string;
@@ -2007,6 +2629,11 @@ interface DeleteWorkspaceRepoParams {
 declare class WorkspaceReposApi {
     private client;
     constructor(client: ApiClient);
+    /**
+     * Search Workspace Refs
+     * Search for workspace refs by session:step format or free text.
+     */
+    searchWorkspaceRefs(params: SearchWorkspaceRefsParams, options?: RequestOptions): Promise<WorkspaceRefSearchResponse>;
     /**
      * Resolve Workspace Repo
      * Resolve or create a workspace repo by name.
@@ -2053,6 +2680,14 @@ declare class WorkspaceReposApi {
   the latest ref matching step_name.
      */
     listWorkspaceFiles(params: ListWorkspaceFilesParams, options?: RequestOptions): Promise<WorkspaceFilesResponse>;
+    /**
+     * Download Workspace Files
+     * Stream a ZIP archive of all files in a workspace ref.
+  
+  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>;
     /**
      * Get Workspace File Content
      * Proxy a DVC-cached file from S3 to the browser (avoids CORS issues).
@@ -2063,6 +2698,16 @@ declare class WorkspaceReposApi {
      * Promote a branch to main by creating a new ref with branch='main'.
      */
     promoteWorkspaceBranch(params: PromoteWorkspaceBranchParams, options?: RequestOptions): Promise<WorkspaceRefResponse>;
+    /**
+     * Get Session Lineage
+     * Walk backward through source_ref links to build session lineage for a workspace.
+     */
+    getSessionLineage(params: GetSessionLineageParams, options?: RequestOptions): Promise<SessionLineageResponse>;
+    /**
+     * Get Downstream Sessions
+     * Find all sessions that consumed (forked/resumed from) a given workspace ref.
+     */
+    getDownstreamSessions(params: GetDownstreamSessionsParams, options?: RequestOptions): Promise<DownstreamSessionsResponse>;
     /**
      * Delete Workspace Repo
      * Delete a workspace repo and all its refs.
@@ -2182,10 +2827,13 @@ declare class ChronosClient {
     readonly checkpoints: CheckpointsApi;
     readonly default: DefaultApi;
     readonly events: EventsApi;
+    readonly experiments: ExperimentsApi;
     readonly jobs: JobsApi;
     readonly otel: OtelApi;
     readonly registry: RegistryApi;
+    readonly savedFilters: SavedFiltersApi;
     readonly sessions: SessionsApi;
+    readonly starredCheckpoints: StarredCheckpointsApi;
     readonly status: StatusApi;
     readonly workspaceRepos: WorkspaceReposApi;
     readonly worlds: WorldsApi;
@@ -2196,4 +2844,4 @@ declare class ChronosClient {
     getApiClient(): ApiClient;
 }
 
-export { AdminApi, type AgentCreate, type AgentInfo, type AgentListResponse, type AgentLookupResponse, type AgentResponse, type AgentSchemaResponse, type AgentStep, type AgentStepMetrics, type AgentTrace, type AgentTrajectory, type AgentVersionInfo, type AgentVersionsResponse, AgentsApi, type AppConfigResponse, type Artifact, AuthApi, type AuthSessionResponse, type AuthStatusResponse, type BranchInfo, type BranchListResponse, 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 CreateSessionRequest, type CreateSessionResponse, type CreateWorkspaceRefRequest, type CreatorsListResponse, DefaultApi, type DirectoryListing, type EnvInfo, type EnvInfoResponse, EventsApi, type FileEntry, type HTTPValidationError, JobsApi, type LaunchJobRequest, type LaunchJobResponse, type LiveLogsResponse, type LogsDownloadResponse, type OTelSpan, type OTelSpanListResponse, type OTelTraceResponse, OtelApi, type PreviewResponse, type PromoteBranchRequest, type RegistryAgentListResponse, type RegistryAgentSchemaResponse, type RegistryAgentVersionInfo, type RegistryAgentVersionsResponse, RegistryApi, type RegistryWorldInfo, type SSOLoginRequest, type ServiceStatuses, type SessionCreator, type SessionEnvsResponse, type SessionListResponse, type SessionLogsResponse, type SessionResponse, type SessionStatusResponse, type SessionTrajectory, type SessionWorldInfo, SessionsApi, StatusApi, type StatusResponse, type SyncAllResult, type SyncResult, type TagsListResponse, type TrajectoryAgentInfo, type TrajectoryMetrics, type TrajectoryObservation, type TrajectoryObservationResult, type TrajectorySandboxInfo, type TrajectoryToolCall, type TrajectoryWorldInfo, type UpdateTagsRequest, type UserInfo, type VMResources, type ValidationError, type VersionResponse, type WorkspaceFilesResponse, type WorkspaceRefResponse, 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 { AdminApi, type AgentCreate, type AgentInfo, type AgentListResponse, type AgentLookupResponse, type AgentResponse, type AgentSchemaResponse, type AgentStep, type AgentStepMetrics, type AgentTrace, type AgentTrajectory, type AgentVersionInfo, type AgentVersionsResponse, AgentsApi, type AppConfigResponse, type Artifact, AuthApi, type AuthSessionResponse, type AuthStatusResponse, type BranchInfo, type BranchListResponse, 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 CreateSessionRequest, type CreateSessionResponse, type CreateWorkspaceRefRequest, type CreatorsListResponse, type DVCManifestEntry, DefaultApi, type DirectoryListing, type DownstreamSessionEntry, type DownstreamSessionsResponse, type EnvInfo, type EnvInfoResponse, EventsApi, type ExperimentFileCreateRequest, type ExperimentFileListResponse, type ExperimentFileResponse, type ExperimentFileUpdateRequest, type ExperimentFileVersionCreateRequest, type ExperimentSessionSummary, type ExperimentVersionResponse, ExperimentsApi, type FeatureFlagCheckResult, type HTTPValidationError, JobsApi, type LaunchJobRequest, type LaunchJobResponse, type LiveLogsResponse, type LogsDownloadResponse, type OTelSpan, type OTelSpanListResponse, type OTelTraceResponse, OtelApi, type PreviewLaunchConfig, type PreviewResponse, type PromoteBranchRequest, type RegistryAgentListResponse, type RegistryAgentSchemaResponse, type RegistryAgentVersionInfo, type RegistryAgentVersionsResponse, RegistryApi, type RegistryWorldInfo, type SSOLoginRequest, type SavedFilterCreate, type SavedFilterListResponse, type SavedFilterResponse, SavedFiltersApi, type ServiceStatuses, type SessionCreator, type SessionEnvsResponse, type SessionLineageEntry, type SessionLineageResponse, type SessionListResponse, type SessionLogsResponse, type SessionResponse, type SessionStatusResponse, type SessionTrajectory, type SessionWorldInfo, SessionsApi, type StarredCheckpointCreate, type StarredCheckpointListResponse, type StarredCheckpointResponse, type StarredCheckpointUpdate, StarredCheckpointsApi, StatusApi, type StatusResponse, type SyncAllResult, type SyncResult, type TagsListResponse, type TrajectoryAgentInfo, type TrajectoryMetrics, type TrajectoryObservation, type TrajectoryObservationResult, type TrajectorySandboxInfo, type TrajectoryToolCall, type TrajectoryWorldInfo, type UpdateNotesRequest, type UpdateSpanNoteRequest, type UpdateTagsRequest, type UserInfo, 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 };