@lumavox/client 0.1.1 → 0.2.0

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

@@ -5,25 +5,39 @@ export type ErrorResponse = {
     error: ErrorInfo;
 };
 export type ErrorInfo = {
+    code: ErrorCode;
     /**
-     * Machine-readable error category
-     */
-    type: string;
-    /**
-     * Human-readable explanation
+     * What went wrong, in words
      */
     message: string;
     /**
-     * Echo of X-Request-Id — include when reporting issues
+     * Echo of `X-Request-Id` — include it when reporting a problem
      */
     request_id: string;
     /**
-     * Field-level validation errors (422 only)
+     * Where the request failed validation; empty otherwise
+     */
+    issues: Array<ValidationIssue>;
+};
+/**
+ * What went wrong, for a client to switch on: one per HTTP status, except `waitlisted`, a 403 of its own. New codes may be added.
+ */
+export type ErrorCode = 'invalid_request' | 'unauthenticated' | 'insufficient_credits' | 'forbidden' | 'waitlisted' | 'not_found' | 'method_not_allowed' | 'conflict' | 'too_large' | 'validation_failed' | 'rate_limited' | 'internal' | 'provider_failed' | 'unavailable';
+export type ValidationIssue = {
+    location: 'body' | 'query' | 'path' | 'header';
+    /**
+     * The dotted path to the field (`voice_config.sample_rate`, `agent_ids.2`); `null` for the whole body.
      */
-    details?: Array<{
-        [key: string]: string;
-    }> | null;
+    field: string | null;
+    message: string;
 };
