@synsci/sdk 1.3.6-test.21.1 → 1.3.6-test.24.1

package/dist/v2/gen/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import { type Client, type Options as Options2, type TDataShape } from "./client/index.js";
-import type { AccountBalanceResponses, AccountBillingModeGetResponses, AccountBillingModeSetResponses, AccountDeviceRevokeResponses, AccountDevicesResponses, AccountGetResponses, AccountLoginKeyResponses, AccountLogoutResponses, AccountSessionResponses, AgentPartInput, AppAgentsResponses, AppLogErrors, AppLogResponses, AppSkillDeleteResponses, AppSkillsResponses, AppSkillWriteResponses, Auth as Auth3, AuthRemoveErrors, AuthRemoveResponses, AuthSetErrors, AuthSetResponses, CommandListResponses, Config as Config4, ConfigGetResponses, ConfigProvidersResponses, ConfigUpdateErrors, ConfigUpdateResponses, EventSubscribeResponses, ExperimentalResourceListResponses, FileArtifactsResponses, FileInspectResponses, FileListResponses, FileManifestResponses, FilePartInput, FilePartSource, FileProvenanceResponses, FilePublicationCapabilitiesResponses, FilePublicationResponses, FileRawResponses, FileReadResponses, FileReproducibilityResponses, FileStarterResponses, FileStatusResponses, FileWriteResponses, FindFilesResponses, FindSymbolsResponses, FindTextResponses, FormatterStatusResponses, GlobalConfigGetResponses, GlobalConfigRawGetResponses, GlobalConfigRawSetErrors, GlobalConfigRawSetResponses, GlobalConfigUnsetErrors, GlobalConfigUnsetResponses, GlobalConfigUpdateErrors, GlobalConfigUpdateResponses, GlobalDisposeResponses, GlobalEventResponses, GlobalHealthResponses, GlobalSyncResponses, InstanceDisposeResponses, LspStatusResponses, McpAddErrors, McpAddResponses, McpAuthAuthenticateErrors, McpAuthAuthenticateResponses, McpAuthCallbackErrors, McpAuthCallbackResponses, McpAuthRemoveErrors, McpAuthRemoveResponses, McpAuthStartErrors, McpAuthStartResponses, McpConfigRemoveErrors, McpConfigRemoveResponses, McpConfigSetErrors, McpConfigSetResponses, McpConnectResponses, McpDisconnectResponses, McpLocalConfig, McpRemoteConfig, McpStatusResponses, NotebookExecuteResponses, NotebookInterruptResponses, NotebookRestartResponses, NotebookStatusResponses, Part as Part2, PartDeleteErrors, PartDeleteResponses, PartUpdateErrors, PartUpdateResponses, PathGetResponses, PermissionListResponses, PermissionReplyErrors, PermissionReplyResponses, PermissionRespondErrors, PermissionRespondResponses, PermissionRuleset, PostSettingsLocalModelsResponses, PostSettingsLocalResponses, PostSettingsLocalStartResponses, ProjectCurrentResponses, ProjectListResponses, ProjectUpdateErrors, ProjectUpdateResponses, ProvenanceExportResponses, ProvenanceListResponses, ProvenanceRecordErrors, ProvenanceRecordResponses, ProvenanceReviewErrors, ProvenanceReviewResponses, ProvenanceTraceErrors, ProvenanceTraceResponses, ProviderAuthResponses, ProviderListResponses, ProviderOauthAuthorizeErrors, ProviderOauthAuthorizeResponses, ProviderOauthCallbackErrors, ProviderOauthCallbackResponses, PtyConnectErrors, PtyConnectResponses, PtyCreateErrors, PtyCreateResponses, PtyGetErrors, PtyGetResponses, PtyListResponses, PtyRemoveErrors, PtyRemoveResponses, PtyUpdateErrors, PtyUpdateResponses, PutSettingsSandboxResponses, QuestionAnswer, QuestionListResponses, QuestionRejectErrors, QuestionRejectResponses, QuestionReplyErrors, QuestionReplyResponses, SessionAbortErrors, SessionAbortResponses, SessionChildrenErrors, SessionChildrenResponses, SessionCommandErrors, SessionCommandResponses, SessionCreateErrors, SessionCreateResponses, SessionDeleteErrors, SessionDeleteResponses, SessionDiffResponses, SessionForkResponses, SessionGetErrors, SessionGetResponses, SessionInitErrors, SessionInitResponses, SessionListResponses, SessionMessageErrors, SessionMessageResponses, SessionMessagesErrors, SessionMessagesResponses, SessionPromptAsyncErrors, SessionPromptAsyncResponses, SessionPromptErrors, SessionPromptResponses, SessionRevertErrors, SessionRevertResponses, SessionShellErrors, SessionShellResponses, SessionStatusErrors, SessionStatusResponses, SessionSummarizeErrors, SessionSummarizeResponses, SessionTodoErrors, SessionTodoResponses, SessionUnrevertErrors, SessionUnrevertResponses, SessionUpdateErrors, SessionUpdateResponses, SettingsBillingGetResponses, SettingsBillingUpdateResponses, SettingsComputeEndpointAddErrors, SettingsComputeEndpointAddResponses, SettingsComputeEndpointRemoveResponses, SettingsComputeGetResponses, SettingsComputeJobsCancelErrors, SettingsComputeJobsCancelResponses, SettingsComputeJobsClearResponses, SettingsComputeJobsListResponses, SettingsComputeJobsLogErrors, SettingsComputeJobsLogResponses, SettingsComputeJobsStartErrors, SettingsComputeJobsStartResponses, SettingsComputeProviderConnectErrors, SettingsComputeProviderConnectResponses, SettingsComputeProviderDisconnectResponses, SettingsComputeSshAddErrors, SettingsComputeSshAddResponses, SettingsComputeSshRemoveResponses, SettingsComputeSshTestErrors, SettingsComputeSshTestResponses, SettingsCredentialsListResponses, SettingsCredentialsRemoveResponses, SettingsCredentialsSetResponses, SettingsMemoryGetResponses, SettingsMemorySetResponses, SettingsNetworkGetResponses, SettingsNetworkSetResponses, SettingsPermissionsGetResponses, SettingsPermissionsRevokeAllErrors, SettingsPermissionsRevokeAllResponses, SettingsPermissionsSetErrors, SettingsPermissionsSetResponses, SettingsPreferencesGetResponses, SettingsPreferencesUpdateResponses, SettingsSkillsInstallErrors, SettingsSkillsInstallResponses, SettingsStorageRelocateResponses, SettingsStorageResetLocationResponses, SettingsStorageUsageResponses, SettingsUsageGetResponses, SettingsWalletGetResponses, SubtaskPartInput, TextPartInput, ToolIdsErrors, ToolIdsResponses, ToolListErrors, ToolListResponses, VcsGetResponses, WorktreeCreateErrors, WorktreeCreateInput, WorktreeCreateResponses, WorktreeListResponses, WorktreeRemoveErrors, WorktreeRemoveInput, WorktreeRemoveResponses, WorktreeResetErrors, WorktreeResetInput, WorktreeResetResponses } from "./types.gen.js";
+import type { AccountBalanceResponses, AccountBillingModeGetResponses, AccountBillingModeSetResponses, AccountDeviceRevokeResponses, AccountDevicesResponses, AccountGetResponses, AccountLoginKeyResponses, AccountLogoutResponses, AccountSessionResponses, AgentPartInput, AppAgentsResponses, AppLogErrors, AppLogResponses, AppSkillDeleteResponses, AppSkillsResponses, AppSkillWriteResponses, Auth as Auth3, AuthRemoveErrors, AuthRemoveResponses, AuthSetErrors, AuthSetResponses, CommandListResponses, Config as Config4, ConfigGetResponses, ConfigProvidersResponses, ConfigUpdateErrors, ConfigUpdateResponses, EventSubscribeResponses, ExperimentalResourceListResponses, FileAnnotationsCreateResponses, FileAnnotationsDeleteResponses, FileAnnotationsHistoryResponses, FileAnnotationsListResponses, FileAnnotationsUpdateResponses, FileArtifactsResponses, FileInspectResponses, FileListResponses, FileManifestResponses, FilePartInput, FilePartSource, FileProvenanceResponses, FilePublicationCapabilitiesResponses, FilePublicationResponses, FileRawResponses, FileReadResponses, FileReproducibilityResponses, FileReviewsCurrentErrors, FileReviewsCurrentResponses, FileReviewsFinalizeErrors, FileReviewsFinalizeResponses, FileReviewsHistoryResponses, FileReviewsResolveErrors, FileReviewsResolveResponses, FileReviewsRunResponses, FileStarterResponses, FileStatusResponses, FileWriteResponses, FindFilesResponses, FindSymbolsResponses, FindTextResponses, FormatterStatusResponses, GlobalConfigGetResponses, GlobalConfigRawGetResponses, GlobalConfigRawSetErrors, GlobalConfigRawSetResponses, GlobalConfigUnsetErrors, GlobalConfigUnsetResponses, GlobalConfigUpdateErrors, GlobalConfigUpdateResponses, GlobalDisposeResponses, GlobalEventResponses, GlobalHealthResponses, GlobalSyncResponses, InstanceDisposeResponses, LspStatusResponses, McpAddErrors, McpAddResponses, McpAuthAuthenticateErrors, McpAuthAuthenticateResponses, McpAuthCallbackErrors, McpAuthCallbackResponses, McpAuthRemoveErrors, McpAuthRemoveResponses, McpAuthStartErrors, McpAuthStartResponses, McpConfigRemoveErrors, McpConfigRemoveResponses, McpConfigSetErrors, McpConfigSetResponses, McpConnectResponses, McpDisconnectResponses, McpLocalConfig, McpRemoteConfig, McpStatusResponses, NotebookExecuteResponses, NotebookInterruptResponses, NotebookRestartResponses, NotebookStatusResponses, Part as Part2, PartDeleteErrors, PartDeleteResponses, PartUpdateErrors, PartUpdateResponses, PathGetResponses, PermissionListResponses, PermissionReplyErrors, PermissionReplyResponses, PermissionRespondErrors, PermissionRespondResponses, PermissionRuleset, PostSettingsLocalModelsResponses, PostSettingsLocalResponses, PostSettingsLocalStartResponses, ProjectCurrentResponses, ProjectListResponses, ProjectUpdateErrors, ProjectUpdateResponses, ProvenanceExportResponses, ProvenanceListResponses, ProvenanceRecordErrors, ProvenanceRecordResponses, ProvenanceReviewErrors, ProvenanceReviewResponses, ProvenanceTraceErrors, ProvenanceTraceResponses, ProviderAuthResponses, ProviderListResponses, ProviderOauthAuthorizeErrors, ProviderOauthAuthorizeResponses, ProviderOauthCallbackErrors, ProviderOauthCallbackResponses, PtyConnectErrors, PtyConnectResponses, PtyCreateErrors, PtyCreateResponses, PtyGetErrors, PtyGetResponses, PtyListResponses, PtyRemoveErrors, PtyRemoveResponses, PtyUpdateErrors, PtyUpdateResponses, PutSettingsSandboxResponses, QuestionAnswer, QuestionListResponses, QuestionRejectErrors, QuestionRejectResponses, QuestionReplyErrors, QuestionReplyResponses, SessionAbortErrors, SessionAbortResponses, SessionChildrenErrors, SessionChildrenResponses, SessionCommandErrors, SessionCommandResponses, SessionCreateErrors, SessionCreateResponses, SessionDeleteErrors, SessionDeleteResponses, SessionDiffResponses, SessionForkResponses, SessionGetErrors, SessionGetResponses, SessionInitErrors, SessionInitResponses, SessionListResponses, SessionMessageErrors, SessionMessageResponses, SessionMessagesErrors, SessionMessagesResponses, SessionPromptAsyncErrors, SessionPromptAsyncResponses, SessionPromptErrors, SessionPromptResponses, SessionRevertErrors, SessionRevertResponses, SessionShellErrors, SessionShellResponses, SessionStatusErrors, SessionStatusResponses, SessionSummarizeErrors, SessionSummarizeResponses, SessionTodoErrors, SessionTodoResponses, SessionUnrevertErrors, SessionUnrevertResponses, SessionUpdateErrors, SessionUpdateResponses, SettingsBillingGetResponses, SettingsBillingUpdateResponses, SettingsComputeEndpointAddErrors, SettingsComputeEndpointAddResponses, SettingsComputeEndpointRemoveResponses, SettingsComputeGetResponses, SettingsComputeJobsCancelErrors, SettingsComputeJobsCancelResponses, SettingsComputeJobsClearResponses, SettingsComputeJobsListResponses, SettingsComputeJobsLogErrors, SettingsComputeJobsLogResponses, SettingsComputeJobsStartErrors, SettingsComputeJobsStartResponses, SettingsComputeProviderConnectErrors, SettingsComputeProviderConnectResponses, SettingsComputeProviderDisconnectResponses, SettingsComputeSshAddErrors, SettingsComputeSshAddResponses, SettingsComputeSshRemoveResponses, SettingsComputeSshTestErrors, SettingsComputeSshTestResponses, SettingsCredentialsListResponses, SettingsCredentialsRemoveResponses, SettingsCredentialsSetResponses, SettingsMemoryGetResponses, SettingsMemorySetResponses, SettingsNetworkGetResponses, SettingsNetworkSetResponses, SettingsPermissionsGetResponses, SettingsPermissionsRevokeAllErrors, SettingsPermissionsRevokeAllResponses, SettingsPermissionsSetErrors, SettingsPermissionsSetResponses, SettingsPreferencesGetResponses, SettingsPreferencesUpdateResponses, SettingsSkillsInstallErrors, SettingsSkillsInstallResponses, SettingsStorageRelocateResponses, SettingsStorageResetLocationResponses, SettingsStorageUsageResponses, SettingsUsageGetResponses, SettingsWalletGetResponses, SubtaskPartInput, TextPartInput, ToolIdsErrors, ToolIdsResponses, ToolListErrors, ToolListResponses, VcsGetResponses, WorktreeCreateErrors, WorktreeCreateInput, WorktreeCreateResponses, WorktreeListResponses, WorktreeRemoveErrors, WorktreeRemoveInput, WorktreeRemoveResponses, WorktreeResetErrors, WorktreeResetInput, WorktreeResetResponses } from "./types.gen.js";
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -1102,6 +1102,134 @@ export declare class Find extends HeyApiClient {
         query: string;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FindSymbolsResponses, unknown, ThrowOnError, "fields">;
 }
