@iflow-mcp/attio-mcp 1.3.6

package/dist/handlers/tool-configs/relationships/state-analyzer.js

@@ -0,0 +1,100 @@
+/**
+ * Relationship state analysis utilities for SRP compliance
+ */
+import { extractRecordIds } from '../../../utils/relationship-helpers.js';
+import { getCompanyDetails } from '../../../objects/companies/index.js';
+import { getPersonDetails as getPersonDetailsFromPeople } from '../../../objects/people/index.js';
+export class RelationshipStateAnalyzer {
+    /**
+     * Analyze current relationship state for linking operations
+     */
+    static async analyzeForLinking(personId, companyId) {
+        // Get current company and person details
+        const [company, person] = await Promise.all([
+            getCompanyDetails(companyId),
+            getPersonDetailsFromPeople(personId),
+        ]);
+        // Extract current team members and person's company
+        const currentTeam = Array.isArray(company.values?.team)
+            ? company.values.team
+            : [];
+        const currentTeamIds = extractRecordIds(currentTeam);
+        const currentPersonCompany = person.values?.company;
+        const currentPersonCompanyId = currentPersonCompany
+            ? typeof currentPersonCompany === 'string'
+                ? currentPersonCompany
+                : String(currentPersonCompany)
+            : null;
+        // Check current linking state
+        const isInTeam = currentTeamIds.includes(personId);
+        const isCompanySet = currentPersonCompanyId === companyId;
+        // Check for conflicts
+        const hasConflict = Boolean(currentPersonCompanyId && currentPersonCompanyId !== companyId);
+        const conflictMessage = hasConflict
+            ? `Person is already linked to company ${currentPersonCompanyId}. Use unlink-person-from-company first.`
+            : undefined;
+        return {
+            currentTeamIds,
+            currentPersonCompanyId,
+            isInTeam,
+            isCompanySet,
+            hasConflict,
+            conflictMessage,
+        };
+    }
+    /**
+     * Analyze current relationship state for unlinking operations
+     */
+    static async analyzeForUnlinking(personId, companyId) {
+        // Get current company and person details
+        const [company, person] = await Promise.all([
+            getCompanyDetails(companyId),
+            getPersonDetailsFromPeople(personId),
+        ]);
+        // Extract current team members and person's company
+        const currentTeam = Array.isArray(company.values?.team)
+            ? company.values.team
+            : [];
+        const currentTeamIds = extractRecordIds(currentTeam);
+        const currentPersonCompany = person.values?.company;
+        const currentPersonCompanyId = currentPersonCompany
+            ? typeof currentPersonCompany === 'string'
+                ? currentPersonCompany
+                : String(currentPersonCompany)
+            : null;
+        // Check current linking state
+        const isInTeam = currentTeamIds.includes(personId);
+        const isCompanySet = currentPersonCompanyId === companyId;
+        // Determine if partial unlinking is needed
+        const needsPartialUnlink = Boolean(!isInTeam || !isCompanySet || currentPersonCompanyId !== companyId);
+        return {
+            currentTeamIds,
+            currentPersonCompanyId,
+            isInTeam,
+            isCompanySet,
+            needsPartialUnlink,
+        };
+    }
+    /**
+     * Extract person name from person record with fallbacks
+     */
+    static extractPersonName(person) {
+        const values = person.values;
+        return (values?.name?.[0]?.value ||
+            values?.full_name?.[0]?.value ||
+            'Unknown Person');
+    }
+    /**
+     * Extract and normalize person company ID
+     */
+    static extractPersonCompanyId(person) {
+        const values = person.values;
+        const personCompany = values?.company;
+        return personCompany
+            ? typeof personCompany === 'string'
+                ? personCompany
+                : String(personCompany)
+            : null;
+    }
+}
+//# sourceMappingURL=state-analyzer.js.map

package/dist/handlers/tool-configs/relationships/state-analyzer.js.map

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

