atproto-mcp 0.1.0

package/dist/tools/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * MCP Tools for AT Protocol operations
+ *
+ * Comprehensive tools that enable LLMs to interact directly with the AT Protocol ecosystem
+ */
+import type { z } from 'zod';
+import type { AtpClient } from '../utils/atp-client.js';
+/**
+ * Tool interface for MCP tools
+ */
+export interface IMcpTool {
+    schema: {
+        method: string;
+        description: string;
+        params?: z.ZodSchema;
+    };
+    handler: (params: any) => Promise<any>;
+}
+/**
+ * Create all MCP tools for AT Protocol operations
+ */
+export declare function createTools(atpClient: AtpClient): IMcpTool[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA6CxD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,EAAE,CAsE5D"}

package/dist/tools/index.js

@@ -0,0 +1,73 @@
+/**
+ * MCP Tools for AT Protocol operations
+ *
+ * Comprehensive tools that enable LLMs to interact directly with the AT Protocol ecosystem
+ */
+import { Logger } from '../utils/logger.js';
+import { AddToListTool, BlockUserTool, CreateListTool, CreatePostTool, CreateRichTextPostTool, DeletePostTool, FollowUserTool, GenerateLinkPreviewTool, GetCustomFeedTool, GetFollowersTool, GetFollowsTool, GetListTool, GetNotificationsTool, GetRecentEventsTool, GetStreamingStatusTool, GetThreadTool, GetTimelineTool, GetUserProfileTool, HandleOAuthCallbackTool, LikePostTool, MuteUserTool, RefreshOAuthTokensTool, RemoveFromListTool, ReplyToPostTool, ReportContentTool, ReportUserTool, RepostTool, RevokeOAuthTokensTool, SearchPostsTool, StartOAuthFlowTool, StartStreamingTool, StopStreamingTool, UnblockUserTool, UnfollowUserTool, UnlikePostTool, UnmuteUserTool, UnrepostTool, UpdateProfileTool, UploadImageTool, UploadVideoTool, } from './implementations/index.js';
+/**
+ * Create all MCP tools for AT Protocol operations
+ */
+export function createTools(atpClient) {
+    const logger = new Logger('ToolsFactory');
+    try {
+        const tools = [
+            // Core social operations
+            new CreatePostTool(atpClient),
+            new ReplyToPostTool(atpClient),
+            new LikePostTool(atpClient),
+            new UnlikePostTool(atpClient),
+            new RepostTool(atpClient),
+            new UnrepostTool(atpClient),
+            // User operations
+            new FollowUserTool(atpClient),
+            new UnfollowUserTool(atpClient),
+            new GetUserProfileTool(atpClient),
+            // Data retrieval
+            new SearchPostsTool(atpClient),
+            new GetTimelineTool(atpClient),
+            new GetFollowersTool(atpClient),
+            new GetFollowsTool(atpClient),
+            new GetNotificationsTool(atpClient),
+            // Content management
+            new DeletePostTool(atpClient),
+            new UpdateProfileTool(atpClient),
+            // OAuth authentication
+            new StartOAuthFlowTool(atpClient),
+            new HandleOAuthCallbackTool(atpClient),
+            new RefreshOAuthTokensTool(atpClient),
+            new RevokeOAuthTokensTool(atpClient),
+            // Content moderation
+            new MuteUserTool(atpClient),
+            new UnmuteUserTool(atpClient),
+            new BlockUserTool(atpClient),
+            new UnblockUserTool(atpClient),
+            new ReportContentTool(atpClient),
+            new ReportUserTool(atpClient),
+            // Real-time streaming
+            new StartStreamingTool(atpClient),
+            new StopStreamingTool(atpClient),
+            new GetStreamingStatusTool(atpClient),
+            new GetRecentEventsTool(atpClient),
+            // Advanced social features
+            new CreateListTool(atpClient),
+            new AddToListTool(atpClient),
+            new RemoveFromListTool(atpClient),
+            new GetListTool(atpClient),
+            new GetThreadTool(atpClient),
+            new GetCustomFeedTool(atpClient),
+            // Enhanced media support
+            new UploadImageTool(atpClient),
+            new UploadVideoTool(atpClient),
+            new CreateRichTextPostTool(atpClient),
+            new GenerateLinkPreviewTool(atpClient),
+        ];
+        logger.info(`Created ${tools.length} AT Protocol MCP tools`);
+        return tools;
+    }
+    catch (error) {
+        logger.error('Failed to create MCP tools', error);
+        return [];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Core type definitions for the AT Protocol MCP Server
+ */
+export type DID = string & {
+    readonly __brand: 'DID';
+};
+export type ATURI = string & {
+    readonly __brand: 'ATURI';
+};
+export type NSID = string & {
+    readonly __brand: 'NSID';
+};
+export type CID = string & {
+    readonly __brand: 'CID';
+};
+export interface IAtpSession {
+    did: DID;
+    handle: string;
+    accessJwt: string;
+    refreshJwt: string;
+    active: boolean;
+}
+export interface IAtpProfile {
+    did: DID;
+    handle: string;
+    displayName?: string;
+    description?: string;
+    avatar?: string;
+    banner?: string;
+    followersCount?: number;
+    followsCount?: number;
+    postsCount?: number;
+}
+export interface IAtpPost {
+    uri: ATURI;
+    cid: CID;
+    author: IAtpProfile;
+    record: {
+        text: string;
+        createdAt: string;
+        reply?: {
+            root: {
+                uri: ATURI;
+                cid: CID;
+            };
+            parent: {
+                uri: ATURI;
+                cid: CID;
+            };
+        };
+        embed?: unknown;
+        langs?: string[];
+        labels?: unknown;
+        tags?: string[];
+    };
+    replyCount?: number;
+    repostCount?: number;
+    likeCount?: number;
+    indexedAt: string;
+    viewer?: {
+        repost?: ATURI;
+        like?: ATURI;
+    };
+}
+export interface IMcpServerConfig {
+    port: number;
+    host: string;
+    name: string;
+    version: string;
+    description: string;
+    atproto: IAtpConfig;
+}
+export interface IAtpConfig {
+    service: string;
+    identifier?: string;
+    password?: string;
+    clientId?: string;
+    clientSecret?: string;
+    redirectUri?: string;
+    authMethod?: 'app-password' | 'oauth';
+}
+export interface ICreatePostParams {
+    text: string;
+    reply?: {
+        root: ATURI;
+        parent: ATURI;
+    };
+    embed?: {
+        images?: Array<{
+            alt: string;
+            image: Blob;
+        }>;
+        external?: {
+            uri: string;
+            title: string;
+            description: string;
+        };
+    };
+    langs?: string[];
+}
+export interface IReplyToPostParams {
+    text: string;
+    root: ATURI;
+    parent: ATURI;
+    langs?: string[];
+}
+export interface ILikePostParams {
+    uri: ATURI;
+    cid: CID;
+}
+export interface IUnlikePostParams {
+    likeUri: ATURI;
+}
+export interface IRepostParams {
+    uri: ATURI;
+    cid: CID;
+    text?: string;
+}
+export interface IUnrepostParams {
+    repostUri: ATURI;
+}
+export interface IFollowUserParams {
+    actor: string;
+}
+export interface IUnfollowUserParams {
+    followUri: ATURI;
+}
+export interface IGetUserProfileParams {
+    actor: string;
+}
+export interface ISearchPostsParams {
+    q: string;
+    limit?: number;
+    cursor?: string;
+    sort?: 'top' | 'latest';
+    since?: string;
+    until?: string;
+    mentions?: string;
+    author?: string;
+    lang?: string;
+    domain?: string;
+    url?: string;
+}
+export interface IGetTimelineParams {
+    algorithm?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface IGetFollowersParams {
+    actor: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface IGetFollowsParams {
+    actor: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface IGetNotificationsParams {
+    limit?: number;
+    cursor?: string;
+    seenAt?: string;
+}
+export interface IDeletePostParams {
+    uri: ATURI;
+}
+export interface IUpdateProfileParams {
+    displayName?: string;
+    description?: string;
+    avatar?: Blob;
+    banner?: Blob;
+}
+export declare abstract class BaseError extends Error {
+    readonly code: string;
+    readonly timestamp: string;
+    readonly context: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, context?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+export declare class AtpError extends BaseError {
+    readonly statusCode?: number | undefined;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, statusCode?: number | undefined, details?: unknown | undefined, context?: Record<string, unknown>);
+}
+export declare class McpError extends BaseError {
+    readonly mcpCode: number;
+    readonly data?: unknown | undefined;
+    constructor(message: string, mcpCode: number, data?: unknown | undefined, context?: Record<string, unknown>);
+}
+export declare class AuthenticationError extends AtpError {
+    constructor(message: string, details?: unknown, context?: Record<string, unknown>);
+}
+export declare class RateLimitError extends AtpError {
+    readonly retryAfter?: number | undefined;
+    constructor(message: string, retryAfter?: number | undefined, context?: Record<string, unknown>);
+}
+export declare class ValidationError extends BaseError {
+    readonly field?: string | undefined;
+    readonly value?: unknown | undefined;
+    constructor(message: string, field?: string | undefined, value?: unknown | undefined, context?: Record<string, unknown>);
+}
+export declare class ConfigurationError extends BaseError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+export type Result<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+export interface IPaginatedResponse<T> {
+    data: T[];
+    cursor?: string;
+    hasMore: boolean;
+}
+export interface IResourceInfo {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType?: string;
+}
+export interface IPromptTemplate {
+    name: string;
+    description: string;
+    arguments: Array<{
+        name: string;
+        description: string;
+        required: boolean;
+    }>;
+}
+export interface IOAuthConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    scope: string[];
+}
+export interface IAppPasswordConfig {
+    identifier: string;
+    password: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,73 @@
+/**
+ * Core type definitions for the AT Protocol MCP Server
+ */
+// Error types with comprehensive error handling
+export class BaseError extends Error {
+    code;
+    timestamp;
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.name = this.constructor.name;
+        this.timestamp = new Date().toISOString();
+        this.context = context;
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            timestamp: this.timestamp,
+            context: this.context,
+            stack: this.stack,
+        };
+    }
+}
+export class AtpError extends BaseError {
+    statusCode;
+    details;
+    constructor(message, code, statusCode, details, context) {
+        super(message, code, context);
+        this.statusCode = statusCode;
+        this.details = details;
+    }
+}
+export class McpError extends BaseError {
+    mcpCode;
+    data;
+    constructor(message, mcpCode, data, context) {
+        super(message, `MCP_${mcpCode}`, context);
+        this.mcpCode = mcpCode;
+        this.data = data;
+    }
+}
+export class AuthenticationError extends AtpError {
+    constructor(message, details, context) {
+        super(message, 'AUTHENTICATION_FAILED', 401, details, context);
+    }
+}
+export class RateLimitError extends AtpError {
+    retryAfter;
+    constructor(message, retryAfter, context) {
+        super(message, 'RATE_LIMIT_EXCEEDED', 429, { retryAfter }, context);
+        this.retryAfter = retryAfter;
+    }
+}
+export class ValidationError extends BaseError {
+    field;
+    value;
+    constructor(message, field, value, context) {
+        super(message, 'VALIDATION_ERROR', { ...context, field, value });
+        this.field = field;
+        this.value = value;
+    }
+}
+export class ConfigurationError extends BaseError {
+    constructor(message, context) {
+        super(message, 'CONFIGURATION_ERROR', context);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuLH,gDAAgD;AAChD,MAAM,OAAgB,SAAU,SAAQ,KAAK;IAMzB;IALF,SAAS,CAAS;IAClB,OAAO,CAAsC;IAE7D,YACE,OAAe,EACC,IAAY,EAC5B,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QAI5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,SAAS;IAInB;IACA;IAJlB,YACE,OAAe,EACf,IAAY,EACI,UAAmB,EACnB,OAAiB,EACjC,OAAiC;QAEjC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAJd,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAAU;IAInC,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,SAAS;IAGnB;IACA;IAHlB,YACE,OAAe,EACC,OAAe,EACf,IAAc,EAC9B,OAAiC;QAEjC,KAAK,CAAC,OAAO,EAAE,OAAO,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAJ1B,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAAU;IAIhC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,OAAe,EAAE,OAAiB,EAAE,OAAiC;QAC/E,KAAK,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAGxB;IAFlB,YACE,OAAe,EACC,UAAmB,EACnC,OAAiC;QAEjC,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;QAHpD,eAAU,GAAV,UAAU,CAAS;IAIrC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAG1B;IACA;IAHlB,YACE,OAAe,EACC,KAAc,EACd,KAAe,EAC/B,OAAiC;QAEjC,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAJjD,UAAK,GAAL,KAAK,CAAS;QACd,UAAK,GAAL,KAAK,CAAU;IAIjC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/utils/atp-client.d.ts

@@ -0,0 +1,109 @@
+/**
+ * AT Protocol client wrapper with authentication and session management
+ * Supports both authenticated and unauthenticated modes
+ */
+import { AtpAgent } from '@atproto/api';
+import { AtpError, type IAtpConfig, type IAtpSession, type Result } from '../types/index.js';
+/**
+ * AT Protocol client wrapper with comprehensive authentication and session management
+ * Supports both authenticated and unauthenticated modes for maximum flexibility
+ */
+export declare class AtpClient {
+    private agent;
+    private publicAgent;
+    private logger;
+    private session;
+    private config;
+    private sessionRefreshPromise;
+    private isAuthenticationRequired;
+    constructor(config: IAtpConfig);
+    /**
+     * Check if authentication credentials are available
+     */
+    private hasAuthenticationCredentials;
+    /**
+     * Initialize the AT Protocol client
+     * In unauthenticated mode, this will skip authentication
+     * In authenticated mode, this will perform authentication
+     */
+    initialize(): Promise<void>;
+    /**
+     * Authenticate with AT Protocol using configured method
+     */
+    private authenticate;
+    /**
+     * Authenticate using app password
+     */
+    private authenticateWithAppPassword;
+    /**
+     * Authenticate using OAuth
+     */
+    private authenticateWithOAuth;
+    /**
+     * Handle session events from AtpAgent
+     */
+    private handleSessionEvent;
+    /**
+     * Refresh the current session
+     */
+    private refreshSession;
+    /**
+     * Perform the actual session refresh
+     */
+    private performSessionRefresh;
+    /**
+     * Get the current session
+     */
+    getSession(): IAtpSession | null;
+    /**
+     * Check if client is authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Check if authentication is required for this client instance
+     */
+    requiresAuthentication(): boolean;
+    /**
+     * Get the underlying AtpAgent instance
+     * Returns the authenticated agent if available, otherwise the public agent
+     */
+    getAgent(): AtpAgent;
+    /**
+     * Get the authenticated agent (for operations that require authentication)
+     */
+    getAuthenticatedAgent(): AtpAgent;
+    /**
+     * Get the public agent (for operations that don't require authentication)
+     */
+    getPublicAgent(): AtpAgent;
+    /**
+     * Execute a request with automatic retry and error handling
+     * Supports both authenticated and unauthenticated operations
+     */
+    executeRequest<T>(operation: () => Promise<T>, context?: Record<string, unknown>, requiresAuth?: boolean): Promise<Result<T, AtpError>>;
+    /**
+     * Execute a public request that doesn't require authentication
+     */
+    executePublicRequest<T>(operation: () => Promise<T>, context?: Record<string, unknown>): Promise<Result<T, AtpError>>;
+    /**
+     * Execute an authenticated request that requires authentication
+     */
+    executeAuthenticatedRequest<T>(operation: () => Promise<T>, context?: Record<string, unknown>): Promise<Result<T, AtpError>>;
+    /**
+     * Handle and transform errors from AT Protocol operations
+     */
+    private handleError;
+    /**
+     * Cleanup resources
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Load stored OAuth session from secure storage
+     */
+    private loadStoredOAuthSession;
+    /**
+     * Store OAuth session to secure storage
+     */
+    private storeOAuthSession;
+}
+//# sourceMappingURL=atp-client.d.ts.map

package/dist/utils/atp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atp-client.d.ts","sourceRoot":"","sources":["../../src/utils/atp-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAA6C,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,QAAQ,EAGR,KAAK,UAAU,EACf,KAAK,WAAW,EAEhB,KAAK,MAAM,EAEZ,MAAM,mBAAmB,CAAC;AAI3B;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,wBAAwB,CAAU;gBAE9B,MAAM,EAAE,UAAU;IAqB9B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IASpC;;;;OAIG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBxC;;OAEG;YACW,YAAY;IAc1B;;OAEG;YACW,2BAA2B;IAuCzC;;OAEG;YACW,qBAAqB;IAkGnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;OAEG;YACW,cAAc;IAc5B;;OAEG;YACW,qBAAqB;IAqCnC;;OAEG;IACI,UAAU,IAAI,WAAW,GAAG,IAAI;IAIvC;;OAEG;IACI,eAAe,IAAI,OAAO;IAIjC;;OAEG;IACI,sBAAsB,IAAI,OAAO;IAIxC;;;OAGG;IACI,QAAQ,IAAI,QAAQ;IAI3B;;OAEG;IACI,qBAAqB,IAAI,QAAQ;IASxC;;OAEG;IACI,cAAc,IAAI,QAAQ;IAIjC;;;OAGG;IACU,cAAc,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,YAAY,GAAE,OAAe,GAC5B,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IA2B/B;;OAEG;IACU,oBAAoB,CAAC,CAAC,EACjC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAS/B;;OAEG;IACU,2BAA2B,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAI/B;;OAEG;IACH,OAAO,CAAC,WAAW;IA2CnB;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrC;;OAEG;YACW,sBAAsB;IAmBpC;;OAEG;YACW,iBAAiB;CAiBhC"}