Skip to content

Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active

3.0 KB
Raw Blame
import type {
  ScheduleMCPOutcome,
  ScheduledMCPFailureReason,
  ScheduledMCPIdentity,
  ScheduledMCPResource,
  ScheduledMCPConsent,
  ScheduledMCPToolSelection,
} from 'librechat-data-provider';
export type {
  ScheduledMCPCredentialMode,
  ScheduledMCPIdentity,
  ScheduledMCPResource,
  ScheduledMCPConsent,
  ScheduledMCPToolSelection,
} from 'librechat-data-provider';

export type { ScheduledMCPFailureReason } from 'librechat-data-provider';

/** Safe diagnosis projected onto existing schedule statuses. */
export interface ScheduledMCPFailure {
  readonly reason: ScheduledMCPFailureReason;
  readonly status: Exclude<ScheduleMCPOutcome['status'], 'ready'>;
  readonly recovery: 'authorize' | 'configure' | 'restore_permission' | 'retry_later';
  readonly automaticReplay: false;
}

export type ScheduledMCPConsentLookupResult =
  | { readonly state: 'found'; readonly consent: ScheduledMCPConsent }
  | { readonly state: 'missing' }
  | { readonly state: 'unavailable' };

export interface ScheduledMCPAuthorizationRequest {
  readonly identity: ScheduledMCPIdentity;
  readonly resource: ScheduledMCPResource;
  readonly stage: 'activation' | 'mint' | 'invoke' | 'resume';
  /** Set only by the owner-authorized manual trigger or its verified resume metadata. */
  readonly manual?: boolean;
  readonly selection: ScheduledMCPToolSelection;
}

/** Ephemeral observation, not a transferable grant or permission to cache an allow decision. */
export type ScheduledMCPAuthorizationResult =
  | {
      readonly state: 'authorized';
      readonly consentId: string;
      readonly consentRevision: string;
      readonly policyRevision: string;
      readonly validUntilMs: number;
    }
  | { readonly state: 'denied'; readonly failure: ScheduledMCPFailure }
  | { readonly state: 'cancelled' };

export interface ScheduledMCPAuthority {
  readonly lookupConsent: (
    identity: ScheduledMCPIdentity,
    resource: ScheduledMCPResource,
    options: { signal?: AbortSignal },
  ) => Promise<ScheduledMCPConsentLookupResult>;
  /** Rechecks live consent, RBAC, schedule/graph binding and trusted tool policy at each stage. */
  readonly authorize: (
    request: ScheduledMCPAuthorizationRequest,
    options: { signal?: AbortSignal },
  ) => Promise<ScheduledMCPAuthorizationResult>;
}

export type ScheduledMCPBearerResult =
  | {
      readonly state: 'ready';
      readonly accessToken: string;
      readonly expiresAtMs: number;
      readonly issuer: string;
      readonly audience: string;
      readonly resourceUrl: string;
    }
  | { readonly state: 'denied'; readonly failure: ScheduledMCPFailure }
  | { readonly state: 'cancelled' };

/** Resolves a resource-bound bearer after live authorization; use must reauthorize. */
export type ScheduledMCPResourceBearerResolver = (
  request: ScheduledMCPAuthorizationRequest & {
    readonly resource: ScheduledMCPResource & { readonly credentialMode: 'resource_bearer' };
  },
  options: { signal?: AbortSignal },
) => Promise<ScheduledMCPBearerResult>;