package/dist/handlers/tool-configs/relationships/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Type definitions for relationship operations
+ */
+export interface RelationshipOperationResult {
+    success: boolean;
+    message: string;
+    companyId: string;
+    personId: string;
+    teamSize?: number;
+    error?: string;
+}
+export interface PersonInfo {
+    id: string;
+    name: string;
+}
+export interface RelationshipState {
+    isInTeam: boolean;
+    isCompanySet: boolean;
+    currentTeamIds: string[];
+    currentPersonCompanyId?: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/handlers/tool-configs/relationships/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/relationships/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC"}

package/dist/handlers/tool-configs/relationships/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for relationship operations
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/handlers/tool-configs/relationships/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/relationships/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/handlers/tool-configs/relationships/validators.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Relationship validation utilities for improved SRP compliance
+ */
+import { RelationshipOperationResult } from './types.js';
+export interface ValidationResult {
+    isValid: boolean;
+    shouldProceed: boolean;
+    result?: RelationshipOperationResult;
+}
+export interface InconsistencyReport {
+    hasInconsistency: boolean;
+    type: 'partial_link' | 'partial_unlink' | 'mismatch' | 'none';
+    description: string;
+}
+export declare class RelationshipValidator {
+    /**
+     * Validate linking operation and determine if it should proceed
+     */
+    static validateForLink(personId: string, companyId: string, isInTeam: boolean, isCompanySet: boolean, hasConflict: boolean, conflictMessage: string | undefined, currentTeamIds: string[]): ValidationResult;
+    /**
+     * Validate unlinking operation and determine if it should proceed
+     */
+    static validateForUnlink(personId: string, companyId: string, isInTeam: boolean, isCompanySet: boolean, currentTeamIds: string[]): ValidationResult;
+    /**
+     * Detect relationship inconsistencies for reporting
+     */
+    static detectInconsistencies(isInTeam: boolean, isCompanySet: boolean, currentPersonCompanyId: string | null, targetCompanyId: string): InconsistencyReport;
+    /**
+     * Create successful operation result
+     */
+    static createSuccessResult(message: string, personId: string, companyId: string, teamSize: number): RelationshipOperationResult;
+    /**
+     * Create failed operation result
+     */
+    static createFailureResult(message: string, personId: string, companyId: string, error: string): RelationshipOperationResult;
+}
+//# sourceMappingURL=validators.d.ts.map

package/dist/handlers/tool-configs/relationships/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/relationships/validators.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAMzD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,2BAA2B,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,IAAI,EAAE,cAAc,GAAG,gBAAgB,GAAG,UAAU,GAAG,MAAM,CAAC;IAC9D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,qBAAqB;IAChC;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,OAAO,EACpB,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,cAAc,EAAE,MAAM,EAAE,GACvB,gBAAgB;IAsCnB;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,EACrB,cAAc,EAAE,MAAM,EAAE,GACvB,gBAAgB;IAuBnB;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,EACrB,sBAAsB,EAAE,MAAM,GAAG,IAAI,EACrC,eAAe,EAAE,MAAM,GACtB,mBAAmB;IAkCtB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,2BAA2B;IAU9B;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,2BAA2B;CAS/B"}

package/dist/handlers/tool-configs/relationships/validators.js

@@ -0,0 +1,125 @@
+/**
+ * Relationship validation utilities for improved SRP compliance
+ */
+export class RelationshipValidator {
+    /**
+     * Validate linking operation and determine if it should proceed
+     */
+    static validateForLink(personId, companyId, isInTeam, isCompanySet, hasConflict, conflictMessage, currentTeamIds) {
+        // Already fully linked
+        if (isInTeam && isCompanySet) {
+            return {
+                isValid: true,
+                shouldProceed: false,
+                result: {
+                    success: true,
+                    message: 'Person is already bidirectionally linked to this company',
+                    companyId,
+                    personId,
+                    teamSize: currentTeamIds.length,
+                },
+            };
+        }
+        // Conflict: person already has different company
+        if (hasConflict && conflictMessage) {
+            return {
+                isValid: false,
+                shouldProceed: false,
+                result: {
+                    success: false,
+                    message: conflictMessage,
+                    companyId,
+                    personId,
+                    error: 'Person already has a different company assigned',
+                },
+            };
+        }
+        // Valid operation that should proceed
+        return {
+            isValid: true,
+            shouldProceed: true,
+        };
+    }
+    /**
+     * Validate unlinking operation and determine if it should proceed
+     */
+    static validateForUnlink(personId, companyId, isInTeam, isCompanySet, currentTeamIds) {
+        // Not linked at all
+        if (!isInTeam && !isCompanySet) {
+            return {
+                isValid: true,
+                shouldProceed: false,
+                result: {
+                    success: true,
+                    message: 'Person is not linked to this company',
+                    companyId,
+                    personId,
+                    teamSize: currentTeamIds.length,
+                },
+            };
+        }
+        // Valid operation that should proceed
+        return {
+            isValid: true,
+            shouldProceed: true,
+        };
+    }
+    /**
+     * Detect relationship inconsistencies for reporting
+     */
+    static detectInconsistencies(isInTeam, isCompanySet, currentPersonCompanyId, targetCompanyId) {
+        // Check for partial linking
+        if (isInTeam && !isCompanySet) {
+            return {
+                hasInconsistency: true,
+                type: 'partial_link',
+                description: 'Person is in company team but company field is not set',
+            };
+        }
+        if (!isInTeam && isCompanySet) {
+            return {
+                hasInconsistency: true,
+                type: 'partial_link',
+                description: 'Person has company field set but is not in team',
+            };
+        }
+        // Check for company mismatch
+        if (currentPersonCompanyId && currentPersonCompanyId !== targetCompanyId) {
+            return {
+                hasInconsistency: true,
+                type: 'mismatch',
+                description: `Person's company field points to ${currentPersonCompanyId}, not ${targetCompanyId}`,
+            };
+        }
+        return {
+            hasInconsistency: false,
+            type: 'none',
+            description: 'No inconsistencies detected',
+        };
+    }
+    /**
+     * Create successful operation result
+     */
+    static createSuccessResult(message, personId, companyId, teamSize) {
+        return {
+            success: true,
+            message,
+            companyId,
+            personId,
+            teamSize,
+        };
+    }
+    /**
+     * Create failed operation result
+     */
+    static createFailureResult(message, personId, companyId, error) {
+        return {
+            success: false,
+            message,
+            companyId,
+            personId,
+            error,
+        };
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/handlers/tool-configs/relationships/validators.js.map

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

package/dist/handlers/tool-configs/resource-specific-tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Configuration for resource-specific tools that don't require objectSlug
+ * These tools have a predefined resource type built into their implementation
+ */
+export declare const RESOURCE_SPECIFIC_CREATE_TOOLS: readonly ["create-company", "create-person"];
+export type ResourceSpecificCreateTool = (typeof RESOURCE_SPECIFIC_CREATE_TOOLS)[number];
+/**
+ * Resource mapping for specific create tools
+ */
+export declare const RESOURCE_TYPE_MAP: Record<ResourceSpecificCreateTool, string>;
+/**
+ * Validation rules for resource-specific tools
+ */
+export declare const VALIDATION_RULES: Record<ResourceSpecificCreateTool, (attributes: Record<string, unknown>) => string | null>;
+//# sourceMappingURL=resource-specific-tools.d.ts.map

package/dist/handlers/tool-configs/resource-specific-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-specific-tools.d.ts","sourceRoot":"","sources":["../../../src/handlers/tool-configs/resource-specific-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,8BAA8B,8CAGjC,CAAC;AACX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAGxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACnC,0BAA0B,EAC1B,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAcvD,CAAC"}

package/dist/handlers/tool-configs/resource-specific-tools.js

@@ -0,0 +1,33 @@
+/**
+ * Configuration for resource-specific tools that don't require objectSlug
+ * These tools have a predefined resource type built into their implementation
+ */
+export const RESOURCE_SPECIFIC_CREATE_TOOLS = [
+    'create-company',
+    'create-person',
+];
+/**
+ * Resource mapping for specific create tools
+ */
+export const RESOURCE_TYPE_MAP = {
+    'create-company': 'companies',
+    'create-person': 'people',
+};
+/**
+ * Validation rules for resource-specific tools
+ */
+export const VALIDATION_RULES = {
+    'create-company': (attributes) => {
+        if (!attributes.name) {
+            return 'Company name is required for create-company tool';
+        }
+        return null;
+    },
+    'create-person': (attributes) => {
+        if (!attributes.name && !attributes.email) {
+            return 'Person name or email is required for create-person tool';
+        }
+        return null;
+    },
+};
+//# sourceMappingURL=resource-specific-tools.js.map

package/dist/handlers/tool-configs/resource-specific-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-specific-tools.js","sourceRoot":"","sources":["../../../src/handlers/tool-configs/resource-specific-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,gBAAgB;IAChB,eAAe;CACP,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA+C;IAC3E,gBAAgB,EAAE,WAAW;IAC7B,eAAe,EAAE,QAAQ;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAGzB;IACF,gBAAgB,EAAE,CAAC,UAAU,EAAE,EAAE;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACrB,OAAO,kDAAkD,CAAC;QAC5D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,eAAe,EAAE,CAAC,UAAU,EAAE,EAAE;QAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAC1C,OAAO,yDAAyD,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/handlers/tool-configs/shared/type-utils.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Type-safe utility functions for extracting values from Attio API responses
+ * Addresses repeated type assertion patterns across tool-config handlers
+ *
+ * **Claude Bot Feedback Implementation:**
+ * This module implements recommendations from PR #677 Claude bot review:
+ * 1. ✅ Runtime type validation with type guards (isNameField, isAttioValueArray)
+ * 2. ✅ Generic utility functions for field extraction (getFieldValue)
+ * 3. ✅ Enhanced JSDoc documentation for complex type assertions
+ * 4. ✅ Standardized type extraction patterns across tool configs
+ * 5. ✅ Elimination of 'as any' patterns in favor of safe alternatives
+ */
+/**
+ * Represents an Attio value entry with typed structure
+ */
+export interface AttioValueEntry {
+    value?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Represents an Attio name field entry with common properties
+ */
+export interface AttioNameEntry {
+    value?: unknown;
+    full_name?: unknown;
+    formatted?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Type guard to check if a value is an array of Attio value entries
+ * Enhanced with runtime validation as recommended in Claude bot feedback
+ */
+export declare function isAttioValueArray(value: unknown): value is AttioValueEntry[];
+/**
+ * Enhanced type guard for name fields with runtime validation
+ * Implements Claude bot feedback recommendation for runtime type validation
+ * @param value - The value to check
+ * @returns True if value is a valid name field array
+ */
+export declare function isNameField(value: unknown): value is Array<{
+    value: unknown;
+}>;
+/**
+ * Generic field value extraction utility as recommended in Claude bot feedback
+ * Extracts values from Attio field arrays with proper type safety
+ * @param field - The field from Attio API response
+ * @param defaultValue - Default value if extraction fails
+ * @returns The extracted value or default
+ *
+ * @example
+ * const name = getFieldValue(person.values?.name, 'Unknown');
+ * const count = getFieldValue(record.values?.count, 0);
+ */
+export declare function getFieldValue<T = unknown>(field: unknown, defaultValue: T): T;
+/**
+ * Safely extracts the first value from an Attio value array
+ * @param fieldValue - The field value from Attio API response
+ * @param fallback - Fallback value if extraction fails
+ * @returns The extracted value or fallback
+ *
+ * @example
+ * const name = safeExtractFirstValue(person.values?.name, 'Unknown');
+ */
+export declare function safeExtractFirstValue(fieldValue: unknown, fallback?: string): string;
+/**
+ * Safely extracts a name from an Attio name field with multiple possible formats
+ * @param nameField - The name field from Attio API response
+ * @param fallback - Fallback value if extraction fails
+ * @returns The extracted name or fallback
+ *
+ * @example
+ * const fullName = safeExtractName(person.values?.name, 'Unknown Person');
+ */
+export declare function safeExtractName(nameField: unknown, fallback?: string): string;
+/**
+ * Safely extracts values from an Attio record's values object
+ * @param record - The record object from Attio API
+ * @returns Type-safe values object or empty object
+ *
+ * @example
+ * const values = safeExtractRecordValues(record);
+ * const name = safeExtractFirstValue(values.name);
+ */
+export declare function safeExtractRecordValues(record: unknown): Record<string, unknown>;
+/**
+ * Type-safe error message extraction
+ * @param error - Error object or unknown value
+ * @returns Error message string
+ *
+ * @example
+ * const message = safeExtractErrorMessage(error);
+ */
+export declare function safeExtractErrorMessage(error: unknown): string;
+/**
+ * Safely extracts timestamp values from various formats
+ * @param timestampField - The timestamp field from Attio API
+ * @param fallback - Fallback value if extraction fails
+ * @returns ISO timestamp string or fallback
+ *
+ * @example
+ * const createdAt = safeExtractTimestamp(record.created_at);
+ */
+export declare function safeExtractTimestamp(timestampField: unknown, fallback?: string): string;
+/**
+ * Type assertion with runtime validation for Attio value arrays
+ * Provides safer alternative to 'as unknown as Array<{ value: unknown }>'
+ *
+ * **Enhanced Documentation (Claude Bot Feedback):**
+ * This function implements a defensive type assertion pattern that:
+ * 1. Validates the runtime type before assertion
+ * 2. Provides helpful debugging information in development
+ * 3. Gracefully degrades to empty array on invalid input
+ * 4. Eliminates the need for unsafe 'as any' patterns
+ *
+ * **Type Safety Guarantees:**
+ * - Returns validated AttioValueEntry[] or empty array
+ * - Never throws on invalid input
+ * - Provides development-time warnings for debugging
+ *
+ * @param value - Value to assert as Attio value array
+ * @returns Type-asserted array or empty array if invalid
+ *
+ * @example
+ * // Safe type assertion with validation
+ * const valueArray = assertAttioValueArray(field.name);
+ * const name = valueArray[0]?.value || 'Unknown';
+ *
+ * // Replaces unsafe patterns like:
+ * // const unsafe = field.name as any as Array<{ value: unknown }>;
+ */
+export declare function assertAttioValueArray(value: unknown): AttioValueEntry[];
+/**
+ * Safely extracts note title from various possible locations in note objects
+ * @param note - Note object from Attio API
+ * @param fallback - Fallback value if extraction fails
+ * @returns Extracted title or fallback
+ *
+ * @example
+ * const title = safeExtractNoteTitle(note, 'Untitled');
+ */
+export declare function safeExtractNoteTitle(note: unknown, fallback?: string): string;
+/**
+ * Safely extracts note content from various possible locations in note objects
+ * @param note - Note object from Attio API
+ * @param fallback - Fallback value if extraction fails
+ * @returns Extracted content or fallback
+ *
+ * @example
+ * const content = safeExtractNoteContent(note, '');
+ */
+export declare function safeExtractNoteContent(note: unknown, fallback?: string): string;
+/**
+ * Safely extracts note timestamp from various possible locations in note objects
+ * @param note - Note object from Attio API
+ * @param fallback - Fallback value if extraction fails
+ * @returns Extracted timestamp or fallback
+ *
+ * @example
+ * const timestamp = safeExtractNoteTimestamp(note, 'unknown');
+ */
+export declare function safeExtractNoteTimestamp(note: unknown, fallback?: string): string;
+//# sourceMappingURL=type-utils.d.ts.map

package/dist/handlers/tool-configs/shared/type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/shared/type-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,EAAE,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,KAAK,CAAC;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAQpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAG7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,OAAO,EACnB,QAAQ,GAAE,MAAkB,GAC3B,MAAM,CAWR;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,MAAkB,GAC3B,MAAM,CAqBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiB9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,OAAO,EACvB,QAAQ,GAAE,MAAiC,GAC1C,MAAM,CAoBR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAevE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAAmB,GAC5B,MAAM,CA6BR;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAAW,GACpB,MAAM,CAsCR;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAAkB,GAC3B,MAAM,CAiCR"}