+/**
+ * A conversation, and a page of it. `messages` is the conversation so far, oldest first.
+ *
+ * **The most recent 50 by default**, not the whole transcript — a long conversation is not something a caller can be handed in one response. `messages.next_cursor` reaches the older ones: pass it as `cursor` on `GET /v1/agent/sessions/{session_id}`, whose `limit` raises or lowers the page, up to 200. It is null once the page reaches the beginning of the conversation.
+ *
+ * **`messages` is empty on a new conversation, including for an agent that has an opening line**. The opening line — generated or scripted — is the first turn on `/v1/agent/stream`, so it is written when a client connects rather than when the session is created. Opening a session makes no model call and no speech call of any kind.
+ */
 export type SessionDetail = {
     agent_id: string;
     created_at: string;
@@ -32,22 +46,10 @@ export type SessionDetail = {
      */
     end_user_id: string;
     id: string;
-    /**
-     * The conversation so far, oldest first.
-     *
-     * **The most recent 50 by default**, not the whole transcript — a long conversation is not something a caller can be handed in one response. `next_before` says whether there are older ones and how to reach them; `limit` on `GET /v1/agent/sessions/{session_id}` raises or lowers the page, up to 200.
-     *
-     * **Empty on a new conversation, including for an agent that has an opening line**. The opening line — generated or scripted — is the first turn on `/v1/agent/stream`, so it is written when a client connects rather than when the session is created. Opening a session makes no model call and no speech call of any kind.
-     */
-    messages: Array<MessageInfo>;
-    /**
-     * Pass as `before` on `GET /v1/agent/sessions/{session_id}` to read the page of **older** messages.
-     *
-     * Null when `messages` reaches the beginning of the conversation — so paging is `while (next_before) fetch(before: next_before)` and never ends on an empty page.
-     *
-     * It is a `seq`, the position of the oldest message returned, and `before` is exclusive. Positions are sparse — a conversation greeted twice has a gap — so nothing that counts rows can be substituted for it.
-     */
-    next_before?: number | null;
+    title: string | null;
+    turn_seq: number;
+    updated_at: string;
+    messages: MessagePage;
     /**
      * How this agent stands with this person, as the conversation opens.
      *
@@ -55,16 +57,20 @@ export type SessionDetail = {
      *
      * It belongs to the **person**, not the conversation, so it carries across every session with the same `end_user_id`. Here so that rendering it at conversation start needs no second call; `GET /v1/agent/relations` is still how you read it any other time, and the socket's `relation` event is how you learn it moved mid-turn — which is rare, and is the only time it changes.
      */
-    relation?: RelationInfo | null;
+    relation: RelationInfo | null;
     /**
      * True when this is a conversation that already existed rather than a new one — see `resume` on the request.
      *
      * Worth branching on: a resumed session arrives with its `messages` already populated and its `turn_seq` past zero, so a client that assumed an empty transcript will render nothing until the next turn.
      */
-    resumed?: boolean;
-    title: string | null;
-    turn_seq: number;
-    updated_at: string;
+    resumed: boolean;
+};
+export type MessagePage = {
+    data: Array<MessageInfo>;
+    /**
+     * Pass as `cursor` for the next page; `null` when this is the last.
+     */
+    next_cursor: string | null;
 };
 export type MessageInfo = {
     content: string;
@@ -73,38 +79,35 @@ export type MessageInfo = {
     /**
      * On a reply: what the agent looked up in its knowledge for it — each lookup's query, outcome and the entries it found, with their scores. Null when nothing was looked up.
      */
-    knowledge?: MessageKnowledge | null;
+    knowledge: MessageKnowledge | null;
     /**
      * How the agent said it felt when it wrote this reply, when the agent reports moods. Null on user messages, on agents with emotion off, and on any reply where the model did not report a usable one.
      */
-    mood?: string | null;
+    mood: string | null;
     /**
      * How strongly, 0 to 1. Null when the model gave a label without a number — the label is the half it gets right.
      */
-    mood_intensity?: number | null;
-    /**
-     * `user` or `assistant`.
-     */
-    role: string;
+    mood_intensity: number | null;
+    role: 'user' | 'assistant';
 };
 export type MessageKnowledge = {
-    lookups?: Array<KnowledgeLookupInfo>;
+    lookups: Array<KnowledgeLookupInfo>;
     /**
      * How the agent read its knowledge on this turn: `lookup` or `prompt`.
      */
-    mode: string;
+    mode: 'lookup' | 'prompt';
 };
 export type KnowledgeLookupInfo = {
-    hits?: Array<KnowledgeCitation>;
+    hits: Array<KnowledgeCitation>;
     /**
      * `found`, `none` (nothing relevant enough), or `failed` (the lookup itself could not be done).
      */
-    outcome: string;
+    outcome: 'found' | 'none' | 'failed';
     query: string;
     /**
      * `first` — looked up before the reply; `tool` — the model asked for it.
      */
-    via: string;
+    via: 'first' | 'tool';
 };
 export type KnowledgeCitation = {
     entry_id: string;
@@ -131,12 +134,12 @@ export type RelationInfo = {
      * The person, as `eu_...`.
      */
     end_user_id: string;
-    first_met_at?: string | null;
-    last_seen_at?: string | null;
+    first_met_at: string | null;
+    last_seen_at: string | null;
     /**
      * One line the model wrote about them. **Replaced, not appended** — it is rendered into every future prompt for this pair, so it is bounded by design.
      */
-    note?: string | null;
+    note: string | null;
     /**
      * How many times the model has recorded a change. Zero on a long history means the tool is not being called, which is the first thing to check when a relationship is not moving.
      */
@@ -150,7 +153,7 @@ export type RelationInfo = {
      *
      * Derived on every read from the axes below and never stored, so it cannot go stale. The rule is one sentence: *warmth and trust set the direction, familiarity sets how far it can go* — a first conversation caps at Acquaintances however well it went, and the ceiling rises as they talk. Dislike is not capped: an agent can take against somebody on one remark.
      */
-    tier: string;
+    tier: 'Despised' | 'Disliked' | 'Acquaintances' | 'Friends' | 'Good Friends';
     /**
      * -1 to 1, on the same scale.
      */
@@ -170,9 +173,9 @@ export type SessionCreateRequest = {
      */
     agent_id: string;
     /**
-     * Optional, and only ever the token's own end user — their id from `POST /v1/end-users`, or your own id for them.
+     * Optional, and only ever the key's own end user — their id from `POST /v1/end-users`, or your own id for them.
      *
-     * **A conversation is always the person the ephemeral token was minted for**: the token says who is talking, so this can only confirm it, and naming anybody else is a **403**. What the agent remembers about them — durable facts and the standing relationship — is theirs, and carries into every conversation with any of your agents.
+     * **A conversation is always the person the ephemeral key was minted for**: the key says who is talking, so this can only confirm it, and naming anybody else is a **403**. What the agent remembers about them — durable facts and the standing relationship — is theirs, and carries into every conversation with any of your agents.
      *
      * Set once, when the session opens. It cannot change afterwards.
      */
@@ -194,6 +197,13 @@ export type SessionCreateRequest = {
      */
     title?: string | null;
 };
+export type SessionPage = {
+    data: Array<SessionInfo>;
+    /**
+     * Pass as `cursor` for the next page; `null` when this is the last.
+     */
+    next_cursor: string | null;
+};
 export type SessionInfo = {
     agent_id: string;
     created_at: string;
@@ -214,22 +224,22 @@ export type CompactionInfo = {
     /**
      * Durable facts written to long-term memory by this call. Zero when extraction was not asked for, or when there was nothing worth keeping.
      */
-    facts_stored?: number;
-    input_tokens?: number | null;
+    facts_stored: number;
+    input_tokens: number | null;
     /**
      * What produced the summary.
      */
-    model?: string | null;
-    output_tokens?: number | null;
+    model: string | null;
+    output_tokens: number | null;
     session_id: string;
     /**
      * What the next turn will start from.
      */
     summary: string;
     /**
-     * `manual` or `automatic`.
+     * `manual` (a client asked), `automatic` (a turn reached the agent's threshold) or `idle` (the conversation went quiet and its facts were extracted).
      */
-    trigger: string;
+    trigger: 'manual' | 'automatic' | 'idle';
 };
 export type CompactRequest = {
     /**
@@ -239,61 +249,65 @@ export type CompactRequest = {
      */
     extract_facts?: boolean | null;
 };
-export type FactList = {
-    end_user_id: string;
-    facts: Array<FactInfo>;
+export type FactPage = {
+    data: Array<FactInfo>;
+    /**
+     * Pass as `cursor` for the next page; `null` when this is the last.
+     */
+    next_cursor: string | null;
 };
 export type FactInfo = {
     /**
      * Which agent was being talked to when this was learned.
      */
-    agent_id?: string | null;
-    created_at?: string | null;
+    agent_id: string | null;
+    created_at: string;
     id: string;
     text: string;
-    updated_at?: string | null;
+    /**
+     * A fact is never edited, only learned or forgotten: the same as `created_at`.
+     */
+    updated_at: string;
 };
-export type ForgottenFacts = {
-    deleted: number;
-    end_user_id: string;
+export type FactsDeleted = {
+    /**
+     * How many stored facts were deleted.
+     */
+    facts_deleted: number;
 };
-export type RelationList = {
-    relations: Array<RelationInfo>;
+export type RelationPage = {
+    data: Array<RelationInfo>;
     /**
-     * Relations matching the filter, ignoring `limit`. Larger than the list means it was truncated — this endpoint returns the most recently active first and has no cursor, so narrow by `end_user_id` rather than paging if you are looking for somebody specific.
+     * Pass as `cursor` for the next page; `null` when this is the last.
      */
-    total: number;
+    next_cursor: string | null;
 };
 export type ListSessionsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * How many to answer, 1 to 200.
+         */
         limit?: number;
-        offset?: number | null;
+        /**
+         * The `next_cursor` of the page before.
+         */
+        cursor?: string;
     };
     url: '/v1/agent/sessions';
 };
 export type ListSessionsErrors = {
     /**
-     * Validation Exception
-     */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
-    /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -304,9 +318,9 @@ export type ListSessionsErrors = {
 export type ListSessionsError = ListSessionsErrors[keyof ListSessionsErrors];
 export type ListSessionsResponses = {
     /**
-     * Conversations for this agent or end user, newest first
+     * One page of conversations, most recent first
      */
-    200: Array<SessionInfo>;
+    200: SessionPage;
 };
 export type ListSessionsResponse = ListSessionsResponses[keyof ListSessionsResponses];
 export type CreateSessionData = {
@@ -317,29 +331,23 @@ export type CreateSessionData = {
 };
 export type CreateSessionErrors = {
     /**
-     * Validation Exception
+     * The request could not be read: malformed JSON
      */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
+    400: ErrorResponse;
     /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * An ephemeral token, for an agent or person it is not bound to
+     * The key's scopes do not cover agents, or it is for another agent or person
      */
-    403: unknown;
+    403: ErrorResponse;
     /**
      * Unknown agent id
      */
-    404: unknown;
+    404: ErrorResponse;
     /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -365,29 +373,19 @@ export type DeleteSessionData = {
 };
 export type DeleteSessionErrors = {
     /**
-     * Validation Exception
-     */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
-    /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
      * Unknown session id
      */
-    404: unknown;
+    404: ErrorResponse;
     /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -400,51 +398,41 @@ export type DeleteSessionResponses = {
     /**
      * The session and its messages are gone
      */
-    200: SessionInfo;
+    204: void;
 };
 export type DeleteSessionResponse = DeleteSessionResponses[keyof DeleteSessionResponses];
-export type GetSessionDetailData = {
+export type GetSessionData = {
     body?: never;
     path: {
         session_id: string;
     };
     query?: {
         /**
-         * How many messages to return, counting back from the newest. The page itself is ordered oldest-first regardless.
+         * How many messages, counting back from the newest, 1 to 200. The page itself is oldest first.
          */
         limit?: number;
         /**
-         * Return only messages before this `seq`, exclusive. Take it from the previous response's `next_before`.
+         * `messages.next_cursor` of the page before, for the older messages.
          */
-        before?: number | null;
+        cursor?: string;
     };
     url: '/v1/agent/sessions/{session_id}';
 };
-export type GetSessionDetailErrors = {
+export type GetSessionErrors = {
     /**
-     * Validation Exception
-     */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
-    /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
      * Unknown session id
      */
-    404: unknown;
+    404: ErrorResponse;
     /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -452,15 +440,15 @@ export type GetSessionDetailErrors = {
      */
     429: ErrorResponse;
 };
-export type GetSessionDetailError = GetSessionDetailErrors[keyof GetSessionDetailErrors];
-export type GetSessionDetailResponses = {
+export type GetSessionError = GetSessionErrors[keyof GetSessionErrors];
+export type GetSessionResponses = {
     /**
      * The conversation and one page of its messages
      */
     200: SessionDetail;
 };
-export type GetSessionDetailResponse = GetSessionDetailResponses[keyof GetSessionDetailResponses];
-export type CompactData = {
+export type GetSessionResponse = GetSessionResponses[keyof GetSessionResponses];
+export type CompactSessionData = {
     body: CompactRequest;
     path: {
         session_id: string;
@@ -468,35 +456,29 @@ export type CompactData = {
     query?: never;
     url: '/v1/agent/sessions/{session_id}/compact';
 };
-export type CompactErrors = {
+export type CompactSessionErrors = {
     /**
-     * Validation Exception
+     * The request could not be read: malformed JSON
      */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
+    400: ErrorResponse;
     /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
      * Unknown session id
      */
-    404: unknown;
+    404: ErrorResponse;
     /**
-     * A turn was processed while this was running
+     * Another compaction of this conversation finished first
      */
-    409: unknown;
+    409: ErrorResponse;
     /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -506,21 +488,21 @@ export type CompactErrors = {
     /**
      * The model provider failed or timed out
      */
-    502: unknown;
+    502: ErrorResponse;
     /**
-     * GEMINI_API_KEY is not configured
+     * The model provider is not configured
      */
-    503: unknown;
+    503: ErrorResponse;
 };
-export type CompactError = CompactErrors[keyof CompactErrors];
-export type CompactResponses = {
+export type CompactSessionError = CompactSessionErrors[keyof CompactSessionErrors];
+export type CompactSessionResponses = {
     /**
      * The summary that replaced the turns it covers
      */
     200: CompactionInfo;
 };
-export type CompactResponse = CompactResponses[keyof CompactResponses];
-export type ExtractData = {
+export type CompactSessionResponse = CompactSessionResponses[keyof CompactSessionResponses];
+export type ExtractSessionFactsData = {
     body?: never;
     path: {
         session_id: string;
@@ -528,35 +510,25 @@ export type ExtractData = {
     query?: never;
     url: '/v1/agent/sessions/{session_id}/extract';
 };
-export type ExtractErrors = {
-    /**
-     * Validation Exception
-     */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
+export type ExtractSessionFactsErrors = {
     /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
      * Unknown session id
      */
-    404: unknown;
+    404: ErrorResponse;
     /**
-     * A turn was processed while this was running
+     * Another compaction of this conversation finished first
      */
-    409: unknown;
+    409: ErrorResponse;
     /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -566,53 +538,42 @@ export type ExtractErrors = {
     /**
      * The model provider failed or timed out
      */
-    502: unknown;
+    502: ErrorResponse;
     /**
-     * GEMINI_API_KEY is not configured
+     * The model provider is not configured
      */
-    503: unknown;
+    503: ErrorResponse;
 };
-export type ExtractError = ExtractErrors[keyof ExtractErrors];
-export type ExtractResponses = {
+export type ExtractSessionFactsError = ExtractSessionFactsErrors[keyof ExtractSessionFactsErrors];
+export type ExtractSessionFactsResponses = {
     /**
      * The facts pulled out of the conversation and stored
      */
     200: CompactionInfo;
 };
-export type ExtractResponse = ExtractResponses[keyof ExtractResponses];
-export type ForgetUserFactsData = {
+export type ExtractSessionFactsResponse = ExtractSessionFactsResponses[keyof ExtractSessionFactsResponses];
+export type DeleteAllFactsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 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;
     };
     url: '/v1/agent/facts';
 };
-export type ForgetUserFactsErrors = {
+export type DeleteAllFactsErrors = {
     /**
-     * Validation Exception
-     */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
-    /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
-     * Unknown end user id
-     */
-    404: unknown;
-    /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -620,47 +581,36 @@ export type ForgetUserFactsErrors = {
      */
     429: ErrorResponse;
 };
-export type ForgetUserFactsError = ForgetUserFactsErrors[keyof ForgetUserFactsErrors];
-export type ForgetUserFactsResponses = {
+export type DeleteAllFactsError = DeleteAllFactsErrors[keyof DeleteAllFactsErrors];
+export type DeleteAllFactsResponses = {
     /**
      * How many stored facts were deleted
      */
-    200: ForgottenFacts;
+    200: FactsDeleted;
 };
-export type ForgetUserFactsResponse = ForgetUserFactsResponses[keyof ForgetUserFactsResponses];
+export type DeleteAllFactsResponse = DeleteAllFactsResponses[keyof DeleteAllFactsResponses];
 export type ListFactsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * 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;
     };
     url: '/v1/agent/facts';
 };
 export type ListFactsErrors = {
     /**
-     * Validation Exception
-     */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
-    /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
-     * Unknown end user id
-     */
-    404: unknown;
-    /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -673,10 +623,10 @@ export type ListFactsResponses = {
     /**
      * What the platform remembers about this end user
      */
-    200: FactList;
+    200: FactPage;
 };
 export type ListFactsResponse = ListFactsResponses[keyof ListFactsResponses];
-export type ForgetFactData = {
+export type DeleteFactData = {
     body?: never;
     path: {
         fact_id: string;
@@ -684,31 +634,21 @@ export type ForgetFactData = {
     query?: never;
     url: '/v1/agent/facts/{fact_id}';
 };
-export type ForgetFactErrors = {
+export type DeleteFactErrors = {
     /**
-     * Validation Exception
-     */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
-    /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
-     * No such fact for this organisation
+     * Unknown fact id
      */
-    404: unknown;
+    404: ErrorResponse;
     /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -716,49 +656,52 @@ export type ForgetFactErrors = {
      */
     429: ErrorResponse;
 };
-export type ForgetFactError = ForgetFactErrors[keyof ForgetFactErrors];
-export type ForgetFactResponses = {
+export type DeleteFactError = DeleteFactErrors[keyof DeleteFactErrors];
+export type DeleteFactResponses = {
     /**
      * The fact is gone
      */
-    200: ForgottenFacts;
+    204: void;
 };
-export type ForgetFactResponse = ForgetFactResponses[keyof ForgetFactResponses];
+export type DeleteFactResponse = DeleteFactResponses[keyof DeleteFactResponses];
 export type ListRelationsData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Only this agent's relationship.
+         */
         agent_id?: string;
+        /**
+         * 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;
-        limit?: number | null;
+        /**
+         * How many to answer, 1 to 200.
+         */
+        limit?: number;
+        /**
+         * The `next_cursor` of the page before.
+         */
+        cursor?: string;
     };
     url: '/v1/agent/relations';
 };
 export type ListRelationsErrors = {
     /**
-     * Validation Exception
-     */
-    400: {
-        status_code: number;
-        detail: string;
-        extra?: {
-            [key: string]: unknown;
-        } | Array<unknown> | null;
-    };
-    /**
-     * Missing or invalid API token
+     * Missing or invalid credentials
      */
     401: ErrorResponse;
     /**
-     * The token is valid but its scopes do not cover this capability
+     * The key is valid but its scopes do not cover this capability
      */
     403: ErrorResponse;
     /**
-     * Unknown agent id, or unknown end user id
+     * Unknown agent id
      */
-    404: unknown;
+    404: ErrorResponse;
     /**
-     * Request failed validation
+     * The request failed validation
      */
     422: ErrorResponse;
     /**
@@ -769,8 +712,8 @@ export type ListRelationsErrors = {
 export type ListRelationsError = ListRelationsErrors[keyof ListRelationsErrors];
 export type ListRelationsResponses = {
     /**
-     * How the agent feels about each person, most recent first
+     * How each agent feels about the person, most recent first
      */
-    200: RelationList;
+    200: RelationPage;
 };
 export type ListRelationsResponse = ListRelationsResponses[keyof ListRelationsResponses];