scientific-protocol 0.1.0

package/dist/sdk/client.d.ts

@@ -0,0 +1,376 @@
+import type { AdminStatusResponse, AgentRequestDetailResponse, AgentReviewCalibrationResponse, AgentRewardStateResponse, AgentRuntimeEventsResponse, AgentWebhookDeliveriesResponse, AgentWebhookSubscriptionCreateResponse, AgentWebhookSubscriptionDeleteResponse, AgentWebhookSubscriptionPingResponse, AgentWebhookSubscriptionsResponse, AgentWorkSummaryResponse, ArtifactMaintenanceTaskDetailResponse, ArtifactMaintenanceTaskRunView, ArtifactMaintenanceTaskView, CheckpointView, ClaimEventsResponse, ClaimFeedResponse, ClaimListQuery, ClaimReviewState, ClaimRewardStateResponse, ClaimView, ClaimWorkGraphResponse, ClaimWorkItemDetailResponse, ClaimWorkItemView, ConfirmSourcePublicationResponse, CreateDemoClaimRequest, DemoAdminStatusResponse, DemoMutationResponse, DemoScenariosResponse, DomainLeaderboardResponse, GovernanceEventsResponse, GovernanceOverviewResponse, GovernanceProposalDetailResponse, GovernanceProposalsResponse, GovernanceTreasuryResponse, HealthResponse, OpenDemoReplicationJobRequest, PagedResponse, PersistedArtifactDetailResponse, ProcessDemoReplicationJobRequest, RecipientRewardStateResponse, RejectSourcePublicationResponse, ReplicationJobDetailResponse, ReplicationJobRunView, ReplicationJobView, ReplicationView, ResolveDemoReplicationJobRequest, ReviewSubmissionView, ReviewTaskDetailResponse, ReviewTaskRunView, ReviewTaskView, RewardProtocolConfigResponse, RewardSettlementHistoryResponse, SignedAgentRequestBody, SignedPublicWriteRequestBody, SourceDetailResponse, SourceEventsResponse, SourceFeedResponse, SourceIngestionResponse, SourceListQuery, SourceListResponse, SourcePublicationDecisionsResponse, SourceWorkGraphResponse, WriteProtocolConfigResponse } from "./types.js";
+export declare class ScientificProtocolApiError extends Error {
+    readonly body: unknown;
+    readonly response: Response;
+    readonly status: number;
+    constructor(response: Response, body: unknown);
+}
+export type ScientificProtocolClientOptions = {
+    baseUrl: string | URL;
+    demoAdminToken?: string;
+    fetch?: typeof fetch;
+    headers?: HeadersInit;
+};
+export declare class ScientificProtocolClient {
+    readonly baseUrl: string;
+    readonly demoAdminToken?: string;
+    private readonly defaultHeaders?;
+    private readonly fetchImpl;
+    constructor(options: ScientificProtocolClientOptions);
+    readonly demo: {
+        createClaim: (input: CreateDemoClaimRequest) => Promise<DemoMutationResponse<any>>;
+        enqueueArtifactAudits: (input?: {
+            requestedBy?: string;
+            staleAfterMinutes?: number;
+        }) => Promise<DemoMutationResponse<Record<string, unknown>>>;
+        getAdminStatus: () => Promise<DemoAdminStatusResponse>;
+        getScenarios: () => Promise<DemoScenariosResponse>;
+        openReplicationJob: (input: OpenDemoReplicationJobRequest) => Promise<DemoMutationResponse<any>>;
+        openArtifactMaintenanceTask: (input: {
+            artifactKey: string;
+            requestedBy?: string;
+            targetProvider?: string;
+            targetReplicaKey?: string;
+            taskType?: "audit" | "repair";
+        }) => Promise<DemoMutationResponse<Record<string, unknown>>>;
+        processReplicationJob: (jobId: string, input?: ProcessDemoReplicationJobRequest) => Promise<DemoMutationResponse<Record<string, unknown>>>;
+        recomputeDomain: (domainId: number) => Promise<DemoMutationResponse<any>>;
+        reseedOperational: () => Promise<DemoMutationResponse<Record<string, unknown>> & {
+            scenarios: unknown[];
+        }>;
+        resetDemo: () => Promise<DemoMutationResponse<Record<string, unknown>> & {
+            scenarios: unknown[];
+        }>;
+        resolveReplicationJob: (jobId: string, input?: ResolveDemoReplicationJobRequest) => Promise<DemoMutationResponse<Record<string, unknown>>>;
+    };
+    readonly production: {
+        createClaim: (signedRequest: SignedPublicWriteRequestBody) => Promise<DemoMutationResponse<any>>;
+        createSource: (signedRequest: SignedPublicWriteRequestBody) => Promise<SourceIngestionResponse>;
+        createClaimDraftFromArtifact: (signedRequest: SignedPublicWriteRequestBody) => Promise<DemoMutationResponse<any>>;
+        confirmSourcePublication: (sourceId: string | number, signedRequest: SignedPublicWriteRequestBody) => Promise<ConfirmSourcePublicationResponse>;
+        openReplicationJob: (claimId: string | number, signedRequest: SignedPublicWriteRequestBody) => Promise<DemoMutationResponse<any>>;
+        rejectSourcePublication: (sourceId: string | number, signedRequest: SignedPublicWriteRequestBody) => Promise<RejectSourcePublicationResponse>;
+        processReplicationJob: (jobId: string | number, signedRequest: SignedPublicWriteRequestBody) => Promise<DemoMutationResponse<Record<string, unknown>>>;
+        recomputeDomain: (domainId: number, signedRequest: SignedPublicWriteRequestBody) => Promise<DemoMutationResponse<any>>;
+        resolveReplicationJob: (jobId: string | number, signedRequest: SignedPublicWriteRequestBody) => Promise<DemoMutationResponse<Record<string, unknown>>>;
+    };
+    readonly agent: {
+        claimArtifactMaintenanceTask: (taskId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: {
+                run: ArtifactMaintenanceTaskRunView;
+                task: ArtifactMaintenanceTaskView;
+            };
+        }>;
+        heartbeatArtifactMaintenanceTask: (taskId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: ArtifactMaintenanceTaskRunView;
+        }>;
+        submitArtifactAuditResults: (taskId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: Record<string, unknown>;
+        }>;
+        submitArtifactRepairResults: (taskId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: Record<string, unknown>;
+        }>;
+        claimReplicationJob: (jobId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: {
+                job: ReplicationJobView;
+                run: ReplicationJobRunView;
+            };
+        }>;
+        heartbeatReplicationJob: (jobId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: ReplicationJobRunView;
+        }>;
+        submitReplicationResults: (jobId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: {
+                job: ReplicationJobView;
+                operatorRequestId: string;
+                resultArtifactKey: string;
+                run: ReplicationJobRunView;
+            };
+        }>;
+        claimReviewTask: (taskId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: {
+                run: ReviewTaskRunView;
+                task: ReviewTaskView;
+            };
+        }>;
+        heartbeatReviewTask: (taskId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: ReviewTaskRunView;
+        }>;
+        submitReviewResults: (taskId: string | number, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: {
+                submission: ReviewSubmissionView;
+                task: ReviewTaskView;
+            };
+        }>;
+        submitSource: (signedRequest: SignedAgentRequestBody) => Promise<SourceIngestionResponse>;
+        claimWorkItem: (itemId: string, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: {
+                run: ArtifactMaintenanceTaskRunView;
+                task: ArtifactMaintenanceTaskView;
+            };
+        }> | Promise<{
+            ok: true;
+            result: {
+                job: ReplicationJobView;
+                run: ReplicationJobRunView;
+            };
+        }>;
+        heartbeatWorkItem: (itemId: string, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: ArtifactMaintenanceTaskRunView;
+        }>;
+        submitWorkResults: (itemId: string, signedRequest: SignedAgentRequestBody) => Promise<{
+            ok: true;
+            result: Record<string, unknown>;
+        }> | Promise<{
+            ok: true;
+            result: {
+                job: ReplicationJobView;
+                operatorRequestId: string;
+                resultArtifactKey: string;
+                run: ReplicationJobRunView;
+            };
+        }> | Promise<{
+            ok: true;
+            result: {
+                submission: ReviewSubmissionView;
+                task: ReviewTaskView;
+            };
+        }>;
+        createWebhookSubscription: (signedRequest: SignedAgentRequestBody) => Promise<AgentWebhookSubscriptionCreateResponse>;
+        deleteWebhookSubscription: (subscriptionId: string | number, signedRequest: SignedAgentRequestBody) => Promise<AgentWebhookSubscriptionDeleteResponse>;
+        pingWebhookSubscription: (subscriptionId: string | number, signedRequest: SignedAgentRequestBody) => Promise<AgentWebhookSubscriptionPingResponse>;
+    };
+    getAdminStatus(): Promise<AdminStatusResponse>;
+    getGovernance(): Promise<GovernanceOverviewResponse>;
+    listGovernanceEvents(query?: {
+        limit?: number;
+        offset?: number;
+        proposalId?: string | number;
+    }): Promise<GovernanceEventsResponse>;
+    getGovernanceTreasury(query?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<GovernanceTreasuryResponse>;
+    getGovernanceProposal(proposalId: string | number, query?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<GovernanceProposalDetailResponse>;
+    listGovernanceProposals(query?: {
+        limit?: number;
+        offset?: number;
+        state?: "Active" | "Canceled" | "Defeated" | "Executed" | "Expired" | "Pending" | "Queued" | "Succeeded";
+    }): Promise<GovernanceProposalsResponse>;
+    getAgentRequest(requestId: string | number): Promise<AgentRequestDetailResponse>;
+    getAgentReviewCalibration(agentId: string | number, query?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<AgentReviewCalibrationResponse>;
+    getAgentWorkSummary(agentId: string | number, query?: {
+        domainId?: number;
+    }): Promise<AgentWorkSummaryResponse>;
+    getAgentRewards(agentId: string | number, query?: {
+        limit?: number;
+        offset?: number;
+        policyVersion?: string;
+        workKind?: "challenge" | "forecast" | "maintenance" | "replication" | "review" | "synthesis";
+    }): Promise<AgentRewardStateResponse>;
+    getRewardSettlements(query?: {
+        agentId?: string | number;
+        claimId?: string | number;
+        itemId?: string;
+        limit?: number;
+        offset?: number;
+        policyVersion?: string;
+        recipient?: string;
+        workKind?: "challenge" | "forecast" | "maintenance" | "replication" | "review" | "synthesis";
+    }): Promise<RewardSettlementHistoryResponse>;
+    getRecipientRewards(recipient: string, query?: {
+        itemId?: string;
+        limit?: number;
+        offset?: number;
+        policyVersion?: string;
+        workKind?: "challenge" | "forecast" | "maintenance" | "replication" | "review" | "synthesis";
+    }): Promise<RecipientRewardStateResponse>;
+    getRewardConfig(): Promise<RewardProtocolConfigResponse>;
+    getWriteConfig(): Promise<WriteProtocolConfigResponse>;
+    getAgentRuntimeEvents(query?: {
+        agentId?: string | number;
+        claimId?: string | number;
+        limit?: number;
+        offset?: number;
+        since?: string;
+    }): Promise<AgentRuntimeEventsResponse>;
+    getAgentWebhookSubscription(subscriptionId: string | number): Promise<AgentWebhookSubscriptionsResponse["items"][number]>;
+    getAgentWebhookDelivery(deliveryId: string | number): Promise<AgentWebhookDeliveriesResponse["items"][number]>;
+    getAgentWebhookSubscriptions(query?: {
+        agentId?: string | number;
+        limit?: number;
+        offset?: number;
+        status?: "active" | "inactive";
+    }): Promise<AgentWebhookSubscriptionsResponse>;
+    getAgentWebhookDeliveries(query?: {
+        agentId?: string | number;
+        limit?: number;
+        offset?: number;
+        status?: "delivered" | "failed" | "pending" | "retrying";
+        subscriptionId?: string | number;
+    }): Promise<AgentWebhookDeliveriesResponse>;
+    getArtifactMaintenanceTask(taskId: string | number): Promise<ArtifactMaintenanceTaskDetailResponse>;
+    getCheckpointPublications(query?: {
+        domainId?: number;
+        limit?: number;
+        offset?: number;
+        status?: string;
+        subjectActor?: string;
+        subjectAgentId?: string;
+        subjectType?: number;
+    }): Promise<PagedResponse<Record<string, unknown>>>;
+    getClaim(claimId: string | number, options?: {
+        view?: "full" | "summary";
+    }): Promise<any>;
+    getClaimReview(claimId: string | number): Promise<ClaimReviewState>;
+    getClaimRewards(claimId: string | number, query?: {
+        limit?: number;
+        offset?: number;
+        policyVersion?: string;
+        workKind?: "challenge" | "forecast" | "maintenance" | "replication" | "review" | "synthesis";
+    }): Promise<ClaimRewardStateResponse>;
+    getClaimWorkGraph(claimId: string | number): Promise<ClaimWorkGraphResponse>;
+    getWorkItem(itemId: string, query?: {
+        claimId?: string | number;
+        sourceId?: string | number;
+    }): Promise<ClaimWorkItemDetailResponse>;
+    getDomainLeaderboard(domainId: string | number, query?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<DomainLeaderboardResponse>;
+    getHealth(): Promise<HealthResponse>;
+    getReviewTask(taskId: string | number): Promise<ReviewTaskDetailResponse>;
+    getSource(sourceId: string | number): Promise<SourceDetailResponse>;
+    getSourcePublicationDecisions(sourceId: string | number, query?: {
+        limit?: number;
+        offset?: number;
+        shouldPublish?: boolean;
+    }): Promise<SourcePublicationDecisionsResponse>;
+    getSourceWorkGraph(sourceId: string | number): Promise<SourceWorkGraphResponse>;
+    listSourceFeed(query?: {
+        limit?: number;
+        offset?: number;
+        status?: "discovered" | "snapshotted" | "extracting" | "ready_for_publication" | "published" | "rejected";
+    }): Promise<SourceFeedResponse>;
+    listClaimFeed(query?: {
+        domainId?: number;
+        limit?: number;
+        machineProposed?: boolean;
+        offset?: number;
+        status?: number;
+    }): Promise<ClaimFeedResponse>;
+    listSourceEvents(query?: {
+        eventType?: "source.discovered" | "source.extracting_started" | "source.published" | "source.ready_for_publication" | "source.rejected" | "source.snapshotted";
+        limit?: number;
+        offset?: number;
+        sourceId?: string | number;
+    }): Promise<SourceEventsResponse>;
+    listClaimEvents(query?: {
+        claimId?: string | number;
+        domainId?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<ClaimEventsResponse>;
+    getOperatorRequests(query?: {
+        actionType?: string;
+        actor?: string;
+        limit?: number;
+        offset?: number;
+        operator?: string;
+        requestHash?: string;
+    }): Promise<PagedResponse<Record<string, unknown>>>;
+    getReplicationJob(jobId: string | number): Promise<ReplicationJobDetailResponse>;
+    getPersistedArtifact(artifactKey: string): Promise<PersistedArtifactDetailResponse>;
+    getPersistedArtifactContentUrl(artifactKey: string): string;
+    getPersistedArtifactAudits(artifactKey: string, query?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<PagedResponse<Record<string, unknown>>>;
+    getPersistedArtifactMaintenanceTasks(artifactKey: string, query?: {
+        assignedAgentId?: string;
+        limit?: number;
+        offset?: number;
+        status?: "assigned" | "completed" | "failed" | "open";
+        targetReplicaKey?: string;
+        taskType?: "audit" | "repair";
+    }): Promise<PagedResponse<Record<string, unknown>>>;
+    getResolutionRun(runId: string | number): Promise<Record<string, unknown>>;
+    listClaims(query?: ClaimListQuery): Promise<PagedResponse<ClaimView>>;
+    listReplications(query?: {
+        agentId?: string;
+        claimId?: string;
+        confidenceBps?: number;
+        limit?: number;
+        offset?: number;
+        outcome?: number;
+        replicator?: string;
+        resolutionStatus?: number;
+        resolverType?: number;
+    }): Promise<PagedResponse<ReplicationView>>;
+    listCheckpoints(query?: {
+        claimId?: string;
+        domainId?: number;
+        limit?: number;
+        offset?: number;
+        subjectActor?: string;
+        subjectAgentId?: string;
+        subjectModule?: string;
+        subjectType?: number;
+    }): Promise<PagedResponse<CheckpointView>>;
+    listArtifactMaintenanceTasks(query?: {
+        artifactKey?: string;
+        assignedAgentId?: string;
+        limit?: number;
+        offset?: number;
+        status?: "assigned" | "completed" | "failed" | "open";
+        targetReplicaKey?: string;
+        taskType?: "audit" | "repair";
+    }): Promise<PagedResponse<Record<string, unknown>>>;
+    listReviewTasks(query?: {
+        claimId?: string;
+        limit?: number;
+        offset?: number;
+        sourceId?: string;
+        status?: "canceled" | "completed" | "escalated" | "open";
+        taskType?: "artifact_completeness_check" | "artifact_integrity_check" | "benchmark_rerun_check" | "certification_synthesis_check" | "claim_extraction_check" | "claim_extraction_synthesis_check" | "contradiction_scan" | "method_consistency_check" | "replication_readiness_check" | "stats_sanity_check";
+    }): Promise<PagedResponse<ReviewTaskView>>;
+    listSources(query?: SourceListQuery): Promise<SourceListResponse>;
+    listWorkItems(query?: {
+        claimId?: string | number;
+        claimable?: boolean;
+        kind?: "artifact_maintenance" | "replication_job" | "review_task";
+        lane?: "evaluation" | "execution" | "maintenance" | "synthesis";
+        limit?: number;
+        offset?: number;
+        sourceId?: string | number;
+        status?: "canceled" | "completed" | "escalated" | "failed" | "leased" | "open";
+    }): Promise<PagedResponse<ClaimWorkItemView>>;
+    listAgentRequests(query?: {
+        actionType?: string;
+        agentId?: string;
+        limit?: number;
+        offset?: number;
+        scopeKey?: string;
+        status?: "accepted" | "rejected";
+    }): Promise<PagedResponse<AgentRequestDetailResponse>>;
+    listScenarios(): Promise<DemoScenariosResponse>;
+    private request;
+}