@opengeni/db 0.28.1 → 0.31.1

package/dist/generated-images.d.ts

@@ -0,0 +1,139 @@
+import type { FileAsset, FileUploadStatus } from "@opengeni/contracts";
+import type { Database } from "./database.js";
+export type GeneratedImageSourceStrategy = "native_hosted" | "provider_adapter";
+export type GeneratedImageArtifactStatus = "pending" | "ready";
+export type ImageGenerationOperationStatus = "prepared" | "provider_started" | "completed" | "outcome_unknown" | "retention_failed";
+export type ImageGenerationOperation = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    sessionId: string | null;
+    turnId: string | null;
+    attemptId: string | null;
+    operationKey: string;
+    toolCallId: string;
+    providerId: string;
+    providerBindingHash: string;
+    modelId: string;
+    requestDigest: string;
+    expectedArtifactId: string;
+    status: ImageGenerationOperationStatus;
+    providerStartedAt: Date | null;
+    completedAt: Date | null;
+    lastError: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+};
+export type GeneratedImageArtifact = {
+    artifactId: string;
+    accountId: string;
+    workspaceId: string;
+    sessionId: string | null;
+    turnId: string | null;
+    attemptId: string | null;
+    uploadId: string | null;
+    settlementKey: string;
+    toolCallId: string;
+    sourceStrategy: GeneratedImageSourceStrategy;
+    providerId: string;
+    providerBindingHash: string;
+    providerItemId: string | null;
+    status: GeneratedImageArtifactStatus;
+    mediaType: string;
+    sizeBytes: number;
+    sha256: string;
+    width: number;
+    height: number;
+    sandboxPath: string;
+    readyAt: Date | null;
+    lastError: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+    uploadStatus: FileUploadStatus | null;
+    file: FileAsset;
+};
+export type PrepareGeneratedImageArtifactInput = {
+    artifactId: string;
+    uploadId: string;
+    accountId: string;
+    workspaceId: string;
+    sessionId: string;
+    turnId: string;
+    attemptId: string;
+    settlementKey: string;
+    toolCallId: string;
+    sourceStrategy: GeneratedImageSourceStrategy;
+    providerId: string;
+    providerBindingHash: string;
+    providerItemId: string | null;
+    mediaType: string;
+    sizeBytes: number;
+    sha256: string;
+    width: number;
+    height: number;
+    sandboxPath: string;
+    filename: string;
+    safeFilename: string;
+    bucket: string;
+    objectKey: string;
+    uploadExpiresAt: Date;
+};
+export type PrepareImageGenerationOperationInput = Omit<ImageGenerationOperation, "status" | "providerStartedAt" | "completedAt" | "lastError" | "createdAt" | "updatedAt">;
+export declare function prepareImageGenerationOperation(db: Database, input: PrepareImageGenerationOperationInput): Promise<{
+    operation: ImageGenerationOperation;
+    created: boolean;
+}>;
+export declare function getImageGenerationOperation(db: Database, workspaceId: string, operationId: string): Promise<ImageGenerationOperation | null>;
+export declare function beginImageGenerationOperation(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    operationId: string;
+    operationKey: string;
+}): Promise<{
+    operation: ImageGenerationOperation;
+    started: boolean;
+}>;
+export declare function markImageGenerationOperationOutcomeUnknown(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    operationId: string;
+    operationKey: string;
+    error: string;
+}): Promise<ImageGenerationOperation>;
+/** Provider completed, but its bytes could not be durably retained. Never replay the paid call. */
+export declare function markImageGenerationOperationRetentionFailed(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    operationId: string;
+    operationKey: string;
+    error: string;
+}): Promise<ImageGenerationOperation>;
+export declare function completeImageGenerationOperation(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    operationId: string;
+    operationKey: string;
+}): Promise<ImageGenerationOperation>;
+/**
+ * Reserve one deterministic file/upload/correlation triple. Concurrent retries
+ * converge on the same identities and must agree on every immutable byte fact.
+ */
+export declare function prepareGeneratedImageArtifact(db: Database, input: PrepareGeneratedImageArtifactInput): Promise<{
+    artifact: GeneratedImageArtifact;
+    created: boolean;
+}>;
+export declare function getGeneratedImageArtifact(db: Database, workspaceId: string, artifactId: string): Promise<GeneratedImageArtifact | null>;
+export declare function settleGeneratedImageArtifactReady(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    artifactId: string;
+    settlementKey: string;
+}): Promise<GeneratedImageArtifact>;
+export declare function recordGeneratedImageArtifactError(db: Database, input: {
+    accountId: string;
+    workspaceId: string;
+    artifactId: string;
+    settlementKey: string;
+    error: string;
+}): Promise<void>;
+export declare function listReadyGeneratedImageArtifactsForSession(db: Database, workspaceId: string, sessionId: string): Promise<GeneratedImageArtifact[]>;