attio-mcp 0.1.0

package/dist/objects/companies/attributes.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Attribute management for companies
+ */
+import { Company } from '../../types/attio.js';
+/**
+ * Gets specific company fields based on a field list
+ *
+ * @param companyIdOrUri - The ID of the company or its URI (attio://companies/{id})
+ * @param fields - Array of field names to retrieve
+ * @returns Partial company data with only requested fields
+ */
+export declare function getCompanyFields(companyIdOrUri: string, fields: string[]): Promise<Partial<Company>>;
+/**
+ * Gets basic company information (limited fields for performance)
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @returns Basic company information
+ */
+export declare function getCompanyBasicInfo(companyIdOrUri: string): Promise<Partial<Company>>;
+/**
+ * Gets company contact information
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @returns Company contact information
+ */
+export declare function getCompanyContactInfo(companyIdOrUri: string): Promise<Partial<Company>>;
+/**
+ * Gets company business information
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @returns Company business information
+ */
+export declare function getCompanyBusinessInfo(companyIdOrUri: string): Promise<Partial<Company>>;
+/**
+ * Gets company social media and online presence
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @returns Company social media information
+ */
+export declare function getCompanySocialInfo(companyIdOrUri: string): Promise<Partial<Company>>;
+/**
+ * Gets custom fields for a company, filtering out standard fields
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @param customFieldNames - Optional array of specific custom field names to retrieve
+ * @returns Company object with only custom fields populated
+ * @example
+ * ```typescript
+ * // Get all custom fields
+ * const custom = await getCompanyCustomFields("comp_123");
+ *
+ * // Get specific custom fields
+ * const selected = await getCompanyCustomFields("comp_123", ["contract_value", "lead_source"]);
+ * ```
+ */
+export declare function getCompanyCustomFields(companyIdOrUri: string, customFieldNames?: string[]): Promise<Partial<Company>>;
+/**
+ * Discovers all available attributes for companies in the workspace
+ *
+ * @returns List of all company attributes with metadata
+ */
+export declare function discoverCompanyAttributes(): Promise<{
+    standard: string[];
+    custom: string[];
+    all: Array<{
+        name: string;
+        type: string;
+        isCustom: boolean;
+    }>;
+}>;
+/**
+ * Gets specific attributes for a company or lists available attributes
+ *
+ * @param companyIdOrUri - The ID of the company or its URI (attio://companies/{id})
+ * @param attributeName - Optional name of specific attribute to retrieve
+ * @returns If attributeName provided: specific attribute value, otherwise list of available attributes
+ */
+export declare function getCompanyAttributes(companyIdOrUri: string, attributeName?: string): Promise<{
+    attributes?: string[];
+    value?: any;
+    company: string;
+}>;
+//# sourceMappingURL=attributes.d.ts.map

package/dist/objects/companies/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/objects/companies/attributes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAqC/C;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAoD3B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAe3B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAgB3B;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAe3B;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAc3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,EACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CA4E3B;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,EAAE,KAAK,CAAC;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ,CAAC,CAwJD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IACT,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CA2DD"}

package/dist/objects/companies/attributes.js

