@opengeni/contracts 0.50.0 → 1.0.0

package/dist/knowledge-preparation.d.ts

@@ -0,0 +1,237 @@
+import { z } from "zod";
+/** Read-only discovery before a model decides whether and where to save. */
+export declare const KnowledgeSavePreparationRequest: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    collectionCursors: z.ZodOptional<z.ZodObject<{
+        published: z.ZodNullable<z.ZodString>;
+        needs_review: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeSavePreparationRequest = z.input<typeof KnowledgeSavePreparationRequest>;
+export declare const KnowledgeCollectionDescriptor: z.ZodObject<{
+    id: z.ZodUUID;
+    revisionId: z.ZodUUID;
+    version: z.ZodNumber;
+    scope: z.ZodEnum<{
+        organization: "organization";
+        personal: "personal";
+        workspace: "workspace";
+    }>;
+    view: z.ZodEnum<{
+        needs_review: "needs_review";
+        published: "published";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    descriptionTruncated: z.ZodBoolean;
+    parentIds: z.ZodArray<z.ZodUUID>;
+}, z.core.$strict>;
+export declare const KnowledgeSavePreparationResponse: z.ZodObject<{
+    collections: z.ZodObject<{
+        entries: z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            revisionId: z.ZodUUID;
+            version: z.ZodNumber;
+            scope: z.ZodEnum<{
+                organization: "organization";
+                personal: "personal";
+                workspace: "workspace";
+            }>;
+            view: z.ZodEnum<{
+                needs_review: "needs_review";
+                published: "published";
+            }>;
+            title: z.ZodString;
+            description: z.ZodString;
+            descriptionTruncated: z.ZodBoolean;
+            parentIds: z.ZodArray<z.ZodUUID>;
+        }, z.core.$strict>>;
+        complete: z.ZodBoolean;
+        nextCursors: z.ZodObject<{
+            published: z.ZodNullable<z.ZodString>;
+            needs_review: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    matches: z.ZodObject<{
+        published: z.ZodObject<{
+            entries: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                scope: z.ZodEnum<{
+                    organization: "organization";
+                    personal: "personal";
+                    workspace: "workspace";
+                }>;
+                version: z.ZodNumber;
+                publishedRevisionId: z.ZodNullable<z.ZodUUID>;
+                latestRevisionId: z.ZodUUID;
+                archived: z.ZodBoolean;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                indexStatus: z.ZodOptional<z.ZodEnum<{
+                    awaiting_funding: "awaiting_funding";
+                    indexed: "indexed";
+                    indexing: "indexing";
+                    provider_failed: "provider_failed";
+                    queued: "queued";
+                    saved: "saved";
+                    source_unavailable: "source_unavailable";
+                }>>;
+                score: z.ZodOptional<z.ZodNumber>;
+                excerpts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    field: z.ZodEnum<{
+                        content: "content";
+                        title: "title";
+                    }>;
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                    text: z.ZodString;
+                }, z.core.$strip>>>;
+                revision: z.ZodObject<{
+                    id: z.ZodUUID;
+                    entryId: z.ZodUUID;
+                    number: z.ZodNumber;
+                    change: z.ZodEnum<{
+                        archive: "archive";
+                        upsert: "upsert";
+                    }>;
+                    previousRevisionId: z.ZodNullable<z.ZodUUID>;
+                    restoredFromRevisionId: z.ZodNullable<z.ZodUUID>;
+                    createdAt: z.ZodString;
+                    createdBySessionId: z.ZodNullable<z.ZodUUID>;
+                    reviewBatchId: z.ZodNullable<z.ZodUUID>;
+                    outcome: z.ZodEnum<{
+                        pending: "pending";
+                        published: "published";
+                        rejected: "rejected";
+                        superseded: "superseded";
+                    }>;
+                    title: z.ZodString;
+                    kind: z.ZodEnum<{
+                        decision: "decision";
+                        fact: "fact";
+                        group: "group";
+                        incident: "incident";
+                        note: "note";
+                        requirement: "requirement";
+                        source: "source";
+                    }>;
+                    preview: z.ZodString;
+                    groupIds: z.ZodArray<z.ZodUUID>;
+                    sourceKind: z.ZodNullable<z.ZodEnum<{
+                        connector: "connector";
+                        conversation: "conversation";
+                        file: "file";
+                        manual: "manual";
+                        repository: "repository";
+                        slack: "slack";
+                        task_note: "task_note";
+                        web: "web";
+                    }>>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+            searchMode: z.ZodOptional<z.ZodEnum<{
+                hybrid: "hybrid";
+                keyword: "keyword";
+                vector: "vector";
+            }>>;
+            fallbackReason: z.ZodOptional<z.ZodEnum<{
+                awaiting_funding: "awaiting_funding";
+                provider_unavailable: "provider_unavailable";
+                query_limit: "query_limit";
+                quota: "quota";
+            }>>;
+        }, z.core.$strip>;
+        needs_review: z.ZodObject<{
+            entries: z.ZodArray<z.ZodObject<{
+                id: z.ZodUUID;
+                scope: z.ZodEnum<{
+                    organization: "organization";
+                    personal: "personal";
+                    workspace: "workspace";
+                }>;
+                version: z.ZodNumber;
+                publishedRevisionId: z.ZodNullable<z.ZodUUID>;
+                latestRevisionId: z.ZodUUID;
+                archived: z.ZodBoolean;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                indexStatus: z.ZodOptional<z.ZodEnum<{
+                    awaiting_funding: "awaiting_funding";
+                    indexed: "indexed";
+                    indexing: "indexing";
+                    provider_failed: "provider_failed";
+                    queued: "queued";
+                    saved: "saved";
+                    source_unavailable: "source_unavailable";
+                }>>;
+                score: z.ZodOptional<z.ZodNumber>;
+                excerpts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    field: z.ZodEnum<{
+                        content: "content";
+                        title: "title";
+                    }>;
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                    text: z.ZodString;
+                }, z.core.$strip>>>;
+                revision: z.ZodObject<{
+                    id: z.ZodUUID;
+                    entryId: z.ZodUUID;
+                    number: z.ZodNumber;
+                    change: z.ZodEnum<{
+                        archive: "archive";
+                        upsert: "upsert";
+                    }>;
+                    previousRevisionId: z.ZodNullable<z.ZodUUID>;
+                    restoredFromRevisionId: z.ZodNullable<z.ZodUUID>;
+                    createdAt: z.ZodString;
+                    createdBySessionId: z.ZodNullable<z.ZodUUID>;
+                    reviewBatchId: z.ZodNullable<z.ZodUUID>;
+                    outcome: z.ZodEnum<{
+                        pending: "pending";
+                        published: "published";
+                        rejected: "rejected";
+                        superseded: "superseded";
+                    }>;
+                    title: z.ZodString;
+                    kind: z.ZodEnum<{
+                        decision: "decision";
+                        fact: "fact";
+                        group: "group";
+                        incident: "incident";
+                        note: "note";
+                        requirement: "requirement";
+                        source: "source";
+                    }>;
+                    preview: z.ZodString;
+                    groupIds: z.ZodArray<z.ZodUUID>;
+                    sourceKind: z.ZodNullable<z.ZodEnum<{
+                        connector: "connector";
+                        conversation: "conversation";
+                        file: "file";
+                        manual: "manual";
+                        repository: "repository";
+                        slack: "slack";
+                        task_note: "task_note";
+                        web: "web";
+                    }>>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+            searchMode: z.ZodOptional<z.ZodEnum<{
+                hybrid: "hybrid";
+                keyword: "keyword";
+                vector: "vector";
+            }>>;
+            fallbackReason: z.ZodOptional<z.ZodEnum<{
+                awaiting_funding: "awaiting_funding";
+                provider_unavailable: "provider_unavailable";
+                query_limit: "query_limit";
+                quota: "quota";
+            }>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+export type KnowledgeSavePreparationResponse = z.infer<typeof KnowledgeSavePreparationResponse>;

package/dist/knowledge.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod";
 export declare const KNOWLEDGE_BROWSE_CURSOR_MAX_CHARS = 1024;
 export declare const KNOWLEDGE_BROWSE_DEFAULT_LIMIT = 20;
 export declare const KNOWLEDGE_BROWSE_MAX_LIMIT = 50;
+export declare const KNOWLEDGE_BROWSE_MAX_RESPONSE_BYTES: number;
 export declare const KNOWLEDGE_TITLE_MAX_BYTES = 1024;
 export declare const KNOWLEDGE_BODY_MAX_BYTES: number;
 export declare const KNOWLEDGE_SUMMARY_MAX_BYTES: number;
@@ -12,6 +13,13 @@ export declare const KNOWLEDGE_METADATA_MAX_ITEMS = 64;
 export declare const KNOWLEDGE_METADATA_MAX_DEPTH = 4;
 export declare const KNOWLEDGE_SOURCE_STRING_MAX_BYTES = 2048;
 export declare const KNOWLEDGE_SOURCE_URI_MAX_BYTES = 8192;
+export declare const KNOWLEDGE_SEARCH_MAX_RESULTS = 50;
+export declare const KNOWLEDGE_SEARCH_MAX_RESPONSE_BYTES: number;
+export declare const KNOWLEDGE_SEARCH_TOKEN_ESTIMATE_BYTES_PER_TOKEN = 4;
+export declare const KNOWLEDGE_SEARCH_MAX_FLOOR_OMISSIONS = 200;
+export declare const KNOWLEDGE_SEARCH_MIN_VECTOR_SCORE = 0.52;
+export declare const KNOWLEDGE_SEARCH_MIN_KEYWORD_SCORE = 0.01;
+export declare const KNOWLEDGE_QUERY_MAX_BYTES: number;
 export declare const KnowledgeRecordId: z.ZodString;
 export type KnowledgeRecordId = z.infer<typeof KnowledgeRecordId>;
 export declare const KnowledgeRecordKind: z.ZodEnum<{
@@ -47,6 +55,63 @@ export declare const KnowledgeSource: z.ZodObject<{
     version: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type KnowledgeSource = z.infer<typeof KnowledgeSource>;
+export declare const KnowledgeSearchRequest: z.ZodObject<{
+    query: z.ZodPipe<z.ZodString, z.ZodString>;
+    baseIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        hybrid: "hybrid";
+        keyword: "keyword";
+        vector: "vector";
+    }>>;
+    sourceKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        chat: "chat";
+        document: "document";
+        email: "email";
+        manual_upload: "manual_upload";
+        meeting_transcript: "meeting_transcript";
+        other: "other";
+        repository: "repository";
+        web: "web";
+    }>>>;
+    authorityKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        organization: "organization";
+        personal: "personal";
+        workspace: "workspace";
+    }>>>;
+    aclTags: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodString>>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type KnowledgeSearchRequest = z.input<typeof KnowledgeSearchRequest>;
+export declare const KnowledgeBrowseRequest: z.ZodObject<{
+    parentId: z.ZodOptional<z.ZodString>;
+    topic: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodString>>;
+    sourceKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        chat: "chat";
+        document: "document";
+        email: "email";
+        manual_upload: "manual_upload";
+        meeting_transcript: "meeting_transcript";
+        other: "other";
+        repository: "repository";
+        web: "web";
+    }>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type KnowledgeBrowseRequest = z.input<typeof KnowledgeBrowseRequest>;
+export declare const KnowledgeProviderCitation: z.ZodObject<{
+    provider: z.ZodLiteral<"google_drive">;
+    externalObjectId: z.ZodString;
+    providerRevision: z.ZodNullable<z.ZodString>;
+    sourceVersion: z.ZodString;
+    driveId: z.ZodNullable<z.ZodString>;
+    deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+    aclRevision: z.ZodString;
+    authorizationObservedAt: z.ZodString;
+    authorizationExpiresAt: z.ZodString;
+    reauthorizedAt: z.ZodString;
+}, z.core.$strip>;
+export type KnowledgeProviderCitation = z.infer<typeof KnowledgeProviderCitation>;
 export declare const KnowledgeLinkTarget: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"knowledge">;
     id: z.ZodString;
@@ -121,6 +186,18 @@ export declare const KnowledgeRecord: z.ZodObject<{
             version: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>;
         indexedAt: z.ZodString;
+        citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            provider: z.ZodLiteral<"google_drive">;
+            externalObjectId: z.ZodString;
+            providerRevision: z.ZodNullable<z.ZodString>;
+            sourceVersion: z.ZodString;
+            driveId: z.ZodNullable<z.ZodString>;
+            deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+            aclRevision: z.ZodString;
+            authorizationObservedAt: z.ZodString;
+            authorizationExpiresAt: z.ZodString;
+            reauthorizedAt: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
     lifecycle: z.ZodObject<{
         state: z.ZodLiteral<"active">;
@@ -155,6 +232,7 @@ export declare const KnowledgeRecord: z.ZodObject<{
             "content.metadata": "content.metadata";
             "content.summary": "content.summary";
             "content.topics": "content.topics";
+            "provenance.citation": "provenance.citation";
             "provenance.source.author": "provenance.source.author";
             "provenance.source.externalId": "provenance.source.externalId";
             "provenance.source.title": "provenance.source.title";
@@ -208,6 +286,18 @@ export declare const KnowledgeSearchResult: z.ZodObject<{
                 version: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>;
             indexedAt: z.ZodString;
+            citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                provider: z.ZodLiteral<"google_drive">;
+                externalObjectId: z.ZodString;
+                providerRevision: z.ZodNullable<z.ZodString>;
+                sourceVersion: z.ZodString;
+                driveId: z.ZodNullable<z.ZodString>;
+                deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+                aclRevision: z.ZodString;
+                authorizationObservedAt: z.ZodString;
+                authorizationExpiresAt: z.ZodString;
+                reauthorizedAt: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
         lifecycle: z.ZodObject<{
             state: z.ZodLiteral<"active">;
@@ -242,6 +332,7 @@ export declare const KnowledgeSearchResult: z.ZodObject<{
                 "content.metadata": "content.metadata";
                 "content.summary": "content.summary";
                 "content.topics": "content.topics";
+                "provenance.citation": "provenance.citation";
                 "provenance.source.author": "provenance.source.author";
                 "provenance.source.externalId": "provenance.source.externalId";
                 "provenance.source.title": "provenance.source.title";
@@ -253,6 +344,7 @@ export declare const KnowledgeSearchResult: z.ZodObject<{
     }, z.core.$strip>;
     retrieval: z.ZodObject<{
         score: z.ZodNumber;
+        semanticScore: z.ZodNumber;
         matchType: z.ZodEnum<{
             hybrid: "hybrid";
             keyword: "keyword";
@@ -260,6 +352,17 @@ export declare const KnowledgeSearchResult: z.ZodObject<{
         }>;
         vectorScore: z.ZodNullable<z.ZodNumber>;
         keywordScore: z.ZodNullable<z.ZodNumber>;
+        relevanceSignals: z.ZodArray<z.ZodEnum<{
+            keyword: "keyword";
+            vector: "vector";
+        }>>;
+        freshness: z.ZodEnum<{
+            aging: "aging";
+            current: "current";
+            stale: "stale";
+        }>;
+        qualityAdjustment: z.ZodNumber;
+        duplicateCount: z.ZodNumber;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type KnowledgeSearchResult = z.infer<typeof KnowledgeSearchResult>;
@@ -307,6 +410,18 @@ export declare const KnowledgeSearchResponse: z.ZodObject<{
                     version: z.ZodNullable<z.ZodString>;
                 }, z.core.$strip>;
                 indexedAt: z.ZodString;
+                citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    provider: z.ZodLiteral<"google_drive">;
+                    externalObjectId: z.ZodString;
+                    providerRevision: z.ZodNullable<z.ZodString>;
+                    sourceVersion: z.ZodString;
+                    driveId: z.ZodNullable<z.ZodString>;
+                    deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+                    aclRevision: z.ZodString;
+                    authorizationObservedAt: z.ZodString;
+                    authorizationExpiresAt: z.ZodString;
+                    reauthorizedAt: z.ZodString;
+                }, z.core.$strip>>>;
             }, z.core.$strip>;
             lifecycle: z.ZodObject<{
                 state: z.ZodLiteral<"active">;
@@ -341,6 +456,7 @@ export declare const KnowledgeSearchResponse: z.ZodObject<{
                     "content.metadata": "content.metadata";
                     "content.summary": "content.summary";
                     "content.topics": "content.topics";
+                    "provenance.citation": "provenance.citation";
                     "provenance.source.author": "provenance.source.author";
                     "provenance.source.externalId": "provenance.source.externalId";
                     "provenance.source.title": "provenance.source.title";
@@ -352,6 +468,7 @@ export declare const KnowledgeSearchResponse: z.ZodObject<{
         }, z.core.$strip>;
         retrieval: z.ZodObject<{
             score: z.ZodNumber;
+            semanticScore: z.ZodNumber;
             matchType: z.ZodEnum<{
                 hybrid: "hybrid";
                 keyword: "keyword";
@@ -359,8 +476,48 @@ export declare const KnowledgeSearchResponse: z.ZodObject<{
             }>;
             vectorScore: z.ZodNullable<z.ZodNumber>;
             keywordScore: z.ZodNullable<z.ZodNumber>;
+            relevanceSignals: z.ZodArray<z.ZodEnum<{
+                keyword: "keyword";
+                vector: "vector";
+            }>>;
+            freshness: z.ZodEnum<{
+                aging: "aging";
+                current: "current";
+                stale: "stale";
+            }>;
+            qualityAdjustment: z.ZodNumber;
+            duplicateCount: z.ZodNumber;
         }, z.core.$strip>;
     }, z.core.$strip>>;
+    selection: z.ZodObject<{
+        relevanceFloor: z.ZodObject<{
+            policy: z.ZodLiteral<"any_signal">;
+            vectorScore: z.ZodLiteral<0.52>;
+            keywordScore: z.ZodLiteral<0.01>;
+        }, z.core.$strip>;
+        dedupe: z.ZodObject<{
+            policy: z.ZodLiteral<"exact_textual_content">;
+        }, z.core.$strip>;
+        candidates: z.ZodObject<{
+            ranked: z.ZodNumber;
+            rechecked: z.ZodNumber;
+            omittedOnRecheck: z.ZodNumber;
+        }, z.core.$strip>;
+        omitted: z.ZodObject<{
+            belowRelevanceFloor: z.ZodNumber;
+            asDuplicate: z.ZodNumber;
+            forLimit: z.ZodNumber;
+            forResponseBudget: z.ZodNumber;
+        }, z.core.$strip>;
+        budget: z.ZodObject<{
+            maxResults: z.ZodLiteral<50>;
+            maxResponseBytes: z.ZodLiteral<number>;
+            responseBytes: z.ZodNumber;
+            tokenEstimateBytesPerToken: z.ZodLiteral<4>;
+            estimatedTokens: z.ZodNumber;
+            maxEstimatedTokens: z.ZodLiteral<number>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
 }, z.core.$strip>;
 export type KnowledgeSearchResponse = z.infer<typeof KnowledgeSearchResponse>;
 export declare const KnowledgeGetResponse: z.ZodObject<{
@@ -406,6 +563,18 @@ export declare const KnowledgeGetResponse: z.ZodObject<{
                 version: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>;
             indexedAt: z.ZodString;
+            citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                provider: z.ZodLiteral<"google_drive">;
+                externalObjectId: z.ZodString;
+                providerRevision: z.ZodNullable<z.ZodString>;
+                sourceVersion: z.ZodString;
+                driveId: z.ZodNullable<z.ZodString>;
+                deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+                aclRevision: z.ZodString;
+                authorizationObservedAt: z.ZodString;
+                authorizationExpiresAt: z.ZodString;
+                reauthorizedAt: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
         lifecycle: z.ZodObject<{
             state: z.ZodLiteral<"active">;
@@ -440,6 +609,7 @@ export declare const KnowledgeGetResponse: z.ZodObject<{
                 "content.metadata": "content.metadata";
                 "content.summary": "content.summary";
                 "content.topics": "content.topics";
+                "provenance.citation": "provenance.citation";
                 "provenance.source.author": "provenance.source.author";
                 "provenance.source.externalId": "provenance.source.externalId";
                 "provenance.source.title": "provenance.source.title";
@@ -494,6 +664,18 @@ export declare const KnowledgeBrowseResponse: z.ZodObject<{
                 version: z.ZodNullable<z.ZodString>;
             }, z.core.$strip>;
             indexedAt: z.ZodString;
+            citation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                provider: z.ZodLiteral<"google_drive">;
+                externalObjectId: z.ZodString;
+                providerRevision: z.ZodNullable<z.ZodString>;
+                sourceVersion: z.ZodString;
+                driveId: z.ZodNullable<z.ZodString>;
+                deepLink: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodString>>;
+                aclRevision: z.ZodString;
+                authorizationObservedAt: z.ZodString;
+                authorizationExpiresAt: z.ZodString;
+                reauthorizedAt: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
         lifecycle: z.ZodObject<{
             state: z.ZodLiteral<"active">;
@@ -528,6 +710,7 @@ export declare const KnowledgeBrowseResponse: z.ZodObject<{
                 "content.metadata": "content.metadata";
                 "content.summary": "content.summary";
                 "content.topics": "content.topics";
+                "provenance.citation": "provenance.citation";
                 "provenance.source.author": "provenance.source.author";
                 "provenance.source.externalId": "provenance.source.externalId";
                 "provenance.source.title": "provenance.source.title";
@@ -539,5 +722,19 @@ export declare const KnowledgeBrowseResponse: z.ZodObject<{
     }, z.core.$strip>>;
     nextCursor: z.ZodNullable<z.ZodString>;
     hasMore: z.ZodBoolean;
+    selection: z.ZodObject<{
+        omitted: z.ZodObject<{
+            forResponseBudget: z.ZodNumber;
+        }, z.core.$strip>;
+        compactedRecordCount: z.ZodNumber;
+        budget: z.ZodObject<{
+            maxResults: z.ZodLiteral<50>;
+            maxResponseBytes: z.ZodLiteral<number>;
+            responseBytes: z.ZodNumber;
+            tokenEstimateBytesPerToken: z.ZodLiteral<4>;
+            estimatedTokens: z.ZodNumber;
+            maxEstimatedTokens: z.ZodLiteral<number>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
 }, z.core.$strip>;
 export type KnowledgeBrowseResponse = z.infer<typeof KnowledgeBrowseResponse>;