@opengeni/sdk 0.44.6 → 0.46.0

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { type SessionEventStreamTransport, type StreamSessionEventsOptions } from "./stream";
 import { type WorkspaceControlStreamTransport } from "./workspace-control-stream";
-import type { AccessContext, ActivateCodexRealtimeConnectionRequest, AddWorkspaceMemberRequest, ApiKey, BillingEntitlementsResponse, CodexAccount, CodexAccountsResponse, CodexAppsUpdate, CodexRotationSettings, CodexOverviewResponse, CodexAllocatorUpdate, CodexConnectionStatus, CodexRealtimeWebrtcRequest, CodexRealtimeWebrtcResponse, GatewayRealtimeConnectRequest, GatewayRealtimeConnectResponse, CodexConnectPoll, CodexConnectStart, CodexUsage, CodexUsageMap, BillingSummary, BillingUsageResponse, InsightsRange, WorkspaceInsightsResponse, BeginSessionRealtimeRequest, CapabilityCatalogItem, CapabilityCatalogResponse, CapabilityInstallation, AddDocumentRequest, CreateKnowledgeDropRequest, MoveDocumentRequest, ClientConfig, WorkspaceModelCatalogResponse, WorkspaceRealtimeModelCatalogResponse, ClientSessionEventInput, CompactSessionContextResult, ConnectionMetadata, CreateApiKeyRequest, CreateApiKeyResponse, CreateCapabilityCatalogItemRequest, CreateCheckoutRequest, CreateCheckoutResponse, OpenGeniSlackBotInstallRequest, OpenGeniSlackBotInstallStart, SlackReactionChannelListResponse, CreateConnectionRequest, CreateDocumentBaseRequest, CreateFileUploadRequest, CreateFileUploadResponse, CreateGitHubAppManifestRequest, CreateGitHubAppManifestResponse, CreateKnowledgeMemoryRequest, CreateScheduledTaskRequest, CreateSessionRequest, CreateSessionResponse, CreateVariableSetRequest, CreateRigRequest, CreateWorkspaceRequest, DeviceEnrollmentApproveResponse, DeviceEnrollmentDenyResponse, DeviceEnrollmentLookupResponse, MintEnrollTokenResponse, EndSessionRealtimeRequest, DiscoverMcpCapabilitiesResponse, Document, DocumentBase, DocumentSearchRequest, DocumentSearchResponse, EnableCapabilityRequest, EnablePackRequest, FileAsset, FileDownloadUrlResponse, GetPackResponse, GitHubAppInfo, GitHubRepositoriesResponse, GoogleDriveDisconnectRequest, GoogleDriveLifecycleActionRequest, KnowledgeMemory, KnowledgeMemorySearchRequest, ListPacksResponse, MachinesResponse, MetricSample, SwapActiveSandboxRequest, SwapActiveSandboxResponse, PackInstallation, LatencyMode, ReasoningEffort, RetainedArtifactContent, RetainedArtifactContentOptions, RetainedArtifactMetadata, RegisterCapabilityPackRequest, ResourceRef, ScheduledTask, ScheduledTaskRun, Session, SessionListResponse, UpdateSessionPinRequest, SessionEvent, SessionEventCompactResult, SessionEventCompactResultOptions, SessionEventListOptions, SessionEventPage, SessionGoal, SessionHumanInputRequest, SessionLineageResponse, SessionRealtimeMutationResponse, SyncSessionRealtimeLedgerRequest, SyncSessionRealtimeLedgerResponse, RenewSessionRealtimeRequest, SessionMcpCredentialUpdateInput, UpdateSessionMcpApprovalPolicyRequest, UpdateSessionMcpApprovalPolicyResponse, SessionQueueSnapshot, SessionQueueMutationResponse, ComposerDraft, DeleteSessionQueueItemRequest, EditSessionQueueItemRequest, MoveSessionQueueItemRequest, NewSessionDraft, SaveComposerDraftRequest, SaveNewSessionDraftRequest, SteerSessionQueueItemRequest, SessionControlResponse, WorkspaceInferenceControlResponse, WorkspaceControlEvent, SessionTurn, SubmitHumanInputResponseRequest, SessionCapabilities, AttachViewerRequest, AttachViewerResponse, AcknowledgeStreamRequest, AcknowledgeStreamResponse, ViewerHeartbeatRequest, ViewerHeartbeatResponse, FsListRequest, FsListResponse, FsReadRequest, FsReadResponse, FsWriteRequest, FsWriteResponse, FsDeleteRequest, FsDeleteResponse, FsMoveRequest, FsMoveResponse, FsMkdirRequest, FsMkdirResponse, GitStatusRequest, GitStatusResponse, GitDiffRequest, GitDiffResponse, GitLogRequest, GitLogResponse, GitShowRequest, GitShowResponse, GetWorkspaceCaptureResponse, GetWorkspaceCaptureFileResponse, TerminalExecRequest, TerminalExecResponse, PtyOpenRequest, PtyOpenResponse, PtyWriteRequest, PtyResizeRequest, PtyCloseRequest, ToolRef, TranscribeAudioResponse, UpdateConnectionRequest, UpdateKnowledgeMemoryRequest, UpdateScheduledTaskRequest, UpdateSessionGoalRequest, UpdateSessionRequest, UpdateSessionToolPolicyRequest, UpdateVariableSetRequest, UpdateRigRequest, UpdateWorkspaceMemberRequest, UpdateWorkspaceRequest, UpdateWorkspaceSettingsRequest, SetWorkspaceDefaultRigRequest, UploadFileInput, VariableSet, VariableSetVariableMetadata, Rig, RigVersion, RigChange, ProposeRigChangeRequest, WorkspaceMember, WorkspaceMemorySearchRequest, WorkspaceMemorySearchResponse, WorkspaceRegisteredPack, Workspace, OAuthStartRequest, OAuthStartResponse, SocialConnection, SocialOAuthStartRequest } from "./types";
+import type { AccessContext, ActivateCodexRealtimeConnectionRequest, AddWorkspaceMemberRequest, ApiKey, BillingEntitlementsResponse, CodexAccount, CodexAccountsResponse, CodexAppsUpdate, CodexRotationSettings, CodexOverviewResponse, CodexAllocatorUpdate, CodexConnectionStatus, CodexRealtimeWebrtcRequest, CodexRealtimeWebrtcResponse, GatewayRealtimeConnectRequest, GatewayRealtimeConnectResponse, CodexConnectPoll, CodexConnectStart, CodexUsage, CodexUsageMap, BillingSummary, BillingUsageResponse, InsightsRange, WorkspaceInsightsResponse, BeginSessionRealtimeRequest, CapabilityCatalogItem, CapabilityCatalogResponse, CapabilityInstallation, AddDocumentRequest, CreateKnowledgeDropRequest, MoveDocumentRequest, ClientConfig, WorkspaceModelCatalogResponse, WorkspaceRealtimeModelCatalogResponse, ClientSessionEventInput, CompactSessionContextResult, ConnectionMetadata, CreateApiKeyRequest, CreateApiKeyResponse, CreateCapabilityCatalogItemRequest, CreateCheckoutRequest, CreateCheckoutResponse, OpenGeniSlackBotInstallRequest, OpenGeniSlackBotInstallStart, SlackReactionChannelListResponse, CreateConnectionRequest, CreateDocumentBaseRequest, CreateFileUploadRequest, CreateFileUploadResponse, CreateGitHubAppManifestRequest, CreateGitHubAppManifestResponse, CreateKnowledgeMemoryRequest, CreateScheduledTaskRequest, CreateSessionRequest, CreateSessionResponse, CreateVariableSetRequest, CreateRigRequest, CreateWorkspaceRequest, DeviceEnrollmentApproveResponse, DeviceEnrollmentDenyResponse, DeviceEnrollmentLookupResponse, MintEnrollTokenResponse, EndSessionRealtimeRequest, DiscoverMcpCapabilitiesResponse, Document, DocumentBase, DocumentSearchRequest, DocumentSearchResponse, EnableCapabilityRequest, EnablePackRequest, FileAsset, FileDownloadUrlResponse, GetPackResponse, GitHubAppInfo, GitHubRepositoriesResponse, GoogleDriveDisconnectRequest, GoogleDriveLifecycleActionRequest, KnowledgeMemory, KnowledgeMemorySearchRequest, ListPacksResponse, MachinesResponse, MetricSample, SwapActiveSandboxRequest, SwapActiveSandboxResponse, PackInstallation, LatencyMode, ReasoningEffort, RetainedArtifactContent, RetainedArtifactContentOptions, RetainedArtifactMetadata, RegisterCapabilityPackRequest, ResourceRef, ScheduledTask, ScheduledTaskRun, Session, SessionListResponse, UpdateSessionPinRequest, SessionEvent, SessionEventCompactResult, SessionEventCompactResultOptions, SessionEventListOptions, SessionEventPage, SessionGoal, SessionHumanInputRequest, SessionLineageResponse, SessionRealtimeMutationResponse, SyncSessionRealtimeLedgerRequest, SyncSessionRealtimeLedgerResponse, RenewSessionRealtimeRequest, SessionMcpCredentialUpdateInput, UpdateSessionMcpApprovalPolicyRequest, UpdateSessionMcpApprovalPolicyResponse, SessionQueueSnapshot, SessionQueueMutationResponse, ComposerDraft, DeleteSessionQueueItemRequest, EditSessionQueueItemRequest, MoveSessionQueueItemRequest, NewSessionDraft, SaveComposerDraftRequest, SaveNewSessionDraftRequest, SteerSessionQueueItemRequest, SessionControlResponse, WorkspaceInferenceControlResponse, WorkspaceControlEvent, SessionTurn, SubmitHumanInputResponseRequest, SessionCapabilities, AttachViewerRequest, AttachViewerResponse, AcknowledgeStreamRequest, AcknowledgeStreamResponse, ViewerHeartbeatRequest, ViewerHeartbeatResponse, FsListRequest, FsListResponse, FsReadRequest, FsReadResponse, FsWriteRequest, FsWriteResponse, FsDeleteRequest, FsDeleteResponse, FsMoveRequest, FsMoveResponse, FsMkdirRequest, FsMkdirResponse, GitStatusRequest, GitStatusResponse, GitDiffRequest, GitDiffResponse, GitLogRequest, GitLogResponse, GitShowRequest, GitShowResponse, GetWorkspaceCaptureResponse, GetWorkspaceCaptureFileResponse, TerminalExecRequest, TerminalExecResponse, PtyOpenRequest, PtyOpenResponse, PtyWriteRequest, PtyResizeRequest, PtyCloseRequest, ToolRef, TranscribeAudioResponse, TranscriptionRecordingListResponse, TranscriptionRecordingResponse, UploadTranscriptionRecordingChunkResponse, UpdateConnectionRequest, UpdateKnowledgeMemoryRequest, UpdateScheduledTaskRequest, UpdateSessionGoalRequest, UpdateSessionRequest, UpdateSessionToolPolicyRequest, UpdateVariableSetRequest, UpdateRigRequest, UpdateWorkspaceMemberRequest, UpdateWorkspaceRequest, UpdateWorkspaceSettingsRequest, SetWorkspaceDefaultRigRequest, UploadFileInput, VariableSet, VariableSetVariableMetadata, Rig, RigVersion, RigChange, ProposeRigChangeRequest, WorkspaceMember, WorkspaceMemorySearchRequest, WorkspaceMemorySearchResponse, WorkspaceRegisteredPack, Workspace, OAuthStartRequest, OAuthStartResponse, SocialConnection, SocialOAuthStartRequest } from "./types";
 import type { ActivateWorkspaceInstructionPolicyRequest, CreateWorkspaceInstructionPolicyDraftRequest, CreateWorkspaceInstructionPolicyOnboardingProposalRequest, ImportLegacyWorkspaceInstructionPolicyDraftRequest, RollbackWorkspaceInstructionPolicyRequest, WorkspaceInstructionPolicyActivationResponse, WorkspaceInstructionPolicyDiffRequest, WorkspaceInstructionPolicyDiffResponse, WorkspaceInstructionPolicyListOptions, WorkspaceInstructionPolicyListResponse, WorkspaceInstructionPolicyOnboardingProposal, WorkspaceInstructionPolicyOnboardingProposalListOptions, WorkspaceInstructionPolicyOnboardingProposalListResponse, WorkspaceInstructionPolicyRevision } from "./workspace-instruction-policies";
 import type { WorkspaceStateExportResponse, WorkspaceStateGetOptions, WorkspaceStateResponse } from "./workspace-state";
 import type { ActivatePreferenceRegistryRevisionRequest, ChangePreferenceRegistryScopeRequest, CorrectPreferenceRegistryRequest, CreatePreferenceRegistryProposalRequest, DeactivatePreferenceRegistryRequest, PreferenceRegistryDetailResponse, PreferenceRegistryFullContent, PreferenceRegistryListOptions, PreferenceRegistryListResponse, PreferenceRegistryMutationResponse, PreferenceRegistryRecord, PreferenceRegistrySnapshot, RejectPreferenceRegistryProposalRequest, SupersedePreferenceRegistryRequest } from "./preference-registry";
