attio-mcp 0.1.0

package/dist/objects/companies/notes.js

@@ -0,0 +1,199 @@
+/**
+ * Note operations for companies
+ */
+import { getAttioClient } from '../../api/attio-client.js';
+import { getObjectNotes, createObjectNote, } from '../../api/operations/index.js';
+import { ResourceType } from '../../types/attio.js';
+/**
+ * Gets notes for a specific company
+ *
+ * @param companyIdOrUri - The ID of the company or its URI (attio://companies/{id})
+ * @param limit - Maximum number of notes to fetch (default: 10)
+ * @param offset - Number of notes to skip (default: 0)
+ * @returns Array of notes
+ */
+export async function getCompanyNotes(companyIdOrUri, limit = 10, offset = 0) {
+    let companyId;
+    try {
+        // Determine if the input is a URI or a direct ID
+        const isUri = companyIdOrUri.startsWith('attio://');
+        if (isUri) {
+            try {
+                // Try to parse the URI formally
+                const [resourceType, id] = companyIdOrUri.match(/^attio:\/\/([^\/]+)\/(.+)$/)?.slice(1) || [];
+                if (resourceType !== ResourceType.COMPANIES) {
+                    throw new Error(`Invalid resource type in URI: Expected 'companies', got '${resourceType}'`);
+                }
+                companyId = id;
+            }
+            catch (parseError) {
+                // Fallback to simple string splitting if formal parsing fails
+                const parts = companyIdOrUri.split('/');
+                companyId = parts[parts.length - 1];
+            }
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[getCompanyNotes] Extracted company ID ${companyId} from URI ${companyIdOrUri}`);
+            }
+        }
+        else {
+            // Direct ID was provided
+            companyId = companyIdOrUri;
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[getCompanyNotes] Using direct company ID: ${companyId}`);
+            }
+        }
+        // Validate that we have a non-empty ID
+        if (!companyId || companyId.trim() === '') {
+            throw new Error(`Invalid company ID: ${companyIdOrUri}`);
+        }
+        // Use the unified operation if available, with fallback to direct implementation
+        try {
+            return await getObjectNotes(ResourceType.COMPANIES, companyId, limit, offset);
+        }
+        catch (error) {
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[getCompanyNotes] Unified operation failed: ${error.message || 'Unknown error'}`, {
+                    method: 'getObjectNotes',
+                    companyId,
+                    limit,
+                    offset,
+                });
+            }
+            // Fallback implementation with better error handling
+            try {
+                const api = getAttioClient();
+                const path = `/notes?limit=${limit}&offset=${offset}&parent_object=companies&parent_record_id=${companyId}`;
+                if (process.env.NODE_ENV === 'development') {
+                    console.log(`[getCompanyNotes] Trying direct API call: ${path}`);
+                }
+                const response = await api.get(path);
+                return response.data.data || [];
+            }
+            catch (directError) {
+                if (process.env.NODE_ENV === 'development') {
+                    console.error(`[getCompanyNotes] All attempts failed:`, {
+                        companyId,
+                        originalUri: companyIdOrUri,
+                        errors: {
+                            unified: error.message || 'Unknown error',
+                            direct: directError.message || 'Unknown error',
+                        },
+                    });
+                }
+                // Return empty array instead of throwing error when no notes are found
+                if (directError.response?.status === 404) {
+                    return [];
+                }
+                throw new Error(`Could not retrieve notes for company ${companyIdOrUri}: ${directError.message || 'Unknown error'}`);
+            }
+        }
+    }
+    catch (error) {
+        // Catch any errors in the URI parsing logic
+        if (error instanceof Error && error.message.includes('match')) {
+            throw new Error(`Cannot parse company identifier: ${companyIdOrUri}. Use either a direct ID or URI format 'attio://companies/{id}'`);
+        }
+        throw error;
+    }
+}
+/**
+ * Creates a note for a specific company
+ *
+ * @param companyIdOrUri - The ID of the company or its URI (attio://companies/{id})
+ * @param title - The title of the note (will be prefixed with "[AI]")
+ * @param content - The text content of the note
+ * @returns The created note object
+ * @throws Error if company ID cannot be parsed or note creation fails
+ * @example
+ * ```typescript
+ * const note = await createCompanyNote("comp_123", "Meeting Notes",
+ *   "Discussed Q4 strategy with the team...");
+ * ```
+ */
+export async function createCompanyNote(companyIdOrUri, title, content) {
+    let companyId;
+    try {
+        // Determine if the input is a URI or a direct ID
+        const isUri = companyIdOrUri.startsWith('attio://');
+        if (isUri) {
+            try {
+                // Try to parse the URI formally
+                const [resourceType, id] = companyIdOrUri.match(/^attio:\/\/([^\/]+)\/(.+)$/)?.slice(1) || [];
+                if (resourceType !== ResourceType.COMPANIES) {
+                    throw new Error(`Invalid resource type in URI: Expected 'companies', got '${resourceType}'`);
+                }
+                companyId = id;
+            }
+            catch (parseError) {
+                // Fallback to simple string splitting if formal parsing fails
+                const parts = companyIdOrUri.split('/');
+                companyId = parts[parts.length - 1];
+            }
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[createCompanyNote] Extracted company ID ${companyId} from URI ${companyIdOrUri}`);
+            }
+        }
+        else {
+            // Direct ID was provided
+            companyId = companyIdOrUri;
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[createCompanyNote] Using direct company ID: ${companyId}`);
+            }
+        }
+        // Validate that we have a non-empty ID
+        if (!companyId || companyId.trim() === '') {
+            throw new Error(`Invalid company ID: ${companyIdOrUri}`);
+        }
+        // Use the unified operation if available, with fallback to direct implementation
+        try {
+            return await createObjectNote(ResourceType.COMPANIES, companyId, title, content);
+        }
+        catch (error) {
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[createCompanyNote] Unified operation failed: ${error.message || 'Unknown error'}`, {
+                    method: 'createObjectNote',
+                    companyId,
+                });
+            }
+            // Fallback implementation with better error handling
+            try {
+                const api = getAttioClient();
+                const path = 'notes';
+                if (process.env.NODE_ENV === 'development') {
+                    console.log(`[createCompanyNote] Trying direct API call: ${path}`);
+                }
+                const response = await api.post(path, {
+                    data: {
+                        format: 'plaintext',
+                        parent_object: 'companies',
+                        parent_record_id: companyId,
+                        title: `[AI] ${title}`,
+                        content,
+                    },
+                });
+                return response.data;
+            }
+            catch (directError) {
+                if (process.env.NODE_ENV === 'development') {
+                    console.error(`[createCompanyNote] All attempts failed:`, {
+                        companyId,
+                        originalUri: companyIdOrUri,
+                        errors: {
+                            unified: error.message || 'Unknown error',
+                            direct: directError.message || 'Unknown error',
+                        },
+                    });
+                }
+                throw new Error(`Could not create note for company ${companyIdOrUri}: ${directError.message || 'Unknown error'}`);
+            }
+        }
+    }
+    catch (error) {
+        // Catch any errors in the URI parsing logic
+        if (error instanceof Error && error.message.includes('match')) {
+            throw new Error(`Cannot parse company identifier: ${companyIdOrUri}. Use either a direct ID or URI format 'attio://companies/{id}'`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=notes.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * Relationship-based queries for companies
+ */
+import { Company, AttioList } from '../../types/attio.js';
+import { ListEntryFilters } from '../../api/operations/index.js';
+/**
+ * Search for companies based on attributes of their associated people
+ *
+ * @param peopleFilter - Filter to apply to people
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching companies
+ */
+export declare function searchCompaniesByPeople(peopleFilter: ListEntryFilters | string | any, limit?: number | string, offset?: number | string): Promise<Company[]>;
+/**
+ * Search for companies that have employees in a specific list
+ *
+ * @param listId - ID of the list containing people
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching companies
+ */
+export declare function searchCompaniesByPeopleList(listId: string, limit?: number | string, offset?: number | string): Promise<Company[]>;
+/**
+ * Search for companies that have notes containing specific text
+ *
+ * @param searchText - Text to search for in notes
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching companies
+ */
+export declare function searchCompaniesByNotes(searchText: string, limit?: number | string, offset?: number | string): Promise<Company[]>;
+/**
+ * Gets lists that a company belongs to
+ *
+ * @param companyId - ID of the company
+ * @param limit - Maximum number of list entries to check (default: 50)
+ * @returns Array of unique lists containing the company
+ */
+export declare function getCompanyLists(companyId: string, limit?: number): Promise<AttioList[]>;
+//# sourceMappingURL=relationships.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../../src/objects/companies/relationships.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,OAAO,EACP,SAAS,EAEV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAYjE;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,gBAAgB,GAAG,MAAM,GAAG,GAAG,EAC7C,KAAK,GAAE,MAAM,GAAG,MAAW,EAC3B,MAAM,GAAE,MAAM,GAAG,MAAU,GAC1B,OAAO,CAAC,OAAO,EAAE,CAAC,CAoCpB;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAM,GAAG,MAAW,EAC3B,MAAM,GAAE,MAAM,GAAG,MAAU,GAC1B,OAAO,CAAC,OAAO,EAAE,CAAC,CA8BpB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAM,GAAG,MAAW,EAC3B,MAAM,GAAE,MAAM,GAAG,MAAU,GAC1B,OAAO,CAAC,OAAO,EAAE,CAAC,CAqCpB;AACD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CAkCtB"}

package/dist/objects/companies/relationships.js

@@ -0,0 +1,142 @@
+/**
+ * Relationship-based queries for companies
+ */
+import { ResourceType, } from '../../types/attio.js';
+import { FilterValidationError } from '../../errors/api-errors.js';
+import { validateNumericParam } from '../../utils/filters/index.js';
+import { getAttioClient } from '../../api/attio-client.js';
+import { getListDetails } from '../lists.js';
+import { createCompaniesByPeopleFilter, createCompaniesByPeopleListFilter, createRecordsByNotesFilter, } from '../../utils/relationship-utils.js';
+import { advancedSearchCompanies } from './search.js';
+/**
+ * Search for companies based on attributes of their associated people
+ *
+ * @param peopleFilter - Filter to apply to people
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching companies
+ */
+export async function searchCompaniesByPeople(peopleFilter, limit = 20, offset = 0) {
+    try {
+        // Ensure peopleFilter is a properly structured filter object
+        if (typeof peopleFilter !== 'object' ||
+            !peopleFilter ||
+            !peopleFilter.filters) {
+            throw new FilterValidationError('People filter must be a valid ListEntryFilters object with at least one filter');
+        }
+        // Validate and normalize limit and offset parameters
+        const validatedLimit = validateNumericParam(limit, 'limit', 20);
+        const validatedOffset = validateNumericParam(offset, 'offset', 0);
+        // Create the relationship-based filter and perform the search
+        const filters = createCompaniesByPeopleFilter(peopleFilter);
+        const results = await advancedSearchCompanies(filters, validatedLimit, validatedOffset);
+        return Array.isArray(results) ? results : [];
+    }
+    catch (error) {
+        // Convert all errors to FilterValidationErrors for consistent handling
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new FilterValidationError(`Failed to search companies by people: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Search for companies that have employees in a specific list
+ *
+ * @param listId - ID of the list containing people
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching companies
+ */
+export async function searchCompaniesByPeopleList(listId, limit = 20, offset = 0) {
+    try {
+        // Validate listId
+        if (!listId || typeof listId !== 'string' || listId.trim() === '') {
+            throw new FilterValidationError('List ID must be a non-empty string');
+        }
+        // Validate and normalize limit and offset parameters
+        const validatedLimit = validateNumericParam(limit, 'limit', 20);
+        const validatedOffset = validateNumericParam(offset, 'offset', 0);
+        // Create the relationship-based filter and perform the search
+        const filters = createCompaniesByPeopleListFilter(listId);
+        const results = await advancedSearchCompanies(filters, validatedLimit, validatedOffset);
+        return Array.isArray(results) ? results : [];
+    }
+    catch (error) {
+        // Convert all errors to FilterValidationErrors for consistent handling
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new FilterValidationError(`Failed to search companies by people list: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Search for companies that have notes containing specific text
+ *
+ * @param searchText - Text to search for in notes
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of matching companies
+ */
+export async function searchCompaniesByNotes(searchText, limit = 20, offset = 0) {
+    try {
+        // Validate searchText
+        if (!searchText ||
+            typeof searchText !== 'string' ||
+            searchText.trim() === '') {
+            throw new FilterValidationError('Search text must be a non-empty string');
+        }
+        // Validate and normalize limit and offset parameters
+        const validatedLimit = validateNumericParam(limit, 'limit', 20);
+        const validatedOffset = validateNumericParam(offset, 'offset', 0);
+        // Create the relationship-based filter and perform the search
+        const filters = createRecordsByNotesFilter(ResourceType.COMPANIES, searchText);
+        const results = await advancedSearchCompanies(filters, validatedLimit, validatedOffset);
+        return Array.isArray(results) ? results : [];
+    }
+    catch (error) {
+        // Convert all errors to FilterValidationErrors for consistent handling
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new FilterValidationError(`Failed to search companies by notes: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Gets lists that a company belongs to
+ *
+ * @param companyId - ID of the company
+ * @param limit - Maximum number of list entries to check (default: 50)
+ * @returns Array of unique lists containing the company
+ */
+export async function getCompanyLists(companyId, limit = 50) {
+    const api = getAttioClient();
+    const response = await api.post('/lists-entries/query', {
+        filter: { record_id: { $equals: companyId } },
+        expand: ['list'],
+        limit,
+    });
+    const entries = response.data.data || [];
+    const lists = [];
+    const seen = new Set();
+    for (const entry of entries) {
+        const listId = entry.list?.id?.list_id || entry.list_id;
+        if (!listId || seen.has(listId))
+            continue;
+        seen.add(listId);
+        if (entry.list) {
+            lists.push(entry.list);
+        }
+        else {
+            try {
+                const detail = await getListDetails(listId);
+                lists.push(detail);
+            }
+            catch {
+                // ignore retrieval errors
+            }
+        }
+    }
+    return lists;
+}
+//# sourceMappingURL=relationships.js.map

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

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

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

@@ -0,0 +1,158 @@
+import { ListEntryFilters } from '../../api/operations/index.js';
+import { Company, FilterConditionType } from '../../types/attio.js';
+/**
+ * Cache management functions for testing and administration
+ */
+export declare const companyCache: {
+    clear: () => void;
+    size: () => number;
+};
+/**
+ * Configuration options for company search
+ */
+export interface CompanySearchOptions {
+    /** Whether to prioritize domain matches over name matches (default: true) */
+    prioritizeDomains?: boolean;
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Whether to include debug logging */
+    debug?: boolean;
+}
+/**
+ * Searches for companies with domain prioritization when available
+ *
+ * @param query - Search query string to match against company names or domains
+ * @param options - Optional search configuration
+ * @returns Array of matching company objects, prioritized by domain matches
+ * @example
+ * ```typescript
+ * const companies = await searchCompanies("acme.com");
+ * // Returns companies with domain "acme.com" first, then name matches
+ *
+ * const companies = await searchCompanies("acme");
+ * // Returns companies with names containing "acme"
+ *
+ * const companies = await searchCompanies("acme.com", { prioritizeDomains: false });
+ * // Disables domain prioritization, uses name-based search only
+ * ```
+ */
+export declare function searchCompanies(query: string, options?: CompanySearchOptions): Promise<Company[]>;
+/**
+ * Searches for companies by domain/website
+ *
+ * @param domain - Domain to search for
+ * @returns Array of matching company objects
+ */
+export declare function searchCompaniesByDomain(domain: string): Promise<Company[]>;
+/**
+ * Searches for companies by name only
+ *
+ * @param query - Search query string to match against company names
+ * @returns Array of matching company objects
+ */
+export declare function searchCompaniesByName(query: string): Promise<Company[]>;
+/**
+ * Performs advanced search with custom filters
+ *
+ * @param filters - List of filters to apply
+ * @param limit - Maximum number of results to return (default: 20)
+ * @param offset - Number of results to skip (default: 0)
+ * @returns Array of company results
+ * @throws Error if the search encounters any issues
+ * @example
+ * ```typescript
+ * // Search for companies with names containing "Tech"
+ * const filters = {
+ *   filters: [
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Tech'
+ *     }
+ *   ]
+ * };
+ * const companies = await advancedSearchCompanies(filters);
+ *
+ * // Search with multiple conditions using OR logic
+ * const orFilters = {
+ *   filters: [
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Tech'
+ *     },
+ *     {
+ *       attribute: { slug: 'industry' },
+ *       condition: 'equals',
+ *       value: 'Software'
+ *     }
+ *   ],
+ *   matchAny: true // Use OR logic between conditions
+ * };
+ *
+ * // Complex search with nested conditions
+ * const complexFilters = {
+ *   filters: [
+ *     // Company name condition
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Tech'
+ *     },
+ *     // Revenue condition - find companies with annual revenue > $10M
+ *     {
+ *       attribute: { slug: 'annual_revenue' },
+ *       condition: 'greater_than',
+ *       value: 10000000
+ *     },
+ *     // Industry condition
+ *     {
+ *       attribute: { slug: 'industry' },
+ *       condition: 'equals',
+ *       value: 'Software'
+ *     }
+ *   ]
+ * };
+ * ```
+ */
+export declare function advancedSearchCompanies(filters: ListEntryFilters, limit?: number, offset?: number): Promise<Company[]>;
+/**
+ * Helper function to create filters for searching companies by name
+ *
+ * @param name - Name to search for
+ * @param condition - Condition type (default: CONTAINS)
+ * @returns ListEntryFilters object configured for name search
+ */
+export declare function createNameFilter(name: string, condition?: FilterConditionType): ListEntryFilters;
+/**
+ * Helper function to create filters for searching companies by website
+ *
+ * @param website - Website to search for
+ * @param condition - Condition type (default: CONTAINS)
+ * @returns ListEntryFilters object configured for website search
+ */
+export declare function createWebsiteFilter(website: string, condition?: FilterConditionType): ListEntryFilters;
+/**
+ * Helper function to create filters for searching companies by industry
+ *
+ * @param industry - Industry to search for
+ * @param condition - Condition type (default: CONTAINS)
+ * @returns ListEntryFilters object configured for industry search
+ */
+export declare function createIndustryFilter(industry: string, condition?: FilterConditionType): ListEntryFilters;
+/**
+ * Helper function to create filters for searching companies by domain
+ *
+ * @param domain - Domain to search for
+ * @param condition - Condition type (default: CONTAINS)
+ * @returns ListEntryFilters object configured for domain search
+ */
+export declare function createDomainFilter(domain: string, condition?: FilterConditionType): ListEntryFilters;
+/**
+ * Smart search that automatically determines search strategy based on query content
+ *
+ * @param query - Search query that may contain domain, email, URL, or company name
+ * @returns Array of matching company objects with domain matches prioritized
+ */
+export declare function smartSearchCompanies(query: string): Promise<Company[]>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/objects/companies/search.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,OAAO,EACP,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAkF9B;;GAEG;AACH,eAAO,MAAM,YAAY;;;CAGxB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,OAAO,EAAE,CAAC,CA6EpB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,EAAE,CAAC,CAwCpB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAoD7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,EAAE,CAAC,CA+CpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,mBAAkD,GAC5D,gBAAgB,CAUlB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,mBAAkD,GAC5D,gBAAgB,CAUlB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,mBAAkD,GAC5D,gBAAgB,CAUlB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,mBAAkD,GAC5D,gBAAgB,CAWlB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAyD5E"}