openpond-sdk 0.11.4 → 0.11.6

package/dist/types/packages/sdk/src/dataset-preparation-client.d.ts

@@ -0,0 +1,810 @@
+import { z } from "zod";
+import { DatasetPreparationCommandSchema, DatasetPreparationCreateSchema, DatasetPreparationGrantCreateSchema } from "./dataset-preparation-contracts.js";
+export declare class DatasetPreparationRequestError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+/** The same durable run is controlled by web, Desktop and CLI. A timed-out
+ * write is recovered by operation ID, never replaced with a new paid intent. */
+export declare class OpenPondDatasetPreparationClient {
+    private readonly options;
+    private readonly baseUrl;
+    constructor(options: {
+        baseUrl: string;
+        apiKey: string;
+        teamId: string;
+        fetch?: typeof fetch;
+    });
+    create(datasetId: string, input: z.input<typeof DatasetPreparationCreateSchema>, signal?: AbortSignal): Promise<{
+        schemaVersion: "openpond.datasetPreparationRun.v1";
+        id: string;
+        operationId: string;
+        teamId: string;
+        ownerUserId: string;
+        datasetId: string;
+        datasetRevision: number;
+        revision: number;
+        requestHash: string;
+        policy: {
+            source: {
+                projectId: string;
+                from: string;
+                to: string;
+                importCutoff: string;
+                connections: string[];
+            };
+            taskClasses: ("coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work")[];
+            limits: {
+                maximumConversations: number;
+                maximumCandidates: number;
+                acceptedTarget: number;
+                maximumRepairsPerCandidate: number;
+                maximumEvidenceBytesPerConversation: number;
+            };
+            researcher: {
+                modelId: string;
+                maximumOutputTokens: number;
+            };
+            grading: {
+                mode: "auto";
+            } | {
+                mode: "existing_only";
+            } | {
+                mode: "manual";
+                releases: {
+                    id: string;
+                    revision: number;
+                    contentHash: string;
+                }[];
+            };
+            budget: {
+                grantId: string;
+                maximumMicroUsd: number;
+                previewMaximumMicroUsd: number;
+                qualificationMaximumMicroUsdPerCandidate: number;
+                maximumSandboxSeconds: number;
+            };
+            finish: "stop_ready" | "create_private_version";
+            execution: "prepare" | "preview_only";
+            allowPartialVersion: boolean;
+            population: "development";
+        };
+        status: "cancelled" | "failed" | "running" | "cancelling" | "completed" | "budget_exhausted" | "draft" | "ready" | "paused" | "pausing" | "needs_attention" | "preview_ready" | "releasing" | "insufficient_data";
+        stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+        coverage: {
+            conversations: number;
+            importedTurns: number;
+            selectedTurns: number;
+            queuedSnapshots: number | null;
+            failedSessions: number | null;
+            skippedSessions: number | null;
+            lastAdmissionAt: string | null;
+            complete: boolean;
+            reasons: {
+                code: string;
+                message: string;
+            }[];
+            sourceInventoryHash: string;
+        } | null;
+        preview: {
+            sampleConversations: number;
+            sampleTurns: number;
+            candidateCount: number;
+            modelId: string;
+            modelConfigurationHash: string;
+            callReceiptIds: string[];
+            inputTokens: number | null;
+            outputTokens: number | null;
+            classes: {
+                taskClass: "coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work";
+                candidates: number;
+                assessment: "executable" | "calibrated_judge" | "unsupported";
+                requirements: string[];
+            }[];
+            exclusions: {
+                code: string;
+                count: number;
+                reason: string;
+            }[];
+            estimates: {
+                stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+                minimumMicroUsd: number;
+                maximumMicroUsd: number;
+                assumptions: string[];
+            }[];
+            createdAt: string;
+        } | null;
+        counts: {
+            scannedConversations: number;
+            scannedTurns: number;
+            candidates: number;
+            reconstructed: number;
+            qualifying: number;
+            qualified: number;
+            excluded: number;
+            needsAttention: number;
+        };
+        accounting: {
+            maximumMicroUsd: number;
+            settledMicroUsd: number;
+            heldMicroUsd: number;
+            unresolvedCalls: number;
+            sandboxSeconds: number;
+            cleanupPending: number;
+            complete: boolean;
+        };
+        publication: {
+            datasetId: string;
+            workspaceRevision: number;
+            release: {
+                id: string;
+                revision: number;
+                contentHash: string;
+            };
+        } | null;
+        error: {
+            code: string;
+            message: string;
+        } | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    createGrant(datasetId: string, input: z.input<typeof DatasetPreparationGrantCreateSchema>, signal?: AbortSignal): Promise<{
+        schemaVersion: "openpond.datasetPreparationGrant.v1";
+        id: string;
+        teamId: string;
+        ownerUserId: string;
+        projectId: string;
+        maximumMicroUsd: number;
+        maximumSandboxSeconds: number;
+        settledMicroUsd: number;
+        heldMicroUsd: number;
+        sandboxSeconds: number;
+        heldSandboxSeconds: number;
+        unresolvedCalls: number;
+        cleanupPending: number;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    getGrant(datasetId: string, grantId: string, signal?: AbortSignal): Promise<{
+        schemaVersion: "openpond.datasetPreparationGrant.v1";
+        id: string;
+        teamId: string;
+        ownerUserId: string;
+        projectId: string;
+        maximumMicroUsd: number;
+        maximumSandboxSeconds: number;
+        settledMicroUsd: number;
+        heldMicroUsd: number;
+        sandboxSeconds: number;
+        heldSandboxSeconds: number;
+        unresolvedCalls: number;
+        cleanupPending: number;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    private readGrant;
+    get(datasetId: string, runId: string, signal?: AbortSignal): Promise<{
+        schemaVersion: "openpond.datasetPreparationRun.v1";
+        id: string;
+        operationId: string;
+        teamId: string;
+        ownerUserId: string;
+        datasetId: string;
+        datasetRevision: number;
+        revision: number;
+        requestHash: string;
+        policy: {
+            source: {
+                projectId: string;
+                from: string;
+                to: string;
+                importCutoff: string;
+                connections: string[];
+            };
+            taskClasses: ("coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work")[];
+            limits: {
+                maximumConversations: number;
+                maximumCandidates: number;
+                acceptedTarget: number;
+                maximumRepairsPerCandidate: number;
+                maximumEvidenceBytesPerConversation: number;
+            };
+            researcher: {
+                modelId: string;
+                maximumOutputTokens: number;
+            };
+            grading: {
+                mode: "auto";
+            } | {
+                mode: "existing_only";
+            } | {
+                mode: "manual";
+                releases: {
+                    id: string;
+                    revision: number;
+                    contentHash: string;
+                }[];
+            };
+            budget: {
+                grantId: string;
+                maximumMicroUsd: number;
+                previewMaximumMicroUsd: number;
+                qualificationMaximumMicroUsdPerCandidate: number;
+                maximumSandboxSeconds: number;
+            };
+            finish: "stop_ready" | "create_private_version";
+            execution: "prepare" | "preview_only";
+            allowPartialVersion: boolean;
+            population: "development";
+        };
+        status: "cancelled" | "failed" | "running" | "cancelling" | "completed" | "budget_exhausted" | "draft" | "ready" | "paused" | "pausing" | "needs_attention" | "preview_ready" | "releasing" | "insufficient_data";
+        stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+        coverage: {
+            conversations: number;
+            importedTurns: number;
+            selectedTurns: number;
+            queuedSnapshots: number | null;
+            failedSessions: number | null;
+            skippedSessions: number | null;
+            lastAdmissionAt: string | null;
+            complete: boolean;
+            reasons: {
+                code: string;
+                message: string;
+            }[];
+            sourceInventoryHash: string;
+        } | null;
+        preview: {
+            sampleConversations: number;
+            sampleTurns: number;
+            candidateCount: number;
+            modelId: string;
+            modelConfigurationHash: string;
+            callReceiptIds: string[];
+            inputTokens: number | null;
+            outputTokens: number | null;
+            classes: {
+                taskClass: "coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work";
+                candidates: number;
+                assessment: "executable" | "calibrated_judge" | "unsupported";
+                requirements: string[];
+            }[];
+            exclusions: {
+                code: string;
+                count: number;
+                reason: string;
+            }[];
+            estimates: {
+                stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+                minimumMicroUsd: number;
+                maximumMicroUsd: number;
+                assumptions: string[];
+            }[];
+            createdAt: string;
+        } | null;
+        counts: {
+            scannedConversations: number;
+            scannedTurns: number;
+            candidates: number;
+            reconstructed: number;
+            qualifying: number;
+            qualified: number;
+            excluded: number;
+            needsAttention: number;
+        };
+        accounting: {
+            maximumMicroUsd: number;
+            settledMicroUsd: number;
+            heldMicroUsd: number;
+            unresolvedCalls: number;
+            sandboxSeconds: number;
+            cleanupPending: number;
+            complete: boolean;
+        };
+        publication: {
+            datasetId: string;
+            workspaceRevision: number;
+            release: {
+                id: string;
+                revision: number;
+                contentHash: string;
+            };
+        } | null;
+        error: {
+            code: string;
+            message: string;
+        } | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    list(datasetId: string, options?: {
+        cursor?: string;
+        signal?: AbortSignal;
+    }): Promise<{
+        teamId: string;
+        datasetId: string;
+        runs: {
+            schemaVersion: "openpond.datasetPreparationRun.v1";
+            id: string;
+            operationId: string;
+            teamId: string;
+            ownerUserId: string;
+            datasetId: string;
+            datasetRevision: number;
+            revision: number;
+            requestHash: string;
+            policy: {
+                source: {
+                    projectId: string;
+                    from: string;
+                    to: string;
+                    importCutoff: string;
+                    connections: string[];
+                };
+                taskClasses: ("coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work")[];
+                limits: {
+                    maximumConversations: number;
+                    maximumCandidates: number;
+                    acceptedTarget: number;
+                    maximumRepairsPerCandidate: number;
+                    maximumEvidenceBytesPerConversation: number;
+                };
+                researcher: {
+                    modelId: string;
+                    maximumOutputTokens: number;
+                };
+                grading: {
+                    mode: "auto";
+                } | {
+                    mode: "existing_only";
+                } | {
+                    mode: "manual";
+                    releases: {
+                        id: string;
+                        revision: number;
+                        contentHash: string;
+                    }[];
+                };
+                budget: {
+                    grantId: string;
+                    maximumMicroUsd: number;
+                    previewMaximumMicroUsd: number;
+                    qualificationMaximumMicroUsdPerCandidate: number;
+                    maximumSandboxSeconds: number;
+                };
+                finish: "stop_ready" | "create_private_version";
+                execution: "prepare" | "preview_only";
+                allowPartialVersion: boolean;
+                population: "development";
+            };
+            status: "cancelled" | "failed" | "running" | "cancelling" | "completed" | "budget_exhausted" | "draft" | "ready" | "paused" | "pausing" | "needs_attention" | "preview_ready" | "releasing" | "insufficient_data";
+            stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+            coverage: {
+                conversations: number;
+                importedTurns: number;
+                selectedTurns: number;
+                queuedSnapshots: number | null;
+                failedSessions: number | null;
+                skippedSessions: number | null;
+                lastAdmissionAt: string | null;
+                complete: boolean;
+                reasons: {
+                    code: string;
+                    message: string;
+                }[];
+                sourceInventoryHash: string;
+            } | null;
+            preview: {
+                sampleConversations: number;
+                sampleTurns: number;
+                candidateCount: number;
+                modelId: string;
+                modelConfigurationHash: string;
+                callReceiptIds: string[];
+                inputTokens: number | null;
+                outputTokens: number | null;
+                classes: {
+                    taskClass: "coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work";
+                    candidates: number;
+                    assessment: "executable" | "calibrated_judge" | "unsupported";
+                    requirements: string[];
+                }[];
+                exclusions: {
+                    code: string;
+                    count: number;
+                    reason: string;
+                }[];
+                estimates: {
+                    stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+                    minimumMicroUsd: number;
+                    maximumMicroUsd: number;
+                    assumptions: string[];
+                }[];
+                createdAt: string;
+            } | null;
+            counts: {
+                scannedConversations: number;
+                scannedTurns: number;
+                candidates: number;
+                reconstructed: number;
+                qualifying: number;
+                qualified: number;
+                excluded: number;
+                needsAttention: number;
+            };
+            accounting: {
+                maximumMicroUsd: number;
+                settledMicroUsd: number;
+                heldMicroUsd: number;
+                unresolvedCalls: number;
+                sandboxSeconds: number;
+                cleanupPending: number;
+                complete: boolean;
+            };
+            publication: {
+                datasetId: string;
+                workspaceRevision: number;
+                release: {
+                    id: string;
+                    revision: number;
+                    contentHash: string;
+                };
+            } | null;
+            error: {
+                code: string;
+                message: string;
+            } | null;
+            createdAt: string;
+            updatedAt: string;
+        }[];
+        nextCursor: string | null;
+    }>;
+    command(datasetId: string, runId: string, input: z.input<typeof DatasetPreparationCommandSchema>, signal?: AbortSignal): Promise<{
+        schemaVersion: "openpond.datasetPreparationRun.v1";
+        id: string;
+        operationId: string;
+        teamId: string;
+        ownerUserId: string;
+        datasetId: string;
+        datasetRevision: number;
+        revision: number;
+        requestHash: string;
+        policy: {
+            source: {
+                projectId: string;
+                from: string;
+                to: string;
+                importCutoff: string;
+                connections: string[];
+            };
+            taskClasses: ("coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work")[];
+            limits: {
+                maximumConversations: number;
+                maximumCandidates: number;
+                acceptedTarget: number;
+                maximumRepairsPerCandidate: number;
+                maximumEvidenceBytesPerConversation: number;
+            };
+            researcher: {
+                modelId: string;
+                maximumOutputTokens: number;
+            };
+            grading: {
+                mode: "auto";
+            } | {
+                mode: "existing_only";
+            } | {
+                mode: "manual";
+                releases: {
+                    id: string;
+                    revision: number;
+                    contentHash: string;
+                }[];
+            };
+            budget: {
+                grantId: string;
+                maximumMicroUsd: number;
+                previewMaximumMicroUsd: number;
+                qualificationMaximumMicroUsdPerCandidate: number;
+                maximumSandboxSeconds: number;
+            };
+            finish: "stop_ready" | "create_private_version";
+            execution: "prepare" | "preview_only";
+            allowPartialVersion: boolean;
+            population: "development";
+        };
+        status: "cancelled" | "failed" | "running" | "cancelling" | "completed" | "budget_exhausted" | "draft" | "ready" | "paused" | "pausing" | "needs_attention" | "preview_ready" | "releasing" | "insufficient_data";
+        stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+        coverage: {
+            conversations: number;
+            importedTurns: number;
+            selectedTurns: number;
+            queuedSnapshots: number | null;
+            failedSessions: number | null;
+            skippedSessions: number | null;
+            lastAdmissionAt: string | null;
+            complete: boolean;
+            reasons: {
+                code: string;
+                message: string;
+            }[];
+            sourceInventoryHash: string;
+        } | null;
+        preview: {
+            sampleConversations: number;
+            sampleTurns: number;
+            candidateCount: number;
+            modelId: string;
+            modelConfigurationHash: string;
+            callReceiptIds: string[];
+            inputTokens: number | null;
+            outputTokens: number | null;
+            classes: {
+                taskClass: "coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work";
+                candidates: number;
+                assessment: "executable" | "calibrated_judge" | "unsupported";
+                requirements: string[];
+            }[];
+            exclusions: {
+                code: string;
+                count: number;
+                reason: string;
+            }[];
+            estimates: {
+                stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+                minimumMicroUsd: number;
+                maximumMicroUsd: number;
+                assumptions: string[];
+            }[];
+            createdAt: string;
+        } | null;
+        counts: {
+            scannedConversations: number;
+            scannedTurns: number;
+            candidates: number;
+            reconstructed: number;
+            qualifying: number;
+            qualified: number;
+            excluded: number;
+            needsAttention: number;
+        };
+        accounting: {
+            maximumMicroUsd: number;
+            settledMicroUsd: number;
+            heldMicroUsd: number;
+            unresolvedCalls: number;
+            sandboxSeconds: number;
+            cleanupPending: number;
+            complete: boolean;
+        };
+        publication: {
+            datasetId: string;
+            workspaceRevision: number;
+            release: {
+                id: string;
+                revision: number;
+                contentHash: string;
+            };
+        } | null;
+        error: {
+            code: string;
+            message: string;
+        } | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    operationResult(datasetId: string, operationId: string, signal?: AbortSignal): Promise<{
+        operationId: string;
+        requestHash: string;
+        run: {
+            schemaVersion: "openpond.datasetPreparationRun.v1";
+            id: string;
+            operationId: string;
+            teamId: string;
+            ownerUserId: string;
+            datasetId: string;
+            datasetRevision: number;
+            revision: number;
+            requestHash: string;
+            policy: {
+                source: {
+                    projectId: string;
+                    from: string;
+                    to: string;
+                    importCutoff: string;
+                    connections: string[];
+                };
+                taskClasses: ("coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work")[];
+                limits: {
+                    maximumConversations: number;
+                    maximumCandidates: number;
+                    acceptedTarget: number;
+                    maximumRepairsPerCandidate: number;
+                    maximumEvidenceBytesPerConversation: number;
+                };
+                researcher: {
+                    modelId: string;
+                    maximumOutputTokens: number;
+                };
+                grading: {
+                    mode: "auto";
+                } | {
+                    mode: "existing_only";
+                } | {
+                    mode: "manual";
+                    releases: {
+                        id: string;
+                        revision: number;
+                        contentHash: string;
+                    }[];
+                };
+                budget: {
+                    grantId: string;
+                    maximumMicroUsd: number;
+                    previewMaximumMicroUsd: number;
+                    qualificationMaximumMicroUsdPerCandidate: number;
+                    maximumSandboxSeconds: number;
+                };
+                finish: "stop_ready" | "create_private_version";
+                execution: "prepare" | "preview_only";
+                allowPartialVersion: boolean;
+                population: "development";
+            };
+            status: "cancelled" | "failed" | "running" | "cancelling" | "completed" | "budget_exhausted" | "draft" | "ready" | "paused" | "pausing" | "needs_attention" | "preview_ready" | "releasing" | "insufficient_data";
+            stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+            coverage: {
+                conversations: number;
+                importedTurns: number;
+                selectedTurns: number;
+                queuedSnapshots: number | null;
+                failedSessions: number | null;
+                skippedSessions: number | null;
+                lastAdmissionAt: string | null;
+                complete: boolean;
+                reasons: {
+                    code: string;
+                    message: string;
+                }[];
+                sourceInventoryHash: string;
+            } | null;
+            preview: {
+                sampleConversations: number;
+                sampleTurns: number;
+                candidateCount: number;
+                modelId: string;
+                modelConfigurationHash: string;
+                callReceiptIds: string[];
+                inputTokens: number | null;
+                outputTokens: number | null;
+                classes: {
+                    taskClass: "coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work";
+                    candidates: number;
+                    assessment: "executable" | "calibrated_judge" | "unsupported";
+                    requirements: string[];
+                }[];
+                exclusions: {
+                    code: string;
+                    count: number;
+                    reason: string;
+                }[];
+                estimates: {
+                    stage: "release" | "qualification" | "inventory" | "preview" | "reconstruction" | "grader_authoring";
+                    minimumMicroUsd: number;
+                    maximumMicroUsd: number;
+                    assumptions: string[];
+                }[];
+                createdAt: string;
+            } | null;
+            counts: {
+                scannedConversations: number;
+                scannedTurns: number;
+                candidates: number;
+                reconstructed: number;
+                qualifying: number;
+                qualified: number;
+                excluded: number;
+                needsAttention: number;
+            };
+            accounting: {
+                maximumMicroUsd: number;
+                settledMicroUsd: number;
+                heldMicroUsd: number;
+                unresolvedCalls: number;
+                sandboxSeconds: number;
+                cleanupPending: number;
+                complete: boolean;
+            };
+            publication: {
+                datasetId: string;
+                workspaceRevision: number;
+                release: {
+                    id: string;
+                    revision: number;
+                    contentHash: string;
+                };
+            } | null;
+            error: {
+                code: string;
+                message: string;
+            } | null;
+            createdAt: string;
+            updatedAt: string;
+        };
+    } | null>;
+    candidates(datasetId: string, runId: string, options?: {
+        cursor?: string;
+        signal?: AbortSignal;
+    }): Promise<{
+        teamId: string;
+        datasetId: string;
+        runId: string;
+        candidates: {
+            id: string;
+            runId: string;
+            revision: number;
+            taskClass: "coding_change" | "debugging" | "code_explanation" | "structured_text" | "artifact_work";
+            status: "authoring" | "excluded" | "needs_attention" | "qualifying" | "qualified" | "discovered" | "reconstructing";
+            objective: string;
+            provenance: {
+                schemaVersion: "openpond.preparedTaskProvenance.v1";
+                candidateId: string;
+                preparationId: string;
+                familyKey: string;
+                sourceSpans: {
+                    source: {
+                        id: string;
+                        snapshotHash: string;
+                        boundaryId: string;
+                        boundaryRevisionHash: string;
+                    };
+                    startSequence: number;
+                    endSequence: number;
+                    role: "outcome" | "correction" | "requirement" | "initial_context" | "verification";
+                }[];
+                firstAvailableAt: string;
+                initialInputHash: string;
+                initialEnvironmentHash: string;
+                sourceScopeHash: string;
+            } | null;
+            qualification: {
+                schemaVersion: "openpond.preparedTaskQualification.v1";
+                id: string;
+                candidateId: string;
+                preparationId: string;
+                taskHash: string;
+                environmentHash: string;
+                packageHash: string;
+                graderBindings: {
+                    id: string;
+                    version: string;
+                    contentHash: string;
+                    origin: "reused" | "adapted" | "authored";
+                }[];
+                checks: {
+                    id: string;
+                    label: "positive" | "adversarial" | "incorrect" | "incomplete" | "clean_reset";
+                    executionReceiptId: string;
+                    expectedPassed: boolean;
+                    observedPassed: boolean | null;
+                    infrastructureError: string | null;
+                }[];
+                independentEvidenceRefs: string[];
+                judgeCalibration: "passed" | "pending" | "failed" | "not_applicable";
+                cleanup: "pending" | "completed";
+                passed: boolean;
+                createdAt: string;
+            } | null;
+            reason: {
+                code: string;
+                message: string;
+            } | null;
+            attempts: number;
+        }[];
+        nextCursor: string | null;
+    }>;
+    private readRun;
+    private request;
+}
+//# sourceMappingURL=dataset-preparation-client.d.ts.map