@@ -51,6 +51,25 @@ export type TranscribeAudioInput = {
     durationSeconds?: number | undefined;
     signal?: AbortSignal | undefined;
 };
+export type CreateTranscriptionRecordingInput = {
+    recordingId: string;
+    mimeType: string;
+    signal?: AbortSignal | undefined;
+};
+export type UploadTranscriptionRecordingChunkInput = {
+    audio: Blob | File | Uint8Array;
+    mimeType: string;
+    sha256: string;
+    startMilliseconds: number;
+    durationMilliseconds: number;
+    signal?: AbortSignal | undefined;
+};
+export type FinalizeTranscriptionRecordingInput = {
+    chunkCount: number;
+    totalBytes: number;
+    totalDurationMilliseconds: number;
+    signal?: AbortSignal | undefined;
+};
 /**
  * Typed client for the OpenGeni public API. Framework-agnostic: only needs
  * WHATWG `fetch` + streams, so it runs in Node 18+, Bun, Deno, browsers, and
@@ -63,6 +82,21 @@ export declare class OpenGeniClient {
     constructor(options: OpenGeniClientOptions);
     /** Make one finalization attempt for a recording; callers may retry retained audio. */
     transcribeAudio(workspaceId: string, input: TranscribeAudioInput): Promise<TranscribeAudioResponse>;
