@xopcai/xopc 0.0.427 → 0.0.428

package/dist/src/agent/mcp/conversation-setup.d.ts

@@ -1,11 +1,15 @@
 import { type WeixinSetupScope } from './weixin-setup-scope.js';
 import type { Config } from '../../config/schema.js';
-type Phase = 'approval_required' | 'planned' | 'oauth_required' | 'authorizing' | 'token_required' | 'blocked' | 'ready' | 'cancelled';
+import { type McpResearch } from './discovery.js';
+import type { McpConnectionProbe } from './connection-setup.js';
+type Phase = 'approval_required' | 'planned' | 'oauth_required' | 'authorizing' | 'token_required' | 'auth_unknown' | 'blocked' | 'ready' | 'cancelled';
 export type McpSetupContext = {
     conversationId: string;
     agentId: string;
     canConfigure: boolean;
     canRequestWeixinSetup?: boolean;
+    signal?: AbortSignal;
+    authorizeResearch?: (tool: 'web_search' | 'web_fetch', args: Record<string, unknown>) => Promise<boolean>;
 };
 type Save = (next: Config, expected?: Config) => Promise<{
     saved: boolean;
@@ -21,9 +25,12 @@ export declare class McpConversationSetup {
     private readonly busy;
     private readonly authorizations;
     private disposed;
+    private readonly retryTimers;
+    private readonly discovery;
     constructor(options: {
         readConfig: () => Config;
         saveConfig: Save;
+        research?: McpResearch;
         changed?: (conversationId: string) => void;
         deliver?: (channel: WeixinSetupScope, text: string, setupId: string) => Promise<void>;
         withConfigLock: <T>(operation: () => Promise<T>) => Promise<T>;
@@ -33,6 +40,7 @@ export declare class McpConversationSetup {
             transcriptId: string;
             serverId: string;
             purpose: string;
+            objective?: 'connect_only' | 'complete_task';
             channel?: WeixinSetupScope;
         }) => Promise<boolean>;
     });
@@ -40,8 +48,10 @@ export declare class McpConversationSetup {
     private save;
     private current;
     private get;
+    private canProvideToken;
     private view;
     private cancelGoal;
+    cancelConversation(conversationId: string): Promise<void>;
     revokeWeixinRequests(accountId: string, peerId: string): void;
     reconcileWeixinScopes(): void;
     private inspect;
@@ -54,6 +64,33 @@ export declare class McpConversationSetup {
             phase: Phase;
             expired: boolean;
             reloadRequired: boolean;
+            canProvideToken: boolean;
+            secretFields: {
+                id: string;
+                label: string;
+                location: "header" | "env";
+                name: string;
+                prefix: "" | "Bearer ";
+            }[];
+            helpUrl: string;
+            objective: "connect_only" | "complete_task";
+            planApproval: {
+                sources: {
+                    url: string;
+                    hash: string;
+                }[];
+                execution: {
+                    command: string;
+                    args: string[];
+                    sourceUrl: string;
+                    cwd?: string;
+                };
+                endpoint: string;
+                purpose: string;
+            };
+            diagnosis: Pick<McpConnectionProbe, "auth" | "observation" | "recovery">;
+            nextRetryAt: number;
+            attempts: number;
             errorCode: string;
             conversationId: string;
             expiresAt: number;
@@ -67,8 +104,9 @@ export declare class McpConversationSetup {
     };
     command(command: string, input: Record<string, unknown>, context: McpSetupContext, dryRun?: boolean): Promise<unknown>;
     private advance;
+    private scheduleRetry;
     /** Owner-only UI; secret values and OAuth URLs never pass through the model API. */
-    interact(id: string, action: 'get' | 'advance' | 'token' | 'authorize' | 'cancel' | 'approve' | 'retry_delivery', value?: string, expectedVersion?: number, ownerPrincipalId?: string): Promise<{
+    interact(id: string, action: 'get' | 'advance' | 'token' | 'authorize' | 'cancel' | 'approve' | 'retry_delivery', value?: string | Record<string, string>, expectedVersion?: number, ownerPrincipalId?: string): Promise<{
         setupId: string;
         serverId: string;
         displayName: string;
@@ -76,6 +114,33 @@ export declare class McpConversationSetup {
         phase: Phase;
         expired: boolean;
         reloadRequired: boolean;
+        canProvideToken: boolean;
+        secretFields: {
+            id: string;
+            label: string;
+            location: "header" | "env";
+            name: string;
+            prefix: "" | "Bearer ";
+        }[];
+        helpUrl: string;
+        objective: "connect_only" | "complete_task";
+        planApproval: {
+            sources: {
+                url: string;
+                hash: string;
+            }[];
+            execution: {
+                command: string;
+                args: string[];
+                sourceUrl: string;
+                cwd?: string;
+            };
+            endpoint: string;
+            purpose: string;
+        };
+        diagnosis: Pick<McpConnectionProbe, "auth" | "observation" | "recovery">;
+        nextRetryAt: number;
+        attempts: number;
         errorCode: string;
         conversationId: string;
         expiresAt: number;
@@ -94,6 +159,33 @@ export declare class McpConversationSetup {
         version: number;
         expired: boolean;
         reloadRequired: boolean;
+        canProvideToken: boolean;
+        secretFields: {
+            id: string;
+            label: string;
+            location: "header" | "env";
+            name: string;
+            prefix: "" | "Bearer ";
+        }[];
+        helpUrl: string;
+        objective: "connect_only" | "complete_task";
+        planApproval: {
+            sources: {
+                url: string;
+                hash: string;
+            }[];
+            execution: {
+                command: string;
+                args: string[];
+                sourceUrl: string;
+                cwd?: string;
+            };
+            endpoint: string;
+            purpose: string;
+        };
+        diagnosis: Pick<McpConnectionProbe, "auth" | "observation" | "recovery">;
+        nextRetryAt: number;
+        attempts: number;
         errorCode: string;
         conversationId: string;
         expiresAt: number;
@@ -124,6 +216,33 @@ export declare class McpConversationSetup {
         phase: Phase;
         expired: boolean;
         reloadRequired: boolean;
+        canProvideToken: boolean;
+        secretFields: {
+            id: string;
+            label: string;
+            location: "header" | "env";
+            name: string;
+            prefix: "" | "Bearer ";
+        }[];
+        helpUrl: string;
+        objective: "connect_only" | "complete_task";
+        planApproval: {
+            sources: {
+                url: string;
+                hash: string;
+            }[];
+            execution: {
+                command: string;
+                args: string[];
+                sourceUrl: string;
+                cwd?: string;
+            };
+            endpoint: string;
+            purpose: string;
+        };
+        diagnosis: Pick<McpConnectionProbe, "auth" | "observation" | "recovery">;
+        nextRetryAt: number;
+        attempts: number;
         errorCode: string;
         conversationId: string;
         expiresAt: number;