attio-mcp 0.1.2 → 1.1.0

package/dist/types/service-types.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Service-specific type definitions for improved type safety
+ *
+ * This file contains interfaces and types used across various services
+ * to replace generic 'any' types with proper type definitions.
+ */
+/**
+ * Generic attribute structure from Attio API
+ */
+export interface AttioAttribute {
+    api_slug: string;
+    title: string;
+    name?: string;
+    type: string;
+    description?: string;
+    is_required?: boolean;
+    is_unique?: boolean;
+    is_multivalue?: boolean;
+    default_value?: unknown;
+    options?: unknown[];
+}
+/**
+ * Attribute response structure from API
+ */
+export interface AttributeResponse {
+    data: AttioAttribute[];
+    meta?: {
+        count?: number;
+        next_cursor?: string;
+    };
+}
+/**
+ * Field mapping result with type safety
+ */
+export interface FieldMappingResult<T = Record<string, unknown>> {
+    mapped: T;
+    warnings: string[];
+    errors?: string[];
+    collisions?: string[];
+    suggestions?: string[];
+}
+/**
+ * Person field input structure for type-safe field picking
+ */
+export interface PersonFieldInput {
+    name?: unknown;
+    email_addresses?: unknown;
+    phone_numbers?: unknown;
+    title?: unknown;
+    first_name?: unknown;
+    last_name?: unknown;
+    full_name?: unknown;
+    email?: unknown;
+    phone?: unknown;
+    job_title?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Allowed person fields output structure
+ */
+export interface AllowedPersonFields {
+    name?: string | unknown[];
+    email_addresses?: string[];
+    phone_numbers?: string[];
+    title?: string;
+    [key: string]: unknown;
+}
+/**
+ * E2E test markers structure
+ */
+export interface E2EMarkers {
+    prefix?: string;
+    suffix?: string;
+    runId?: string;
+    testMode?: boolean;
+}
+/**
+ * E2E metadata for test data generation
+ */
+export interface E2EMeta {
+    runId?: string;
+    testSuite?: string;
+    markers?: E2EMarkers;
+}
+/**
+ * Axios error structure (partial, for error handling)
+ */
+export interface AxiosErrorLike {
+    response?: {
+        status?: number;
+        statusText?: string;
+        data?: {
+            error?: {
+                message?: string;
+                code?: string;
+            };
+            message?: string;
+            code?: string;
+        };
+    };
+    message?: string;
+    code?: string;
+    config?: {
+        url?: string;
+        method?: string;
+    };
+}
+/**
+ * List membership route parameters
+ */
+export interface ListMembershipParams {
+    list_id?: string;
+    listId?: string;
+    record_id?: string;
+    recordId?: string;
+    object?: string;
+    [key: string]: unknown;
+}
+/**
+ * Generic API response structure
+ */
+export interface ApiResponse<T = unknown> {
+    data?: T;
+    meta?: {
+        count?: number;
+        next_cursor?: string;
+        has_more?: boolean;
+    };
+    error?: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+}
+/**
+ * Validation message extraction context
+ */
+export interface ValidationErrorContext {
+    response?: {
+        data?: {
+            message?: string;
+            detail?: string;
+            error?: {
+                message?: string;
+                details?: unknown;
+            } | string;
+            errors?: Array<{
+                message?: string;
+                field?: string;
+            }>;
+        };
+    };
+    message?: string;
+}
+/**
+ * Performance tracking data
+ */
+export interface PerformanceData {
+    operation: string;
+    duration: number;
+    resource_type?: string;
+    cache_hit?: boolean;
+    error?: string;
+    timestamp: number;
+}
+/**
+ * Cache entry base structure
+ */
+export interface CacheEntryBase {
+    timestamp: number;
+    data: unknown;
+}
+/**
+ * Type-safe record for field transformations
+ */
+export interface TransformableRecord extends Record<string, unknown> {
+    id?: string | {
+        record_id: string;
+    };
+    created_at?: string;
+    updated_at?: string;
+    name?: unknown;
+    values?: Record<string, unknown>;
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Utility type for making specific properties required
+ */
+export type WithRequired<T, K extends keyof T> = T & {
+    [P in K]-?: T[P];
+};
+/**
+ * Utility type for partial record with known string keys
+ */
+export type PartialRecord<K extends string | number | symbol, T> = {
+    [P in K]?: T;
+};
+/**
+ * Type-safe unknown object (better than any)
+ */
+export type UnknownRecord = Record<string, unknown>;
+/**
+ * Type guard for checking if value is an object
+ */
+export declare function isRecord(value: unknown): value is UnknownRecord;
+/**
+ * Type guard for checking if value is a string array
+ */
+export declare function isStringArray(value: unknown): value is string[];
+/**
+ * Type guard for checking if value is an Attio attribute
+ */
+export declare function isAttioAttribute(value: unknown): value is AttioAttribute;
+//# sourceMappingURL=service-types.d.ts.map

package/dist/types/service-types.d.ts.map

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

package/dist/types/service-types.js

@@ -0,0 +1,28 @@
+/**
+ * Service-specific type definitions for improved type safety
+ *
+ * This file contains interfaces and types used across various services
+ * to replace generic 'any' types with proper type definitions.
+ */
+/**
+ * Type guard for checking if value is an object
+ */
+export function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Type guard for checking if value is a string array
+ */
+export function isStringArray(value) {
+    return (Array.isArray(value) && value.every((item) => typeof item === 'string'));
+}
+/**
+ * Type guard for checking if value is an Attio attribute
+ */
+export function isAttioAttribute(value) {
+    return (isRecord(value) &&
+        typeof value.api_slug === 'string' &&
+        typeof value.title === 'string' &&
+        typeof value.type === 'string');
+}
+//# sourceMappingURL=service-types.js.map

package/dist/types/service-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-types.js","sourceRoot":"","sources":["../../src/types/service-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuNH;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CACxE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAC/B,CAAC;AACJ,CAAC"}

package/dist/types/tool-types.d.ts

@@ -252,11 +252,27 @@ export interface ContactValue {
 }
 /**
  * Note interface for displaying notes
+ * Handles multiple API response formats for backward compatibility
  */
 export interface NoteDisplay {
     title?: string;
     content?: string;
+    created_at?: string;
     timestamp?: string;
+    text?: string;
+    body?: string;
+    data?: {
+        title?: string;
+        content?: string;
+        created_at?: string;
+        [key: string]: unknown;
+    };
+    values?: {
+        title?: string;
+        content?: string;
+        created_at?: string;
+        [key: string]: unknown;
+    };
     [key: string]: unknown;
 }
 //# sourceMappingURL=tool-types.d.ts.map

package/dist/types/tool-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-types.d.ts","sourceRoot":"","sources":["../../src/types/tool-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-types.d.ts","sourceRoot":"","sources":["../../src/types/tool-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE;QACN,SAAS,EAAE,oBAAoB,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,KAAK,CAAC;QACb,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,KAAK,CAAC;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,KAAK,CAAC,OAAO,CAAC,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IAEF,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/universal-service-types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Universal Service Type Definitions
+ *
+ * Centralized type definitions for Universal*Service classes to eliminate
+ * repeated inline type definitions and improve type safety.
+ *
+ * This file extracts common patterns found across:
+ * - UniversalDeleteService
+ * - UniversalUpdateService
+ * - UniversalRetrievalService
+ * - UniversalSearchService
+ * - UniversalMetadataService
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+/**
+ * Standardized error response structure used across Universal services
+ *
+ * @see UniversalDeleteService lines 72-77, 90-95, 112-117, etc.
+ * @see UniversalUpdateService lines 118-123, 137-142
+ * @see UniversalRetrievalService lines 384-389, 405-410
+ */
+export interface UniversalErrorResponse {
+    status: number;
+    body: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Common "not found" error response (404) used throughout Universal services
+ *
+ * **Design Decision**: Using Record<string, unknown> instead of any for type safety.
+ * This allows property access while preventing unsafe operations on unknown data.
+ */
+export interface NotFoundErrorResponse extends UniversalErrorResponse {
+    status: 404;
+    body: {
+        code: 'not_found';
+        message: string;
+    };
+}
+/**
+ * Error object structures commonly encountered in Universal services
+ *
+ * **Type Safety Note**: These interfaces use Record<string, unknown> rather than any
+ * to provide type safety while allowing dynamic property access. This prevents
+ * accidental misuse of error properties while maintaining flexibility.
+ */
+export interface ApiErrorWithResponse {
+    response?: {
+        status?: number;
+        data?: {
+            code?: string;
+            message?: string;
+        };
+    };
+    status?: number;
+    code?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+/**
+ * Error structure for task-specific operations
+ * Used in UniversalDeleteService task handling
+ */
+export interface TaskError extends Error {
+    status?: number;
+    body?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Generic error object structure found across Universal services
+ *
+ * @example
+ * ```typescript
+ * // Instead of:
+ * const errorObj = apiError as any;
+ *
+ * // Use:
+ * const errorObj = apiError as GenericErrorObject;
+ * ```
+ */
+export interface GenericErrorObject {
+    response?: {
+        status?: number;
+        data?: {
+            message?: string;
+            error?: {
+                message?: string;
+                detail?: string;
+                details?: unknown;
+            };
+            details?: unknown;
+        };
+    };
+    status?: number;
+    statusCode?: number;
+    code?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+/**
+ * Attribute object structure for metadata operations
+ *
+ * **Record<string, unknown> Rationale**: Attribute objects from the API can contain
+ * arbitrary properties. Using unknown ensures we handle these safely rather than
+ * bypassing type checking with any.
+ */
+export interface AttributeObject {
+    api_slug?: string;
+    title?: string;
+    name?: string;
+    [key: string]: unknown;
+}
+/**
+ * Data payload structure for Universal service operations
+ *
+ * Used in update/create operations where data can be in various formats
+ */
+export interface DataPayload {
+    values?: Record<string, unknown>;
+    object?: string;
+    object_api_slug?: string;
+    [key: string]: unknown;
+}
+/**
+ * Type guards for Universal service error handling
+ */
+/**
+ * Type guard to check if an error has the expected API error structure
+ *
+ * @param error - Unknown error object
+ * @returns true if error matches ApiErrorWithResponse structure
+ */
+export declare function isApiErrorWithResponse(error: unknown): error is ApiErrorWithResponse;
+/**
+ * Type guard to check if an error is a 404 not found error
+ *
+ * **Usage Pattern**: Extracted from repeated 404 detection logic across services
+ *
+ * @param error - Unknown error object
+ * @returns true if error indicates a 404 not found condition
+ */
+export declare function is404Error(error: unknown): boolean;
+/**
+ * Type guard for checking if a value is an attribute object
+ *
+ * @param value - Unknown value to check
+ * @returns true if value has expected attribute structure
+ */
+export declare function isAttributeObject(value: unknown): value is AttributeObject;
+/**
+ * Helper to create standardized not found error responses
+ *
+ * @param resourceType - Type of resource that was not found
+ * @param recordId - ID of the record that was not found
+ * @returns Standardized not found error response
+ */
+export declare function createNotFoundError(resourceType: UniversalResourceType | string, recordId: string): NotFoundErrorResponse;
+/**
+ * Safe error status extraction utility
+ *
+ * **Type Safety**: Uses type guards to safely extract status codes from
+ * various error formats without unsafe any casting.
+ *
+ * @param error - Unknown error object
+ * @returns HTTP status code if found, undefined otherwise
+ */
+export declare function extractErrorStatus(error: unknown): number | undefined;
+/**
+ * Safe error message extraction utility
+ *
+ * @param error - Unknown error object
+ * @returns Error message if found, undefined otherwise
+ */
+export declare function extractErrorMessage(error: unknown): string | undefined;
+//# sourceMappingURL=universal-service-types.d.ts.map

package/dist/types/universal-service-types.d.ts.map

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

package/dist/types/universal-service-types.js

@@ -0,0 +1,141 @@
+/**
+ * Universal Service Type Definitions
+ *
+ * Centralized type definitions for Universal*Service classes to eliminate
+ * repeated inline type definitions and improve type safety.
+ *
+ * This file extracts common patterns found across:
+ * - UniversalDeleteService
+ * - UniversalUpdateService
+ * - UniversalRetrievalService
+ * - UniversalSearchService
+ * - UniversalMetadataService
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+/**
+ * Type guards for Universal service error handling
+ */
+/**
+ * Type guard to check if an error has the expected API error structure
+ *
+ * @param error - Unknown error object
+ * @returns true if error matches ApiErrorWithResponse structure
+ */
+export function isApiErrorWithResponse(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        ('response' in error || 'status' in error || 'message' in error));
+}
+/**
+ * Type guard to check if an error is a 404 not found error
+ *
+ * **Usage Pattern**: Extracted from repeated 404 detection logic across services
+ *
+ * @param error - Unknown error object
+ * @returns true if error indicates a 404 not found condition
+ */
+export function is404Error(error) {
+    if (!isApiErrorWithResponse(error)) {
+        return false;
+    }
+    const status = error.response?.status ?? error.status;
+    const code = error.response?.data?.code ?? error.code;
+    const message = (error.response?.data?.message ?? error.message ?? '')
+        .toString()
+        .toLowerCase();
+    return (status === 404 ||
+        code === 'not_found' ||
+        message.includes('not found') ||
+        message.includes('404'));
+}
+/**
+ * Type guard for checking if a value is an attribute object
+ *
+ * @param value - Unknown value to check
+ * @returns true if value has expected attribute structure
+ */
+export function isAttributeObject(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        (('api_slug' in value &&
+            typeof value.api_slug === 'string') ||
+            ('title' in value &&
+                typeof value.title === 'string') ||
+            ('name' in value &&
+                typeof value.name === 'string')));
+}
+/**
+ * Helper to create standardized not found error responses
+ *
+ * @param resourceType - Type of resource that was not found
+ * @param recordId - ID of the record that was not found
+ * @returns Standardized not found error response
+ */
+export function createNotFoundError(resourceType, recordId) {
+    const resourceName = getResourceDisplayName(resourceType);
+    return {
+        status: 404,
+        body: {
+            code: 'not_found',
+            message: `${resourceName} record with ID "${recordId}" not found.`,
+        },
+    };
+}
+/**
+ * Helper to get display name for resource types
+ *
+ * @param resourceType - Resource type enum or string
+ * @returns Human-readable resource name
+ */
+function getResourceDisplayName(resourceType) {
+    switch (resourceType) {
+        case UniversalResourceType.COMPANIES:
+            return 'Company';
+        case UniversalResourceType.PEOPLE:
+            return 'Person';
+        case UniversalResourceType.LISTS:
+            return 'List';
+        case UniversalResourceType.RECORDS:
+            return 'Record';
+        case UniversalResourceType.DEALS:
+            return 'Deal';
+        case UniversalResourceType.TASKS:
+            return 'Task';
+        case UniversalResourceType.NOTES:
+            return 'Note';
+        default:
+            return String(resourceType);
+    }
+}
+/**
+ * Safe error status extraction utility
+ *
+ * **Type Safety**: Uses type guards to safely extract status codes from
+ * various error formats without unsafe any casting.
+ *
+ * @param error - Unknown error object
+ * @returns HTTP status code if found, undefined otherwise
+ */
+export function extractErrorStatus(error) {
+    if (!isApiErrorWithResponse(error)) {
+        return undefined;
+    }
+    const status = error.response?.status ?? error.status;
+    return typeof status === 'number' ? status : undefined;
+}
+/**
+ * Safe error message extraction utility
+ *
+ * @param error - Unknown error object
+ * @returns Error message if found, undefined otherwise
+ */
+export function extractErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (!isApiErrorWithResponse(error)) {
+        return typeof error === 'string' ? error : undefined;
+    }
+    return error.response?.data?.message ?? error.message ?? undefined;
+}
+//# sourceMappingURL=universal-service-types.js.map

package/dist/types/universal-service-types.js.map

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

package/dist/utils/AttioFieldMapper.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Attio Field Name Mapper
+ *
+ * Maps generic field names to Attio-specific field names
+ * Provides deprecation warnings for unsupported aliases
+ */
+export declare const FIELD_MAPPINGS: {
+    readonly timestamp: {
+        readonly created: "created_at";
+        readonly modified: "modified_at";
+        readonly updated: "modified_at";
+        readonly interacted: "interacted_at";
+    };
+    readonly system: {
+        readonly id: "record_id";
+        readonly workspace: "workspace_id";
+        readonly object: "object_id";
+    };
+};
+/**
+ * Map generic field name to Attio-specific field name
+ * Logs deprecation warnings for unsupported aliases
+ */
+export declare function mapFieldName(genericField: string): string;
+/**
+ * Get all valid timestamp field names for a given resource
+ * Different resources may support different timestamp fields
+ */
+export declare function getValidTimestampFields(resourceType: string): string[];
+/**
+ * Validate if a field name is supported for timeframe filtering
+ */
+export declare function isValidTimestampField(fieldName: string, resourceType: string): boolean;
+//# sourceMappingURL=AttioFieldMapper.d.ts.map

package/dist/utils/AttioFieldMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttioFieldMapper.d.ts","sourceRoot":"","sources":["../../src/utils/AttioFieldMapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,eAAO,MAAM,cAAc;;;;;;;;;;;;CAYjB,CAAC;AAWX;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA2BzD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CActE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAGT"}