+    createTranscriptionRecording(workspaceId: string, input: CreateTranscriptionRecordingInput): Promise<TranscriptionRecordingResponse>;
+    getTranscriptionRecording(workspaceId: string, recordingId: string, options?: {
+        signal?: AbortSignal | undefined;
+    }): Promise<TranscriptionRecordingResponse>;
+    listTranscriptionRecordings(workspaceId: string, options?: {
+        signal?: AbortSignal | undefined;
+    }): Promise<TranscriptionRecordingListResponse>;
+    uploadTranscriptionRecordingChunk(workspaceId: string, recordingId: string, chunkNumber: number, input: UploadTranscriptionRecordingChunkInput): Promise<UploadTranscriptionRecordingChunkResponse>;
+    finalizeTranscriptionRecording(workspaceId: string, recordingId: string, input: FinalizeTranscriptionRecordingInput): Promise<TranscriptionRecordingResponse>;
+    processNextTranscriptionRecordingSegment(workspaceId: string, recordingId: string, options?: {
+        signal?: AbortSignal | undefined;
+    }): Promise<TranscriptionRecordingResponse>;
+    discardTranscriptionRecording(workspaceId: string, recordingId: string, options?: {
+        signal?: AbortSignal | undefined;
+    }): Promise<TranscriptionRecordingResponse>;
     createSession(workspaceId: string, request: CreateSessionRequest): Promise<CreateSessionResponse>;
     getNewSessionDraft(workspaceId: string): Promise<NewSessionDraft>;
     saveNewSessionDraft(workspaceId: string, request: SaveNewSessionDraftRequest): Promise<NewSessionDraft>;

