@opengeni/contracts 0.50.0 → 2.2.0-canary.0

package/dist/interaction.d.ts

@@ -339,8 +339,34 @@ export declare const AttachedBrowserDevice: z.ZodObject<{
     updatedAt: z.ZodString;
 }, z.core.$strict>;
 export type AttachedBrowserDevice = z.infer<typeof AttachedBrowserDevice>;
+/** One enrolled machine agent currently reporting its browser-bridge inventory.
+ * A bridge with zero devices is operational but has no Chrome profile connected
+ * through the OpenGeni extension yet. */
+export declare const AttachedBrowserBridge: z.ZodObject<{
+    enrollmentId: z.ZodString;
+    state: z.ZodEnum<{
+        offline: "offline";
+        online: "online";
+    }>;
+    bridgeGeneration: z.ZodString;
+    inventoryRevision: z.ZodNumber;
+    connectedProfileCount: z.ZodNumber;
+    lastSeenAt: z.ZodString;
+}, z.core.$strict>;
+export type AttachedBrowserBridge = z.infer<typeof AttachedBrowserBridge>;
 export declare const AttachedBrowserDeviceListResponse: z.ZodObject<{
     revision: z.ZodNumber;
+    bridges: z.ZodArray<z.ZodObject<{
+        enrollmentId: z.ZodString;
+        state: z.ZodEnum<{
+            offline: "offline";
+            online: "online";
+        }>;
+        bridgeGeneration: z.ZodString;
+        inventoryRevision: z.ZodNumber;
+        connectedProfileCount: z.ZodNumber;
+        lastSeenAt: z.ZodString;
+    }, z.core.$strict>>;
     devices: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         accountId: z.ZodString;
@@ -4586,6 +4612,48 @@ export declare const BrowserActionBatch: z.ZodObject<{
     }, z.core.$strict>], "type">>;
 }, z.core.$strict>;
 export type BrowserActionBatch = z.infer<typeof BrowserActionBatch>;
+/** Secret-safe projection of a connected-machine control failure carried in a
+ * standard API error envelope. The outer envelope owns HTTP status, retryability,
+ * and public request correlation; this preserves the exact failing control class
+ * and optional inner request id without exposing subjects, local paths, or tokens. */
+export declare const InteractionControlFailureCode: z.ZodEnum<{
+    agent_offline: "agent_offline";
+    consent_required: "consent_required";
+    draining: "draining";
+    fenced: "fenced";
+    not_found: "not_found";
+    os: "os";
+    payload_too_large: "payload_too_large";
+    protocol: "protocol";
+    stream: "stream";
+    timeout: "timeout";
+    unknown: "unknown";
+    unsupported: "unsupported";
+}>;
+export type InteractionControlFailureCode = z.infer<typeof InteractionControlFailureCode>;
+export declare const InteractionControlFailureDetails: z.ZodObject<{
+    interactionLayer: z.ZodLiteral<"connected_machine">;
+    interactionSurface: z.ZodEnum<{
+        browser: "browser";
+        computer: "computer";
+    }>;
+    controlFailureCode: z.ZodEnum<{
+        agent_offline: "agent_offline";
+        consent_required: "consent_required";
+        draining: "draining";
+        fenced: "fenced";
+        not_found: "not_found";
+        os: "os";
+        payload_too_large: "payload_too_large";
+        protocol: "protocol";
+        stream: "stream";
+        timeout: "timeout";
+        unknown: "unknown";
+        unsupported: "unsupported";
+    }>;
+    controlRequestId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type InteractionControlFailureDetails = z.infer<typeof InteractionControlFailureDetails>;
 export declare const InteractionError: z.ZodObject<{
     code: z.ZodEnum<{
         attempt_stale: "attempt_stale";

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,58 @@ 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";
+    }>>>;
+    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 +181,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 +227,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 +281,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 +327,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 +339,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 +347,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 +405,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 +451,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 +463,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 +471,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 +558,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 +604,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 +659,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 +705,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 +717,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>;