+export declare class Annotations extends HeyApiClient {
+    /**
+     * List artifact annotations
+     *
+     * List durable review threads anchored to a project artifact.
+     */
+    list<ThrowOnError extends boolean = false>(parameters: {
+        directory?: string;
+        path: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileAnnotationsListResponses, unknown, ThrowOnError, "fields">;
+    /**
+     * Create an artifact annotation
+     *
+     * Create a durable review thread anchored to an artifact, text range, notebook cell, molecule, or locus.
+     */
+    create<ThrowOnError extends boolean = false>(parameters?: {
+        directory?: string;
+        path?: string;
+        body?: string;
+        author?: string;
+        anchor?: {
+            kind: "artifact";
+            label?: string;
+        } | {
+            kind: "text";
+            startLine: number;
+            endLine: number;
+            quote?: string;
+        } | {
+            kind: "notebook";
+            cellId: string;
+            line?: number;
+        } | {
+            kind: "molecule";
+            selection: string;
+            count?: number;
+        } | {
+            kind: "genome";
+            chromosome: string;
+            start: number;
+            end: number;
+        };
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileAnnotationsCreateResponses, unknown, ThrowOnError, "fields">;
+    /**
+     * Read artifact annotation history
+     *
+     * Read every immutable revision of an artifact review thread, including a recoverable tombstone.
+     */
+    history<ThrowOnError extends boolean = false>(parameters: {
+        id: string;
+        directory?: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileAnnotationsHistoryResponses, unknown, ThrowOnError, "fields">;
+    /**
+     * Tombstone an artifact annotation
+     *
+     * Hide an artifact review thread while retaining its recoverable revision history.
+     */
+    delete<ThrowOnError extends boolean = false>(parameters: {
+        id: string;
+        directory?: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileAnnotationsDeleteResponses, unknown, ThrowOnError, "fields">;
+    /**
+     * Update an artifact annotation
+     *
+     * Reply to, resolve, or reopen an artifact review thread.
+     */
+    update<ThrowOnError extends boolean = false>(parameters: {
+        id: string;
+        directory?: string;
+        status?: "open" | "resolved";
+        body?: string;
+        reply?: string;
+        author?: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileAnnotationsUpdateResponses, unknown, ThrowOnError, "fields">;
+}
+export declare class Reviews extends HeyApiClient {
+    /**
+     * Read the current publication review
+     *
+     * Return the latest deterministic review report and whether it is stale for the current source bytes.
+     */
+    current<ThrowOnError extends boolean = false>(parameters: {
+        directory?: string;
+        path: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileReviewsCurrentResponses, FileReviewsCurrentErrors, ThrowOnError, "fields">;
+    /**
+     * Run deterministic publication checks
+     *
+     * Check citations, numeric traces, figures, and provenance for the exact Markdown manuscript bytes.
+     */
+    run<ThrowOnError extends boolean = false>(parameters?: {
+        directory?: string;
+        path?: string;
+        actor?: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileReviewsRunResponses, unknown, ThrowOnError, "fields">;
+    /**
+     * List publication review history
+     *
+     * List prior deterministic review reports for every reviewed version of a manuscript.
+     */
+    history<ThrowOnError extends boolean = false>(parameters: {
+        directory?: string;
+        path: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileReviewsHistoryResponses, unknown, ThrowOnError, "fields">;
+    /**
+     * Resolve or override a publication finding
+     *
+     * Record an attributed reason and close one deterministic review finding.
+     */
+    resolve<ThrowOnError extends boolean = false>(parameters: {
+        id: string;
+        finding: string;
+        directory?: string;
+        status?: "resolved" | "overridden";
+        actor?: string;
+        reason?: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileReviewsResolveResponses, FileReviewsResolveErrors, ThrowOnError, "fields">;
+    /**
+     * Finalize a publication review
+     *
+     * Bind publication-ready state to the exact reviewed source hash after all blocking findings close.
+     */
+    finalize<ThrowOnError extends boolean = false>(parameters: {
+        id: string;
+        directory?: string;
+        actor?: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileReviewsFinalizeResponses, FileReviewsFinalizeErrors, ThrowOnError, "fields">;
+}
 export declare class File extends HeyApiClient {
     /**
      * List files
@@ -1208,6 +1336,8 @@ export declare class File extends HeyApiClient {
         directory?: string;
         path?: string;
         format?: "html" | "pdf" | "docx" | "latex" | "pptx";
+        readiness?: "draft" | "reviewed";
+        review_id?: string;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FilePublicationResponses, unknown, ThrowOnError, "fields">;
     /**
      * Get file status
@@ -1217,6 +1347,10 @@ export declare class File extends HeyApiClient {
     status<ThrowOnError extends boolean = false>(parameters?: {
         directory?: string;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileStatusResponses, unknown, ThrowOnError, "fields">;
+    private _annotations?;
+    get annotations(): Annotations;
+    private _reviews?;
+    get reviews(): Reviews;
 }
 export declare class Notebook extends HeyApiClient {
     /**

package/dist/v2/gen/sdk.gen.js

@@ -2161,6 +2161,248 @@ export class Find extends HeyApiClient {
         });
     }
 }
+export class Annotations extends HeyApiClient {
+    /**
+     * List artifact annotations
+     *
+     * List durable review threads anchored to a project artifact.
+     */
+    list(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "query", key: "directory" },
+                    { in: "query", key: "path" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).get({
+            url: "/file/annotations",
+            ...options,
+            ...params,
+        });
+    }
+    /**
+     * Create an artifact annotation
+     *
+     * Create a durable review thread anchored to an artifact, text range, notebook cell, molecule, or locus.
+     */
+    create(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "query", key: "directory" },
+                    { in: "body", key: "path" },
+                    { in: "body", key: "body" },
+                    { in: "body", key: "author" },
+                    { in: "body", key: "anchor" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).post({
+            url: "/file/annotations",
+            ...options,
+            ...params,
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.headers,
+                ...params.headers,
+            },
+        });
+    }
+    /**
+     * Read artifact annotation history
+     *
+     * Read every immutable revision of an artifact review thread, including a recoverable tombstone.
+     */
+    history(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "path", key: "id" },
+                    { in: "query", key: "directory" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).get({
+            url: "/file/annotations/{id}/history",
+            ...options,
+            ...params,
+        });
+    }
+    /**
+     * Tombstone an artifact annotation
+     *
+     * Hide an artifact review thread while retaining its recoverable revision history.
+     */
+    delete(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "path", key: "id" },
+                    { in: "query", key: "directory" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).delete({
+            url: "/file/annotations/{id}",
+            ...options,
+            ...params,
+        });
+    }
+    /**
+     * Update an artifact annotation
+     *
+     * Reply to, resolve, or reopen an artifact review thread.
+     */
+    update(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "path", key: "id" },
+                    { in: "query", key: "directory" },
+                    { in: "body", key: "status" },
+                    { in: "body", key: "body" },
+                    { in: "body", key: "reply" },
+                    { in: "body", key: "author" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).patch({
+            url: "/file/annotations/{id}",
+            ...options,
+            ...params,
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.headers,
+                ...params.headers,
+            },
+        });
+    }
+}
+export class Reviews extends HeyApiClient {
+    /**
+     * Read the current publication review
+     *
+     * Return the latest deterministic review report and whether it is stale for the current source bytes.
+     */
+    current(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "query", key: "directory" },
+                    { in: "query", key: "path" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).get({
+            url: "/file/reviews",
+            ...options,
+            ...params,
+        });
+    }
+    /**
+     * Run deterministic publication checks
+     *
+     * Check citations, numeric traces, figures, and provenance for the exact Markdown manuscript bytes.
+     */
+    run(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "query", key: "directory" },
+                    { in: "body", key: "path" },
+                    { in: "body", key: "actor" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).post({
+            url: "/file/reviews",
+            ...options,
+            ...params,
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.headers,
+                ...params.headers,
+            },
+        });
+    }
+    /**
+     * List publication review history
+     *
+     * List prior deterministic review reports for every reviewed version of a manuscript.
+     */
+    history(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "query", key: "directory" },
+                    { in: "query", key: "path" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).get({
+            url: "/file/reviews/history",
+            ...options,
+            ...params,
+        });
+    }
+    /**
+     * Resolve or override a publication finding
+     *
+     * Record an attributed reason and close one deterministic review finding.
+     */
+    resolve(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "path", key: "id" },
+                    { in: "path", key: "finding" },
+                    { in: "query", key: "directory" },
+                    { in: "body", key: "status" },
+                    { in: "body", key: "actor" },
+                    { in: "body", key: "reason" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).patch({
+            url: "/file/reviews/{id}/findings/{finding}",
+            ...options,
+            ...params,
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.headers,
+                ...params.headers,
+            },
+        });
+    }
+    /**
+     * Finalize a publication review
+     *
+     * Bind publication-ready state to the exact reviewed source hash after all blocking findings close.
+     */
+    finalize(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "path", key: "id" },
+                    { in: "query", key: "directory" },
+                    { in: "body", key: "actor" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).post({
+            url: "/file/reviews/{id}/finalize",
+            ...options,
+            ...params,
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.headers,
+                ...params.headers,
+            },
+        });
+    }
+}
 export class File extends HeyApiClient {
     /**
      * List files
@@ -2377,6 +2619,8 @@ export class File extends HeyApiClient {
                     { in: "query", key: "directory" },
                     { in: "body", key: "path" },
                     { in: "body", key: "format" },
+                    { in: "body", key: "readiness" },
+                    { in: "body", key: "review_id" },
                 ],
             },
         ]);
@@ -2404,6 +2648,14 @@ export class File extends HeyApiClient {
             ...params,
         });
     }
+    _annotations;
+    get annotations() {
+        return (this._annotations ??= new Annotations({ client: this.client }));
+    }
+    _reviews;
+    get reviews() {
+        return (this._reviews ??= new Reviews({ client: this.client }));
+    }
 }
 export class Notebook extends HeyApiClient {
     /**

package/dist/v2/gen/types.gen.d.ts

@@ -5156,6 +5156,330 @@ export type FileReproducibilityResponses = {
     };
 };
 export type FileReproducibilityResponse = FileReproducibilityResponses[keyof FileReproducibilityResponses];
+export type FileAnnotationsListData = {
+    body?: never;
+    path?: never;
+    query: {
+        directory?: string;
+        path: string;
+    };
+    url: "/file/annotations";
+};
+export type FileAnnotationsListResponses = {
+    /**
+     * Artifact annotations
+     */
+    200: Array<{
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        anchor: {
+            kind: "artifact";
+            label?: string;
+        } | {
+            kind: "text";
+            startLine: number;
+            endLine: number;
+            quote?: string;
+        } | {
+            kind: "notebook";
+            cellId: string;
+            line?: number;
+        } | {
+            kind: "molecule";
+            selection: string;
+            count?: number;
+        } | {
+            kind: "genome";
+            chromosome: string;
+            start: number;
+            end: number;
+        };
+        messages: Array<{
+            id: string;
+            body: string;
+            author: string;
+            createdAt: number;
+        }>;
+        status: "open" | "resolved";
+        version: number;
+        revisions: Array<{
+            version: number;
+            event: "created" | "edited" | "replied" | "resolved" | "reopened" | "deleted";
+            actor: string;
+            at: number;
+            status: "open" | "resolved";
+            messages: Array<{
+                id: string;
+                body: string;
+                author: string;
+                createdAt: number;
+            }>;
+            deletedAt?: number;
+        }>;
+        createdAt: number;
+        updatedAt: number;
+        deletedAt?: number;
+    }>;
+};
+export type FileAnnotationsListResponse = FileAnnotationsListResponses[keyof FileAnnotationsListResponses];
+export type FileAnnotationsCreateData = {
+    body?: {
+        path: string;
+        body: string;
+        author?: string;
+        anchor?: {
+            kind: "artifact";
+            label?: string;
+        } | {
+            kind: "text";
+            startLine: number;
+            endLine: number;
+            quote?: string;
+        } | {
+            kind: "notebook";
+            cellId: string;
+            line?: number;
+        } | {
+            kind: "molecule";
+            selection: string;
+            count?: number;
+        } | {
+            kind: "genome";
+            chromosome: string;
+            start: number;
+            end: number;
+        };
+    };
+    path?: never;
+    query?: {
+        directory?: string;
+    };
+    url: "/file/annotations";
+};
+export type FileAnnotationsCreateResponses = {
+    /**
+     * Created annotation
+     */
+    200: {
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        anchor: {
+            kind: "artifact";
+            label?: string;
+        } | {
+            kind: "text";
+            startLine: number;
+            endLine: number;
+            quote?: string;
+        } | {
+            kind: "notebook";
+            cellId: string;
+            line?: number;
+        } | {
+            kind: "molecule";
+            selection: string;
+            count?: number;
+        } | {
+            kind: "genome";
+            chromosome: string;
+            start: number;
+            end: number;
+        };
+        messages: Array<{
+            id: string;
+            body: string;
+            author: string;
+            createdAt: number;
+        }>;
+        status: "open" | "resolved";
+        version: number;
+        revisions: Array<{
+            version: number;
+            event: "created" | "edited" | "replied" | "resolved" | "reopened" | "deleted";
+            actor: string;
+            at: number;
+            status: "open" | "resolved";
+            messages: Array<{
+                id: string;
+                body: string;
+                author: string;
+                createdAt: number;
+            }>;
+            deletedAt?: number;
+        }>;
+        createdAt: number;
+        updatedAt: number;
+        deletedAt?: number;
+    };
+};
+export type FileAnnotationsCreateResponse = FileAnnotationsCreateResponses[keyof FileAnnotationsCreateResponses];
+export type FileAnnotationsHistoryData = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: {
+        directory?: string;
+    };
+    url: "/file/annotations/{id}/history";
+};
+export type FileAnnotationsHistoryResponses = {
+    /**
+     * Versioned artifact annotation
+     */
+    200: {
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        anchor: {
+            kind: "artifact";
+            label?: string;
+        } | {
+            kind: "text";
+            startLine: number;
+            endLine: number;
+            quote?: string;
+        } | {
+            kind: "notebook";
+            cellId: string;
+            line?: number;
+        } | {
+            kind: "molecule";
+            selection: string;
+            count?: number;
+        } | {
+            kind: "genome";
+            chromosome: string;
+            start: number;
+            end: number;
+        };
+        messages: Array<{
+            id: string;
+            body: string;
+            author: string;
+            createdAt: number;
+        }>;
+        status: "open" | "resolved";
+        version: number;
+        revisions: Array<{
+            version: number;
+            event: "created" | "edited" | "replied" | "resolved" | "reopened" | "deleted";
+            actor: string;
+            at: number;
+            status: "open" | "resolved";
+            messages: Array<{
+                id: string;
+                body: string;
+                author: string;
+                createdAt: number;
+            }>;
+            deletedAt?: number;
+        }>;
+        createdAt: number;
+        updatedAt: number;
+        deletedAt?: number;
+    };
+};
+export type FileAnnotationsHistoryResponse = FileAnnotationsHistoryResponses[keyof FileAnnotationsHistoryResponses];
+export type FileAnnotationsDeleteData = {
+    body?: never;
+    path: {
+        id: string;
+    };
+    query?: {
+        directory?: string;
+    };
+    url: "/file/annotations/{id}";
+};
+export type FileAnnotationsDeleteResponses = {
+    /**
+     * Tombstoned annotation
+     */
+    200: {
+        deleted: true;
+        version: number;
+    };
+};
+export type FileAnnotationsDeleteResponse = FileAnnotationsDeleteResponses[keyof FileAnnotationsDeleteResponses];
+export type FileAnnotationsUpdateData = {
+    body?: {
+        status?: "open" | "resolved";
+        body?: string;
+        reply?: string;
+        author?: string;
+    };
+    path: {
+        id: string;
+    };
+    query?: {
+        directory?: string;
+    };
+    url: "/file/annotations/{id}";
+};
+export type FileAnnotationsUpdateResponses = {
+    /**
+     * Updated annotation
+     */
+    200: {
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        anchor: {
+            kind: "artifact";
+            label?: string;
+        } | {
+            kind: "text";
+            startLine: number;
+            endLine: number;
+            quote?: string;
+        } | {
+            kind: "notebook";
+            cellId: string;
+            line?: number;
+        } | {
+            kind: "molecule";
+            selection: string;
+            count?: number;
+        } | {
+            kind: "genome";
+            chromosome: string;
+            start: number;
+            end: number;
+        };
+        messages: Array<{
+            id: string;
+            body: string;
+            author: string;
+            createdAt: number;
+        }>;
+        status: "open" | "resolved";
+        version: number;
+        revisions: Array<{
+            version: number;
+            event: "created" | "edited" | "replied" | "resolved" | "reopened" | "deleted";
+            actor: string;
+            at: number;
+            status: "open" | "resolved";
+            messages: Array<{
+                id: string;
+                body: string;
+                author: string;
+                createdAt: number;
+            }>;
+            deletedAt?: number;
+        }>;
+        createdAt: number;
+        updatedAt: number;
+        deletedAt?: number;
+    };
+};
+export type FileAnnotationsUpdateResponse = FileAnnotationsUpdateResponses[keyof FileAnnotationsUpdateResponses];
 export type FileManifestData = {
     body?: never;
     path?: never;
@@ -5232,6 +5556,8 @@ export type FilePublicationData = {
     body?: {
         path: string;
         format: "html" | "pdf" | "docx" | "latex" | "pptx";
+        readiness?: "draft" | "reviewed";
+        review_id?: string;
     };
     path?: never;
     query?: {
@@ -5249,9 +5575,381 @@ export type FilePublicationResponses = {
         size: number;
         created_at: string;
         engine: string;
+        readiness: "draft" | "reviewed";
+        review_id?: string;
     };
 };
 export type FilePublicationResponse = FilePublicationResponses[keyof FilePublicationResponses];
+export type FileReviewsCurrentData = {
+    body?: never;
+    path?: never;
+    query: {
+        directory?: string;
+        path: string;
+    };
+    url: "/file/reviews";
+};
+export type FileReviewsCurrentErrors = {
+    /**
+     * No publication review exists for this manuscript
+     */
+    404: unknown;
+};
+export type FileReviewsCurrentResponses = {
+    /**
+     * Current publication review
+     */
+    200: {
+        format: "openscience.publication-review.v1";
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        version: number;
+        status: "blocked" | "warnings" | "ready";
+        summary: {
+            total: number;
+            open: number;
+            blocking: number;
+            major: number;
+            minor: number;
+            info: number;
+            resolved: number;
+            overridden: number;
+        };
+        findings: Array<{
+            id: string;
+            check: "citation" | "numeric" | "figure" | "provenance";
+            severity: "blocking" | "major" | "minor" | "info";
+            status: "open" | "resolved" | "overridden";
+            title: string;
+            detail: string;
+            evidence: Array<string>;
+            location: {
+                path: string;
+                line?: number;
+            };
+            resolution?: {
+                kind: "resolved" | "overridden";
+                actor: string;
+                reason: string;
+                at: number;
+            };
+        }>;
+        events: Array<{
+            version: number;
+            type: "generated" | "resolved" | "overridden" | "finalized";
+            actor: string;
+            at: number;
+            findingID?: string;
+            reason?: string;
+        }>;
+        finalized?: {
+            actor: string;
+            at: number;
+            artifactHash: string;
+        };
+        createdAt: number;
+        updatedAt: number;
+        stale: boolean;
+    };
+};
+export type FileReviewsCurrentResponse = FileReviewsCurrentResponses[keyof FileReviewsCurrentResponses];
+export type FileReviewsRunData = {
+    body?: {
+        path: string;
+        actor?: string;
+    };
+    path?: never;
+    query?: {
+        directory?: string;
+    };
+    url: "/file/reviews";
+};
+export type FileReviewsRunResponses = {
+    /**
+     * Generated publication review
+     */
+    200: {
+        format: "openscience.publication-review.v1";
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        version: number;
+        status: "blocked" | "warnings" | "ready";
+        summary: {
+            total: number;
+            open: number;
+            blocking: number;
+            major: number;
+            minor: number;
+            info: number;
+            resolved: number;
+            overridden: number;
+        };
+        findings: Array<{
+            id: string;
+            check: "citation" | "numeric" | "figure" | "provenance";
+            severity: "blocking" | "major" | "minor" | "info";
+            status: "open" | "resolved" | "overridden";
+            title: string;
+            detail: string;
+            evidence: Array<string>;
+            location: {
+                path: string;
+                line?: number;
+            };
+            resolution?: {
+                kind: "resolved" | "overridden";
+                actor: string;
+                reason: string;
+                at: number;
+            };
+        }>;
+        events: Array<{
+            version: number;
+            type: "generated" | "resolved" | "overridden" | "finalized";
+            actor: string;
+            at: number;
+            findingID?: string;
+            reason?: string;
+        }>;
+        finalized?: {
+            actor: string;
+            at: number;
+            artifactHash: string;
+        };
+        createdAt: number;
+        updatedAt: number;
+    };
+};
+export type FileReviewsRunResponse = FileReviewsRunResponses[keyof FileReviewsRunResponses];
+export type FileReviewsHistoryData = {
+    body?: never;
+    path?: never;
+    query: {
+        directory?: string;
+        path: string;
+    };
+    url: "/file/reviews/history";
+};
+export type FileReviewsHistoryResponses = {
+    /**
+     * Publication review history
+     */
+    200: Array<{
+        format: "openscience.publication-review.v1";
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        version: number;
+        status: "blocked" | "warnings" | "ready";
+        summary: {
+            total: number;
+            open: number;
+            blocking: number;
+            major: number;
+            minor: number;
+            info: number;
+            resolved: number;
+            overridden: number;
+        };
+        findings: Array<{
+            id: string;
+            check: "citation" | "numeric" | "figure" | "provenance";
+            severity: "blocking" | "major" | "minor" | "info";
+            status: "open" | "resolved" | "overridden";
+            title: string;
+            detail: string;
+            evidence: Array<string>;
+            location: {
+                path: string;
+                line?: number;
+            };
+            resolution?: {
+                kind: "resolved" | "overridden";
+                actor: string;
+                reason: string;
+                at: number;
+            };
+        }>;
+        events: Array<{
+            version: number;
+            type: "generated" | "resolved" | "overridden" | "finalized";
+            actor: string;
+            at: number;
+            findingID?: string;
+            reason?: string;
+        }>;
+        finalized?: {
+            actor: string;
+            at: number;
+            artifactHash: string;
+        };
+        createdAt: number;
+        updatedAt: number;
+    }>;
+};
+export type FileReviewsHistoryResponse = FileReviewsHistoryResponses[keyof FileReviewsHistoryResponses];
+export type FileReviewsResolveData = {
+    body?: {
+        status: "resolved" | "overridden";
+        actor: string;
+        reason: string;
+    };
+    path: {
+        id: string;
+        finding: string;
+    };
+    query?: {
+        directory?: string;
+    };
+    url: "/file/reviews/{id}/findings/{finding}";
+};
+export type FileReviewsResolveErrors = {
+    /**
+     * Finding cannot be updated
+     */
+    409: unknown;
+};
+export type FileReviewsResolveResponses = {
+    /**
+     * Updated publication review
+     */
+    200: {
+        format: "openscience.publication-review.v1";
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        version: number;
+        status: "blocked" | "warnings" | "ready";
+        summary: {
+            total: number;
+            open: number;
+            blocking: number;
+            major: number;
+            minor: number;
+            info: number;
+            resolved: number;
+            overridden: number;
+        };
+        findings: Array<{
+            id: string;
+            check: "citation" | "numeric" | "figure" | "provenance";
+            severity: "blocking" | "major" | "minor" | "info";
+            status: "open" | "resolved" | "overridden";
+            title: string;
+            detail: string;
+            evidence: Array<string>;
+            location: {
+                path: string;
+                line?: number;
+            };
+            resolution?: {
+                kind: "resolved" | "overridden";
+                actor: string;
+                reason: string;
+                at: number;
+            };
+        }>;
+        events: Array<{
+            version: number;
+            type: "generated" | "resolved" | "overridden" | "finalized";
+            actor: string;
+            at: number;
+            findingID?: string;
+            reason?: string;
+        }>;
+        finalized?: {
+            actor: string;
+            at: number;
+            artifactHash: string;
+        };
+        createdAt: number;
+        updatedAt: number;
+    };
+};
+export type FileReviewsResolveResponse = FileReviewsResolveResponses[keyof FileReviewsResolveResponses];
+export type FileReviewsFinalizeData = {
+    body?: {
+        actor: string;
+    };
+    path: {
+        id: string;
+    };
+    query?: {
+        directory?: string;
+    };
+    url: "/file/reviews/{id}/finalize";
+};
+export type FileReviewsFinalizeErrors = {
+    /**
+     * Review is blocked, stale, or already invalid
+     */
+    409: unknown;
+};
+export type FileReviewsFinalizeResponses = {
+    /**
+     * Finalized publication review
+     */
+    200: {
+        format: "openscience.publication-review.v1";
+        id: string;
+        projectID: string;
+        path: string;
+        artifactHash: string;
+        version: number;
+        status: "blocked" | "warnings" | "ready";
+        summary: {
+            total: number;
+            open: number;
+            blocking: number;
+            major: number;
+            minor: number;
+            info: number;
+            resolved: number;
+            overridden: number;
+        };
+        findings: Array<{
+            id: string;
+            check: "citation" | "numeric" | "figure" | "provenance";
+            severity: "blocking" | "major" | "minor" | "info";
+            status: "open" | "resolved" | "overridden";
+            title: string;
+            detail: string;
+            evidence: Array<string>;
+            location: {
+                path: string;
+                line?: number;
+            };
+            resolution?: {
+                kind: "resolved" | "overridden";
+                actor: string;
+                reason: string;
+                at: number;
+            };
+        }>;
+        events: Array<{
+            version: number;
+            type: "generated" | "resolved" | "overridden" | "finalized";
+            actor: string;
+            at: number;
+            findingID?: string;
+            reason?: string;
+        }>;
+        finalized?: {
+            actor: string;
+            at: number;
+            artifactHash: string;
+        };
+        createdAt: number;
+        updatedAt: number;
+    };
+};
+export type FileReviewsFinalizeResponse = FileReviewsFinalizeResponses[keyof FileReviewsFinalizeResponses];
 export type FileStatusData = {
     body?: never;
     path?: never;

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@synsci/sdk",
-  "version": "1.3.6-test.21.1",
+  "version": "1.3.6-test.24.1",
   "type": "module",
   "license": "Apache-2.0",
   "scripts": {