@burtson-labs/bandit-engine 2.0.166 → 2.0.168

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage } from './public-0EYmtpGD.mjs';
-export { A as AIChatRequest, c as AIChatResponse, d as AIGenerateRequest, e as AIGenerateResponse, f as AIMessage, g as AIModel, h as AIProviderConfig, C as ChatConfig, i as ChatModal, j as ChatModalProps, k as ChatProvider, D as DEFAULT_TIER_FEATURES, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, V as VoiceModelsResponse, m as VoiceService, v as voiceService } from './public-0EYmtpGD.mjs';
+import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage } from './public-DJa4Db00.mjs';
+export { A as AIChatRequest, c as AIChatResponse, d as AIGenerateRequest, e as AIGenerateResponse, f as AIMessage, g as AIModel, h as AIProviderConfig, C as ChatConfig, i as ChatModal, j as ChatModalProps, k as ChatProvider, D as DEFAULT_TIER_FEATURES, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, V as VoiceModelsResponse, m as VoiceService, v as voiceService } from './public-DJa4Db00.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { Theme } from '@mui/material/styles';
@@ -1007,6 +1007,39 @@ declare function getCriticalConfig(): {
     timestamp: string;
 };
 
+/**
+ * Knowledge file listing (GET {gateway}/embedding/files).
+ *
+ * The gateway's file store is shared with every Burtson Labs product that keeps files in the
+ * account: Drive uploads, attachments pulled out of email (Outlook's image001.png, Word's
+ * ~WRD0548.jpg), app assets, Image Studio output. Knowledge should show only the documents that
+ * are indexed for Knowledge search.
+ *
+ * Current gateways scope the list on the server (`scope=knowledge`, the default: files with a
+ * vector in the documents index) and answer with a paged envelope:
+ *   { files, total, skip, limit, hasMore, scope, knowledgeFilterUnavailable }
+ * Older gateways answer with a bare array of every file. For those, `knowledge` scope falls back
+ * to a client-side filter that drops images, media and temporary files (Knowledge uploads only
+ * accept documents, code and data), and the page reports how many it hid so the UI can offer
+ * "All workspace files".
+ */
+type KnowledgeFileScope = 'knowledge' | 'all';
+type RawFileRecord = Record<string, unknown>;
+interface KnowledgeFilePage {
+    files: RawFileRecord[];
+    /** Files matching the scope in total (server count), or the filtered count of this page on old gateways. */
+    total: number;
+    hasMore: boolean;
+    /** The scope the listing actually has. */
+    scope: KnowledgeFileScope;
+    /** The server applied the scope (current gateway). False: old gateway, client-side filter. */
+    serverScoped: boolean;
+    /** Knowledge was asked for but the index couldn't be checked, so this is every workspace file. */
+    knowledgeFilterUnavailable: boolean;
+    /** Files hidden by the client-side filter on this page (old gateways only). */
+    hiddenCount: number;
+}
+
 interface VectorMemory {
     id: string;
     content: string;
@@ -1040,6 +1073,13 @@ interface VectorDocument {
     isUserContent: boolean;
     isTeamContent: boolean;
     contentSource: 'user' | 'team';
+    /** File size in bytes, when the listing reports it. */
+    size?: number;
+    bucket?: string;
+    teamSid?: string;
+    userEmail?: string;
+    /** Short text preview extracted when the file was indexed. */
+    preview?: string;
 }
 interface SearchResult {
     memories: VectorMemory[];
@@ -1047,7 +1087,6 @@ interface SearchResult {
     success: boolean;
     message?: string;
 }
-type RawFileRecord = Record<string, unknown>;
 interface MemorySearchFilters {
     includePinned?: boolean;
     topics?: string[];
@@ -1232,7 +1271,15 @@ declare class VectorDatabaseService {
      */
     getAvailableFiles(skip?: number, limit?: number): Promise<RawFileRecord[]>;
     /**
-     * Get user's files - tries both Gateway API and file storage API
+     * One page of the Knowledge file list from the gateway (see ./knowledgeFiles).
+     *
+     * No fallback to the file storage API here: its listing is the whole Drive (every product's
+     * files), which is exactly what Knowledge must not show. A failure surfaces to the caller.
+     */
+    listKnowledgeFiles(skip?: number, limit?: number, scope?: KnowledgeFileScope): Promise<KnowledgeFilePage>;
+    /**
+     * Get the user's Knowledge files (first page, knowledge scope). Kept for existing callers;
+     * prefer listKnowledgeFiles for totals and paging.
      */
     getUserFiles(skip?: number, limit?: number): Promise<RawFileRecord[]>;
     /**
@@ -1403,6 +1450,10 @@ interface SearchOptions {
     useVector?: boolean;
     filters?: MemorySearchFilters;
 }
+/** One page of Knowledge documents, ready for the Knowledge view. */
+interface KnowledgeDocumentPage extends Omit<KnowledgeFilePage, 'files'> {
+    documents: VectorDocument[];
+}
 /**
  * Advanced Vector Storage Hook
  *
@@ -1517,6 +1568,7 @@ declare const useVectorStore: () => {
     }>;
     searchDocuments: (query: string, options?: SearchOptions) => Promise<VectorDocument[]>;
     getUserDocuments: (skip?: number, limit?: number) => Promise<VectorDocument[]>;
+    getKnowledgeDocumentsPage: (skip?: number, limit?: number, scope?: KnowledgeFileScope) => Promise<KnowledgeDocumentPage>;
     deleteDocument: (fileId: string) => Promise<{
         success: boolean;
         error?: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage } from './public-0EYmtpGD.js';
-export { A as AIChatRequest, c as AIChatResponse, d as AIGenerateRequest, e as AIGenerateResponse, f as AIMessage, g as AIModel, h as AIProviderConfig, C as ChatConfig, i as ChatModal, j as ChatModalProps, k as ChatProvider, D as DEFAULT_TIER_FEATURES, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, V as VoiceModelsResponse, m as VoiceService, v as voiceService } from './public-0EYmtpGD.js';
+import { F as FeatureKey, a as FeatureEvaluation, S as SubscriptionTier, b as FeatureFlagConfig, T as TrialUsage } from './public-DJa4Db00.js';
+export { A as AIChatRequest, c as AIChatResponse, d as AIGenerateRequest, e as AIGenerateResponse, f as AIMessage, g as AIModel, h as AIProviderConfig, C as ChatConfig, i as ChatModal, j as ChatModalProps, k as ChatProvider, D as DEFAULT_TIER_FEATURES, l as FeatureMatrix, O as OSS_DEFAULT_FEATURES, P as PackageSettings, V as VoiceModelsResponse, m as VoiceService, v as voiceService } from './public-DJa4Db00.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 import { Theme } from '@mui/material/styles';
@@ -1007,6 +1007,39 @@ declare function getCriticalConfig(): {
     timestamp: string;
 };
 
+/**
+ * Knowledge file listing (GET {gateway}/embedding/files).
+ *
+ * The gateway's file store is shared with every Burtson Labs product that keeps files in the
+ * account: Drive uploads, attachments pulled out of email (Outlook's image001.png, Word's
+ * ~WRD0548.jpg), app assets, Image Studio output. Knowledge should show only the documents that
+ * are indexed for Knowledge search.
+ *
+ * Current gateways scope the list on the server (`scope=knowledge`, the default: files with a
+ * vector in the documents index) and answer with a paged envelope:
+ *   { files, total, skip, limit, hasMore, scope, knowledgeFilterUnavailable }
+ * Older gateways answer with a bare array of every file. For those, `knowledge` scope falls back
+ * to a client-side filter that drops images, media and temporary files (Knowledge uploads only
+ * accept documents, code and data), and the page reports how many it hid so the UI can offer
+ * "All workspace files".
+ */
+type KnowledgeFileScope = 'knowledge' | 'all';
+type RawFileRecord = Record<string, unknown>;
+interface KnowledgeFilePage {
+    files: RawFileRecord[];
+    /** Files matching the scope in total (server count), or the filtered count of this page on old gateways. */
+    total: number;
+    hasMore: boolean;
+    /** The scope the listing actually has. */
+    scope: KnowledgeFileScope;
+    /** The server applied the scope (current gateway). False: old gateway, client-side filter. */
+    serverScoped: boolean;
+    /** Knowledge was asked for but the index couldn't be checked, so this is every workspace file. */
+    knowledgeFilterUnavailable: boolean;
+    /** Files hidden by the client-side filter on this page (old gateways only). */
+    hiddenCount: number;
+}
+
 interface VectorMemory {
     id: string;
     content: string;
@@ -1040,6 +1073,13 @@ interface VectorDocument {
     isUserContent: boolean;
     isTeamContent: boolean;
     contentSource: 'user' | 'team';
+    /** File size in bytes, when the listing reports it. */
+    size?: number;
+    bucket?: string;
+    teamSid?: string;
+    userEmail?: string;
+    /** Short text preview extracted when the file was indexed. */
+    preview?: string;
 }
 interface SearchResult {
     memories: VectorMemory[];
@@ -1047,7 +1087,6 @@ interface SearchResult {
     success: boolean;
     message?: string;
 }
-type RawFileRecord = Record<string, unknown>;
 interface MemorySearchFilters {
     includePinned?: boolean;
     topics?: string[];
@@ -1232,7 +1271,15 @@ declare class VectorDatabaseService {
      */
     getAvailableFiles(skip?: number, limit?: number): Promise<RawFileRecord[]>;
     /**
-     * Get user's files - tries both Gateway API and file storage API
+     * One page of the Knowledge file list from the gateway (see ./knowledgeFiles).
+     *
+     * No fallback to the file storage API here: its listing is the whole Drive (every product's
+     * files), which is exactly what Knowledge must not show. A failure surfaces to the caller.
+     */
+    listKnowledgeFiles(skip?: number, limit?: number, scope?: KnowledgeFileScope): Promise<KnowledgeFilePage>;
+    /**
+     * Get the user's Knowledge files (first page, knowledge scope). Kept for existing callers;
+     * prefer listKnowledgeFiles for totals and paging.
      */
     getUserFiles(skip?: number, limit?: number): Promise<RawFileRecord[]>;
     /**
@@ -1403,6 +1450,10 @@ interface SearchOptions {
     useVector?: boolean;
     filters?: MemorySearchFilters;
 }
+/** One page of Knowledge documents, ready for the Knowledge view. */
+interface KnowledgeDocumentPage extends Omit<KnowledgeFilePage, 'files'> {
+    documents: VectorDocument[];
+}
 /**
  * Advanced Vector Storage Hook
  *
@@ -1517,6 +1568,7 @@ declare const useVectorStore: () => {
     }>;
     searchDocuments: (query: string, options?: SearchOptions) => Promise<VectorDocument[]>;
     getUserDocuments: (skip?: number, limit?: number) => Promise<VectorDocument[]>;
+    getKnowledgeDocumentsPage: (skip?: number, limit?: number, scope?: KnowledgeFileScope) => Promise<KnowledgeDocumentPage>;
     deleteDocument: (fileId: string) => Promise<{
         success: boolean;
         error?: string;