observability-toolkit 2.0.0 → 2.1.0

package/dist/tools/manage-datasets.d.ts

@@ -0,0 +1,850 @@
+/**
+ * Manage evaluation datasets: create, list, get, delete, version, promote
+ */
+import { z } from 'zod';
+import type { TelemetryBackend } from '../backends/index.js';
+export declare const manageDatasetsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"create">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    frozen: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    evaluationNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    selectionCriteria: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    fieldMapping: z.ZodOptional<z.ZodObject<{
+        input: z.ZodString;
+        expectedOutput: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"list">;
+    filterFrozen: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    limit: z.ZodOptional<z.ZodInt>;
+    cursor: z.ZodOptional<z.ZodString>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"get">;
+    datasetId: z.ZodString;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"delete">;
+    datasetId: z.ZodString;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"add_traces">;
+    datasetId: z.ZodString;
+    traceIds: z.ZodArray<z.ZodString>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"remove_traces">;
+    datasetId: z.ZodString;
+    traceIds: z.ZodArray<z.ZodString>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"get_version">;
+    datasetId: z.ZodString;
+    version: z.ZodInt;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"list_versions">;
+    datasetId: z.ZodString;
+    limit: z.ZodOptional<z.ZodInt>;
+    cursor: z.ZodOptional<z.ZodString>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"promote">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    traceIds: z.ZodArray<z.ZodString>;
+    evaluationNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    frozen: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"list_runs">;
+    datasetId: z.ZodString;
+    limit: z.ZodOptional<z.ZodInt>;
+    cursor: z.ZodOptional<z.ZodString>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        cloud: "cloud";
+        local: "local";
+    }>>;
+}, z.core.$strip>], "action">;
+export type ManageDatasetsInput = z.input<typeof manageDatasetsSchema>;
+export interface ManageDatasetsOptions {
+    localBackend?: TelemetryBackend;
+}
+/**
+ * Manage evaluation datasets. On success returns `{ backend, action, ...actionFields }`.
+ * On error returns `{ error: string, backend?, action? }`.
+ */
+export declare const manageDatasets: (rawInput: {
+    action: "create";
+    name: string;
+    description?: string | undefined;
+    frozen?: 0 | 1 | undefined;
+    traceIds?: string[] | undefined;
+    evaluationNames?: string[] | undefined;
+    selectionCriteria?: Record<string, unknown> | undefined;
+    fieldMapping?: {
+        input: string;
+        expectedOutput?: string | undefined;
+        metadata?: string[] | undefined;
+    } | undefined;
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "list";
+    filterFrozen?: 0 | 1 | undefined;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "get";
+    datasetId: string;
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "delete";
+    datasetId: string;
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "add_traces";
+    datasetId: string;
+    traceIds: string[];
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "remove_traces";
+    datasetId: string;
+    traceIds: string[];
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "get_version";
+    datasetId: string;
+    version: number;
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "list_versions";
+    datasetId: string;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "promote";
+    name: string;
+    traceIds: string[];
+    description?: string | undefined;
+    evaluationNames?: string[] | undefined;
+    frozen?: 0 | 1 | undefined;
+    backend?: "cloud" | "local" | undefined;
+} | {
+    action: "list_runs";
+    datasetId: string;
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    backend?: "cloud" | "local" | undefined;
+}, options?: ManageDatasetsOptions | undefined) => Promise<{
+    error: string;
+    backend: string;
+    action?: undefined;
+} | {
+    action: "create";
+    dataset: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        frozen: 0 | 1;
+        traceCount: number;
+        evaluationNames: string[];
+        selectionCriteria: Record<string, unknown> | null;
+        dateRangeStart: string | null;
+        dateRangeEnd: string | null;
+        version?: number | undefined;
+        parentVersion?: number | null | undefined;
+        versionCreatedAt?: string | undefined;
+        versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        traceSnapshot?: string[] | undefined;
+    };
+    backend: string;
+    error?: undefined;
+} | {
+    action: "list";
+    datasets: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        frozen: 0 | 1;
+        traceCount: number;
+        evaluationNames: string[];
+        selectionCriteria: Record<string, unknown> | null;
+        dateRangeStart: string | null;
+        dateRangeEnd: string | null;
+        version?: number | undefined;
+        parentVersion?: number | null | undefined;
+        versionCreatedAt?: string | undefined;
+        versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        traceSnapshot?: string[] | undefined;
+    }[];
+    count: number;
+    hasMore: boolean;
+    nextCursor?: string | undefined;
+    backend: string;
+    error?: undefined;
+} | {
+    action: "get";
+    dataset: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        frozen: 0 | 1;
+        traceCount: number;
+        evaluationNames: string[];
+        selectionCriteria: Record<string, unknown> | null;
+        dateRangeStart: string | null;
+        dateRangeEnd: string | null;
+        version?: number | undefined;
+        parentVersion?: number | null | undefined;
+        versionCreatedAt?: string | undefined;
+        versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        traceSnapshot?: string[] | undefined;
+    };
+    traces: {
+        datasetId: string;
+        traceId: string;
+        addedAt: string;
+    }[];
+    traceCount: number;
+    truncated: boolean;
+    backend: string;
+    error?: undefined;
+} | {
+    action: "delete";
+    deleted: boolean;
+    id: string;
+    backend: string;
+    error?: undefined;
+} | {
+    action: "add_traces";
+    dataset: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        frozen: 0 | 1;
+        traceCount: number;
+        evaluationNames: string[];
+        selectionCriteria: Record<string, unknown> | null;
+        dateRangeStart: string | null;
+        dateRangeEnd: string | null;
+        version?: number | undefined;
+        parentVersion?: number | null | undefined;
+        versionCreatedAt?: string | undefined;
+        versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        traceSnapshot?: string[] | undefined;
+    };
+    tracesAdded: number;
+    backend: string;
+    error?: undefined;
+} | {
+    action: "remove_traces";
+    dataset: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        frozen: 0 | 1;
+        traceCount: number;
+        evaluationNames: string[];
+        selectionCriteria: Record<string, unknown> | null;
+        dateRangeStart: string | null;
+        dateRangeEnd: string | null;
+        version?: number | undefined;
+        parentVersion?: number | null | undefined;
+        versionCreatedAt?: string | undefined;
+        versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        traceSnapshot?: string[] | undefined;
+    };
+    tracesRemoved: number;
+    backend: string;
+    error?: undefined;
+} | {
+    action: "get_version";
+    dataset: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        frozen: 0 | 1;
+        traceCount: number;
+        evaluationNames: string[];
+        selectionCriteria: Record<string, unknown> | null;
+        dateRangeStart: string | null;
+        dateRangeEnd: string | null;
+        version?: number | undefined;
+        parentVersion?: number | null | undefined;
+        versionCreatedAt?: string | undefined;
+        versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        traceSnapshot?: string[] | undefined;
+    };
+    traces: {
+        datasetId: string;
+        traceId: string;
+        addedAt: string;
+    }[];
+    backend: string;
+    error?: undefined;
+} | {
+    action: "list_versions";
+    versions: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        frozen: 0 | 1;
+        traceCount: number;
+        evaluationNames: string[];
+        selectionCriteria: Record<string, unknown> | null;
+        dateRangeStart: string | null;
+        dateRangeEnd: string | null;
+        version?: number | undefined;
+        parentVersion?: number | null | undefined;
+        versionCreatedAt?: string | undefined;
+        versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        traceSnapshot?: string[] | undefined;
+    }[];
+    count: number;
+    hasMore: boolean;
+    nextCursor?: string | undefined;
+    backend: string;
+    error?: undefined;
+} | {
+    action: "promote";
+    dataset: {
+        id: string;
+        name: string;
+        description: string | null;
+        createdAt: string;
+        frozen: 0 | 1;
+        traceCount: number;
+        evaluationNames: string[];
+        selectionCriteria: Record<string, unknown> | null;
+        dateRangeStart: string | null;
+        dateRangeEnd: string | null;
+        version?: number | undefined;
+        parentVersion?: number | null | undefined;
+        versionCreatedAt?: string | undefined;
+        versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        traceSnapshot?: string[] | undefined;
+    };
+    backend: string;
+    error?: undefined;
+} | {
+    action: "list_runs";
+    runs: {
+        id: string;
+        datasetId: string;
+        datasetVersion: number;
+        runAt: string;
+        evaluationNames: string[];
+        resultCount: number;
+        evaluator?: string | undefined;
+    }[];
+    count: number;
+    hasMore: boolean;
+    nextCursor?: string | undefined;
+    backend: string;
+    error?: undefined;
+} | {
+    error: string;
+    backend: string;
+    action: "get" | "delete" | "create" | "list" | "add_traces" | "remove_traces" | "get_version" | "list_versions" | "promote" | "list_runs";
+}>;
+export declare const manageDatasetsTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"create">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        frozen: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+        traceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        evaluationNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        selectionCriteria: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fieldMapping: z.ZodOptional<z.ZodObject<{
+            input: z.ZodString;
+            expectedOutput: z.ZodOptional<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"list">;
+        filterFrozen: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+        limit: z.ZodOptional<z.ZodInt>;
+        cursor: z.ZodOptional<z.ZodString>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"get">;
+        datasetId: z.ZodString;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"delete">;
+        datasetId: z.ZodString;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"add_traces">;
+        datasetId: z.ZodString;
+        traceIds: z.ZodArray<z.ZodString>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"remove_traces">;
+        datasetId: z.ZodString;
+        traceIds: z.ZodArray<z.ZodString>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"get_version">;
+        datasetId: z.ZodString;
+        version: z.ZodInt;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"list_versions">;
+        datasetId: z.ZodString;
+        limit: z.ZodOptional<z.ZodInt>;
+        cursor: z.ZodOptional<z.ZodString>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"promote">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        traceIds: z.ZodArray<z.ZodString>;
+        evaluationNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        frozen: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"list_runs">;
+        datasetId: z.ZodString;
+        limit: z.ZodOptional<z.ZodInt>;
+        cursor: z.ZodOptional<z.ZodString>;
+        backend: z.ZodDefault<z.ZodEnum<{
+            cloud: "cloud";
+            local: "local";
+        }>>;
+    }, z.core.$strip>], "action">;
+    handler: (rawInput: {
+        action: "create";
+        name: string;
+        description?: string | undefined;
+        frozen?: 0 | 1 | undefined;
+        traceIds?: string[] | undefined;
+        evaluationNames?: string[] | undefined;
+        selectionCriteria?: Record<string, unknown> | undefined;
+        fieldMapping?: {
+            input: string;
+            expectedOutput?: string | undefined;
+            metadata?: string[] | undefined;
+        } | undefined;
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "list";
+        filterFrozen?: 0 | 1 | undefined;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "get";
+        datasetId: string;
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "delete";
+        datasetId: string;
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "add_traces";
+        datasetId: string;
+        traceIds: string[];
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "remove_traces";
+        datasetId: string;
+        traceIds: string[];
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "get_version";
+        datasetId: string;
+        version: number;
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "list_versions";
+        datasetId: string;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "promote";
+        name: string;
+        traceIds: string[];
+        description?: string | undefined;
+        evaluationNames?: string[] | undefined;
+        frozen?: 0 | 1 | undefined;
+        backend?: "cloud" | "local" | undefined;
+    } | {
+        action: "list_runs";
+        datasetId: string;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+        backend?: "cloud" | "local" | undefined;
+    }, options?: ManageDatasetsOptions | undefined) => Promise<{
+        error: string;
+        backend: string;
+        action?: undefined;
+    } | {
+        action: "create";
+        dataset: {
+            id: string;
+            name: string;
+            description: string | null;
+            createdAt: string;
+            frozen: 0 | 1;
+            traceCount: number;
+            evaluationNames: string[];
+            selectionCriteria: Record<string, unknown> | null;
+            dateRangeStart: string | null;
+            dateRangeEnd: string | null;
+            version?: number | undefined;
+            parentVersion?: number | null | undefined;
+            versionCreatedAt?: string | undefined;
+            versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+            fieldMapping?: {
+                input: string;
+                expectedOutput?: string | undefined;
+                metadata?: string[] | undefined;
+            } | undefined;
+            traceSnapshot?: string[] | undefined;
+        };
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "list";
+        datasets: {
+            id: string;
+            name: string;
+            description: string | null;
+            createdAt: string;
+            frozen: 0 | 1;
+            traceCount: number;
+            evaluationNames: string[];
+            selectionCriteria: Record<string, unknown> | null;
+            dateRangeStart: string | null;
+            dateRangeEnd: string | null;
+            version?: number | undefined;
+            parentVersion?: number | null | undefined;
+            versionCreatedAt?: string | undefined;
+            versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+            fieldMapping?: {
+                input: string;
+                expectedOutput?: string | undefined;
+                metadata?: string[] | undefined;
+            } | undefined;
+            traceSnapshot?: string[] | undefined;
+        }[];
+        count: number;
+        hasMore: boolean;
+        nextCursor?: string | undefined;
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "get";
+        dataset: {
+            id: string;
+            name: string;
+            description: string | null;
+            createdAt: string;
+            frozen: 0 | 1;
+            traceCount: number;
+            evaluationNames: string[];
+            selectionCriteria: Record<string, unknown> | null;
+            dateRangeStart: string | null;
+            dateRangeEnd: string | null;
+            version?: number | undefined;
+            parentVersion?: number | null | undefined;
+            versionCreatedAt?: string | undefined;
+            versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+            fieldMapping?: {
+                input: string;
+                expectedOutput?: string | undefined;
+                metadata?: string[] | undefined;
+            } | undefined;
+            traceSnapshot?: string[] | undefined;
+        };
+        traces: {
+            datasetId: string;
+            traceId: string;
+            addedAt: string;
+        }[];
+        traceCount: number;
+        truncated: boolean;
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "delete";
+        deleted: boolean;
+        id: string;
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "add_traces";
+        dataset: {
+            id: string;
+            name: string;
+            description: string | null;
+            createdAt: string;
+            frozen: 0 | 1;
+            traceCount: number;
+            evaluationNames: string[];
+            selectionCriteria: Record<string, unknown> | null;
+            dateRangeStart: string | null;
+            dateRangeEnd: string | null;
+            version?: number | undefined;
+            parentVersion?: number | null | undefined;
+            versionCreatedAt?: string | undefined;
+            versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+            fieldMapping?: {
+                input: string;
+                expectedOutput?: string | undefined;
+                metadata?: string[] | undefined;
+            } | undefined;
+            traceSnapshot?: string[] | undefined;
+        };
+        tracesAdded: number;
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "remove_traces";
+        dataset: {
+            id: string;
+            name: string;
+            description: string | null;
+            createdAt: string;
+            frozen: 0 | 1;
+            traceCount: number;
+            evaluationNames: string[];
+            selectionCriteria: Record<string, unknown> | null;
+            dateRangeStart: string | null;
+            dateRangeEnd: string | null;
+            version?: number | undefined;
+            parentVersion?: number | null | undefined;
+            versionCreatedAt?: string | undefined;
+            versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+            fieldMapping?: {
+                input: string;
+                expectedOutput?: string | undefined;
+                metadata?: string[] | undefined;
+            } | undefined;
+            traceSnapshot?: string[] | undefined;
+        };
+        tracesRemoved: number;
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "get_version";
+        dataset: {
+            id: string;
+            name: string;
+            description: string | null;
+            createdAt: string;
+            frozen: 0 | 1;
+            traceCount: number;
+            evaluationNames: string[];
+            selectionCriteria: Record<string, unknown> | null;
+            dateRangeStart: string | null;
+            dateRangeEnd: string | null;
+            version?: number | undefined;
+            parentVersion?: number | null | undefined;
+            versionCreatedAt?: string | undefined;
+            versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+            fieldMapping?: {
+                input: string;
+                expectedOutput?: string | undefined;
+                metadata?: string[] | undefined;
+            } | undefined;
+            traceSnapshot?: string[] | undefined;
+        };
+        traces: {
+            datasetId: string;
+            traceId: string;
+            addedAt: string;
+        }[];
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "list_versions";
+        versions: {
+            id: string;
+            name: string;
+            description: string | null;
+            createdAt: string;
+            frozen: 0 | 1;
+            traceCount: number;
+            evaluationNames: string[];
+            selectionCriteria: Record<string, unknown> | null;
+            dateRangeStart: string | null;
+            dateRangeEnd: string | null;
+            version?: number | undefined;
+            parentVersion?: number | null | undefined;
+            versionCreatedAt?: string | undefined;
+            versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+            fieldMapping?: {
+                input: string;
+                expectedOutput?: string | undefined;
+                metadata?: string[] | undefined;
+            } | undefined;
+            traceSnapshot?: string[] | undefined;
+        }[];
+        count: number;
+        hasMore: boolean;
+        nextCursor?: string | undefined;
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "promote";
+        dataset: {
+            id: string;
+            name: string;
+            description: string | null;
+            createdAt: string;
+            frozen: 0 | 1;
+            traceCount: number;
+            evaluationNames: string[];
+            selectionCriteria: Record<string, unknown> | null;
+            dateRangeStart: string | null;
+            dateRangeEnd: string | null;
+            version?: number | undefined;
+            parentVersion?: number | null | undefined;
+            versionCreatedAt?: string | undefined;
+            versionReason?: "created" | "traces_added" | "traces_removed" | "metadata_updated" | undefined;
+            fieldMapping?: {
+                input: string;
+                expectedOutput?: string | undefined;
+                metadata?: string[] | undefined;
+            } | undefined;
+            traceSnapshot?: string[] | undefined;
+        };
+        backend: string;
+        error?: undefined;
+    } | {
+        action: "list_runs";
+        runs: {
+            id: string;
+            datasetId: string;
+            datasetVersion: number;
+            runAt: string;
+            evaluationNames: string[];
+            resultCount: number;
+            evaluator?: string | undefined;
+        }[];
+        count: number;
+        hasMore: boolean;
+        nextCursor?: string | undefined;
+        backend: string;
+        error?: undefined;
+    } | {
+        error: string;
+        backend: string;
+        action: "get" | "delete" | "create" | "list" | "add_traces" | "remove_traces" | "get_version" | "list_versions" | "promote" | "list_runs";
+    }>;
+};
+//# sourceMappingURL=manage-datasets.d.ts.map