@chengxianglibra/dsh-data-analysis 0.3.0 → 0.3.1

package/lib/types/presentation/rpc.d.ts

@@ -1,4 +1,5 @@
 import type { HostConnectionHandle } from '@deepseek-ai/dsh-client-connection';
+import { type SavedReportRef } from './contracts/report-ref.ts';
 import type { AnalysisDrafts } from './drafts.ts';
 export interface PresentationWorkspace {
     id: string;
@@ -1484,6 +1485,1363 @@ export declare class MarivoPresentationFileService {
         schemaVersion: "dsh.analysis-ui/v3";
     }>;
     resourceStream(payload: unknown, caller: AbortSignal): Promise<import("./contracts/resource-stream.ts").ResourceStreamResponse>;
+    readSavedReport(scope: {
+        sessionId: string;
+    } | {
+        workspaceId: string;
+    }, ref: SavedReportRef, caller: AbortSignal): Promise<{
+        workspaceId: string;
+        reportId: string;
+        buildId: string;
+        recordId: string;
+        title: string;
+        locale: "zh-CN" | "en-US";
+        generatedAt: string;
+        catalog: {
+            id: "dsh-data-analysis/analysis-ui/v1";
+            build: string;
+        };
+        program: string;
+        resources: Record<string, {
+            kind: "snapshot";
+            declaration: {
+                kind: "analysis-frame";
+                ref: {
+                    schema: "marivo.frame_ref/v2";
+                    store_id: string;
+                    session_id: string;
+                    artifact_id: string;
+                };
+                codeRef?: {
+                    executionId: string;
+                    sha256: string;
+                } | undefined;
+            } | {
+                kind: "dataframe";
+                ref: {
+                    schema: "marivo.dataframe_ref/v2";
+                    project_root: string;
+                    result_id: string;
+                };
+                codeRef?: {
+                    executionId: string;
+                    sha256: string;
+                } | undefined;
+            } | {
+                kind: "dataset-snapshot";
+                snapshotRef: string;
+            } | {
+                kind: "frame-snapshot";
+                snapshotRef: string;
+            } | {
+                kind: "image-file";
+                path: string;
+            };
+            snapshot: {
+                kind: "dataset";
+                source: {
+                    kind: "dataframe";
+                    details: "not-captured";
+                };
+                schemaVersion: 1;
+                fetchedAt: string;
+                data: import("./contracts/types.ts").TypedDataset;
+                coverage: {
+                    start: 0;
+                    totalRows: number;
+                    capturedRows: number;
+                    complete: boolean;
+                    columns: string[];
+                    business: "unknown";
+                };
+            } | {
+                schemaVersion: 2;
+                kind: "frame";
+                source: {
+                    kind: "frame";
+                    sessionId: string;
+                    artifactId: string | null;
+                };
+                frame: {
+                    inputId: string;
+                    description: string | null;
+                    fields: {
+                        id: string;
+                        role: "value" | "coordinate" | "presence";
+                        slotId?: string | undefined;
+                        axisToken?: string | undefined;
+                    }[];
+                    layout: ({
+                        kind: "field";
+                        name: string;
+                        slotId: string;
+                    } | {
+                        kind: "coordinate";
+                        name: string;
+                        axisToken: string;
+                        endpoint: "self" | "left" | "right";
+                        part: "key" | "end" | "label" | "start" | "nominal_start" | "nominal_end";
+                    })[];
+                    slots: {
+                        id: string;
+                        slotId: string;
+                        dtype: {
+                            type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                            precision?: number | undefined;
+                            scale?: number | undefined;
+                            timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                            timezone?: string | undefined;
+                        };
+                        nullable: boolean;
+                        unit: string | null;
+                    }[];
+                    axes: {
+                        token: string;
+                        name: string;
+                        role: string;
+                        keys: {
+                            id: string;
+                            slotId: string;
+                            dtype: {
+                                type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                precision?: number | undefined;
+                                scale?: number | undefined;
+                                timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                timezone?: string | undefined;
+                            };
+                            nullable: boolean;
+                            unit: string | null;
+                        }[];
+                        variant: {
+                            kind: "ordinary";
+                        } | {
+                            kind: "calendar";
+                            timezone: string;
+                            grain: {
+                                kind: "builtin";
+                                unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+                                step: number;
+                            } | {
+                                kind: "named";
+                                ref: {
+                                    kind: string;
+                                    path: string;
+                                    definitionId: string;
+                                };
+                                level: string;
+                            };
+                        } | {
+                            kind: "interval";
+                            timezone: string;
+                        } | {
+                            kind: "paired";
+                            left: {
+                                kind: "calendar";
+                                name: string;
+                                at: string | null;
+                                timezone: string;
+                                grain: {
+                                    kind: "builtin";
+                                    unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+                                    step: number;
+                                } | {
+                                    kind: "named";
+                                    ref: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    };
+                                    level: string;
+                                };
+                            } | {
+                                kind: "interval";
+                                name: string;
+                                at: string | null;
+                                timezone: string;
+                            };
+                            right: {
+                                kind: "calendar";
+                                name: string;
+                                at: string | null;
+                                timezone: string;
+                                grain: {
+                                    kind: "builtin";
+                                    unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+                                    step: number;
+                                } | {
+                                    kind: "named";
+                                    ref: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    };
+                                    level: string;
+                                };
+                            } | {
+                                kind: "interval";
+                                name: string;
+                                at: string | null;
+                                timezone: string;
+                            };
+                        };
+                    }[];
+                    coordinates: Record<string, {
+                        column: {
+                            id: string;
+                            label: string;
+                            type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                            nullable: boolean;
+                            unit?: string | undefined;
+                        };
+                        values: (string | number | boolean | null)[];
+                    }>;
+                    readStats: {
+                        dataRowsRead: number;
+                        coordinateRowsRead: number;
+                        receiptBytesHashed: number;
+                    };
+                    sections: {
+                        semantics: {
+                            status: "captured";
+                            columns: {
+                                role: "value" | "presence" | "axis";
+                                id: string;
+                                valueOrigins: {
+                                    kind: string;
+                                    path: string;
+                                    definitionId: string;
+                                }[];
+                                contextOrigins: {
+                                    kind: string;
+                                    path: string;
+                                    definitionId: string;
+                                }[];
+                                omittedOrigins: number;
+                            }[];
+                        } | {
+                            status: "unavailable";
+                            reason: "budget" | "runtime-incompatible" | "read-failed" | "identity-mismatch";
+                        };
+                        interpretation: {
+                            status: "captured";
+                            fixedAxes: {
+                                token: string;
+                                name: string;
+                                role: "field" | "identity";
+                                keys: {
+                                    id: string;
+                                    slotId: string;
+                                    dtype: {
+                                        type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                        precision?: number | undefined;
+                                        scale?: number | undefined;
+                                        timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                        timezone?: string | undefined;
+                                    };
+                                    nullable: boolean;
+                                    unit: string | null;
+                                }[];
+                                key: (string | number | boolean | null)[];
+                                origins: {
+                                    kind: string;
+                                    path: string;
+                                    definitionId: string;
+                                }[];
+                            }[];
+                            valueContexts: Record<string, {
+                                kind: "observation";
+                                subject: {
+                                    kind: string;
+                                    path: string;
+                                    definitionId: string;
+                                } | null;
+                                time: {
+                                    kind: "axis";
+                                    axisToken: string;
+                                    endpoint: "self" | "left" | "right";
+                                } | {
+                                    kind: "compared";
+                                    comparison: number;
+                                    endpoint: "current" | "baseline";
+                                } | {
+                                    kind: "fixed";
+                                    start: string;
+                                    end: string;
+                                    timezone: string;
+                                } | null;
+                                window: {
+                                    kind: "all_history";
+                                } | {
+                                    kind: "since";
+                                    start: string;
+                                } | {
+                                    kind: "to_date";
+                                    grain: {
+                                        kind: "builtin";
+                                        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+                                        step: number;
+                                    } | {
+                                        kind: "named";
+                                        ref: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        };
+                                        level: string;
+                                    };
+                                } | {
+                                    kind: "trailing_duration";
+                                    seconds: number;
+                                } | {
+                                    kind: "trailing_periods";
+                                    count: number;
+                                } | null;
+                            } | {
+                                kind: "statistic";
+                                statistic: "sum" | "mean" | "row_count";
+                                groups: ({
+                                    kind: "axis";
+                                    axisToken: string;
+                                } | {
+                                    kind: "fixed";
+                                    fixed: {
+                                        token: string;
+                                        name: string;
+                                        role: "field" | "identity";
+                                        keys: {
+                                            id: string;
+                                            slotId: string;
+                                            dtype: {
+                                                type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                                precision?: number | undefined;
+                                                scale?: number | undefined;
+                                                timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                                timezone?: string | undefined;
+                                            };
+                                            nullable: boolean;
+                                            unit: string | null;
+                                        }[];
+                                        key: (string | number | boolean | null)[];
+                                        origins: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        }[];
+                                    };
+                                })[];
+                                rowScope: "complete" | "restricted";
+                            } | {
+                                kind: "share";
+                                numerator: {
+                                    kind: "named";
+                                    name: string;
+                                    subject: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    } | null;
+                                } | {
+                                    kind: "derived";
+                                    origins: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    }[];
+                                };
+                                groups: ({
+                                    kind: "axis";
+                                    axisToken: string;
+                                } | {
+                                    kind: "fixed";
+                                    fixed: {
+                                        token: string;
+                                        name: string;
+                                        role: "field" | "identity";
+                                        keys: {
+                                            id: string;
+                                            slotId: string;
+                                            dtype: {
+                                                type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                                precision?: number | undefined;
+                                                scale?: number | undefined;
+                                                timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                                timezone?: string | undefined;
+                                            };
+                                            nullable: boolean;
+                                            unit: string | null;
+                                        }[];
+                                        key: (string | number | boolean | null)[];
+                                        origins: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        }[];
+                                    };
+                                })[];
+                                along: ({
+                                    kind: "axis";
+                                    axisToken: string;
+                                } | {
+                                    kind: "fixed";
+                                    fixed: {
+                                        token: string;
+                                        name: string;
+                                        role: "field" | "identity";
+                                        keys: {
+                                            id: string;
+                                            slotId: string;
+                                            dtype: {
+                                                type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                                precision?: number | undefined;
+                                                scale?: number | undefined;
+                                                timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                                timezone?: string | undefined;
+                                            };
+                                            nullable: boolean;
+                                            unit: string | null;
+                                        }[];
+                                        key: (string | number | boolean | null)[];
+                                        origins: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        }[];
+                                    };
+                                })[];
+                                rowScope: "complete" | "restricted";
+                            } | {
+                                kind: "pair_statistic";
+                                statistic: "pearson" | "spearman" | "pair_count";
+                                x: {
+                                    kind: "named";
+                                    name: string;
+                                    subject: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    } | null;
+                                } | {
+                                    kind: "derived";
+                                    origins: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    }[];
+                                };
+                                y: {
+                                    kind: "named";
+                                    name: string;
+                                    subject: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    } | null;
+                                } | {
+                                    kind: "derived";
+                                    origins: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    }[];
+                                };
+                                groups: ({
+                                    kind: "axis";
+                                    axisToken: string;
+                                } | {
+                                    kind: "fixed";
+                                    fixed: {
+                                        token: string;
+                                        name: string;
+                                        role: "field" | "identity";
+                                        keys: {
+                                            id: string;
+                                            slotId: string;
+                                            dtype: {
+                                                type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                                precision?: number | undefined;
+                                                scale?: number | undefined;
+                                                timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                                timezone?: string | undefined;
+                                            };
+                                            nullable: boolean;
+                                            unit: string | null;
+                                        }[];
+                                        key: (string | number | boolean | null)[];
+                                        origins: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        }[];
+                                    };
+                                })[];
+                                rowScope: "complete" | "restricted";
+                            }>;
+                            comparisons: {
+                                alias: string | null;
+                                groups: {
+                                    name: string;
+                                    values: {
+                                        role: "current" | "baseline" | "absolute" | "relative";
+                                        name: string;
+                                    }[];
+                                    currentContext: {
+                                        kind: "observation";
+                                        subject: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        } | null;
+                                        time: {
+                                            kind: "axis";
+                                            axisToken: string;
+                                            endpoint: "self" | "left" | "right";
+                                        } | {
+                                            kind: "compared";
+                                            comparison: number;
+                                            endpoint: "current" | "baseline";
+                                        } | {
+                                            kind: "fixed";
+                                            start: string;
+                                            end: string;
+                                            timezone: string;
+                                        } | null;
+                                        window: {
+                                            kind: "all_history";
+                                        } | {
+                                            kind: "since";
+                                            start: string;
+                                        } | {
+                                            kind: "to_date";
+                                            grain: {
+                                                kind: "builtin";
+                                                unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+                                                step: number;
+                                            } | {
+                                                kind: "named";
+                                                ref: /*elided*/ any;
+                                                level: string;
+                                            };
+                                        } | {
+                                            kind: "trailing_duration";
+                                            seconds: number;
+                                        } | {
+                                            kind: "trailing_periods";
+                                            count: number;
+                                        } | null;
+                                    } | {
+                                        kind: "statistic";
+                                        statistic: "sum" | "mean" | "row_count";
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | {
+                                        kind: "share";
+                                        numerator: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        along: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | {
+                                        kind: "pair_statistic";
+                                        statistic: "pearson" | "spearman" | "pair_count";
+                                        x: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        y: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | null;
+                                    baselineContext: {
+                                        kind: "observation";
+                                        subject: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        } | null;
+                                        time: {
+                                            kind: "axis";
+                                            axisToken: string;
+                                            endpoint: "self" | "left" | "right";
+                                        } | {
+                                            kind: "compared";
+                                            comparison: number;
+                                            endpoint: "current" | "baseline";
+                                        } | {
+                                            kind: "fixed";
+                                            start: string;
+                                            end: string;
+                                            timezone: string;
+                                        } | null;
+                                        window: {
+                                            kind: "all_history";
+                                        } | {
+                                            kind: "since";
+                                            start: string;
+                                        } | {
+                                            kind: "to_date";
+                                            grain: {
+                                                kind: "builtin";
+                                                unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+                                                step: number;
+                                            } | {
+                                                kind: "named";
+                                                ref: /*elided*/ any;
+                                                level: string;
+                                            };
+                                        } | {
+                                            kind: "trailing_duration";
+                                            seconds: number;
+                                        } | {
+                                            kind: "trailing_periods";
+                                            count: number;
+                                        } | null;
+                                    } | {
+                                        kind: "statistic";
+                                        statistic: "sum" | "mean" | "row_count";
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | {
+                                        kind: "share";
+                                        numerator: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        along: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | {
+                                        kind: "pair_statistic";
+                                        statistic: "pearson" | "spearman" | "pair_count";
+                                        x: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        y: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | null;
+                                }[];
+                                binding: {
+                                    kind: "ordinary";
+                                } | {
+                                    kind: "calendar";
+                                    axisToken: string;
+                                    endpoint: "self" | "left" | "right";
+                                    baseline: {
+                                        kind: "calendar";
+                                        name: string;
+                                        at: string | null;
+                                        timezone: string;
+                                        grain: {
+                                            kind: "builtin";
+                                            unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+                                            step: number;
+                                        } | {
+                                            kind: "named";
+                                            ref: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            };
+                                            level: string;
+                                        };
+                                    };
+                                } | {
+                                    kind: "interval";
+                                    axisToken: string;
+                                    endpoint: "self" | "left" | "right";
+                                    baseline: {
+                                        kind: "interval";
+                                        name: string;
+                                        at: string | null;
+                                        timezone: string;
+                                    };
+                                };
+                                presence: {
+                                    current: string;
+                                    baseline: string;
+                                    enclosing: string[];
+                                } | null;
+                                currentFixedAxes: {
+                                    token: string;
+                                    name: string;
+                                    role: "field" | "identity";
+                                    keys: {
+                                        id: string;
+                                        slotId: string;
+                                        dtype: {
+                                            type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                            precision?: number | undefined;
+                                            scale?: number | undefined;
+                                            timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                            timezone?: string | undefined;
+                                        };
+                                        nullable: boolean;
+                                        unit: string | null;
+                                    }[];
+                                    key: (string | number | boolean | null)[];
+                                    origins: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    }[];
+                                }[];
+                                baselineFixedAxes: {
+                                    token: string;
+                                    name: string;
+                                    role: "field" | "identity";
+                                    keys: {
+                                        id: string;
+                                        slotId: string;
+                                        dtype: {
+                                            type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                            precision?: number | undefined;
+                                            scale?: number | undefined;
+                                            timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                            timezone?: string | undefined;
+                                        };
+                                        nullable: boolean;
+                                        unit: string | null;
+                                    }[];
+                                    key: (string | number | boolean | null)[];
+                                    origins: {
+                                        kind: string;
+                                        path: string;
+                                        definitionId: string;
+                                    }[];
+                                }[];
+                            }[];
+                            decompositions: {
+                                target: {
+                                    kind: "level";
+                                    name: string;
+                                    context: {
+                                        kind: "observation";
+                                        subject: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        } | null;
+                                        time: {
+                                            kind: "axis";
+                                            axisToken: string;
+                                            endpoint: "self" | "left" | "right";
+                                        } | {
+                                            kind: "compared";
+                                            comparison: number;
+                                            endpoint: "current" | "baseline";
+                                        } | {
+                                            kind: "fixed";
+                                            start: string;
+                                            end: string;
+                                            timezone: string;
+                                        } | null;
+                                        window: {
+                                            kind: "all_history";
+                                        } | {
+                                            kind: "since";
+                                            start: string;
+                                        } | {
+                                            kind: "to_date";
+                                            grain: {
+                                                kind: "builtin";
+                                                unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+                                                step: number;
+                                            } | {
+                                                kind: "named";
+                                                ref: /*elided*/ any;
+                                                level: string;
+                                            };
+                                        } | {
+                                            kind: "trailing_duration";
+                                            seconds: number;
+                                        } | {
+                                            kind: "trailing_periods";
+                                            count: number;
+                                        } | null;
+                                    } | {
+                                        kind: "statistic";
+                                        statistic: "sum" | "mean" | "row_count";
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | {
+                                        kind: "share";
+                                        numerator: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        along: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | {
+                                        kind: "pair_statistic";
+                                        statistic: "pearson" | "spearman" | "pair_count";
+                                        x: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        y: {
+                                            kind: "named";
+                                            name: string;
+                                            subject: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            } | null;
+                                        } | {
+                                            kind: "derived";
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                        groups: ({
+                                            kind: "axis";
+                                            axisToken: string;
+                                        } | {
+                                            kind: "fixed";
+                                            fixed: {
+                                                token: string;
+                                                name: string;
+                                                role: "field" | "identity";
+                                                keys: /*elided*/ any[];
+                                                key: (string | number | boolean | null)[];
+                                                origins: /*elided*/ any[];
+                                            };
+                                        })[];
+                                        rowScope: "complete" | "restricted";
+                                    } | null;
+                                } | {
+                                    kind: "absolute";
+                                    comparison: number;
+                                    group: string;
+                                } | {
+                                    kind: "relative";
+                                    comparison: number;
+                                    group: string;
+                                };
+                                groups: ({
+                                    kind: "axis";
+                                    axisToken: string;
+                                } | {
+                                    kind: "fixed";
+                                    fixed: {
+                                        token: string;
+                                        name: string;
+                                        role: "field" | "identity";
+                                        keys: {
+                                            id: string;
+                                            slotId: string;
+                                            dtype: {
+                                                type: "string" | "boolean" | "date" | "float64" | "int64" | "decimal" | "datetime";
+                                                precision?: number | undefined;
+                                                scale?: number | undefined;
+                                                timeUnit?: "s" | "ms" | "us" | "ns" | undefined;
+                                                timezone?: string | undefined;
+                                            };
+                                            nullable: boolean;
+                                            unit: string | null;
+                                        }[];
+                                        key: (string | number | boolean | null)[];
+                                        origins: {
+                                            kind: string;
+                                            path: string;
+                                            definitionId: string;
+                                        }[];
+                                    };
+                                })[];
+                                rowScope: "complete" | "restricted";
+                                outputs: {
+                                    fieldKind: "value" | "presence";
+                                    role: "value" | "current" | "baseline" | "share" | "numerator" | "absolute" | "contribution" | "total" | "observed_total" | "denominator" | "valid_count" | "current_present" | "baseline_present" | "value_present" | "numerator_current" | "numerator_baseline" | "denominator_current" | "denominator_baseline" | "valid_count_current" | "valid_count_baseline" | "effect_within" | "effect_mix" | "effect_entry_exit" | "effect_additive" | "contribution_std_error";
+                                    name: string;
+                                }[];
+                            }[];
+                            alignments: {
+                                left: {
+                                    values: string[];
+                                    presence: string[];
+                                    coordinates: ({
+                                        kind: "axis";
+                                        axisToken: string;
+                                        endpoint: "self" | "left" | "right";
+                                    } | {
+                                        kind: "fixed";
+                                        fixed: {
+                                            token: string;
+                                            name: string;
+                                            role: "field" | "identity";
+                                            keys: {
+                                                id: string;
+                                                slotId: string;
+                                                dtype: /*elided*/ any;
+                                                nullable: boolean;
+                                                unit: string | null;
+                                            }[];
+                                            key: (string | number | boolean | null)[];
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                    })[];
+                                };
+                                right: {
+                                    values: string[];
+                                    presence: string[];
+                                    coordinates: ({
+                                        kind: "axis";
+                                        axisToken: string;
+                                        endpoint: "self" | "left" | "right";
+                                    } | {
+                                        kind: "fixed";
+                                        fixed: {
+                                            token: string;
+                                            name: string;
+                                            role: "field" | "identity";
+                                            keys: {
+                                                id: string;
+                                                slotId: string;
+                                                dtype: /*elided*/ any;
+                                                nullable: boolean;
+                                                unit: string | null;
+                                            }[];
+                                            key: (string | number | boolean | null)[];
+                                            origins: {
+                                                kind: string;
+                                                path: string;
+                                                definitionId: string;
+                                            }[];
+                                        };
+                                    })[];
+                                };
+                            }[];
+                        } | {
+                            status: "unavailable";
+                            reason: "budget" | "runtime-incompatible" | "read-failed" | "identity-mismatch";
+                        };
+                        periods: {
+                            status: "captured";
+                            pages: {
+                                target: {
+                                    kind: "axis";
+                                    axisToken: string;
+                                } | {
+                                    kind: "comparison";
+                                    comparison: number;
+                                };
+                                totalCount: number;
+                                hasMore: boolean;
+                                items: ({
+                                    kind: "calendar";
+                                    key: (string | number | boolean | null)[];
+                                    timezone: string;
+                                    start: string;
+                                    end: string;
+                                    label: string | number | boolean | null;
+                                    nominalStart: string;
+                                    nominalEnd: string;
+                                } | {
+                                    kind: "calendar";
+                                    key: (string | number | boolean | null)[];
+                                    timezone: string;
+                                    label: string | number | boolean | null;
+                                    selection: "unavailable" | "full" | "prefix" | "partial";
+                                    cutoff: string | null;
+                                } | {
+                                    kind: "interval";
+                                    key: (string | number | boolean | null)[];
+                                    timezone: string;
+                                    start: string;
+                                    end: string;
+                                } | {
+                                    kind: "paired";
+                                    key: (string | number | boolean | null)[];
+                                    left: {
+                                        kind: "calendar";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        start: string;
+                                        end: string;
+                                        label: string | number | boolean | null;
+                                        nominalStart: string;
+                                        nominalEnd: string;
+                                    } | {
+                                        kind: "calendar";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        label: string | number | boolean | null;
+                                        selection: "unavailable" | "full" | "prefix" | "partial";
+                                        cutoff: string | null;
+                                    } | {
+                                        kind: "interval";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        start: string;
+                                        end: string;
+                                    } | null;
+                                    right: {
+                                        kind: "calendar";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        start: string;
+                                        end: string;
+                                        label: string | number | boolean | null;
+                                        nominalStart: string;
+                                        nominalEnd: string;
+                                    } | {
+                                        kind: "calendar";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        label: string | number | boolean | null;
+                                        selection: "unavailable" | "full" | "prefix" | "partial";
+                                        cutoff: string | null;
+                                    } | {
+                                        kind: "interval";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        start: string;
+                                        end: string;
+                                    } | null;
+                                } | {
+                                    kind: "comparison";
+                                    key: (string | number | boolean | null)[];
+                                    current: {
+                                        kind: "calendar";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        start: string;
+                                        end: string;
+                                        label: string | number | boolean | null;
+                                        nominalStart: string;
+                                        nominalEnd: string;
+                                    } | {
+                                        kind: "calendar";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        label: string | number | boolean | null;
+                                        selection: "unavailable" | "full" | "prefix" | "partial";
+                                        cutoff: string | null;
+                                    } | {
+                                        kind: "interval";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        start: string;
+                                        end: string;
+                                    };
+                                    baseline: {
+                                        kind: "calendar";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        start: string;
+                                        end: string;
+                                        label: string | number | boolean | null;
+                                        nominalStart: string;
+                                        nominalEnd: string;
+                                    } | {
+                                        kind: "calendar";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        label: string | number | boolean | null;
+                                        selection: "unavailable" | "full" | "prefix" | "partial";
+                                        cutoff: string | null;
+                                    } | {
+                                        kind: "interval";
+                                        key: (string | number | boolean | null)[];
+                                        timezone: string;
+                                        start: string;
+                                        end: string;
+                                    } | null;
+                                    absentReason: "period_absent" | "cutoff_absent" | "unmatched" | null;
+                                })[];
+                            }[];
+                        } | {
+                            status: "unavailable";
+                            reason: "budget" | "runtime-incompatible" | "read-failed" | "identity-mismatch";
+                        };
+                    };
+                };
+                fetchedAt: string;
+                data: import("./contracts/types.ts").TypedDataset;
+                coverage: {
+                    start: 0;
+                    totalRows: number;
+                    capturedRows: number;
+                    complete: boolean;
+                    columns: string[];
+                    business: "unknown";
+                };
+            };
+            binding: {
+                workspaceId: string;
+                codeRef?: {
+                    executionId: string;
+                    sha256: string;
+                } | undefined;
+                sessionId?: string | undefined;
+                callId?: string | undefined;
+            };
+        } | {
+            kind: "image";
+            declaration: {
+                kind: "image-file";
+                path: string;
+            };
+            mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+            dataUrl: string;
+            sha256: string;
+        }>;
+        schemaVersion: "dsh.analysis-ui/v3";
+    }>;
     read(payload: unknown, caller?: AbortSignal): Promise<{
         workspaceId: string;
         reportId: string;