@xopcai/xopc 0.0.426 → 0.0.428

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

@@ -0,0 +1,282 @@
+import { type WeixinSetupScope } from './weixin-setup-scope.js';
+import type { Config } from '../../config/schema.js';
+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;
+    persisted?: boolean;
+    conflict?: boolean;
+}>;
+/** Coordinates HTTP MCP setup; pi remains the sole MCP and OAuth implementation. */
+export declare class McpConversationSetup {
+    private readonly options;
+    private readonly goals;
+    private readonly drafts;
+    private readonly draftIds;
+    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>;
+        resume: (goal: {
+            id: string;
+            conversationId: string;
+            transcriptId: string;
+            serverId: string;
+            purpose: string;
+            objective?: 'connect_only' | 'complete_task';
+            channel?: WeixinSetupScope;
+        }) => Promise<boolean>;
+    });
+    private notify;
+    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;
+    currentForConversation(conversationId: string): {
+        setup: {
+            setupId: string;
+            serverId: string;
+            displayName: string;
+            version: number;
+            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;
+            interactionPath: string;
+            returnChannel: string;
+            managementPath: string;
+            continuationQueued: boolean;
+            replyDelivery: "failed" | "pending" | "delivered";
+            instruction: string;
+        };
+    };
+    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 | Record<string, string>, expectedVersion?: number, ownerPrincipalId?: string): Promise<{
+        setupId: string;
+        serverId: string;
+        displayName: string;
+        version: number;
+        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;
+        interactionPath: string;
+        returnChannel: string;
+        managementPath: string;
+        continuationQueued: boolean;
+        replyDelivery: "failed" | "pending" | "delivered";
+        instruction: string;
+    } | {
+        phase: string;
+        endpointOrigin: string;
+        setupId: string;
+        serverId: string;
+        displayName: string;
+        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;
+        interactionPath: string;
+        returnChannel: string;
+        managementPath: string;
+        continuationQueued: boolean;
+        replyDelivery: "failed" | "pending" | "delivered";
+        instruction: string;
+    } | {
+        endpointOrigin: string;
+        approval: {
+            endpoint: string;
+            purpose: string;
+            accountId: string;
+            peerId: string;
+            principalId: string;
+            origin: string;
+        };
+        canReplaceToken: boolean;
+        authorizationUrl: string;
+        authState: string;
+        requiresRecheck: boolean;
+        setupId: string;
+        serverId: string;
+        displayName: string;
+        version: number;
+        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;
+        interactionPath: string;
+        returnChannel: string;
+        managementPath: string;
+        continuationQueued: boolean;
+        replyDelivery: "failed" | "pending" | "delivered";
+        instruction: string;
+    }>;
+    private settleAuthorization;
+    dispose(): void;
+    relayCallback(id: string, callbackUrl: string): string;
+    completeContinuation(input: {
+        conversationId: string;
+        clientMessageId: string;
+        expectedTranscriptId?: string;
+        origin: {
+            type: string;
+            source?: string;
+        };
+        runId?: string;
+    }, text: string): Promise<void>;
+    private deliverReply;
+    private resume;
+    permitsContinuation(input: {
+        conversationId: string;
+        clientMessageId: string;
+        expectedTranscriptId?: string;
+        origin: {
+            type: string;
+            source?: string;
+        };
+    }): boolean;
+    resumePending(runtimeReloaded?: boolean): Promise<void>;
+}
+export {};