@lumavox/server 0.4.1 → 0.6.0

package/README.md

@@ -128,13 +128,15 @@ and a longer one is thrown at once as a `RateLimitError` with its
 
 - **A key is prepaid**: its `credit_limit_micros` is set aside from your balance
   when it is minted, and what it does not spend comes back when it settles.
-  `create` clamps the lifetime to the platform's maximum (`clampTtl: false`
-  sends your body as written); your plan's own caps for one person's key
-  are not reported yet, so a key within the platform's can still be refused.
+  `create` clamps the lifetime to the tighter of the platform's maximum and
+  your plan's for one person's key (`clampTtl: false` sends your body as
+  written).
 - **`revoke` answers at once**, with the figures from before the key's last
-  spend is settled; **`inspect` shows the spend as of the last
-  settlement**, so a key in use reads as unspent for now.
+  spend is settled; `revoke(id, { settled: true })` waits for the final
+  ones (`settled_at`), reading the key with `get` — pass a `signal` for a
+  deadline. **`inspect` shows a key's spend turn by turn**, as the key
+  itself reads it.
 - **`endUsers.export(id)`** reads every conversation and fact about a
   person with a five-minute key of their own, revoked after — on failure
   too. The key is an ordinary one: at the person's live-key cap the export
-  fails as the mint does. Facts are the newest 100 for now.
+  fails as the mint does.

package/dist/gen/index.d.ts

