@resolveio/server-lib 22.2.14 → 22.2.16

package/methods/ai-terminal.d.ts

@@ -1,3 +1,54 @@
+type AttachmentInput = {
+    id?: string;
+    name?: string;
+    type?: string;
+    size?: number;
+    local_path?: string;
+};
+type AiCodexRunInput = {
+    id_conversation?: string;
+    id_client?: string;
+    id_app?: string;
+    message: string;
+    request_id?: string;
+    guardrails?: boolean;
+    config?: {
+        mode?: string;
+        model?: string;
+        fallback_model?: string;
+        fallback_models?: string[] | string;
+        fallbackModel?: string;
+        fallbackModels?: string[] | string;
+        guardrails?: boolean;
+        planner_enabled?: boolean;
+        plannerEnabled?: boolean;
+        fast_mode?: boolean;
+        fastMode?: boolean;
+        always_allow_probe?: boolean;
+        alwaysAllowProbe?: boolean;
+        run_budget_ms?: number;
+        runBudgetMs?: number;
+        mongo_max_time_ms?: number;
+        mongoMaxTimeMs?: number;
+        system_prompt?: string;
+        systemPrompt?: string;
+        user_prompt_template?: string;
+        userPromptTemplate?: string;
+    };
+    context?: {
+        mode?: string;
+        route?: string;
+    };
+    mongo?: {
+        database?: string;
+        databases?: string[];
+        access?: string;
+        readonly?: boolean;
+    };
+    attachments?: AttachmentInput[];
+    delete_files_after_run?: boolean;
+    max_history?: number;
+};
 type AiAssistantCollectionRetryState = {
     triedCollections?: string[];
     disableCrossCollectionRetry?: boolean;
@@ -8,6 +59,12 @@ type AiAssistantRuntimeControl = {
     deadlineMs?: number;
     maxTimeMS?: number;
 };
+type AiAssistantDirectiveHints = {
+    collectionHints?: string[];
+    rankedCollections?: string[];
+    fieldHints?: string[];
+    schemaHints?: string[];
+};
 export type AiAssistantMongoReadInput = {
     database?: string;
     collection?: string;
@@ -23,6 +80,7 @@ export type AiAssistantMongoReadInput = {
     };
     permissionView?: string;
     id_client?: string;
+    id_app?: string;
     mongo?: {
         database?: string;
         databases?: string[];
@@ -31,6 +89,7 @@ export type AiAssistantMongoReadInput = {
     };
     __assistantRetryState?: AiAssistantCollectionRetryState;
     __assistantRuntime?: AiAssistantRuntimeControl;
+    __assistantHints?: AiAssistantDirectiveHints;
 };
 export type AiAssistantMongoAggregateInput = {
     database?: string;
@@ -46,6 +105,7 @@ export type AiAssistantMongoAggregateInput = {
     };
     permissionView?: string;
     id_client?: string;
+    id_app?: string;
     mongo?: {
         database?: string;
         databases?: string[];
@@ -55,6 +115,7 @@ export type AiAssistantMongoAggregateInput = {
     __assistantMessage?: string;
     __assistantRetryState?: AiAssistantCollectionRetryState;
     __assistantRuntime?: AiAssistantRuntimeControl;
+    __assistantHints?: AiAssistantDirectiveHints;
 };
 type AiAssistantDisplayTable = {
     columns: string[];
@@ -101,7 +162,9 @@ export declare function loadAiTerminalMethods(methodManager: any): void;
 export declare function executeAiAssistantMongoRead(payload: AiAssistantMongoReadInput, context: any): Promise<any>;
 export declare function executeAiAssistantMongoAggregate(payload: AiAssistantMongoAggregateInput, context: any): Promise<any>;
 export declare function extractAssistantMongoDirective(content: string): AssistantMongoDirective | null;
+export declare function buildAssistantToolRequest(directive: AssistantMongoDirective, payload: AiCodexRunInput, hints?: AiAssistantDirectiveHints): Record<string, any>;
 export declare function buildAssistantInvoiceCustomerLabelExpr(): Record<string, any>;
+export declare function resolveAssistantHeuristicDirectiveForTesting(message: string, collectionHints: string[], collectionNames?: string[], appId?: string): any;
 export declare function buildAssistantDatedPivotDisplay(display: AiAssistantDisplayTable, expectedMonths?: string[]): AiAssistantDisplayTable | null;
 export declare function deriveAssistantCommandExecutionStatus(commandValue: any): string;
 export declare function normalizeIdsForTargetField(ids: any[], targetDocs: any[], targetFieldPath: string, targetFieldTypeOverride?: 'objectId' | 'string' | 'unknown'): any[];
@@ -130,6 +193,8 @@ export declare function normalizeAssistantAggregatePipeline(pipeline?: Array<Rec
 export declare function stripQueryFieldPathsDeep(query: any, fieldsToStrip: string[]): any;
 export declare function stripScopedFieldsFromPipeline(pipeline: any[], fieldsToStrip: string[]): any[];
 export declare function rewriteEmbeddedMatchObjects(query: any): any;
+export declare function resolveAssistantAppCollectionHintCandidates(message: string, appId?: string): string[];
+export declare function isAssistantDeterministicHeuristicEnabledForApp(heuristicId: string, appId?: string): boolean;
 export declare function resolveAssistantCollectionOverride(collectionRanking: Record<string, any> | null, currentCollection: string): {
     from: string;
     to: string;
@@ -155,6 +220,15 @@ export declare function evaluateAssistantFallbackDocumentsQuality(documents: any
     averageFillRate: number;
 };
 export declare function shouldAcceptAssistantFallbackDocuments(documents: any[], options?: AssistantFallbackAcceptanceOptions): boolean;
+export declare function resolveAssistantReportBuilderBridgeCollection(collection: string, db?: any, dbName?: string, options?: {
+    requestHints?: AiAssistantDirectiveHints;
+    appId?: string;
+}): Promise<{
+    collection: string;
+    fallbackFrom?: string;
+    mode: 'report-builder' | 'direct-mongo';
+    resolutionPath: string[];
+}>;
 export declare function collectUserViewPermissions(user: any): string[];
 export declare function userHasInvoiceAccess(user: any): boolean;
 export declare function resolveAssistantUserAccessTier(user: any): 'super_admin' | 'customer_portal' | 'client_user';
@@ -176,6 +250,11 @@ export declare function shouldRunAssistantPlanner(params: {
     hasDeterministicHeuristicFastPath: boolean;
 }): boolean;
 export declare function shouldEnforceAssistantDatedDirective(message: string, plannerOutput: any, requestClassification: AssistantRequestClassification): boolean;
+export declare function buildAssistantSchemaHints(collectionNames: string[], options?: {
+    maxCollections?: number;
+    maxFields?: number;
+    maxLookups?: number;
+}): string[];
 export declare function collectAssistantAllowedRoutesForUser(user: any, allRoutes: string[], isSuperAdmin: boolean): string[];
 export declare function rankAssistantNavigationRoutes(message: string, routes: string[], limit?: number): string[];
 export declare function shouldUseAssistantNavigationFastPath(message: string, hasAttachments?: boolean): boolean;