@@ -0,0 +1,426 @@
+import { getCompanyDetails, extractCompanyId } from './basic.js';
+import { listCompanies } from './basic.js';
+/**
+ * Logs attribute operation errors in a consistent format
+ *
+ * @param functionName - The name of the function where the error occurred
+ * @param error - The error that was caught
+ * @param context - Optional additional context about the operation
+ */
+function logAttributeError(functionName, error, context = {}) {
+    console.error(`[${functionName}] Error:`, error);
+    console.error(`- Error type: ${error instanceof Error ? error.constructor.name : typeof error}`);
+    console.error(`- Message: ${error instanceof Error ? error.message : String(error)}`);
+    if (error instanceof Error && error.stack) {
+        console.error(`- Stack trace: ${error.stack}`);
+    }
+    else {
+        console.error('- No stack trace available');
+    }
+    if (Object.keys(context).length > 0) {
+        console.error('- Context:', context);
+    }
+}
+/**
+ * Gets specific company fields based on a field list
+ *
+ * @param companyIdOrUri - The ID of the company or its URI (attio://companies/{id})
+ * @param fields - Array of field names to retrieve
+ * @returns Partial company data with only requested fields
+ */
+export async function getCompanyFields(companyIdOrUri, fields) {
+    let companyId;
+    try {
+        // Extract company ID from URI if needed
+        companyId = extractCompanyId(companyIdOrUri);
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[getCompanyFields] Fetching fields for company ${companyId}:`, fields);
+        }
+        // Fetch all company data first
+        const fullCompany = await getCompanyDetails(companyIdOrUri);
+        // Filter to only requested fields
+        const filteredValues = {};
+        const allValues = fullCompany.values || {};
+        for (const field of fields) {
+            if (field in allValues) {
+                filteredValues[field] = allValues[field];
+            }
+        }
+        // Always include basic identifiers
+        if (!('name' in filteredValues) && 'name' in allValues) {
+            filteredValues.name = allValues.name;
+        }
+        const result = {
+            id: fullCompany.id,
+            values: filteredValues,
+        };
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[getCompanyFields] Filtered to ${Object.keys(filteredValues).length} fields`);
+        }
+        return result;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Could not retrieve company fields: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Gets basic company information (limited fields for performance)
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @returns Basic company information
+ */
+export async function getCompanyBasicInfo(companyIdOrUri) {
+    const basicFields = [
+        'name',
+        'website',
+        'industry',
+        'type',
+        'type_persona',
+        'employee_range',
+        'foundation_date',
+        'primary_location',
+        'description',
+        'logo_url',
+    ];
+    return getCompanyFields(companyIdOrUri, basicFields);
+}
+/**
+ * Gets company contact information
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @returns Company contact information
+ */
+export async function getCompanyContactInfo(companyIdOrUri) {
+    const contactFields = [
+        'name',
+        'website',
+        'company_phone_5',
+        'primary_location',
+        'street_address',
+        'street_address_2',
+        'city',
+        'state',
+        'postal_code',
+        'country',
+        'main_contact',
+    ];
+    return getCompanyFields(companyIdOrUri, contactFields);
+}
+/**
+ * Gets company business information
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @returns Company business information
+ */
+export async function getCompanyBusinessInfo(companyIdOrUri) {
+    const businessFields = [
+        'name',
+        'type',
+        'type_persona',
+        'services',
+        'categories',
+        'industry',
+        'estimated_arr_usd',
+        'funding_raised_usd',
+        'employee_range',
+        'foundation_date',
+    ];
+    return getCompanyFields(companyIdOrUri, businessFields);
+}
+/**
+ * Gets company social media and online presence
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @returns Company social media information
+ */
+export async function getCompanySocialInfo(companyIdOrUri) {
+    const socialFields = [
+        'name',
+        'website',
+        'linkedin',
+        'twitter',
+        'facebook',
+        'instagram',
+        'angellist',
+        'twitter_follower_count',
+        'logo_url',
+    ];
+    return getCompanyFields(companyIdOrUri, socialFields);
+}
+/**
+ * Gets custom fields for a company, filtering out standard fields
+ *
+ * @param companyIdOrUri - The ID of the company or its URI
+ * @param customFieldNames - Optional array of specific custom field names to retrieve
+ * @returns Company object with only custom fields populated
+ * @example
+ * ```typescript
+ * // Get all custom fields
+ * const custom = await getCompanyCustomFields("comp_123");
+ *
+ * // Get specific custom fields
+ * const selected = await getCompanyCustomFields("comp_123", ["contract_value", "lead_source"]);
+ * ```
+ */
+export async function getCompanyCustomFields(companyIdOrUri, customFieldNames) {
+    // If specific custom fields are requested, fetch only those
+    if (customFieldNames && customFieldNames.length > 0) {
+        // Always include name for context
+        const fieldsToFetch = ['name', ...customFieldNames];
+        return getCompanyFields(companyIdOrUri, fieldsToFetch);
+    }
+    // Otherwise, we need to fetch all fields first to identify custom ones
+    const allData = await getCompanyDetails(companyIdOrUri);
+    // Standard fields that are NOT custom
+    const standardFields = new Set([
+        'name',
+        'website',
+        'industry',
+        'domains',
+        'description',
+        'logo_url',
+        'primary_location',
+        'employee_range',
+        'foundation_date',
+        'created_at',
+        'created_by',
+        'matching_id',
+        'record_id',
+        'linkedin',
+        'twitter',
+        'facebook',
+        'instagram',
+        'angellist',
+        'twitter_follower_count',
+        'estimated_arr_usd',
+        'funding_raised_usd',
+        'categories',
+        'about',
+        'notes',
+        'team',
+        'main_contact',
+        'street_address',
+        'street_address_2',
+        'city',
+        'state',
+        'postal_code',
+        'country',
+        'first_interaction',
+        'last_interaction',
+        'next_interaction',
+        'first_email_interaction',
+        'last_email_interaction',
+        'first_calendar_interaction',
+        'last_calendar_interaction',
+        'next_calendar_interaction',
+        'strongest_connection_strength',
+        'strongest_connection_user',
+        'associated_deals',
+        'associated_workspaces',
+    ]);
+    // Extract custom fields
+    const customFields = {};
+    const values = allData.values || {};
+    for (const [fieldName, fieldValue] of Object.entries(values)) {
+        if (!standardFields.has(fieldName)) {
+            customFields[fieldName] = fieldValue;
+        }
+    }
+    return {
+        id: allData.id,
+        values: {
+            name: values.name,
+            ...customFields,
+        },
+    };
+}
+/**
+ * Discovers all available attributes for companies in the workspace
+ *
+ * @returns List of all company attributes with metadata
+ */
+export async function discoverCompanyAttributes() {
+    // This is a simplified version - in reality, Attio likely has an API endpoint
+    // to list all available attributes for an object type
+    // For now, we'll fetch a sample company and examine its fields
+    if (process.env.NODE_ENV === 'development') {
+        console.log('[discoverCompanyAttributes] Starting attribute discovery...');
+    }
+    try {
+        // Get a sample company to see what fields are available
+        const companies = await listCompanies(1);
+        if (companies.length === 0) {
+            console.warn('[discoverCompanyAttributes] No companies found to discover attributes');
+            // Return an empty structure rather than throwing an error
+            return {
+                standard: [],
+                custom: [],
+                all: [],
+            };
+        }
+        const sampleCompanyId = companies[0].id?.record_id;
+        if (!sampleCompanyId) {
+            console.warn('[discoverCompanyAttributes] Sample company has no record ID');
+            return {
+                standard: [],
+                custom: [],
+                all: [],
+            };
+        }
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[discoverCompanyAttributes] Using sample company ID: ${sampleCompanyId}`);
+        }
+        const sampleCompany = await getCompanyDetails(sampleCompanyId);
+        const values = sampleCompany.values || {};
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[discoverCompanyAttributes] Retrieved ${Object.keys(values).length} fields from sample company`);
+        }
+        const standardFields = new Set([
+            'name',
+            'website',
+            'industry',
+            'domains',
+            'description',
+            'logo_url',
+            'primary_location',
+            'employee_range',
+            'foundation_date',
+            'created_at',
+            'created_by',
+            'matching_id',
+            'record_id',
+            'linkedin',
+            'twitter',
+            'facebook',
+            'instagram',
+            'angellist',
+            'twitter_follower_count',
+            'estimated_arr_usd',
+            'funding_raised_usd',
+            'categories',
+            'about',
+            'notes',
+            'team',
+            'main_contact',
+            'street_address',
+            'street_address_2',
+            'city',
+            'state',
+            'postal_code',
+            'country',
+            'first_interaction',
+            'last_interaction',
+            'next_interaction',
+            'first_email_interaction',
+            'last_email_interaction',
+            'first_calendar_interaction',
+            'last_calendar_interaction',
+            'next_calendar_interaction',
+            'strongest_connection_strength',
+            'strongest_connection_user',
+            'associated_deals',
+            'associated_workspaces',
+        ]);
+        const standard = [];
+        const custom = [];
+        const all = [];
+        for (const [fieldName, fieldValue] of Object.entries(values)) {
+            const isCustom = !standardFields.has(fieldName);
+            const fieldType = Array.isArray(fieldValue) && fieldValue.length > 0
+                ? fieldValue[0].attribute_type || 'unknown'
+                : 'unknown';
+            if (isCustom) {
+                custom.push(fieldName);
+            }
+            else {
+                standard.push(fieldName);
+            }
+            all.push({
+                name: fieldName,
+                type: fieldType,
+                isCustom,
+            });
+        }
+        const result = {
+            standard: standard.sort(),
+            custom: custom.sort(),
+            all: all.sort((a, b) => a.name.localeCompare(b.name)),
+        };
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[discoverCompanyAttributes] Discovery complete. Found ${standard.length} standard fields and ${custom.length} custom fields.`);
+        }
+        return result;
+    }
+    catch (error) {
+        // Use consistent error logging pattern
+        logAttributeError('discoverCompanyAttributes', error, {
+            operation: 'attribute discovery',
+            context: 'company attributes',
+        });
+        // Throw with more context
+        throw new Error(`Failed to discover company attributes: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Gets specific attributes for a company or lists available attributes
+ *
+ * @param companyIdOrUri - The ID of the company or its URI (attio://companies/{id})
+ * @param attributeName - Optional name of specific attribute to retrieve
+ * @returns If attributeName provided: specific attribute value, otherwise list of available attributes
+ */
+export async function getCompanyAttributes(companyIdOrUri, attributeName) {
+    const companyId = extractCompanyId(companyIdOrUri);
+    const fullCompany = await getCompanyDetails(companyIdOrUri);
+    try {
+        if (attributeName) {
+            // Return specific attribute value
+            const values = fullCompany.values || {};
+            const value = values[attributeName];
+            const companyName = fullCompany.values?.name?.[0]?.value || companyId;
+            if (value === undefined) {
+                throw new Error(`Attribute '${attributeName}' not found for company ${companyName}`);
+            }
+            // Extract simple value from array structure if applicable
+            let simplifiedValue = value;
+            if (Array.isArray(value) && value.length > 0) {
+                const firstItem = value[0];
+                if (firstItem && firstItem.value !== undefined) {
+                    simplifiedValue = firstItem.value;
+                }
+                else if (firstItem && firstItem.option?.title) {
+                    simplifiedValue = firstItem.option.title;
+                }
+                else if (firstItem && firstItem.target_record_id) {
+                    simplifiedValue = `Reference: ${firstItem.target_record_id}`;
+                }
+            }
+            return {
+                value: simplifiedValue,
+                company: companyName,
+            };
+        }
+        else {
+            // Return list of available attributes
+            const values = fullCompany.values || {};
+            const attributes = Object.keys(values).sort();
+            return {
+                attributes,
+                company: fullCompany.values?.name?.[0]?.value || companyId,
+            };
+        }
+    }
+    catch (error) {
+        // Use consistent error logging pattern
+        logAttributeError('getCompanyAttributes', error, {
+            companyId,
+            attributeName,
+            operation: 'get attributes',
+        });
+        // Re-throw with enhanced context
+        throw new Error(`Failed to get company attribute: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=attributes.js.map

package/dist/objects/companies/attributes.js.map

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

package/dist/objects/companies/basic.d.ts

@@ -0,0 +1,117 @@
+import { Company } from '../../types/attio.js';
+import { CompanyAttributes } from './types.js';
+/**
+ * Lists companies sorted by most recent interaction
+ *
+ * @param limit - Maximum number of companies to return (default: 20)
+ * @returns Array of company results
+ */
+export declare function listCompanies(limit?: number): Promise<Company[]>;
+/**
+ * Gets full details for a specific company (all fields)
+ *
+ * @param companyIdOrUri - The ID of the company or its URI (attio://companies/{id})
+ * @returns Company details
+ */
+export declare function getCompanyDetails(companyIdOrUri: string): Promise<Company>;
+/**
+ * Creates a new company with the specified attributes
+ *
+ * @param attributes - Company attributes to set
+ * @returns The created company object
+ * @throws InvalidCompanyDataError if validation fails
+ * @throws CompanyOperationError if creation fails
+ * @example
+ * ```typescript
+ * const company = await createCompany({
+ *   name: "Acme Corp",
+ *   website: "https://acme.com",
+ *   industry: "Technology"
+ * });
+ * ```
+ */
+export declare function createCompany(attributes: CompanyAttributes): Promise<Company>;
+/**
+ * Updates an existing company with new attributes
+ *
+ * @param companyId - ID of the company to update
+ * @param attributes - Company attributes to update (partial update supported)
+ * @returns The updated company object
+ * @throws InvalidCompanyDataError if validation fails
+ * @throws CompanyOperationError if update fails
+ * @example
+ * ```typescript
+ * const updated = await updateCompany("comp_123", {
+ *   industry: "Healthcare",
+ *   employee_range: "100-500"
+ * });
+ * ```
+ */
+export declare function updateCompany(companyId: string, attributes: Partial<CompanyAttributes>): Promise<Company>;
+/**
+ * Updates a specific attribute of a company
+ *
+ * @param companyId - ID of the company to update
+ * @param attributeName - Name of the attribute to update
+ * @param attributeValue - New value for the attribute
+ * @returns Updated company record
+ * @throws InvalidCompanyDataError if validation fails
+ * @throws CompanyOperationError if update fails
+ *
+ * @example
+ * ```typescript
+ * // Update a simple string attribute
+ * const updated = await updateCompanyAttribute(
+ *   "company_123",
+ *   "website",
+ *   "https://example.com"
+ * );
+ *
+ * // Update main_contact with Person Record ID
+ * const withPerson = await updateCompanyAttribute(
+ *   "company_123",
+ *   "main_contact",
+ *   "person_01h8g3j5k7m9n1p3r"
+ * );
+ *
+ * // Update main_contact with person name (will be looked up)
+ * const byName = await updateCompanyAttribute(
+ *   "company_123",
+ *   "main_contact",
+ *   "John Smith"
+ * );
+ *
+ * // Clear an attribute
+ * const cleared = await updateCompanyAttribute(
+ *   "company_123",
+ *   "website",
+ *   null
+ * );
+ * ```
+ */
+export declare function updateCompanyAttribute(companyId: string, attributeName: string, attributeValue: any): Promise<Company>;
+/**
+ * Deletes a company permanently from the system
+ *
+ * @param companyId - ID of the company to delete
+ * @returns True if deletion was successful
+ * @throws InvalidCompanyDataError if validation fails
+ * @throws CompanyOperationError if deletion fails
+ * @example
+ * ```typescript
+ * const success = await deleteCompany("comp_123");
+ * if (success) {
+ *   console.log("Company deleted successfully");
+ * }
+ * ```
+ */
+export declare function deleteCompany(companyId: string): Promise<boolean>;
+/**
+ * Extracts company ID from a URI or returns the ID directly
+ *
+ * @param companyIdOrUri - Either a direct ID or URI format (attio://companies/{id})
+ * @returns The extracted company ID
+ * @throws Error if the URI format is invalid
+ */
+export declare function extractCompanyId(companyIdOrUri: string): string;
+//# sourceMappingURL=basic.d.ts.map

package/dist/objects/companies/basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../../src/objects/companies/basic.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,OAAO,EAAU,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAc/C;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAqB1E;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CA0JlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,OAAO,CAAC,OAAO,CAAC,CAkBlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,GAAG,GAClB,OAAO,CAAC,OAAO,CAAC,CA2DlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBvE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAmD/D"}