@@ -1 +1 @@
-export type { AgentCreateRequest, AgentInfo, AgentKnowledgeUpdate, AgentPage, AgentSettingsInfo, AgentSettingsUpdate, AgentStt, AgentSttInfo, AgentSummary, AgentUpdate, AgentVoice, AgentVoiceInfo, ApiKeySelf, AssetBulkRequest, AssetDetail, AssetMoveRequest, AssetPage, AssetsAffected, AssetSummary, AssetUpdate, AssignedAgent, AudioRequest, BulkEditKnowledgeData, BulkEditKnowledgeError, BulkEditKnowledgeErrors, BulkEditKnowledgeResponse, BulkEditKnowledgeResponses, ClientOptions, CompactionInfo, CompactRequest, CompactSessionData, CompactSessionError, CompactSessionErrors, CompactSessionResponse, CompactSessionResponses, ConfirmAssetUploadData, ConfirmAssetUploadError, ConfirmAssetUploadErrors, ConfirmAssetUploadResponse, ConfirmAssetUploadResponses, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentResponse, CreateAgentResponses, CreateAssetFolderData, CreateAssetFolderError, CreateAssetFolderErrors, CreateAssetFolderResponse, CreateAssetFolderResponses, CreateAssetUploadUrlData, CreateAssetUploadUrlError, CreateAssetUploadUrlErrors, CreateAssetUploadUrlResponse, CreateAssetUploadUrlResponses, CreateAudioData, CreateAudioError, CreateAudioErrors, CreateAudioResponse, CreateAudioResponses, CreateEndUserData, CreateEndUserError, CreateEndUserErrors, CreateEndUserResponse, CreateEndUserResponses, CreateEphemeralKeyData, CreateEphemeralKeyError, CreateEphemeralKeyErrors, CreateEphemeralKeyResponse, CreateEphemeralKeyResponses, CreateImageData, CreateImageError, CreateImageErrors, CreateImageResponse, CreateImageResponses, CreateKnowledgeData, CreateKnowledgeError, CreateKnowledgeErrors, CreateKnowledgeFromFileData, CreateKnowledgeFromFileError, CreateKnowledgeFromFileErrors, CreateKnowledgeFromFileResponse, CreateKnowledgeFromFileResponses, CreateKnowledgeFromUrlData, CreateKnowledgeFromUrlError, CreateKnowledgeFromUrlErrors, CreateKnowledgeFromUrlResponse, CreateKnowledgeFromUrlResponses, CreateKnowledgeResponse, CreateKnowledgeResponses, CreateKnowledgeUploadUrlData, CreateKnowledgeUploadUrlError, CreateKnowledgeUploadUrlErrors, CreateKnowledgeUploadUrlResponse, CreateKnowledgeUploadUrlResponses, CreateSessionData, CreateSessionError, CreateSessionErrors, CreateSessionResponse, CreateSessionResponses, CreateSkyboxData, CreateSkyboxError, CreateSkyboxErrors, CreateSkyboxResponse, CreateSkyboxResponses, CreateTranscriptionData, CreateTranscriptionError, CreateTranscriptionErrors, CreateTranscriptionResponse, CreateTranscriptionResponses, CreateVideoData, CreateVideoError, CreateVideoErrors, CreateVideoResponse, CreateVideoResponses, CreateVoiceData, CreateVoiceError, CreateVoiceErrors, CreateVoiceResponse, CreateVoiceResponses, CreateVoiceUploadUrlData, CreateVoiceUploadUrlError, CreateVoiceUploadUrlErrors, CreateVoiceUploadUrlResponse, CreateVoiceUploadUrlResponses, DeleteAgentData, DeleteAgentError, DeleteAgentErrors, DeleteAgentResponse, DeleteAgentResponses, DeleteAllFactsData, DeleteAllFactsError, DeleteAllFactsErrors, DeleteAllFactsResponse, DeleteAllFactsResponses, DeleteAssetData, DeleteAssetError, DeleteAssetErrors, DeleteAssetFolderData, DeleteAssetFolderError, DeleteAssetFolderErrors, DeleteAssetFolderResponse, DeleteAssetFolderResponses, DeleteAssetResponse, DeleteAssetResponses, DeleteAssetsData, DeleteAssetsError, DeleteAssetsErrors, DeleteAssetsResponse, DeleteAssetsResponses, DeleteEndUserData, DeleteEndUserError, DeleteEndUserErrors, DeleteEndUserResponse, DeleteEndUserResponses, DeleteFactData, DeleteFactError, DeleteFactErrors, DeleteFactResponse, DeleteFactResponses, DeleteKnowledgeData, DeleteKnowledgeError, DeleteKnowledgeErrors, DeleteKnowledgeResponse, DeleteKnowledgeResponses, DeleteSessionData, DeleteSessionError, DeleteSessionErrors, DeleteSessionResponse, DeleteSessionResponses, DeleteVoiceData, DeleteVoiceError, DeleteVoiceErrors, DeleteVoiceResponse, DeleteVoiceResponses, DesignVoiceData, DesignVoiceError, DesignVoiceErrors, DesignVoiceResponse, DesignVoiceResponses, EndUserCreateRequest, EndUserDeleted, EndUserInfo, EndUserPage, EndUserUpdateRequest, EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EphemeralKeyInfo, EphemeralKeyLimits, EphemeralKeyPage, EphemeralTokenSelf, ErrorCode, ErrorInfo, ErrorResponse, ExtractSessionFactsData, ExtractSessionFactsError, ExtractSessionFactsErrors, ExtractSessionFactsResponse, ExtractSessionFactsResponses, FactInfo, FactPage, FactsDeleted, FolderCreate, FolderDeleted, FolderDetail, FolderPage, FolderSummary, FolderUpdate, GenerateFromTemplateData, GenerateFromTemplateError, GenerateFromTemplateErrors, GenerateFromTemplateResponse, GenerateFromTemplateResponses, GenerationAudio, GenerationImage, GenerationInfo, GenerationPage, GenerationSkybox, GenerationTranscript, GenerationVideo, GetAgentData, GetAgentError, GetAgentErrors, GetAgentResponse, GetAgentResponses, GetAgentSettingsData, GetAgentSettingsError, GetAgentSettingsErrors, GetAgentSettingsResponse, GetAgentSettingsResponses, GetAssetData, GetAssetError, GetAssetErrors, GetAssetFolderData, GetAssetFolderError, GetAssetFolderErrors, GetAssetFolderResponse, GetAssetFolderResponses, GetAssetResponse, GetAssetResponses, GetAudioData, GetAudioError, GetAudioErrors, GetAudioResponse, GetAudioResponses, GetEndUserData, GetEndUserError, GetEndUserErrors, GetEndUserResponse, GetEndUserResponses, GetEphemeralKeyLimitsData, GetEphemeralKeyLimitsError, GetEphemeralKeyLimitsErrors, GetEphemeralKeyLimitsResponse, GetEphemeralKeyLimitsResponses, GetGenerationData, GetGenerationError, GetGenerationErrors, GetGenerationResponse, GetGenerationResponses, GetHealthData, GetHealthResponse, GetHealthResponses, GetImageData, GetImageError, GetImageErrors, GetImageResponse, GetImageResponses, GetKnowledgeData, GetKnowledgeError, GetKnowledgeErrors, GetKnowledgeInsightsData, GetKnowledgeInsightsError, GetKnowledgeInsightsErrors, GetKnowledgeInsightsResponse, GetKnowledgeInsightsResponses, GetKnowledgeResponse, GetKnowledgeResponses, GetPlanData, GetPlanError, GetPlanErrors, GetPlanResponse, GetPlanResponses, GetSessionData, GetSessionError, GetSessionErrors, GetSessionResponse, GetSessionResponses, GetSkyboxData, GetSkyboxError, GetSkyboxErrors, GetSkyboxResponse, GetSkyboxResponses, GetTemplateData, GetTemplateError, GetTemplateErrors, GetTemplateFileData, GetTemplateFileError, GetTemplateFileErrors, GetTemplateFileResponses, GetTemplateResponse, GetTemplateResponses, GetTokenData, GetTokenError, GetTokenErrors, GetTokenResponse, GetTokenResponses, GetTranscriptionData, GetTranscriptionError, GetTranscriptionErrors, GetTranscriptionResponse, GetTranscriptionResponses, GetUsageData, GetUsageError, GetUsageErrors, GetUsageResponse, GetUsageResponses, GetVideoData, GetVideoError, GetVideoErrors, GetVideoResponse, GetVideoResponses, GetVoiceData, GetVoiceError, GetVoiceErrors, GetVoiceResponse, GetVoiceResponses, HealthResponse, ImageRequest, KnowledgeAgentsUpdate, KnowledgeAssigned, KnowledgeBulk, KnowledgeBulkResult, KnowledgeCategoryPage, KnowledgeCitation, KnowledgeCreate, KnowledgeEntryUsage, KnowledgeFileCreate, KnowledgeInfo, KnowledgeInsights, KnowledgeLookupInfo, KnowledgePage, KnowledgeSearchHit, KnowledgeSearchRequest, KnowledgeSearchResult, KnowledgeUpdate, KnowledgeUploadRequest, KnowledgeUploadTicket, KnowledgeUrlCreate, ListAgentKnowledgeData, ListAgentKnowledgeError, ListAgentKnowledgeErrors, ListAgentKnowledgeResponse, ListAgentKnowledgeResponses, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListAssetFoldersData, ListAssetFoldersError, ListAssetFoldersErrors, ListAssetFoldersResponse, ListAssetFoldersResponses, ListAssetsData, ListAssetsError, ListAssetsErrors, ListAssetsResponse, ListAssetsResponses, ListEndUsersData, ListEndUsersError, ListEndUsersErrors, ListEndUsersResponse, ListEndUsersResponses, ListEphemeralKeysData, ListEphemeralKeysError, ListEphemeralKeysErrors, ListEphemeralKeysResponse, ListEphemeralKeysResponses, ListFactsData, ListFactsError, ListFactsErrors, ListFactsResponse, ListFactsResponses, ListGenerationsData, ListGenerationsError, ListGenerationsErrors, ListGenerationsResponse, ListGenerationsResponses, ListKnowledgeCategoriesData, ListKnowledgeCategoriesError, ListKnowledgeCategoriesErrors, ListKnowledgeCategoriesResponse, ListKnowledgeCategoriesResponses, ListKnowledgeData, ListKnowledgeError, ListKnowledgeErrors, ListKnowledgeResponse, ListKnowledgeResponses, ListRelationsData, ListRelationsError, ListRelationsErrors, ListRelationsResponse, ListRelationsResponses, ListSessionsData, ListSessionsError, ListSessionsErrors, ListSessionsResponse, ListSessionsResponses, ListSkyboxStylesData, ListSkyboxStylesError, ListSkyboxStylesErrors, ListSkyboxStylesResponse, ListSkyboxStylesResponses, ListTemplatesData, ListTemplatesError, ListTemplatesErrors, ListTemplatesResponse, ListTemplatesResponses, ListVoicesData, ListVoicesError, ListVoicesErrors, ListVoicesResponse, ListVoicesResponses, MessageInfo, MessageKnowledge, MessagePage, MoveAssetsData, MoveAssetsError, MoveAssetsErrors, MoveAssetsResponse, MoveAssetsResponses, OrgPlan, ProviderVoiceSettings, ProviderVoiceSettingsInfo, Reference, RefreshKnowledgeData, RefreshKnowledgeError, RefreshKnowledgeErrors, RefreshKnowledgeResponse, RefreshKnowledgeResponses, ReindexKnowledgeData, ReindexKnowledgeError, ReindexKnowledgeErrors, ReindexKnowledgeResponse, ReindexKnowledgeResponses, RelationInfo, RelationPage, ResampleVoiceData, ResampleVoiceError, ResampleVoiceErrors, ResampleVoiceResponse, ResampleVoiceResponses, RevokeEphemeralKeyData, RevokeEphemeralKeyError, RevokeEphemeralKeyErrors, RevokeEphemeralKeyResponse, RevokeEphemeralKeyResponses, SaveDesignedVoiceData, SaveDesignedVoiceError, SaveDesignedVoiceErrors, SaveDesignedVoiceResponse, SaveDesignedVoiceResponses, SearchKnowledgeData, SearchKnowledgeError, SearchKnowledgeErrors, SearchKnowledgeResponse, SearchKnowledgeResponses, SessionCreateRequest, SessionDetail, SessionInfo, SessionPage, SetAgentKnowledgeData, SetAgentKnowledgeError, SetAgentKnowledgeErrors, SetAgentKnowledgeResponse, SetAgentKnowledgeResponses, SetKnowledgeAgentsData, SetKnowledgeAgentsError, SetKnowledgeAgentsErrors, SetKnowledgeAgentsResponse, SetKnowledgeAgentsResponses, SkyboxFile, SkyboxRequest, SkyboxStyle, SkyboxStylePage, SpeechProvider, StreamDone, StreamError, StreamSegment, StreamTranscript, SynthesizeSpeechData, SynthesizeSpeechError, SynthesizeSpeechErrors, SynthesizeSpeechResponse, SynthesizeSpeechResponses, TemplateGenerateRequest, TemplateInfo, TemplateInput, TemplatePage, TokenSelf, TranscribeAssetRequest, TranscribeData, TranscribeError, TranscribeErrors, TranscribeResponse, TranscribeResponses, Transcription, TranscriptionStreamLine, TranscriptWord, TtsOptions, TtsRequest, UnansweredQuestion, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentResponse, UpdateAgentResponses, UpdateAgentSettingsData, UpdateAgentSettingsError, UpdateAgentSettingsErrors, UpdateAgentSettingsResponse, UpdateAgentSettingsResponses, UpdateAssetData, UpdateAssetError, UpdateAssetErrors, UpdateAssetFolderData, UpdateAssetFolderError, UpdateAssetFolderErrors, UpdateAssetFolderResponse, UpdateAssetFolderResponses, UpdateAssetResponse, UpdateAssetResponses, UpdateEndUserData, UpdateEndUserError, UpdateEndUserErrors, UpdateEndUserResponse, UpdateEndUserResponses, UpdateKnowledgeData, UpdateKnowledgeError, UpdateKnowledgeErrors, UpdateKnowledgeResponse, UpdateKnowledgeResponses, UpdateVoiceData, UpdateVoiceError, UpdateVoiceErrors, UpdateVoiceResponse, UpdateVoiceResponses, UploadConfirm, UploadTicket, UploadTicketRequest, UsageByKey, UsageDay, UsageResponse, UsageSummary, ValidationIssue, VariantInfo, VideoRequest, VoiceDesignPreview, VoiceDesignRequest, VoiceDesignResult, VoiceDesignSaveRequest, VoiceDetail, VoiceInfo, VoiceInfoPage, VoiceKind, VoiceSample, VoiceSource, VoiceStatus, VoiceUpdate, VoiceUpload, VoiceUploadRequest, VoiceUploadTicket } from './types.gen.js';
+export type { AgentCreateRequest, AgentInfo, AgentKnowledgeUpdate, AgentPage, AgentSettingsInfo, AgentSettingsUpdate, AgentStt, AgentSttInfo, AgentSummary, AgentUpdate, AgentVoice, AgentVoiceInfo, ApiKeySelf, AssetBulkRequest, AssetDetail, AssetMoveRequest, AssetPage, AssetsAffected, AssetSummary, AssetUpdate, AssignedAgent, AudioRequest, BulkEditKnowledgeData, BulkEditKnowledgeError, BulkEditKnowledgeErrors, BulkEditKnowledgeResponse, BulkEditKnowledgeResponses, ClientOptions, CompactionInfo, CompactRequest, CompactSessionData, CompactSessionError, CompactSessionErrors, CompactSessionResponse, CompactSessionResponses, ConfirmAssetUploadData, ConfirmAssetUploadError, ConfirmAssetUploadErrors, ConfirmAssetUploadResponse, ConfirmAssetUploadResponses, CreateAgentData, CreateAgentError, CreateAgentErrors, CreateAgentResponse, CreateAgentResponses, CreateAssetFolderData, CreateAssetFolderError, CreateAssetFolderErrors, CreateAssetFolderResponse, CreateAssetFolderResponses, CreateAssetUploadUrlData, CreateAssetUploadUrlError, CreateAssetUploadUrlErrors, CreateAssetUploadUrlResponse, CreateAssetUploadUrlResponses, CreateAudioData, CreateAudioError, CreateAudioErrors, CreateAudioResponse, CreateAudioResponses, CreateEndUserData, CreateEndUserError, CreateEndUserErrors, CreateEndUserResponse, CreateEndUserResponses, CreateEphemeralKeyData, CreateEphemeralKeyError, CreateEphemeralKeyErrors, CreateEphemeralKeyResponse, CreateEphemeralKeyResponses, CreateImageData, CreateImageError, CreateImageErrors, CreateImageResponse, CreateImageResponses, CreateKnowledgeData, CreateKnowledgeError, CreateKnowledgeErrors, CreateKnowledgeFromFileData, CreateKnowledgeFromFileError, CreateKnowledgeFromFileErrors, CreateKnowledgeFromFileResponse, CreateKnowledgeFromFileResponses, CreateKnowledgeFromUrlData, CreateKnowledgeFromUrlError, CreateKnowledgeFromUrlErrors, CreateKnowledgeFromUrlResponse, CreateKnowledgeFromUrlResponses, CreateKnowledgeResponse, CreateKnowledgeResponses, CreateKnowledgeUploadUrlData, CreateKnowledgeUploadUrlError, CreateKnowledgeUploadUrlErrors, CreateKnowledgeUploadUrlResponse, CreateKnowledgeUploadUrlResponses, CreateSessionData, CreateSessionError, CreateSessionErrors, CreateSessionResponse, CreateSessionResponses, CreateSkyboxData, CreateSkyboxError, CreateSkyboxErrors, CreateSkyboxResponse, CreateSkyboxResponses, CreateTranscriptionData, CreateTranscriptionError, CreateTranscriptionErrors, CreateTranscriptionResponse, CreateTranscriptionResponses, CreateVideoData, CreateVideoError, CreateVideoErrors, CreateVideoResponse, CreateVideoResponses, CreateVoiceData, CreateVoiceError, CreateVoiceErrors, CreateVoiceResponse, CreateVoiceResponses, CreateVoiceUploadUrlData, CreateVoiceUploadUrlError, CreateVoiceUploadUrlErrors, CreateVoiceUploadUrlResponse, CreateVoiceUploadUrlResponses, DeleteAgentData, DeleteAgentError, DeleteAgentErrors, DeleteAgentResponse, DeleteAgentResponses, DeleteAllFactsData, DeleteAllFactsError, DeleteAllFactsErrors, DeleteAllFactsResponse, DeleteAllFactsResponses, DeleteAssetData, DeleteAssetError, DeleteAssetErrors, DeleteAssetFolderData, DeleteAssetFolderError, DeleteAssetFolderErrors, DeleteAssetFolderResponse, DeleteAssetFolderResponses, DeleteAssetResponse, DeleteAssetResponses, DeleteAssetsData, DeleteAssetsError, DeleteAssetsErrors, DeleteAssetsResponse, DeleteAssetsResponses, DeleteEndUserData, DeleteEndUserError, DeleteEndUserErrors, DeleteEndUserResponse, DeleteEndUserResponses, DeleteFactData, DeleteFactError, DeleteFactErrors, DeleteFactResponse, DeleteFactResponses, DeleteKnowledgeData, DeleteKnowledgeError, DeleteKnowledgeErrors, DeleteKnowledgeResponse, DeleteKnowledgeResponses, DeleteSessionData, DeleteSessionError, DeleteSessionErrors, DeleteSessionResponse, DeleteSessionResponses, DeleteVoiceData, DeleteVoiceError, DeleteVoiceErrors, DeleteVoiceResponse, DeleteVoiceResponses, DesignVoiceData, DesignVoiceError, DesignVoiceErrors, DesignVoiceResponse, DesignVoiceResponses, EndUserCreateRequest, EndUserDeleted, EndUserInfo, EndUserPage, EndUserUpdateRequest, EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EphemeralKeyInfo, EphemeralKeyLimits, EphemeralKeyPage, EphemeralTokenSelf, ErrorCode, ErrorInfo, ErrorResponse, ExtractSessionFactsData, ExtractSessionFactsError, ExtractSessionFactsErrors, ExtractSessionFactsResponse, ExtractSessionFactsResponses, FactInfo, FactPage, FactsDeleted, FolderCreate, FolderDeleted, FolderDetail, FolderPage, FolderSummary, FolderUpdate, GenerateFromTemplateData, GenerateFromTemplateError, GenerateFromTemplateErrors, GenerateFromTemplateResponse, GenerateFromTemplateResponses, GenerationAudio, GenerationImage, GenerationInfo, GenerationPage, GenerationSkybox, GenerationTranscript, GenerationVideo, GetAgentData, GetAgentError, GetAgentErrors, GetAgentResponse, GetAgentResponses, GetAgentSettingsData, GetAgentSettingsError, GetAgentSettingsErrors, GetAgentSettingsResponse, GetAgentSettingsResponses, GetAssetData, GetAssetError, GetAssetErrors, GetAssetFolderData, GetAssetFolderError, GetAssetFolderErrors, GetAssetFolderResponse, GetAssetFolderResponses, GetAssetResponse, GetAssetResponses, GetAudioData, GetAudioError, GetAudioErrors, GetAudioResponse, GetAudioResponses, GetEndUserData, GetEndUserError, GetEndUserErrors, GetEndUserResponse, GetEndUserResponses, GetEphemeralKeyData, GetEphemeralKeyError, GetEphemeralKeyErrors, GetEphemeralKeyLimitsData, GetEphemeralKeyLimitsError, GetEphemeralKeyLimitsErrors, GetEphemeralKeyLimitsResponse, GetEphemeralKeyLimitsResponses, GetEphemeralKeyResponse, GetEphemeralKeyResponses, GetGenerationData, GetGenerationError, GetGenerationErrors, GetGenerationResponse, GetGenerationResponses, GetHealthData, GetHealthResponse, GetHealthResponses, GetImageData, GetImageError, GetImageErrors, GetImageResponse, GetImageResponses, GetKnowledgeData, GetKnowledgeError, GetKnowledgeErrors, GetKnowledgeInsightsData, GetKnowledgeInsightsError, GetKnowledgeInsightsErrors, GetKnowledgeInsightsResponse, GetKnowledgeInsightsResponses, GetKnowledgeResponse, GetKnowledgeResponses, GetPlanData, GetPlanError, GetPlanErrors, GetPlanResponse, GetPlanResponses, GetSessionData, GetSessionError, GetSessionErrors, GetSessionResponse, GetSessionResponses, GetSkyboxData, GetSkyboxError, GetSkyboxErrors, GetSkyboxResponse, GetSkyboxResponses, GetTemplateData, GetTemplateError, GetTemplateErrors, GetTemplateFileData, GetTemplateFileError, GetTemplateFileErrors, GetTemplateFileResponses, GetTemplateResponse, GetTemplateResponses, GetTokenData, GetTokenError, GetTokenErrors, GetTokenResponse, GetTokenResponses, GetTranscriptionData, GetTranscriptionError, GetTranscriptionErrors, GetTranscriptionResponse, GetTranscriptionResponses, GetUsageData, GetUsageError, GetUsageErrors, GetUsageResponse, GetUsageResponses, GetVideoData, GetVideoError, GetVideoErrors, GetVideoResponse, GetVideoResponses, GetVoiceData, GetVoiceError, GetVoiceErrors, GetVoiceResponse, GetVoiceResponses, HealthResponse, ImageRequest, KnowledgeAgentsUpdate, KnowledgeAssigned, KnowledgeBulk, KnowledgeBulkResult, KnowledgeCategoryPage, KnowledgeCitation, KnowledgeCreate, KnowledgeEntryUsage, KnowledgeFileCreate, KnowledgeInfo, KnowledgeInsights, KnowledgeLookupInfo, KnowledgePage, KnowledgeSearchHit, KnowledgeSearchRequest, KnowledgeSearchResult, KnowledgeUpdate, KnowledgeUploadRequest, KnowledgeUploadTicket, KnowledgeUrlCreate, ListAgentKnowledgeData, ListAgentKnowledgeError, ListAgentKnowledgeErrors, ListAgentKnowledgeResponse, ListAgentKnowledgeResponses, ListAgentsData, ListAgentsError, ListAgentsErrors, ListAgentsResponse, ListAgentsResponses, ListAssetFoldersData, ListAssetFoldersError, ListAssetFoldersErrors, ListAssetFoldersResponse, ListAssetFoldersResponses, ListAssetsData, ListAssetsError, ListAssetsErrors, ListAssetsResponse, ListAssetsResponses, ListEndUsersData, ListEndUsersError, ListEndUsersErrors, ListEndUsersResponse, ListEndUsersResponses, ListEphemeralKeysData, ListEphemeralKeysError, ListEphemeralKeysErrors, ListEphemeralKeysResponse, ListEphemeralKeysResponses, ListFactsData, ListFactsError, ListFactsErrors, ListFactsResponse, ListFactsResponses, ListGenerationsData, ListGenerationsError, ListGenerationsErrors, ListGenerationsResponse, ListGenerationsResponses, ListKnowledgeCategoriesData, ListKnowledgeCategoriesError, ListKnowledgeCategoriesErrors, ListKnowledgeCategoriesResponse, ListKnowledgeCategoriesResponses, ListKnowledgeData, ListKnowledgeError, ListKnowledgeErrors, ListKnowledgeResponse, ListKnowledgeResponses, ListRelationsData, ListRelationsError, ListRelationsErrors, ListRelationsResponse, ListRelationsResponses, ListSessionsData, ListSessionsError, ListSessionsErrors, ListSessionsResponse, ListSessionsResponses, ListSkyboxStylesData, ListSkyboxStylesError, ListSkyboxStylesErrors, ListSkyboxStylesResponse, ListSkyboxStylesResponses, ListTemplatesData, ListTemplatesError, ListTemplatesErrors, ListTemplatesResponse, ListTemplatesResponses, ListVoicesData, ListVoicesError, ListVoicesErrors, ListVoicesResponse, ListVoicesResponses, MessageInfo, MessageKnowledge, MessagePage, MoveAssetsData, MoveAssetsError, MoveAssetsErrors, MoveAssetsResponse, MoveAssetsResponses, OrgPlan, ProviderVoiceSettings, ProviderVoiceSettingsInfo, Reference, RefreshKnowledgeData, RefreshKnowledgeError, RefreshKnowledgeErrors, RefreshKnowledgeResponse, RefreshKnowledgeResponses, ReindexKnowledgeData, ReindexKnowledgeError, ReindexKnowledgeErrors, ReindexKnowledgeResponse, ReindexKnowledgeResponses, RelationInfo, RelationPage, ResampleVoiceData, ResampleVoiceError, ResampleVoiceErrors, ResampleVoiceResponse, ResampleVoiceResponses, RevokeEphemeralKeyData, RevokeEphemeralKeyError, RevokeEphemeralKeyErrors, RevokeEphemeralKeyResponse, RevokeEphemeralKeyResponses, SaveDesignedVoiceData, SaveDesignedVoiceError, SaveDesignedVoiceErrors, SaveDesignedVoiceResponse, SaveDesignedVoiceResponses, SearchKnowledgeData, SearchKnowledgeError, SearchKnowledgeErrors, SearchKnowledgeResponse, SearchKnowledgeResponses, SessionCreateRequest, SessionDetail, SessionInfo, SessionPage, SetAgentKnowledgeData, SetAgentKnowledgeError, SetAgentKnowledgeErrors, SetAgentKnowledgeResponse, SetAgentKnowledgeResponses, SetKnowledgeAgentsData, SetKnowledgeAgentsError, SetKnowledgeAgentsErrors, SetKnowledgeAgentsResponse, SetKnowledgeAgentsResponses, SkyboxFile, SkyboxRequest, SkyboxStyle, SkyboxStylePage, SpeechProvider, StreamDone, StreamError, StreamSegment, StreamTranscript, SynthesizeSpeechData, SynthesizeSpeechError, SynthesizeSpeechErrors, SynthesizeSpeechResponse, SynthesizeSpeechResponses, TemplateGenerateRequest, TemplateInfo, TemplateInput, TemplatePage, TokenSelf, TranscribeAssetRequest, TranscribeData, TranscribeError, TranscribeErrors, TranscribeResponse, TranscribeResponses, Transcription, TranscriptionStreamLine, TranscriptWord, TtsOptions, TtsRequest, UnansweredQuestion, UpdateAgentData, UpdateAgentError, UpdateAgentErrors, UpdateAgentResponse, UpdateAgentResponses, UpdateAgentSettingsData, UpdateAgentSettingsError, UpdateAgentSettingsErrors, UpdateAgentSettingsResponse, UpdateAgentSettingsResponses, UpdateAssetData, UpdateAssetError, UpdateAssetErrors, UpdateAssetFolderData, UpdateAssetFolderError, UpdateAssetFolderErrors, UpdateAssetFolderResponse, UpdateAssetFolderResponses, UpdateAssetResponse, UpdateAssetResponses, UpdateEndUserData, UpdateEndUserError, UpdateEndUserErrors, UpdateEndUserResponse, UpdateEndUserResponses, UpdateKnowledgeData, UpdateKnowledgeError, UpdateKnowledgeErrors, UpdateKnowledgeResponse, UpdateKnowledgeResponses, UpdateVoiceData, UpdateVoiceError, UpdateVoiceErrors, UpdateVoiceResponse, UpdateVoiceResponses, UploadConfirm, UploadTicket, UploadTicketRequest, UsageByKey, UsageDay, UsageResponse, UsageSummary, ValidationIssue, VariantInfo, VideoRequest, VoiceDesignPreview, VoiceDesignRequest, VoiceDesignResult, VoiceDesignSaveRequest, VoiceDetail, VoiceInfo, VoiceInfoPage, VoiceKind, VoiceSample, VoiceSource, VoiceStatus, VoiceUpdate, VoiceUpload, VoiceUploadRequest, VoiceUploadTicket } from './types.gen.js';

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

