@lumavox/server 0.10.0 → 0.14.1

package/README.md

@@ -60,7 +60,7 @@ list's page.
 
 | Resource | Methods |
 |---|---|
-| `endUsers` | `create`, `get`, `update`, `delete`, `list`, `page`, `export` |
+| `endUsers` | `create`, `get`, `update`, `delete`, `list`, `page`, `export`; `facts.list`, `facts.add`, `facts.update`, `facts.delete` |
 | `ephemeralKeys` | `limits`, `create`, `revoke`, `inspect`, `list`, `page` |
 | `images`, `videos`, `audio`, `skybox`, `transcriptions` | `create`, `get`, `wait`, `generate`; `skybox.styles` |
 | `generations` | `get`, `wait`, `list`, `page` |
@@ -72,7 +72,7 @@ list's page.
 | `tools` | `list`, `page`, `get`, `create` (a webhook's signing secret, shown once), `update`, `delete`, `rotateSecret`, `test` |
 | `knowledge` | `list`, `page`, `get`, `create`, `bulk`, `fromUrl`, `uploadUrl`, `fromFile`, `upload`, `update`, `delete`, `reindex`, `refresh`, `setAgents`, `search`, `categories`, `insights`, `wait` |
 | `usage` | `get`, `plan` |
-| the client | `health()` |
+| the client | `health()`, `limits()` (the platform's limits, each by its key) |
 
 - **`list()` is an async iterator over every item**, page after page by
   each page's `next_cursor`; `page()` is one page, `{ data, next_cursor }`.
@@ -138,6 +138,7 @@ and a longer one is thrown at once as a `RateLimitError` with its
   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
+  person — replaced facts too, until they are deleted — 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.

package/dist/client.d.ts

@@ -1,7 +1,8 @@
 /**
  * `createClient`: one org API key, one base URL, and a resource per area of
  * the API — every operation an API key may call (`test/coverage.test.ts`
- * holds the document to it), and `health()`, which needs none.
+ * holds the document to it), and the two that need none: `health()` and
+ * `limits()`.
  *
  * - **Nothing is read from `process.env`**: Workers has none, and a key
  *   that arrives by argument is one the caller can see arrive.
@@ -11,7 +12,7 @@
  *   `(url, init) => env.API.fetch(url, init)`.
  * - **It refuses a browser and React Native** (`runtime.ts`).
  */
-import type { AudioRequest, HealthResponse, ImageRequest, SkyboxRequest, TranscribeAssetRequest, VideoRequest } from "./gen/index.js";
+import type { AudioRequest, HealthResponse, ImageRequest, PlatformLimit, SkyboxRequest, TranscribeAssetRequest, VideoRequest } from "./gen/index.js";
 import { Agents } from "./resources/agents.js";
 import { Assets } from "./resources/assets.js";
 import { EndUsers } from "./resources/end-users.js";
@@ -57,5 +58,12 @@ export interface Client {
     readonly tools: Tools;
     /** Whether the API is up, and its version. Sends no key. */
     health(options?: RequestOptions): Promise<HealthResponse>;
+    /**
+     * The platform's limits as they stand now — the tools on an agent, the
+     * voices, uploads and knowledge an organisation may keep, the ceilings on
+     * an ephemeral key — each by the `key` the reference names it by. The
+     * platform's staff may change them. Sends no key.
+     */
+    limits(options?: RequestOptions): Promise<PlatformLimit[]>;
 }
 export declare function createClient(options: ClientOptions): Client;

package/dist/client.js

@@ -50,5 +50,9 @@ export function createClient(options) {
         health: (request) => transport
             .request({ method: "GET", path: "/health", open: true }, request)
             .then((answer) => answer.data),
+        // One page, always: its `next_cursor` is null.
+        limits: (request) => transport
+            .request({ method: "GET", path: "/v1/platform/limits", open: true }, request)
+            .then((answer) => answer.data.data),
     };
 }

package/dist/gen/index.d.ts

@@ -1 +1 @@
-export type { AgentCreateRequest, AgentInfo, AgentKnowledgeUpdate, AgentPage, AgentSettingsInfo, AgentSettingsUpdate, AgentStt, AgentSttInfo, AgentSummary, AgentToolsUpdate, 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, CreateToolData, CreateToolError, CreateToolErrors, CreateToolResponse, CreateToolResponses, 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, DeleteToolData, DeleteToolError, DeleteToolErrors, DeleteToolResponse, DeleteToolResponses, 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, GetToolData, GetToolError, GetToolErrors, GetToolResponse, GetToolResponses, 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, ListAgentToolsData, ListAgentToolsError, ListAgentToolsErrors, ListAgentToolsResponse, ListAgentToolsResponses, 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, ListToolCallsData, ListToolCallsError, ListToolCallsErrors, ListToolCallsResponse, ListToolCallsResponses, ListToolsData, ListToolsError, ListToolsErrors, ListToolsResponse, ListToolsResponses, ListVoicesData, ListVoicesError, ListVoicesErrors, ListVoicesResponse, ListVoicesResponses, MessageInfo, MessageKnowledge, MessagePage, MessageSource, MessageToolCall, 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, RotateToolSecretData, RotateToolSecretError, RotateToolSecretErrors, RotateToolSecretResponse, RotateToolSecretResponses, SaveDesignedVoiceData, SaveDesignedVoiceError, SaveDesignedVoiceErrors, SaveDesignedVoiceResponse, SaveDesignedVoiceResponses, SearchKnowledgeData, SearchKnowledgeError, SearchKnowledgeErrors, SearchKnowledgeResponse, SearchKnowledgeResponses, SessionCreateRequest, SessionDetail, SessionInfo, SessionPage, SetAgentKnowledgeData, SetAgentKnowledgeError, SetAgentKnowledgeErrors, SetAgentKnowledgeResponse, SetAgentKnowledgeResponses, SetAgentToolsData, SetAgentToolsError, SetAgentToolsErrors, SetAgentToolsResponse, SetAgentToolsResponses, SetKnowledgeAgentsData, SetKnowledgeAgentsError, SetKnowledgeAgentsErrors, SetKnowledgeAgentsResponse, SetKnowledgeAgentsResponses, SkyboxFile, SkyboxRequest, SkyboxStyle, SkyboxStylePage, SpeechProvider, StreamDone, StreamError, StreamSegment, StreamTranscript, SynthesizeSpeechData, SynthesizeSpeechError, SynthesizeSpeechErrors, SynthesizeSpeechResponse, SynthesizeSpeechResponses, TemplateGenerateRequest, TemplateInfo, TemplateInput, TemplatePage, TestToolData, TestToolError, TestToolErrors, TestToolResponse, TestToolResponses, TokenSelf, ToolCall, ToolCallPage, ToolCreate, ToolInfo, ToolPage, ToolsAssigned, ToolTestRequest, ToolTestResult, ToolUpdate, ToolWithSecret, 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, UpdateToolData, UpdateToolError, UpdateToolErrors, UpdateToolResponse, UpdateToolResponses, 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, AgentToolsUpdate, 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, CreateEndUserFactData, CreateEndUserFactError, CreateEndUserFactErrors, CreateEndUserFactResponse, CreateEndUserFactResponses, CreateEndUserResponse, CreateEndUserResponses, CreateEphemeralKeyData, CreateEphemeralKeyError, CreateEphemeralKeyErrors, CreateEphemeralKeyResponse, CreateEphemeralKeyResponses, CreateFactData, CreateFactError, CreateFactErrors, CreateFactResponse, CreateFactResponses, 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, CreateToolData, CreateToolError, CreateToolErrors, CreateToolResponse, CreateToolResponses, 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, DeleteEndUserFactData, DeleteEndUserFactError, DeleteEndUserFactErrors, DeleteEndUserFactResponse, DeleteEndUserFactResponses, DeleteEndUserResponse, DeleteEndUserResponses, DeleteFactData, DeleteFactError, DeleteFactErrors, DeleteFactResponse, DeleteFactResponses, DeleteKnowledgeData, DeleteKnowledgeError, DeleteKnowledgeErrors, DeleteKnowledgeResponse, DeleteKnowledgeResponses, DeleteSessionData, DeleteSessionError, DeleteSessionErrors, DeleteSessionResponse, DeleteSessionResponses, DeleteToolData, DeleteToolError, DeleteToolErrors, DeleteToolResponse, DeleteToolResponses, 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, FactCreateRequest, FactInfo, FactPage, FactsDeleted, FactUpdateRequest, 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, GetPlatformLimitsData, GetPlatformLimitsResponse, GetPlatformLimitsResponses, GetSessionData, GetSessionError, GetSessionErrors, GetSessionResponse, GetSessionResponses, GetSkyboxData, GetSkyboxError, GetSkyboxErrors, GetSkyboxResponse, GetSkyboxResponses, GetTemplateData, GetTemplateError, GetTemplateErrors, GetTemplateFileData, GetTemplateFileError, GetTemplateFileErrors, GetTemplateFileResponses, GetTemplateResponse, GetTemplateResponses, GetTokenData, GetTokenError, GetTokenErrors, GetTokenResponse, GetTokenResponses, GetToolData, GetToolError, GetToolErrors, GetToolResponse, GetToolResponses, 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, ListAgentToolsData, ListAgentToolsError, ListAgentToolsErrors, ListAgentToolsResponse, ListAgentToolsResponses, ListAssetFoldersData, ListAssetFoldersError, ListAssetFoldersErrors, ListAssetFoldersResponse, ListAssetFoldersResponses, ListAssetsData, ListAssetsError, ListAssetsErrors, ListAssetsResponse, ListAssetsResponses, ListEndUserFactsData, ListEndUserFactsError, ListEndUserFactsErrors, ListEndUserFactsResponse, ListEndUserFactsResponses, 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, ListToolCallsData, ListToolCallsError, ListToolCallsErrors, ListToolCallsResponse, ListToolCallsResponses, ListToolsData, ListToolsError, ListToolsErrors, ListToolsResponse, ListToolsResponses, ListVoicesData, ListVoicesError, ListVoicesErrors, ListVoicesResponse, ListVoicesResponses, MessageInfo, MessageKnowledge, MessagePage, MessageSource, MessageToolCall, MoveAssetsData, MoveAssetsError, MoveAssetsErrors, MoveAssetsResponse, MoveAssetsResponses, OrgPlan, PlatformLimit, PlatformLimitPage, 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, RotateToolSecretData, RotateToolSecretError, RotateToolSecretErrors, RotateToolSecretResponse, RotateToolSecretResponses, SaveDesignedVoiceData, SaveDesignedVoiceError, SaveDesignedVoiceErrors, SaveDesignedVoiceResponse, SaveDesignedVoiceResponses, SearchKnowledgeData, SearchKnowledgeError, SearchKnowledgeErrors, SearchKnowledgeResponse, SearchKnowledgeResponses, SessionCreateRequest, SessionDetail, SessionInfo, SessionPage, SetAgentKnowledgeData, SetAgentKnowledgeError, SetAgentKnowledgeErrors, SetAgentKnowledgeResponse, SetAgentKnowledgeResponses, SetAgentToolsData, SetAgentToolsError, SetAgentToolsErrors, SetAgentToolsResponse, SetAgentToolsResponses, SetKnowledgeAgentsData, SetKnowledgeAgentsError, SetKnowledgeAgentsErrors, SetKnowledgeAgentsResponse, SetKnowledgeAgentsResponses, SkyboxFile, SkyboxRequest, SkyboxStyle, SkyboxStylePage, SpeechProvider, StreamDone, StreamError, StreamSegment, StreamTranscript, SynthesizeSpeechData, SynthesizeSpeechError, SynthesizeSpeechErrors, SynthesizeSpeechResponse, SynthesizeSpeechResponses, TemplateGenerateRequest, TemplateInfo, TemplateInput, TemplatePage, TestToolData, TestToolError, TestToolErrors, TestToolResponse, TestToolResponses, TokenSelf, ToolCall, ToolCallPage, ToolCreate, ToolInfo, ToolPage, ToolsAssigned, ToolTestRequest, ToolTestResult, ToolUpdate, ToolWithSecret, 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, UpdateEndUserFactData, UpdateEndUserFactError, UpdateEndUserFactErrors, UpdateEndUserFactResponse, UpdateEndUserFactResponses, UpdateEndUserResponse, UpdateEndUserResponses, UpdateFactData, UpdateFactError, UpdateFactErrors, UpdateFactResponse, UpdateFactResponses, UpdateKnowledgeData, UpdateKnowledgeError, UpdateKnowledgeErrors, UpdateKnowledgeResponse, UpdateKnowledgeResponses, UpdateToolData, UpdateToolError, UpdateToolErrors, UpdateToolResponse, UpdateToolResponses, 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

@@ -38,6 +38,35 @@ export type ValidationIssue = {
     field: string | null;
     message: string;
 };
+export type PlatformLimitPage = {
+    data: Array<PlatformLimit>;
+    /**
+     * Pass as `cursor` for the next page; `null` when this is the last.
+     */
+    next_cursor: string | null;
+};
+export type PlatformLimit = {
+    /**
+     * The limit's name, which this reference's descriptions use for it.
+     */
+    key: string;
+    /**
+     * What it limits, in words.
+     */
+    label: string;
+    /**
+     * The limit in force now, in `unit`.
+     */
+    value: number | string | boolean;
+    /**
+     * What `value` counts; null for a plain count. `credits` are whole credits, not micro-credits.
+     */
+    unit: 'ms' | 'seconds' | 'minutes' | 'hours' | 'days' | 'bytes' | 'credits' | null;
+    /**
+     * The platform's built-in value, which `value` may differ from.
+     */
+    default: number | string | boolean;
+};
 export type TemplateInput = {
     /**
      * What to name it in `inputs` when generating.
@@ -1181,7 +1210,7 @@ export type MessageToolCall = {
         [key: string]: unknown;
     };
     /**
-     * What it answered, as the model read it — its JSON, or its text, cut at 16 KB. Null when it answered nothing.
+     * What it answered, as the model read it — its JSON, or its text, cut at the platform's `agents.tools.result_max_bytes` (`GET /v1/platform/limits`). Null when it answered nothing.
      */
     result?: unknown;
     /**
@@ -1270,7 +1299,7 @@ export type SessionCreateRequest = {
     /**
      * Whether to continue this person's most recent conversation with this agent instead of starting a new one.
      *
-     * **Unset is the useful default**: it resumes when this person has a conversation with this agent from the last 7 days to continue, and starts a new one otherwise. That matches what 'open a conversation with this person' usually means, and it stops an integration that opens a session per page load from scattering somebody's history across a dozen fragments.
+     * **Unset is the useful default**: it resumes when this person has a conversation with this agent young enough to continue — within the organisation's `resume_max_age_days`, else the platform's `agents.sessions.resume_max_age_days` (`GET /v1/platform/limits`) — and starts a new one otherwise. That matches what 'open a conversation with this person' usually means, and it stops an integration that opens a session per page load from scattering somebody's history across a dozen fragments.
      *
      * `false` always starts a new conversation — this is what a 'new chat' button should send. `true` is the same as leaving it unset; it exists so the intent can be stated rather than implied.
      *
@@ -1348,14 +1377,50 @@ export type FactInfo = {
      * Which agent was being talked to when this was learned.
      */
     agent_id: string | null;
+    /**
+     * When a conversation last said it again; `null` for never. The agents see the most recently confirmed first when not every fact fits.
+     */
+    confirmed_at: string | null;
     created_at: string;
     id: string;
+    /**
+     * When a later conversation replaced or removed it; `null` while it stands. Listed only with `include_replaced=true`.
+     */
+    replaced_at: string | null;
+    /**
+     * The fact that replaced it — moved city, changed job — or `null` when it was removed with nothing in its place, or stands.
+     */
+    replaced_by: string | null;
+    /**
+     * `person`: recalled by every agent of yours that shares its facts. `agent`: kept to one agent (`agent_id`), which alone recalls it — learnt by an agent whose `facts_scope` is `agent`, or added for that agent.
+     */
+    scope: 'person' | 'agent';
+    /**
+     * `conversation`: a reading learnt it. `customer`: you added or corrected it — a later conversation never replaces or removes it.
+     */
+    source: 'conversation' | 'customer';
     text: string;
     /**
-     * A fact is never edited, only learned or forgotten: the same as `created_at`.
+     * When it last changed: its `replaced_at` once replaced, else when you last corrected it, else its `created_at`.
      */
     updated_at: string;
 };
+export type FactCreateRequest = {
+    /**
+     * What to remember about the person, as one plain statement: "Prefers to be called Sam." At most 500 characters. Never a secret — a password, a code, a card, account or identity number, or a key is refused, since facts are sent to the model on every turn.
+     */
+    text: string;
+    /**
+     * Keep it to one agent: only that agent recalls it. Unset or `null`: every agent of yours that shares its facts — and the ones that keep their own, too.
+     */
+    agent_id?: string | null;
+};
+export type FactUpdateRequest = {
+    /**
+     * What to remember about the person, as one plain statement: "Prefers to be called Sam." At most 500 characters. Never a secret — a password, a code, a card, account or identity number, or a key is refused, since facts are sent to the model on every turn.
+     */
+    text: string;
+};
 export type FactsDeleted = {
     /**
      * How many stored facts were deleted.
@@ -1427,6 +1492,18 @@ export type AgentSummary = {
      * What counts as worth remembering. Unset falls back to the organisation's default, then to a built-in instruction.
      */
     fact_instruction: string | null;
+    /**
+     * Whether this agent remembers facts about the people it talks to. **On by default**, unlike most switches here.
+     *
+     * Off, its conversations are never read for facts and its turns recall none — nothing is charged for either — and a compaction extracts nothing whatever it is asked. Facts already stored stay, and other agents still recall the ones they share. Turning it back on reads only what is said from then on.
+     */
+    facts_enabled: boolean;
+    /**
+     * Whose facts this agent sees and adds to. `person` (the default, and what unset means): what any of your agents learnt about the person that shares. `agent`: its own only — what it learns is not recalled by your other agents, and it does not recall theirs.
+     *
+     * A change applies to what it learns from then on: a fact keeps the scope it was learnt under.
+     */
+    facts_scope: 'person' | 'agent' | null;
     /**
      * The agent's opening line — or, with `first_message_generated` on, the direction for one.
      *
@@ -1466,15 +1543,15 @@ export type AgentSummary = {
      */
     knowledge_lookup_first: boolean | null;
     /**
-     * Pieces of material a lookup hands the model, 1-8. Unset is 4.
+     * Pieces of material a lookup hands the model, 1-8. Unset is the platform's `agents.knowledge.default_results` (`GET /v1/platform/limits`).
      */
     knowledge_max_results: number | null;
     /**
-     * How the agent reads its knowledge. `auto` (the default, and what unset means) puts the whole text in the prompt while it fits about 8,000 tokens — no lookup, nothing to miss — and looks it up beyond that. `prompt` puts it in the prompt up to about 32,000 tokens (each turn's first word is slower the more there is). `lookup` always looks it up.
+     * How the agent reads its knowledge. `auto` (the default, and what unset means) puts the whole text in the prompt while it fits the platform's `agents.knowledge.inline_budget_tokens` — no lookup, nothing to miss — and looks it up beyond that. `prompt` puts it in the prompt up to the platform's `agents.knowledge.prompt_cap_tokens` (each turn's first word is slower the more there is). `lookup` always looks it up. Both are on `GET /v1/platform/limits`.
      */
     knowledge_mode: 'auto' | 'prompt' | 'lookup' | null;
     /**
-     * How many recalled facts are put in front of the model when a session opens. They are prompt tokens on every turn.
+     * The most of the person's facts put in front of the model, 1-100. Unset is as many as fit in the platform's `agents.memory.recall.budget_chars` (`GET /v1/platform/limits`; 6,000 characters is some 1,500 tokens). When they do not all fit, the ones a conversation confirmed or learnt most recently go in. They are prompt tokens on every turn.
      */
     max_facts: number | null;
     /**
@@ -1670,6 +1747,18 @@ export type AgentInfo = {
      * What counts as worth remembering. Unset falls back to the organisation's default, then to a built-in instruction.
      */
     fact_instruction: string | null;
+    /**
+     * Whether this agent remembers facts about the people it talks to. **On by default**, unlike most switches here.
+     *
+     * Off, its conversations are never read for facts and its turns recall none — nothing is charged for either — and a compaction extracts nothing whatever it is asked. Facts already stored stay, and other agents still recall the ones they share. Turning it back on reads only what is said from then on.
+     */
+    facts_enabled: boolean;
+    /**
+     * Whose facts this agent sees and adds to. `person` (the default, and what unset means): what any of your agents learnt about the person that shares. `agent`: its own only — what it learns is not recalled by your other agents, and it does not recall theirs.
+     *
+     * A change applies to what it learns from then on: a fact keeps the scope it was learnt under.
+     */
+    facts_scope: 'person' | 'agent' | null;
     /**
      * The agent's opening line — or, with `first_message_generated` on, the direction for one.
      *
@@ -1709,15 +1798,15 @@ export type AgentInfo = {
      */
     knowledge_lookup_first: boolean | null;
     /**
-     * Pieces of material a lookup hands the model, 1-8. Unset is 4.
+     * Pieces of material a lookup hands the model, 1-8. Unset is the platform's `agents.knowledge.default_results` (`GET /v1/platform/limits`).
      */
     knowledge_max_results: number | null;
     /**
-     * How the agent reads its knowledge. `auto` (the default, and what unset means) puts the whole text in the prompt while it fits about 8,000 tokens — no lookup, nothing to miss — and looks it up beyond that. `prompt` puts it in the prompt up to about 32,000 tokens (each turn's first word is slower the more there is). `lookup` always looks it up.
+     * How the agent reads its knowledge. `auto` (the default, and what unset means) puts the whole text in the prompt while it fits the platform's `agents.knowledge.inline_budget_tokens` — no lookup, nothing to miss — and looks it up beyond that. `prompt` puts it in the prompt up to the platform's `agents.knowledge.prompt_cap_tokens` (each turn's first word is slower the more there is). `lookup` always looks it up. Both are on `GET /v1/platform/limits`.
      */
     knowledge_mode: 'auto' | 'prompt' | 'lookup' | null;
     /**
-     * How many recalled facts are put in front of the model when a session opens. They are prompt tokens on every turn.
+     * The most of the person's facts put in front of the model, 1-100. Unset is as many as fit in the platform's `agents.memory.recall.budget_chars` (`GET /v1/platform/limits`; 6,000 characters is some 1,500 tokens). When they do not all fit, the ones a conversation confirmed or learnt most recently go in. They are prompt tokens on every turn.
      */
     max_facts: number | null;
     /**
@@ -1855,6 +1944,18 @@ export type AgentCreateRequest = {
      * What counts as worth remembering. Unset falls back to the organisation's default, then to a built-in instruction.
      */
     fact_instruction?: string | null;
+    /**
+     * Whether this agent remembers facts about the people it talks to. **On by default**, unlike most switches here.
+     *
+     * Off, its conversations are never read for facts and its turns recall none — nothing is charged for either — and a compaction extracts nothing whatever it is asked. Facts already stored stay, and other agents still recall the ones they share. Turning it back on reads only what is said from then on.
+     */
+    facts_enabled?: boolean | null;
+    /**
+     * Whose facts this agent sees and adds to. `person` (the default, and what unset means): what any of your agents learnt about the person that shares. `agent`: its own only — what it learns is not recalled by your other agents, and it does not recall theirs.
+     *
+     * A change applies to what it learns from then on: a fact keeps the scope it was learnt under.
+     */
+    facts_scope?: 'person' | 'agent' | null;
     /**
      * The agent's opening line — or, with `first_message_generated` on, the direction for one.
      *
@@ -1894,15 +1995,15 @@ export type AgentCreateRequest = {
      */
     knowledge_lookup_first?: boolean | null;
     /**
-     * Pieces of material a lookup hands the model, 1-8. Unset is 4.
+     * Pieces of material a lookup hands the model, 1-8. Unset is the platform's `agents.knowledge.default_results` (`GET /v1/platform/limits`).
      */
     knowledge_max_results?: number | null;
     /**
-     * How the agent reads its knowledge. `auto` (the default, and what unset means) puts the whole text in the prompt while it fits about 8,000 tokens — no lookup, nothing to miss — and looks it up beyond that. `prompt` puts it in the prompt up to about 32,000 tokens (each turn's first word is slower the more there is). `lookup` always looks it up.
+     * How the agent reads its knowledge. `auto` (the default, and what unset means) puts the whole text in the prompt while it fits the platform's `agents.knowledge.inline_budget_tokens` — no lookup, nothing to miss — and looks it up beyond that. `prompt` puts it in the prompt up to the platform's `agents.knowledge.prompt_cap_tokens` (each turn's first word is slower the more there is). `lookup` always looks it up. Both are on `GET /v1/platform/limits`.
      */
     knowledge_mode?: 'auto' | 'prompt' | 'lookup' | null;
     /**
-     * How many recalled facts are put in front of the model when a session opens. They are prompt tokens on every turn.
+     * The most of the person's facts put in front of the model, 1-100. Unset is as many as fit in the platform's `agents.memory.recall.budget_chars` (`GET /v1/platform/limits`; 6,000 characters is some 1,500 tokens). When they do not all fit, the ones a conversation confirmed or learnt most recently go in. They are prompt tokens on every turn.
      */
     max_facts?: number | null;
     /**
@@ -1910,7 +2011,7 @@ export type AgentCreateRequest = {
      */
     max_output_tokens?: number | null;
     /**
-     * Gemini model id. Defaults to `gemini-3.1-flash-lite`.
+     * Gemini model id. Defaults to the platform's `agents.model` (`GET /v1/platform/limits`).
      */
     model?: string | null;
     /**
@@ -2054,7 +2155,7 @@ export type AgentSettingsInfo = {
      *
      * A conversation continued inside this window gets no fresh opening line, because re-greeting somebody who refreshed the page thirty seconds ago is worse than silence — and costs a model call and a speech call to be worse. Continued outside it, the agent says hello again, which is what a `first_message` direction reading "say hello and catch up with them" is asking for.
      *
-     * **Zero means always greet**, on every connection. Clear it (`null`) and the platform default applies, which is 15 minutes.
+     * **Zero means always greet**, on every connection. Clear it (`null`) and the platform's `agents.greeting.resume_after_minutes` applies (`GET /v1/platform/limits`).
      *
      * Organisation-wide: every agent here uses it. It is read when a socket connects, so a change reaches the next connection rather than the ones already open.
      */
@@ -2064,7 +2165,7 @@ export type AgentSettingsInfo = {
      *
      * Applies to `POST /v1/agent/sessions` when it resumes — see `resume` on that request. Past this, opening a session starts a fresh conversation instead. Nothing is lost at the boundary: durable facts and the standing relationship belong to the person rather than the conversation, and carry into every new one.
      *
-     * **Zero means never resume** — every session is a new conversation, which is what an integration that treats a visit as a conversation wants. Clear it (`null`) and the platform default applies, which is 7 days.
+     * **Zero means never resume** — every session is a new conversation, which is what an integration that treats a visit as a conversation wants. Clear it (`null`) and the platform's `agents.sessions.resume_max_age_days` applies (`GET /v1/platform/limits`).
      */
     resume_max_age_days: number | null;
     /**
@@ -2072,7 +2173,7 @@ export type AgentSettingsInfo = {
      */
     built_in_compact_instruction: string;
     /**
-     * The built-in mood-reporting instruction, served from the running constant so the console never shows a stale copy of it.
+     * The platform's mood-reporting instruction, served as it stands so the console never shows a stale copy of it.
      */
     built_in_emotion_instruction: string;
     /**
@@ -2080,7 +2181,7 @@ export type AgentSettingsInfo = {
      */
     built_in_fact_instruction: string;
     /**
-     * The built-in relationship instruction, served from the running constant so the console never shows a stale copy of it.
+     * The platform's relationship instruction, served as it stands so the console never shows a stale copy of it.
      */
     built_in_relation_instruction: string;
     /**
@@ -2114,7 +2215,7 @@ export type AgentSettingsUpdate = {
      *
      * A conversation continued inside this window gets no fresh opening line, because re-greeting somebody who refreshed the page thirty seconds ago is worse than silence — and costs a model call and a speech call to be worse. Continued outside it, the agent says hello again, which is what a `first_message` direction reading "say hello and catch up with them" is asking for.
      *
-     * **Zero means always greet**, on every connection. Clear it (`null`) and the platform default applies, which is 15 minutes.
+     * **Zero means always greet**, on every connection. Clear it (`null`) and the platform's `agents.greeting.resume_after_minutes` applies (`GET /v1/platform/limits`).
      *
      * Organisation-wide: every agent here uses it. It is read when a socket connects, so a change reaches the next connection rather than the ones already open.
      */
@@ -2124,7 +2225,7 @@ export type AgentSettingsUpdate = {
      *
      * Applies to `POST /v1/agent/sessions` when it resumes — see `resume` on that request. Past this, opening a session starts a fresh conversation instead. Nothing is lost at the boundary: durable facts and the standing relationship belong to the person rather than the conversation, and carry into every new one.
      *
-     * **Zero means never resume** — every session is a new conversation, which is what an integration that treats a visit as a conversation wants. Clear it (`null`) and the platform default applies, which is 7 days.
+     * **Zero means never resume** — every session is a new conversation, which is what an integration that treats a visit as a conversation wants. Clear it (`null`) and the platform's `agents.sessions.resume_max_age_days` applies (`GET /v1/platform/limits`).
      */
     resume_max_age_days?: number | null;
 };
@@ -2179,6 +2280,18 @@ export type AgentUpdate = {
      * What counts as worth remembering. Unset falls back to the organisation's default, then to a built-in instruction.
      */
     fact_instruction?: string | null;
+    /**
+     * Whether this agent remembers facts about the people it talks to. **On by default**, unlike most switches here.
+     *
+     * Off, its conversations are never read for facts and its turns recall none — nothing is charged for either — and a compaction extracts nothing whatever it is asked. Facts already stored stay, and other agents still recall the ones they share. Turning it back on reads only what is said from then on.
+     */
+    facts_enabled?: boolean | null;
+    /**
+     * Whose facts this agent sees and adds to. `person` (the default, and what unset means): what any of your agents learnt about the person that shares. `agent`: its own only — what it learns is not recalled by your other agents, and it does not recall theirs.
+     *
+     * A change applies to what it learns from then on: a fact keeps the scope it was learnt under.
+     */
+    facts_scope?: 'person' | 'agent' | null;
     /**
      * The agent's opening line — or, with `first_message_generated` on, the direction for one.
      *
@@ -2218,15 +2331,15 @@ export type AgentUpdate = {
      */
     knowledge_lookup_first?: boolean | null;
     /**
-     * Pieces of material a lookup hands the model, 1-8. Unset is 4.
+     * Pieces of material a lookup hands the model, 1-8. Unset is the platform's `agents.knowledge.default_results` (`GET /v1/platform/limits`).
      */
     knowledge_max_results?: number | null;
     /**
-     * How the agent reads its knowledge. `auto` (the default, and what unset means) puts the whole text in the prompt while it fits about 8,000 tokens — no lookup, nothing to miss — and looks it up beyond that. `prompt` puts it in the prompt up to about 32,000 tokens (each turn's first word is slower the more there is). `lookup` always looks it up.
+     * How the agent reads its knowledge. `auto` (the default, and what unset means) puts the whole text in the prompt while it fits the platform's `agents.knowledge.inline_budget_tokens` — no lookup, nothing to miss — and looks it up beyond that. `prompt` puts it in the prompt up to the platform's `agents.knowledge.prompt_cap_tokens` (each turn's first word is slower the more there is). `lookup` always looks it up. Both are on `GET /v1/platform/limits`.
      */
     knowledge_mode?: 'auto' | 'prompt' | 'lookup' | null;
     /**
-     * How many recalled facts are put in front of the model when a session opens. They are prompt tokens on every turn.
+     * The most of the person's facts put in front of the model, 1-100. Unset is as many as fit in the platform's `agents.memory.recall.budget_chars` (`GET /v1/platform/limits`; 6,000 characters is some 1,500 tokens). When they do not all fit, the ones a conversation confirmed or learnt most recently go in. They are prompt tokens on every turn.
      */
     max_facts?: number | null;
     /**
@@ -2234,7 +2347,7 @@ export type AgentUpdate = {
      */
     max_output_tokens?: number | null;
     /**
-     * Gemini model id. `null` or empty returns it to the default, `gemini-3.1-flash-lite`.
+     * Gemini model id. `null` or empty returns it to the default, the platform's `agents.model` (`GET /v1/platform/limits`).
      */
     model?: string | null;
     /**
@@ -2456,7 +2569,7 @@ export type KnowledgeSearchResult = {
 export type KnowledgeSearchHit = {
     entry_id: string;
     /**
-     * Cosine similarity, 0-1. Nothing under 0.6 is handed over.
+     * Cosine similarity, 0-1. Nothing under the platform's `agents.knowledge.min_score` (`GET /v1/platform/limits`) is handed over.
      */
     score: number;
     /**
@@ -2740,7 +2853,7 @@ export type ToolInfo = {
     created_at: string;
     updated_at: string;
     /**
-     * Its failed calls in your agents' conversations in the past hour or so — a deadline missed, an error answered, a server out of reach — counted from the first; 0 once an hour passes with none. Each conversation reports its failures at most every five minutes, so the count can lag by that much. At 20 in an hour, your organisation's admins are mailed, at most once a day per tool.
+     * Its failed calls in your agents' conversations within the platform's `agents.tools.failure_window_minutes` — a deadline missed, an error answered, a server out of reach — counted from the first; 0 once the window passes with none. Each conversation reports its failures at most once in the platform's `agents.tools.report_every_minutes`, so the count can lag by that much. At the platform's `agents.tools.failures_to_mail` in the window, your organisation's admins are mailed, at most once in its `agents.tools.mail_every_hours` per tool. Each is on `GET /v1/platform/limits`.
      */
     recent_failures: number;
     /**
@@ -2899,11 +3012,11 @@ export type ToolTestResult = {
      */
     duration_ms: number;
     /**
-     * Its answer: the JSON it sent, else its text, cut at 16384 bytes; `null` for none.
+     * Its answer: the JSON it sent, else its text, cut at the platform's `agents.tools.result_max_bytes` (`GET /v1/platform/limits`); `null` for none.
      */
     result?: unknown;
     /**
-     * The answer was longer than 16384 bytes and was cut.
+     * The answer was longer than the platform's `agents.tools.result_max_bytes` and was cut.
      */
     truncated: boolean;
     /**
@@ -2929,7 +3042,7 @@ export type ToolsAssigned = {
 };
 export type AgentToolsUpdate = {
     /**
-     * The complete set, at most 20. An empty list turns every tool off.
+     * The complete set, at most the platform's `limits.agent.tools` (`GET /v1/platform/limits`). An empty list turns every tool off.
      */
     tool_ids: Array<string>;
 };
@@ -3247,6 +3360,19 @@ export type GetHealthResponses = {
     200: HealthResponse;
 };
 export type GetHealthResponse = GetHealthResponses[keyof GetHealthResponses];
+export type GetPlatformLimitsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/platform/limits';
+};
+export type GetPlatformLimitsResponses = {
+    /**
+     * Every limit, as it stands now
+     */
+    200: PlatformLimitPage;
+};
+export type GetPlatformLimitsResponse = GetPlatformLimitsResponses[keyof GetPlatformLimitsResponses];
 export type GetEphemeralKeyLimitsData = {
     body?: never;
     path?: never;
@@ -4356,7 +4482,7 @@ export type CreateAssetUploadUrlErrors = {
      */
     403: ErrorResponse;
     /**
-     * The library holds as many files as the plan allows
+     * The library holds the platform's `limits.org.asset_uploads` uploaded files
      */
     409: ErrorResponse;
     /**
@@ -5156,6 +5282,10 @@ 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;
+        /**
+         * Also list the facts a later conversation replaced or removed, until they are deleted, the platform's `agents.memory.facts.replaced_kept_days` later (`GET /v1/platform/limits`).
+         */
+        include_replaced?: boolean;
         /**
          * How many to answer, 1 to 200.
          */
@@ -5193,6 +5323,46 @@ export type ListFactsResponses = {
     200: FactPage;
 };
 export type ListFactsResponse = ListFactsResponses[keyof ListFactsResponses];
+export type CreateFactData = {
+    body: FactCreateRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/agent/facts';
+};
+export type CreateFactErrors = {
+    /**
+     * The request could not be read: malformed JSON
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid credentials
+     */
+    401: ErrorResponse;
+    /**
+     * The key's scopes do not cover this, or it is pinned to agents and `agent_id` names another
+     */
+    403: ErrorResponse;
+    /**
+     * No text, or text that looks like a secret — a password, a code, a card, account or identity number, or a key — which no fact may hold
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+};
+export type CreateFactError = CreateFactErrors[keyof CreateFactErrors];
+export type CreateFactResponses = {
+    /**
+     * The fact that already said it, now yours
+     */
+    200: FactInfo;
+    /**
+     * The fact, remembered
+     */
+    201: FactInfo;
+};
+export type CreateFactResponse = CreateFactResponses[keyof CreateFactResponses];
 export type DeleteFactData = {
     body?: never;
     path: {
@@ -5231,6 +5401,52 @@ export type DeleteFactResponses = {
     204: void;
 };
 export type DeleteFactResponse = DeleteFactResponses[keyof DeleteFactResponses];
+export type UpdateFactData = {
+    body: FactUpdateRequest;
+    path: {
+        fact_id: string;
+    };
+    query?: never;
+    url: '/v1/agent/facts/{fact_id}';
+};
+export type UpdateFactErrors = {
+    /**
+     * 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
+     */
+    403: ErrorResponse;
+    /**
+     * Unknown fact id
+     */
+    404: ErrorResponse;
+    /**
+     * Replaced by a later conversation, or another fact already says that
+     */
+    409: ErrorResponse;
+    /**
+     * No text, or text that looks like a secret — a password, a code, a card, account or identity number, or a key — which no fact may hold
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+};
+export type UpdateFactError = UpdateFactErrors[keyof UpdateFactErrors];
+export type UpdateFactResponses = {
+    /**
+     * The fact, corrected
+     */
+    200: FactInfo;
+};
+export type UpdateFactResponse = UpdateFactResponses[keyof UpdateFactResponses];
 export type ListRelationsData = {
     body?: never;
     path?: never;
@@ -5757,6 +5973,189 @@ export type UpdateEndUserResponses = {
     200: EndUserInfo;
 };
 export type UpdateEndUserResponse = UpdateEndUserResponses[keyof UpdateEndUserResponses];
+export type ListEndUserFactsData = {
+    body?: never;
+    path: {
+        end_user_id: string;
+    };
+    query?: {
+        /**
+         * Also list the facts a later conversation replaced or removed, until they are deleted, the platform's `agents.memory.facts.replaced_kept_days` later (`GET /v1/platform/limits`).
+         */
+        include_replaced?: boolean;
+        /**
+         * How many to answer, 1 to 200.
+         */
+        limit?: number;
+        /**
+         * The `next_cursor` of the page before.
+         */
+        cursor?: string;
+    };
+    url: '/v1/end-users/{end_user_id}/facts';
+};
+export type ListEndUserFactsErrors = {
+    /**
+     * 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 end user id
+     */
+    404: ErrorResponse;
+    /**
+     * The request failed validation
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+};
+export type ListEndUserFactsError = ListEndUserFactsErrors[keyof ListEndUserFactsErrors];
+export type ListEndUserFactsResponses = {
+    /**
+     * One page of what is remembered, oldest first
+     */
+    200: FactPage;
+};
+export type ListEndUserFactsResponse = ListEndUserFactsResponses[keyof ListEndUserFactsResponses];
+export type CreateEndUserFactData = {
+    body: FactCreateRequest;
+    path: {
+        end_user_id: string;
+    };
+    query?: never;
+    url: '/v1/end-users/{end_user_id}/facts';
+};
+export type CreateEndUserFactErrors = {
+    /**
+     * 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 end user id
+     */
+    404: ErrorResponse;
+    /**
+     * No text, or text that looks like a secret — a password, a code, a card, account or identity number, or a key — which no fact may hold
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+};
+export type CreateEndUserFactError = CreateEndUserFactErrors[keyof CreateEndUserFactErrors];
+export type CreateEndUserFactResponses = {
+    /**
+     * The fact that already said it, now yours
+     */
+    200: FactInfo;
+    /**
+     * The fact, remembered
+     */
+    201: FactInfo;
+};
+export type CreateEndUserFactResponse = CreateEndUserFactResponses[keyof CreateEndUserFactResponses];
+export type DeleteEndUserFactData = {
+    body?: never;
+    path: {
+        end_user_id: string;
+        fact_id: string;
+    };
+    query?: never;
+    url: '/v1/end-users/{end_user_id}/facts/{fact_id}';
+};
+export type DeleteEndUserFactErrors = {
+    /**
+     * 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 end user id, or Unknown fact id
+     */
+    404: ErrorResponse;
+    /**
+     * The request failed validation
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+};
+export type DeleteEndUserFactError = DeleteEndUserFactErrors[keyof DeleteEndUserFactErrors];
+export type DeleteEndUserFactResponses = {
+    /**
+     * The fact is gone
+     */
+    204: void;
+};
+export type DeleteEndUserFactResponse = DeleteEndUserFactResponses[keyof DeleteEndUserFactResponses];
+export type UpdateEndUserFactData = {
+    body: FactUpdateRequest;
+    path: {
+        end_user_id: string;
+        fact_id: string;
+    };
+    query?: never;
+    url: '/v1/end-users/{end_user_id}/facts/{fact_id}';
+};
+export type UpdateEndUserFactErrors = {
+    /**
+     * 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 end user id, or Unknown fact id
+     */
+    404: ErrorResponse;
+    /**
+     * Replaced by a later conversation, or another fact already says that
+     */
+    409: ErrorResponse;
+    /**
+     * No text, or text that looks like a secret — a password, a code, a card, account or identity number, or a key — which no fact may hold
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+};
+export type UpdateEndUserFactError = UpdateEndUserFactErrors[keyof UpdateEndUserFactErrors];
+export type UpdateEndUserFactResponses = {
+    /**
+     * The fact, corrected
+     */
+    200: FactInfo;
+};
+export type UpdateEndUserFactResponse = UpdateEndUserFactResponses[keyof UpdateEndUserFactResponses];
 export type ListKnowledgeCategoriesData = {
     body?: never;
     path?: never;
@@ -6522,7 +6921,7 @@ export type CreateToolErrors = {
      */
     403: ErrorResponse;
     /**
-     * A tool by that name exists already, or the library holds 200 tools.
+     * A tool by that name exists already, or the library holds the platform's `limits.org.tools`.
      */
     409: ErrorResponse;
     /**
@@ -7135,7 +7534,7 @@ export type CreateVoiceUploadUrlErrors = {
      */
     403: ErrorResponse;
     /**
-     * The organisation already has as many voices as its plan allows, or the provider's account has no room for another. Delete one, or ask for a higher limit.
+     * The organisation already has as many voices as its plan allows — never more than the platform's `limits.org.voices` (`GET /v1/platform/limits`) — or the provider's account has no room for another. Delete one, or ask for a higher limit.
      */
     409: ErrorResponse;
     /**
@@ -7231,7 +7630,7 @@ export type SaveDesignedVoiceErrors = {
      */
     403: ErrorResponse;
     /**
-     * The organisation already has as many voices as its plan allows, or the provider's account has no room for another. Delete one, or ask for a higher limit.
+     * The organisation already has as many voices as its plan allows — never more than the platform's `limits.org.voices` (`GET /v1/platform/limits`) — or the provider's account has no room for another. Delete one, or ask for a higher limit.
      */
     409: ErrorResponse;
     /**

package/dist/resources/agents.d.ts

@@ -32,7 +32,7 @@ export interface AgentKnowledge {
 export interface AgentTools {
     /** Every tool it can call. */
     list(agentId: string, options?: RequestOptions): AsyncGenerator<ToolInfo, void, undefined>;
-    /** Replaces them all with these, 20 at most. */
+    /** Replaces them all with these: the platform's `limits.agent.tools` at most (`limits()`). */
     set(agentId: string, body: AgentToolsUpdate, options?: RequestOptions): Promise<ToolsAssigned>;
 }
 export declare class Agents extends Library<AgentInfo, AgentUpdate, AgentSummary, AgentPage, AgentCreateRequest> {

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

@@ -22,7 +22,9 @@
  * 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 (200
- * a page), and revokes the key in `finally` — after an abort or a failure
+ * a page) — those a later conversation replaced too, which are still held
+ * until they are deleted 30 days on — 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
@@ -31,7 +33,7 @@
  * 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).
  */
-import type { EndUserCreateRequest, EndUserDeleted, EndUserInfo, EndUserPage, EndUserUpdateRequest, FactInfo, ListEndUsersData, SessionDetail } from "../gen/index.js";
+import type { EndUserCreateRequest, EndUserDeleted, EndUserInfo, EndUserPage, EndUserUpdateRequest, FactCreateRequest, FactInfo, FactUpdateRequest, ListEndUsersData, SessionDetail } from "../gen/index.js";
 import { type RequestOptions, type Transport } from "../transport.js";
 import type { EphemeralKeys } from "./ephemeral-keys.js";
 import { Editable } from "./resource.js";
@@ -57,8 +59,30 @@ export interface EndUserExport {
     /** What is remembered about them, oldest first — the newest 100 for now. */
     facts: FactInfo[];
 }
+/** A fact `facts.add` answered, and whether this call made it. */
+export type FactAdded = FactInfo & {
+    /** `true` on a 201, `false` when a fact already said it — now yours. */
+    created: boolean;
+};
+/**
+ * `endUsers.facts`: what the agents remember about one person, from your
+ * server, with no key minted for them — `/v1/end-users/{id}/facts`.
+ */
+export interface EndUserFacts {
+    /** Every fact, oldest first; `include_replaced` lists the replaced ones too. */
+    list(id: string, params?: {
+        include_replaced?: boolean;
+    }, options?: RequestOptions): AsyncGenerator<FactInfo, void, undefined>;
+    /** Tells the agents something: yours, never replaced by a conversation. */
+    add(id: string, body: FactCreateRequest, options?: RequestOptions): Promise<FactAdded>;
+    /** Corrects one fact's words; the old ones are kept as forgotten. */
+    update(id: string, factId: string, body: FactUpdateRequest, options?: RequestOptions): Promise<FactInfo>;
+    /** Forgets one: `true`, or `false` when there is none by that id. */
+    delete(id: string, factId: string, options?: RequestOptions): Promise<boolean>;
+}
 export declare class EndUsers extends Editable<EndUserInfo, EndUserUpdateRequest, EndUserInfo, EndUserDeleted | null> {
     private readonly keys;
+    readonly facts: EndUserFacts;
     constructor(api: Transport, base: string, keys: EphemeralKeys);
     /**
      * Makes a person, or finds the one your `external_id` already names.

package/dist/resources/end-users.js

@@ -22,7 +22,9 @@
  * 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 (200
- * a page), and revokes the key in `finally` — after an abort or a failure
+ * a page) — those a later conversation replaced too, which are still held
+ * until they are deleted 30 days on — 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
@@ -32,7 +34,7 @@
  * so an organisation with no balance cannot export (402).
  */
 import { pages } from "../paging.js";
-import { segment, } from "../transport.js";
+import { orNull, segment, } from "../transport.js";
 import { Editable } from "./resource.js";
 /** The routes' largest page, for end users, sessions and transcripts alike. */
 const PAGE = 200;
@@ -65,6 +67,16 @@ export class EndUsers extends Editable {
     constructor(api, base, keys) {
         super(api, base);
         this.keys = keys;
+        const fact = (id, factId) => this.at(id, `/facts/${segment(factId)}`);
+        this.facts = {
+            list: (id, params = {}, options) => this.each(this.at(id, "/facts"), params, options, PAGE),
+            add: async (id, body, options) => {
+                const answer = await this.api.request({ method: "POST", path: this.base + this.at(id, "/facts"), body }, options);
+                return { ...answer.data, created: answer.status === 201 };
+            },
+            update: (id, factId, body, options) => this.send("PATCH", fact(id, factId), options, body),
+            delete: (id, factId, options) => orNull(this.send("DELETE", fact(id, factId), options)).then((gone) => gone !== null),
+        };
     }
     /**
      * Makes a person, or finds the one your `external_id` already names.
@@ -125,7 +137,11 @@ export class EndUsers extends Editable {
                     messages: { data: held.flat(), next_cursor: null },
                 };
             });
-            const facts = await all(pages((cursor) => read("/v1/agent/facts", { limit: PAGE, cursor })));
+            const facts = await all(pages((cursor) => read("/v1/agent/facts", {
+                limit: PAGE,
+                cursor,
+                include_replaced: true,
+            })));
             return { end_user_id: key.end_user_id ?? id, sessions, facts };
         }
         finally {

package/dist/resources/tools.d.ts

@@ -2,13 +2,15 @@
  * `client.tools`: what an organisation's agents can call while they reply
  * — `/v1/tools*`. A tool is your server (`webhook`), sent a signed `POST`
  * with the call, or the person's app (`app`), called over the agent's
- * socket; each is turned on per agent (`agents.tools.set`), 20 at most.
+ * socket; each is turned on per agent (`agents.tools.set`), up to the
+ * platform's `limits.agent.tools` (`client.limits()`).
  *
  * - **`create(body)`** answers a webhook's signing secret once, as does
  *   `rotateSecret` (`secret`); every call carries `X-Tool-Signature`.
  * - **`test(id, { arguments })`** sends your server one call, signed as a
  *   real one, and answers what came back.
- * - **`list()` reads one page**: a library holds 200 tools at most.
+ * - **`list()` reads one page**: a library holds the platform's
+ *   `limits.org.tools` at most.
  * - **`calls(id, { limit })`** reads its most recent calls in your agents'
  *   conversations (100 at most), and each tool carries its
  *   `recent_failures`.

package/dist/resources/tools.js

@@ -2,13 +2,15 @@
  * `client.tools`: what an organisation's agents can call while they reply
  * — `/v1/tools*`. A tool is your server (`webhook`), sent a signed `POST`
  * with the call, or the person's app (`app`), called over the agent's
- * socket; each is turned on per agent (`agents.tools.set`), 20 at most.
+ * socket; each is turned on per agent (`agents.tools.set`), up to the
+ * platform's `limits.agent.tools` (`client.limits()`).
  *
  * - **`create(body)`** answers a webhook's signing secret once, as does
  *   `rotateSecret` (`secret`); every call carries `X-Tool-Signature`.
  * - **`test(id, { arguments })`** sends your server one call, signed as a
  *   real one, and answers what came back.
- * - **`list()` reads one page**: a library holds 200 tools at most.
+ * - **`list()` reads one page**: a library holds the platform's
+ *   `limits.org.tools` at most.
  * - **`calls(id, { limit })`** reads its most recent calls in your agents'
  *   conversations (100 at most), and each tool carries its
  *   `recent_failures`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumavox/server",
-  "version": "0.10.0",
+  "version": "0.14.1",
   "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",