package/dist/core.js

@@ -3,7 +3,7 @@ import {
   OPENGENI_API_CONTRACT_REVISION,
   OpenGeniClient,
   resolveWorkspaceVoiceInputEnabled
-} from "./chunk-ONKUBP7A.js";
+} from "./chunk-QKV5OCLJ.js";
 import {
   OpenGeniApiContractMismatchError,
   OpenGeniApiError,

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   resolveWorkspaceVoiceInputEnabled,
   streamSessionEvents,
   streamWorkspaceControlEvents
-} from "./chunk-ONKUBP7A.js";
+} from "./chunk-QKV5OCLJ.js";
 import {
   CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,
   CodexRealtimeMicrophoneError,

package/dist/types.d.ts

@@ -1972,6 +1972,65 @@ export type ClientVoiceInputConfig = {
     maxDurationSeconds: number;
     maxSizeBytes: number;
     acceptedMimeTypes: string[];
+    resumable?: ClientResumableVoiceInputConfig | undefined;
+};
+export type ClientResumableVoiceInputConfig = {
+    maxDurationSeconds: number;
+    maxSizeBytes: number;
+    maxChunkSizeBytes: number;
+    providerSegmentSeconds: number;
+};
+export type TranscriptionRecordingErrorCode = "permission_denied" | "not_supported" | "network" | "provider" | "policy_blocked" | "timeout" | "cancelled" | "unavailable" | "too_large" | "invalid_audio" | "unknown";
+export type TranscriptionRecordingState = "uploading" | "segmenting" | "ready" | "transcribing" | "complete" | "failed" | "discarded";
+export type TranscriptionRecordingSegmentState = "preparing" | "pending" | "transcribing" | "complete" | "failed";
+export type TranscriptionRecordingSegment = {
+    segmentNumber: number;
+    state: TranscriptionRecordingSegmentState;
+    startMilliseconds: number;
+    durationMilliseconds: number;
+    byteLength: number;
+    errorCode: TranscriptionRecordingErrorCode | null;
+    retryable: boolean;
+};
+export type TranscriptionRecording = {
+    id: string;
+    workspaceId: string;
+    mimeType: string;
+    state: TranscriptionRecordingState;
+    nextChunkNumber: number;
+    chunkCount: number;
+    totalBytes: number;
+    totalDurationMilliseconds: number;
+    segmentCount: number;
+    completedSegmentCount: number;
+    transcriptText: string | null;
+    languages: string[];
+    errorCode: TranscriptionRecordingErrorCode | null;
+    retryable: boolean;
+    objectsCleaned: boolean;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt: string;
+};
+export type TranscriptionRecordingResponse = {
+    recording: TranscriptionRecording;
+    segments: TranscriptionRecordingSegment[];
+    retryAfterMilliseconds?: number;
+};
+export type TranscriptionRecordingListResponse = {
+    recordings: TranscriptionRecording[];
+};
+export type TranscriptionRecordingChunk = {
+    chunkNumber: number;
+    byteLength: number;
+    sha256: string;
+    startMilliseconds: number;
+    durationMilliseconds: number;
+    deduplicated: boolean;
+};
+export type UploadTranscriptionRecordingChunkResponse = {
+    recording: TranscriptionRecording;
+    chunk: TranscriptionRecordingChunk;
 };
 /** Response from POST /v1/workspaces/:workspaceId/transcriptions. */
 export type TranscribeAudioResponse = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "0.44.6",
+  "version": "0.46.0",
   "description": "Framework-agnostic TypeScript SDK for the OpenGeni API: typed client, session lifecycle, SSE event streaming with reconnect + replay-by-sequence, and proxy re-streaming helpers.",
   "license": "Apache-2.0",
   "repository": {

package/src/client.ts

@@ -189,6 +189,9 @@ import type {
   PtyCloseRequest,
   ToolRef,
   TranscribeAudioResponse,
+  TranscriptionRecordingListResponse,
+  TranscriptionRecordingResponse,
+  UploadTranscriptionRecordingChunkResponse,
   UpdateConnectionRequest,
   UpdateKnowledgeMemoryRequest,
   UpdateScheduledTaskRequest,
@@ -329,6 +332,28 @@ export type TranscribeAudioInput = {
   signal?: AbortSignal | undefined;
 };
 
+export type CreateTranscriptionRecordingInput = {
+  recordingId: string;
+  mimeType: string;
+  signal?: AbortSignal | undefined;
+};
+
+export type UploadTranscriptionRecordingChunkInput = {
+  audio: Blob | File | Uint8Array;
+  mimeType: string;
+  sha256: string;
+  startMilliseconds: number;
+  durationMilliseconds: number;
+  signal?: AbortSignal | undefined;
+};
+
+export type FinalizeTranscriptionRecordingInput = {
+  chunkCount: number;
+  totalBytes: number;
+  totalDurationMilliseconds: number;
+  signal?: AbortSignal | undefined;
+};
+
 /**
  * Typed client for the OpenGeni public API. Framework-agnostic: only needs
  * WHATWG `fetch` + streams, so it runs in Node 18+, Bun, Deno, browsers, and
@@ -402,6 +427,153 @@ export class OpenGeniClient {
     return body;
   }
 
+  async createTranscriptionRecording(
+    workspaceId: string,
+    input: CreateTranscriptionRecordingInput,
+  ): Promise<TranscriptionRecordingResponse> {
+    return transcriptionRecordingResponse(
+      await this.requestJson<unknown>(
+        "POST",
+        `/v1/workspaces/${workspaceId}/transcription-recordings`,
+        { recordingId: input.recordingId, mimeType: input.mimeType },
+        {},
+        input.signal ? { signal: input.signal } : {},
+      ),
+    );
+  }
+
+  async getTranscriptionRecording(
+    workspaceId: string,
+    recordingId: string,
+    options: { signal?: AbortSignal | undefined } = {},
+  ): Promise<TranscriptionRecordingResponse> {
+    return transcriptionRecordingResponse(
+      await this.requestJson<unknown>(
+        "GET",
+        `/v1/workspaces/${workspaceId}/transcription-recordings/${recordingId}`,
+        undefined,
+        {},
+        options.signal ? { signal: options.signal } : {},
+      ),
+    );
+  }
+
+  async listTranscriptionRecordings(
+    workspaceId: string,
+    options: { signal?: AbortSignal | undefined } = {},
+  ): Promise<TranscriptionRecordingListResponse> {
+    const body = await this.requestJson<unknown>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/transcription-recordings`,
+      undefined,
+      {},
+      options.signal ? { signal: options.signal } : {},
+    );
+    if (!isTranscriptionRecordingListResponse(body)) {
+      throw new OpenGeniApiError(502, "Invalid transcription recording list response.", {
+        code: "invalid_response",
+      });
+    }
+    return body;
+  }
+
+  async uploadTranscriptionRecordingChunk(
+    workspaceId: string,
+    recordingId: string,
+    chunkNumber: number,
+    input: UploadTranscriptionRecordingChunkInput,
+  ): Promise<UploadTranscriptionRecordingChunkResponse> {
+    const correlationId = crypto.randomUUID();
+    let response: Response;
+    try {
+      response = await this.fetchImpl(
+        this.url(
+          `/v1/workspaces/${workspaceId}/transcription-recordings/${recordingId}/chunks/${chunkNumber}`,
+        ),
+        {
+          method: "PUT",
+          headers: {
+            ...this.headers(correlationId),
+            Accept: "application/json",
+            "Content-Type": input.mimeType,
+            "x-opengeni-chunk-sha256": input.sha256,
+            "x-opengeni-chunk-start-milliseconds": String(input.startMilliseconds),
+            "x-opengeni-chunk-duration-milliseconds": String(input.durationMilliseconds),
+          },
+          body: input.audio instanceof Uint8Array ? Uint8Array.from(input.audio) : input.audio,
+          ...(input.signal ? { signal: input.signal } : {}),
+        },
+      );
+    } catch (error) {
+      if (input.signal?.aborted) throw error;
+      throw mutationTransportError(correlationId);
+    }
+    assertApiContractResponse(response);
+    if (!response.ok) throw await apiErrorFromResponse(response, { method: "PUT", correlationId });
+    await assertJsonResponse(response, { method: "PUT", correlationId });
+    const body = await response.json().catch(() => null);
+    if (!isUploadTranscriptionRecordingChunkResponse(body)) {
+      throw new OpenGeniApiError(response.status, "Invalid transcription chunk response.", {
+        code: "invalid_response",
+        mutation: true,
+        correlationId,
+      });
+    }
+    return body;
+  }
+
+  async finalizeTranscriptionRecording(
+    workspaceId: string,
+    recordingId: string,
+    input: FinalizeTranscriptionRecordingInput,
+  ): Promise<TranscriptionRecordingResponse> {
+    return transcriptionRecordingResponse(
+      await this.requestJson<unknown>(
+        "POST",
+        `/v1/workspaces/${workspaceId}/transcription-recordings/${recordingId}/finalize`,
+        {
+          chunkCount: input.chunkCount,
+          totalBytes: input.totalBytes,
+          totalDurationMilliseconds: input.totalDurationMilliseconds,
+        },
+        {},
+        input.signal ? { signal: input.signal } : {},
+      ),
+    );
+  }
+
+  async processNextTranscriptionRecordingSegment(
+    workspaceId: string,
+    recordingId: string,
+    options: { signal?: AbortSignal | undefined } = {},
+  ): Promise<TranscriptionRecordingResponse> {
+    return transcriptionRecordingResponse(
+      await this.requestJson<unknown>(
+        "POST",
+        `/v1/workspaces/${workspaceId}/transcription-recordings/${recordingId}/process-next`,
+        {},
+        {},
+        options.signal ? { signal: options.signal } : {},
+      ),
+    );
+  }
+
+  async discardTranscriptionRecording(
+    workspaceId: string,
+    recordingId: string,
+    options: { signal?: AbortSignal | undefined } = {},
+  ): Promise<TranscriptionRecordingResponse> {
+    return transcriptionRecordingResponse(
+      await this.requestJson<unknown>(
+        "DELETE",
+        `/v1/workspaces/${workspaceId}/transcription-recordings/${recordingId}`,
+        undefined,
+        {},
+        options.signal ? { signal: options.signal } : {},
+      ),
+    );
+  }
+
   async createSession(
     workspaceId: string,
     request: CreateSessionRequest,
@@ -3595,6 +3767,86 @@ function isTranscribeAudioResponse(value: unknown): value is TranscribeAudioResp
   );
 }
 
+function isUploadTranscriptionRecordingChunkResponse(
+  value: unknown,
+): value is UploadTranscriptionRecordingChunkResponse {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const record = value as Record<string, unknown>;
+  if (!isTranscriptionRecordingResponse({ recording: record.recording, segments: [] })) {
+    return false;
+  }
+  if (!record.chunk || typeof record.chunk !== "object" || Array.isArray(record.chunk)) {
+    return false;
+  }
+  const chunk = record.chunk as Record<string, unknown>;
+  return (
+    typeof chunk.chunkNumber === "number" &&
+    typeof chunk.byteLength === "number" &&
+    typeof chunk.sha256 === "string" &&
+    typeof chunk.startMilliseconds === "number" &&
+    typeof chunk.durationMilliseconds === "number" &&
+    typeof chunk.deduplicated === "boolean"
+  );
+}
+
+function isTranscriptionRecordingResponse(value: unknown): value is TranscriptionRecordingResponse {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const response = value as Record<string, unknown>;
+  if (
+    !response.recording ||
+    typeof response.recording !== "object" ||
+    Array.isArray(response.recording)
+  ) {
+    return false;
+  }
+  const recording = response.recording as Record<string, unknown>;
+  return (
+    typeof recording.id === "string" &&
+    typeof recording.workspaceId === "string" &&
+    typeof recording.mimeType === "string" &&
+    typeof recording.state === "string" &&
+    typeof recording.nextChunkNumber === "number" &&
+    typeof recording.chunkCount === "number" &&
+    typeof recording.totalBytes === "number" &&
+    typeof recording.totalDurationMilliseconds === "number" &&
+    typeof recording.segmentCount === "number" &&
+    typeof recording.completedSegmentCount === "number" &&
+    (recording.transcriptText === null || typeof recording.transcriptText === "string") &&
+    Array.isArray(recording.languages) &&
+    (recording.errorCode === null || typeof recording.errorCode === "string") &&
+    typeof recording.retryable === "boolean" &&
+    typeof recording.objectsCleaned === "boolean" &&
+    typeof recording.createdAt === "string" &&
+    typeof recording.updatedAt === "string" &&
+    typeof recording.expiresAt === "string" &&
+    (response.retryAfterMilliseconds === undefined ||
+      (typeof response.retryAfterMilliseconds === "number" &&
+        Number.isInteger(response.retryAfterMilliseconds) &&
+        response.retryAfterMilliseconds > 0 &&
+        response.retryAfterMilliseconds <= 60_000)) &&
+    Array.isArray(response.segments)
+  );
+}
+
+function transcriptionRecordingResponse(value: unknown): TranscriptionRecordingResponse {
+  if (isTranscriptionRecordingResponse(value)) return value;
+  throw new OpenGeniApiError(502, "Invalid transcription recording response.", {
+    code: "invalid_response",
+  });
+}
+
+function isTranscriptionRecordingListResponse(
+  value: unknown,
+): value is TranscriptionRecordingListResponse {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const recordings = (value as Record<string, unknown>).recordings;
+  return (
+    Array.isArray(recordings) &&
+    recordings.length <= 50 &&
+    recordings.every((recording) => isTranscriptionRecordingResponse({ recording, segments: [] }))
+  );
+}
+
 function filenameForAudioMimeType(mimeType: string): string {
   const bare = mimeType.trim().toLowerCase().split(";")[0] ?? "audio/webm";
   switch (bare) {

package/src/types.ts

@@ -2568,6 +2568,98 @@ export type ClientVoiceInputConfig = {
   maxDurationSeconds: number;
   maxSizeBytes: number;
   acceptedMimeTypes: string[];
+  resumable?: ClientResumableVoiceInputConfig | undefined;
+};
+
+export type ClientResumableVoiceInputConfig = {
+  maxDurationSeconds: number;
+  maxSizeBytes: number;
+  maxChunkSizeBytes: number;
+  providerSegmentSeconds: number;
+};
+
+export type TranscriptionRecordingErrorCode =
+  | "permission_denied"
+  | "not_supported"
+  | "network"
+  | "provider"
+  | "policy_blocked"
+  | "timeout"
+  | "cancelled"
+  | "unavailable"
+  | "too_large"
+  | "invalid_audio"
+  | "unknown";
+
+export type TranscriptionRecordingState =
+  | "uploading"
+  | "segmenting"
+  | "ready"
+  | "transcribing"
+  | "complete"
+  | "failed"
+  | "discarded";
+
+export type TranscriptionRecordingSegmentState =
+  | "preparing"
+  | "pending"
+  | "transcribing"
+  | "complete"
+  | "failed";
+
+export type TranscriptionRecordingSegment = {
+  segmentNumber: number;
+  state: TranscriptionRecordingSegmentState;
+  startMilliseconds: number;
+  durationMilliseconds: number;
+  byteLength: number;
+  errorCode: TranscriptionRecordingErrorCode | null;
+  retryable: boolean;
+};
+
+export type TranscriptionRecording = {
+  id: string;
+  workspaceId: string;
+  mimeType: string;
+  state: TranscriptionRecordingState;
+  nextChunkNumber: number;
+  chunkCount: number;
+  totalBytes: number;
+  totalDurationMilliseconds: number;
+  segmentCount: number;
+  completedSegmentCount: number;
+  transcriptText: string | null;
+  languages: string[];
+  errorCode: TranscriptionRecordingErrorCode | null;
+  retryable: boolean;
+  objectsCleaned: boolean;
+  createdAt: string;
+  updatedAt: string;
+  expiresAt: string;
+};
+
+export type TranscriptionRecordingResponse = {
+  recording: TranscriptionRecording;
+  segments: TranscriptionRecordingSegment[];
+  retryAfterMilliseconds?: number;
+};
+
+export type TranscriptionRecordingListResponse = {
+  recordings: TranscriptionRecording[];
+};
+
+export type TranscriptionRecordingChunk = {
+  chunkNumber: number;
+  byteLength: number;
+  sha256: string;
+  startMilliseconds: number;
+  durationMilliseconds: number;
+  deduplicated: boolean;
+};
+
+export type UploadTranscriptionRecordingChunkResponse = {
+  recording: TranscriptionRecording;
+  chunk: TranscriptionRecordingChunk;
 };
 
 /** Response from POST /v1/workspaces/:workspaceId/transcriptions. */