@@ -81,12 +81,27 @@ export type SkyboxStyle = {
     image: string | null;
 };
 export type EphemeralKeyLimits = {
+    /**
+     * The platform's longest lifetime for a key.
+     */
     max_ttl_seconds: number;
     default_ttl_seconds: number;
     /**
-     * Micro-credits: 1 credit is 1,000,000.
+     * The platform's largest credit limit for a key.
      */
     max_credit_limit_micros: number;
+    /**
+     * Your plan's longest lifetime for one end user's key; `null` sets none. A key is held to the tighter of this and `max_ttl_seconds`.
+     */
+    plan_max_ttl_seconds: number | null;
+    /**
+     * Your plan's largest credit limit for one end user's key, in micro-credits; `null` sets none. A key is held to the tighter of this and `max_credit_limit_micros`.
+     */
+    plan_max_credit_limit_micros: number | null;
+    /**
+     * How many live keys one end user may hold on your plan; `null` sets none.
+     */
+    plan_max_live_keys: number | null;
     grantable_scopes: Array<string>;
 };
 export type EphemeralKeyCreateResponse = {
@@ -100,7 +115,7 @@ export type EphemeralKeyCreateResponse = {
      */
     credit_limit_micros: number;
     /**
-     * What it has spent, as its end user DO last settled — at the end, or daily for a long-lived key.
+     * What it has spent, as its end user DO last settled — at the end, or daily for a long-lived key. Final once `settled_at` is set.
      */
     credits_spent_micros: number;
     /**
@@ -116,6 +131,10 @@ export type EphemeralKeyCreateResponse = {
     last_used_at: string | null;
     revoked_at: string | null;
     revoked_reason: string | null;
+    /**
+     * When its end user DO settled it for the last time — what it spent and what came back are final from then. `null` while it is live, and for a few seconds after it ends, longer while a memory job it paid for still runs.
+     */
+    settled_at: string | null;
     active: boolean;
     /**
      * The token, in full. **Shown once**: it is signed rather than stored, so it cannot be shown again.
@@ -151,7 +170,7 @@ export type EphemeralKeyInfo = {
      */
     credit_limit_micros: number;
     /**
-     * What it has spent, as its end user DO last settled — at the end, or daily for a long-lived key.
+     * What it has spent, as its end user DO last settled — at the end, or daily for a long-lived key. Final once `settled_at` is set.
      */
     credits_spent_micros: number;
     /**
@@ -167,6 +186,10 @@ export type EphemeralKeyInfo = {
     last_used_at: string | null;
     revoked_at: string | null;
     revoked_reason: string | null;
+    /**
+     * When its end user DO settled it for the last time — what it spent and what came back are final from then. `null` while it is live, and for a few seconds after it ends, longer while a memory job it paid for still runs.
+     */
+    settled_at: string | null;
     active: boolean;
 };
 export type TokenSelf = ({
@@ -182,7 +205,7 @@ export type EphemeralTokenSelf = {
      */
     credit_limit_micros: number;
     /**
-     * What the key had spent when its end user DO last settled — at the end, or daily for a long-lived key.
+     * What the key has spent so far, turn by turn.
      */
     credits_spent_micros: number;
     /**
@@ -717,6 +740,10 @@ export type TemplateInfo = {
      * What one generation from it costs your organisation, in micro-credits (1 credit is 1,000,000). Knowable up front because every parameter is frozen — but on an image template your own pictures are charged on top, each at the output's per-megapixel rate and the size sent. Null when the platform has no rate for the capability.
      */
     credits_micros: number | null;
+    /**
+     * On an image template, the megapixels of the pictures the template itself sends with every generation, each charged at the output's per-megapixel rate and already in `credits_micros` — so an estimate that moves the output's size keeps this term as it is, and adds your own pictures at the size they are sent. 0 on a video or skybox template, whose price no picture changes.
+     */
+    fixed_megapixels: number;
     /**
      * The request the template froze, minus the prompt. Every entry is decided for you unless its name is in `exposed`, in which case it is the default you may override.
      */
@@ -3021,6 +3048,48 @@ export type RevokeEphemeralKeyResponses = {
     200: EphemeralKeyInfo;
 };
 export type RevokeEphemeralKeyResponse = RevokeEphemeralKeyResponses[keyof RevokeEphemeralKeyResponses];
+export type GetEphemeralKeyData = {
+    body?: never;
+    path: {
+        key_id: string;
+    };
+    query?: never;
+    url: '/v1/ephemeral-keys/{key_id}';
+};
+export type GetEphemeralKeyErrors = {
+    /**
+     * The request could not be read: malformed JSON
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid credentials
+     */
+    401: ErrorResponse;
+    /**
+     * The key is valid but its scopes do not cover this capability — a key limited to `tts` gets this from `/v1/images` rather than a 401
+     */
+    403: ErrorResponse;
+    /**
+     * Unknown ephemeral key id
+     */
+    404: ErrorResponse;
+    /**
+     * The request failed validation
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+};
+export type GetEphemeralKeyError = GetEphemeralKeyErrors[keyof GetEphemeralKeyErrors];
+export type GetEphemeralKeyResponses = {
+    /**
+     * The token
+     */
+    200: EphemeralKeyInfo;
+};
+export type GetEphemeralKeyResponse = GetEphemeralKeyResponses[keyof GetEphemeralKeyResponses];
 export type GetTokenData = {
     body?: never;
     path?: never;
@@ -4728,6 +4797,14 @@ export type ListFactsData = {
          * Optional, and only ever the key's own end user — their `eu_...` id or your own id for them. Anybody else is a 403.
          */
         end_user_id?: string;
+        /**
+         * How many to answer, 1 to 200.
+         */
+        limit?: number;
+        /**
+         * The `next_cursor` of the page before.
+         */
+        cursor?: string;
     };
     url: '/v1/agent/facts';
 };

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export type { Page } from "./paging.js";
 export type { AgentKnowledge, AgentSettings, Agents, } from "./resources/agents.js";
 export type { AssetListParams, Assets, AssetUploadFields, FolderListParams, Folders, } from "./resources/assets.js";
 export type { EndUserCreated, EndUserExport, EndUserListParams, EndUsers, } from "./resources/end-users.js";
-export type { EphemeralKeyCreateOptions, EphemeralKeyListParams, EphemeralKeys, } from "./resources/ephemeral-keys.js";
+export type { EphemeralKeyCreateOptions, EphemeralKeyListParams, EphemeralKeyRevokeOptions, EphemeralKeys, } from "./resources/ephemeral-keys.js";
 export type { GenerationListParams, Generations, Jobs, Skybox, } from "./resources/generations.js";
 export type { Knowledge, KnowledgeInsightsParams, KnowledgeListParams, KnowledgeUploadFields, } from "./resources/knowledge.js";
 export type { Resource, Waitable } from "./resources/resource.js";

package/dist/resources/end-users.d.ts

@@ -21,18 +21,15 @@
  * and an API key cannot read them (`/v1/agent/*` takes only an ephemeral
  * key): it mints a five-minute key for them, lists their sessions (200 a
  * page), reads each transcript back to its start by `messages.next_cursor`
- * (200 messages a page, four sessions at a time), reads their facts, and
- * revokes the key in `finally` — after an abort or a failure too. The
- * cost: one mint (and `limits()` when cold) + ⌈S/200⌉ lists + Σ⌈M/200⌉
- * transcript pages + one facts read + one revoke. **Its ceilings**: the
+ * (200 messages a page, four sessions at a time), reads their facts (200
+ * a page), and revokes the key in `finally` — after an abort or a failure
+ * too. The cost: one mint (and `limits()` when cold) + ⌈S/200⌉ lists +
+ * Σ⌈M/200⌉ transcript pages + ⌈F/200⌉ fact pages + one revoke. **Its ceilings**: the
  * key is ordinary, so at the person's live-key cap or the plan's mint rate
  * the export fails as the mint does (422, 429) and can be retried once a
  * key lapses; it lives five minutes, so a history that takes longer to
  * read fails with a 401; its one micro-credit is set aside like any key's,
- * so an organisation with no balance cannot export (402); and the facts
- * route answers the newest 100 in one page until it pages (left-overs
- * #109) — read here by its cursor, so the day it does, the export has
- * them all.
+ * so an organisation with no balance cannot export (402).
  */
 import type { EndUserCreateRequest, EndUserDeleted, EndUserInfo, EndUserPage, EndUserUpdateRequest, FactInfo, ListEndUsersData, SessionDetail } from "../gen/index.js";
 import { type RequestOptions, type Transport } from "../transport.js";

package/dist/resources/end-users.js

@@ -21,18 +21,15 @@
  * and an API key cannot read them (`/v1/agent/*` takes only an ephemeral
  * key): it mints a five-minute key for them, lists their sessions (200 a
  * page), reads each transcript back to its start by `messages.next_cursor`
- * (200 messages a page, four sessions at a time), reads their facts, and
- * revokes the key in `finally` — after an abort or a failure too. The
- * cost: one mint (and `limits()` when cold) + ⌈S/200⌉ lists + Σ⌈M/200⌉
- * transcript pages + one facts read + one revoke. **Its ceilings**: the
+ * (200 messages a page, four sessions at a time), reads their facts (200
+ * a page), and revokes the key in `finally` — after an abort or a failure
+ * too. The cost: one mint (and `limits()` when cold) + ⌈S/200⌉ lists +
+ * Σ⌈M/200⌉ transcript pages + ⌈F/200⌉ fact pages + one revoke. **Its ceilings**: the
  * key is ordinary, so at the person's live-key cap or the plan's mint rate
  * the export fails as the mint does (422, 429) and can be retried once a
  * key lapses; it lives five minutes, so a history that takes longer to
  * read fails with a 401; its one micro-credit is set aside like any key's,
- * so an organisation with no balance cannot export (402); and the facts
- * route answers the newest 100 in one page until it pages (left-overs
- * #109) — read here by its cursor, so the day it does, the export has
- * them all.
+ * so an organisation with no balance cannot export (402).
  */
 import { pages } from "../paging.js";
 import { segment, } from "../transport.js";
@@ -128,7 +125,7 @@ export class EndUsers extends Editable {
                     messages: { data: held.flat(), next_cursor: null },
                 };
             });
-            const facts = await all(pages((cursor) => read("/v1/agent/facts", { cursor })));
+            const facts = await all(pages((cursor) => read("/v1/agent/facts", { limit: PAGE, cursor })));
             return { end_user_id: key.end_user_id ?? id, sessions, facts };
         }
         finally {

package/dist/resources/ephemeral-keys.d.ts

@@ -5,24 +5,24 @@
  * - **A key is prepaid**: its `credit_limit_micros` is set aside from the
  *   balance when it is minted (402 when it cannot be), and what it does not spend
  *   comes back when it settles.
- * - **`create` clamps the lifetime by default** to the platform's maximum,
- *   read from `limits()` — which the API never does: past a cap is a 422
- *   (`apps/api/src/org/minting.ts`). The plan's own caps for one end
- *   user's key are not reported yet (left-overs #107), so a key within the
- *   platform's can still be refused.
+ * - **`create` clamps the lifetime by default** to the tighter of the
+ *   platform's maximum and the plan's for one end user's key, both read
+ *   from `limits()` — which the API never does: past a cap is a 422
+ *   (`apps/api/src/org/minting.ts`).
  * - **`limits()` is cached five minutes per client**, so a mint is two
  *   requests cold and one warm. Concurrent cold callers share one read.
  * - **`revoke` answers at once**, with the figures from before the key's
  *   end user DO settles: revocation leaves through the org DO's outbox
- *   (`apps/api/src/org/areas/keys.ts` `revokeEphemeral`). Waiting for the
- *   final figures needs the key's read route (left-overs #106).
- * - **`inspect` reads a key as itself** (`GET /v1/token` with that key).
- *   Its `credits_spent_micros` moves only when the key settles — at the end, or
- *   daily — so a live key reads as unspent (left-overs #105).
+ *   (`apps/api/src/org/areas/keys.ts` `revokeEphemeral`). With
+ *   `{ settled: true }` it reads the key (`get`) until `settled_at` is set
+ *   — seconds, longer while a memory job the key paid for runs — on the
+ *   polls of `../wait.ts`; a `signal` is its deadline.
+ * - **`inspect` reads a key as itself** (`GET /v1/token` with that key):
+ *   its spend as its end user DO counts it, turn by turn.
  */
 import type { EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EphemeralKeyInfo, EphemeralKeyLimits, EphemeralKeyPage, EphemeralTokenSelf, ListEphemeralKeysData } from "../gen/index.js";
 import { type RequestOptions } from "../transport.js";
-import { Resource } from "./resource.js";
+import { Readable } from "./resource.js";
 export type EphemeralKeyListParams = NonNullable<ListEphemeralKeysData["query"]>;
 export interface EphemeralKeyCreateOptions extends RequestOptions {
     /**
@@ -32,12 +32,17 @@ export interface EphemeralKeyCreateOptions extends RequestOptions {
      */
     clampTtl?: boolean;
 }
-export declare class EphemeralKeys extends Resource {
+export interface EphemeralKeyRevokeOptions extends RequestOptions {
+    /** Answer once the key's final figures are in (`settled_at` set), not at once. */
+    settled?: boolean;
+}
+export declare class EphemeralKeys extends Readable<EphemeralKeyInfo> {
     private cached;
     /**
-     * What a key may be minted with: the **platform's** longest lifetime and
-     * largest credit limit, and the scopes this API key may grant. Cached
-     * five minutes per client.
+     * What a key may be minted with: the platform's longest lifetime and
+     * largest credit limit, the plan's for one end user's key (`plan_*`,
+     * `null` where it sets none), and the scopes this API key may grant.
+     * Cached five minutes per client.
      */
     limits(options?: RequestOptions): Promise<EphemeralKeyLimits>;
     /**
@@ -49,10 +54,11 @@ export declare class EphemeralKeys extends Resource {
     create(body: EphemeralKeyCreateRequest, options?: EphemeralKeyCreateOptions): Promise<EphemeralKeyCreateResponse>;
     /**
      * Revokes a key: it is refused from now on, and what it did not spend
-     * comes back when it settles. `null` when there is no such key — a
-     * revoked, expired or unknown id answers as itself, a non-UUID as none.
+     * comes back when it settles — awaited with `{ settled: true }`. `null`
+     * when there is no such key — a revoked, expired or unknown id answers
+     * as itself, a non-UUID as none.
      */
-    revoke(id: string, options?: RequestOptions): Promise<EphemeralKeyInfo | null>;
+    revoke(id: string, options?: EphemeralKeyRevokeOptions): Promise<EphemeralKeyInfo | null>;
     /**
      * A key as it reads itself: its scopes, limit, spend and expiry. `null`
      * when the key is refused — expired, revoked, spent or not a key.

package/dist/resources/ephemeral-keys.js

@@ -5,24 +5,25 @@
  * - **A key is prepaid**: its `credit_limit_micros` is set aside from the
  *   balance when it is minted (402 when it cannot be), and what it does not spend
  *   comes back when it settles.
- * - **`create` clamps the lifetime by default** to the platform's maximum,
- *   read from `limits()` — which the API never does: past a cap is a 422
- *   (`apps/api/src/org/minting.ts`). The plan's own caps for one end
- *   user's key are not reported yet (left-overs #107), so a key within the
- *   platform's can still be refused.
+ * - **`create` clamps the lifetime by default** to the tighter of the
+ *   platform's maximum and the plan's for one end user's key, both read
+ *   from `limits()` — which the API never does: past a cap is a 422
+ *   (`apps/api/src/org/minting.ts`).
  * - **`limits()` is cached five minutes per client**, so a mint is two
  *   requests cold and one warm. Concurrent cold callers share one read.
  * - **`revoke` answers at once**, with the figures from before the key's
  *   end user DO settles: revocation leaves through the org DO's outbox
- *   (`apps/api/src/org/areas/keys.ts` `revokeEphemeral`). Waiting for the
- *   final figures needs the key's read route (left-overs #106).
- * - **`inspect` reads a key as itself** (`GET /v1/token` with that key).
- *   Its `credits_spent_micros` moves only when the key settles — at the end, or
- *   daily — so a live key reads as unspent (left-overs #105).
+ *   (`apps/api/src/org/areas/keys.ts` `revokeEphemeral`). With
+ *   `{ settled: true }` it reads the key (`get`) until `settled_at` is set
+ *   — seconds, longer while a memory job the key paid for runs — on the
+ *   polls of `../wait.ts`; a `signal` is its deadline.
+ * - **`inspect` reads a key as itself** (`GET /v1/token` with that key):
+ *   its spend as its end user DO counts it, turn by turn.
  */
 import { AuthenticationError } from "../errors.js";
 import { orNull } from "../transport.js";
-import { Resource } from "./resource.js";
+import { poll } from "../wait.js";
+import { Readable } from "./resource.js";
 const LIMITS_TTL_MS = 5 * 60_000;
 /** The route's largest page. */
 const PAGE = 200;
@@ -44,12 +45,13 @@ function until(promise, signal) {
         });
     });
 }
-export class EphemeralKeys extends Resource {
+export class EphemeralKeys extends Readable {
     cached = null;
     /**
-     * What a key may be minted with: the **platform's** longest lifetime and
-     * largest credit limit, and the scopes this API key may grant. Cached
-     * five minutes per client.
+     * What a key may be minted with: the platform's longest lifetime and
+     * largest credit limit, the plan's for one end user's key (`plan_*`,
+     * `null` where it sets none), and the scopes this API key may grant.
+     * Cached five minutes per client.
      */
     limits(options = {}) {
         const now = Date.now();
@@ -82,18 +84,23 @@ export class EphemeralKeys extends Resource {
             const wanted = body.expires_in_seconds ?? limits.default_ttl_seconds;
             sent = {
                 ...body,
-                expires_in_seconds: Math.min(wanted, limits.max_ttl_seconds),
+                expires_in_seconds: Math.min(wanted, limits.max_ttl_seconds, limits.plan_max_ttl_seconds ?? wanted),
             };
         }
         return this.send("POST", "", request, sent);
     }
     /**
      * Revokes a key: it is refused from now on, and what it did not spend
-     * comes back when it settles. `null` when there is no such key — a
-     * revoked, expired or unknown id answers as itself, a non-UUID as none.
+     * comes back when it settles — awaited with `{ settled: true }`. `null`
+     * when there is no such key — a revoked, expired or unknown id answers
+     * as itself, a non-UUID as none.
      */
-    revoke(id, options) {
-        return orNull(this.send("DELETE", this.at(id), options));
+    async revoke(id, options = {}) {
+        const { settled, ...request } = options;
+        const key = await orNull(this.send("DELETE", this.at(id), request));
+        return key && settled
+            ? poll(() => this.get(id, request), request, key, (k) => !k.settled_at)
+            : key;
     }
     /**
      * A key as it reads itself: its scopes, limit, spend and expiry. `null`

package/dist/wait.d.ts

@@ -32,7 +32,9 @@ export interface Job {
     status: string;
 }
 /**
- * Reads `read` until its status is final, starting from `first` (a job
- * just made, so the first read waits) or with a read now.
+ * Reads `read` until its status is final — or until `pending` says it no
+ * longer is, for what is not a job (a revoked key's settlement) —
+ * starting from `first` (a job just made, so the first read waits) or
+ * with a read now.
  */
-export declare function poll<T extends Job>(read: () => Promise<T>, options?: RequestOptions, first?: T): Promise<T>;
+export declare function poll<T>(read: () => Promise<T>, options?: RequestOptions, first?: T, pending?: (job: T) => boolean): Promise<T>;

package/dist/wait.js

@@ -37,12 +37,14 @@ const IN_PROGRESS = [
 const FIRST_MS = 1_000;
 const MAX_MS = 10_000;
 /**
- * Reads `read` until its status is final, starting from `first` (a job
- * just made, so the first read waits) or with a read now.
+ * Reads `read` until its status is final — or until `pending` says it no
+ * longer is, for what is not a job (a revoked key's settlement) —
+ * starting from `first` (a job just made, so the first read waits) or
+ * with a read now.
  */
-export async function poll(read, options = {}, first) {
+export async function poll(read, options = {}, first, pending = (job) => IN_PROGRESS.includes(job.status)) {
     let job = first ?? (await read());
-    for (let ms = FIRST_MS; IN_PROGRESS.includes(job.status);) {
+    for (let ms = FIRST_MS; pending(job);) {
         await sleep(ms, options.signal);
         job = await read();
         ms = Math.min(ms * 1.5, MAX_MS);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumavox/server",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "The Lumavox API from your server: end users, ephemeral keys and the rest, typed from the published OpenAPI document. Zero dependencies.",
   "license": "MIT",
   "type": "module",