@hasna/contacts 0.6.34 → 0.6.35

package/dist/mcp/tools.d.ts

@@ -0,0 +1,3799 @@
+export declare const TOOL_DEFINITIONS: readonly [{
+    readonly name: "create_contact";
+    readonly description: "Create a new contact. Provide at minimum display_name or first_name+last_name. Emails, phones, addresses, and social_profiles are arrays of objects. relationship_type values: colleague|friend|family|reports_to|mentor|investor|partner|client|vendor|other. source values: manual|import|linkedin|github|twitter|email|calendar|crm|other.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly first_name: {
+                readonly type: "string";
+            };
+            readonly last_name: {
+                readonly type: "string";
+            };
+            readonly display_name: {
+                readonly type: "string";
+                readonly description: "Display name (auto-generated from first+last if omitted)";
+            };
+            readonly nickname: {
+                readonly type: "string";
+            };
+            readonly job_title: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly birthday: {
+                readonly type: "string";
+                readonly description: "YYYY-MM-DD";
+            };
+            readonly website: {
+                readonly type: "string";
+                readonly description: "Personal or professional website URL";
+            };
+            readonly last_contacted_at: {
+                readonly type: "string";
+                readonly description: "ISO 8601 datetime of last contact";
+            };
+            readonly preferred_contact_method: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "phone", "telegram", "whatsapp", "linkedin", "twitter", "other"];
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "pending_reply", "converted", "closed", "other"];
+                readonly description: "Contact lifecycle status (default: active)";
+            };
+            readonly follow_up_at: {
+                readonly type: "string";
+                readonly description: "ISO 8601 datetime to follow up with this contact";
+            };
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Primary project ID (single). Use project_ids for multiple.";
+            };
+            readonly project_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Associate contact with multiple todos project IDs";
+            };
+            readonly emails: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly address: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["work", "personal", "other"];
+                        };
+                        readonly is_primary: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["address"];
+                };
+            };
+            readonly phones: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly number: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["mobile", "work", "home", "fax", "whatsapp", "other"];
+                        };
+                        readonly is_primary: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["number"];
+                };
+            };
+            readonly addresses: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly enum: readonly ["physical", "mailing", "billing", "virtual", "other"];
+                        };
+                        readonly street: {
+                            readonly type: "string";
+                        };
+                        readonly city: {
+                            readonly type: "string";
+                        };
+                        readonly state: {
+                            readonly type: "string";
+                        };
+                        readonly zip: {
+                            readonly type: "string";
+                        };
+                        readonly country: {
+                            readonly type: "string";
+                        };
+                        readonly is_primary: {
+                            readonly type: "boolean";
+                        };
+                    };
+                };
+            };
+            readonly social_profiles: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly platform: {
+                            readonly type: "string";
+                            readonly enum: readonly ["twitter", "linkedin", "github", "instagram", "telegram", "discord", "youtube", "tiktok", "bluesky", "facebook", "whatsapp", "snapchat", "reddit", "other"];
+                        };
+                        readonly handle: {
+                            readonly type: "string";
+                        };
+                        readonly url: {
+                            readonly type: "string";
+                        };
+                        readonly is_primary: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["platform"];
+                };
+            };
+            readonly tag_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Tag IDs to assign";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly enum: readonly ["manual", "import", "linkedin", "github", "twitter", "email", "calendar", "crm", "other"];
+            };
+            readonly sensitivity: {
+                readonly type: "string";
+                readonly enum: readonly ["normal", "confidential", "restricted"];
+                readonly description: "Contact sensitivity level (default: normal)";
+            };
+        };
+    };
+}, {
+    readonly name: "get_contact";
+    readonly description: "Get a contact by ID, returning all details including emails, phones, addresses, social profiles, tags, and company.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "update_contact";
+    readonly description: "Update an existing contact's fields. Only provided fields are changed. Supports all contact fields including status, follow_up_at, project_id. Use emails_add/phones_add to append new contact methods without replacing existing ones.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly first_name: {
+                readonly type: "string";
+            };
+            readonly last_name: {
+                readonly type: "string";
+            };
+            readonly display_name: {
+                readonly type: "string";
+            };
+            readonly nickname: {
+                readonly type: "string";
+            };
+            readonly job_title: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly birthday: {
+                readonly type: "string";
+                readonly description: "YYYY-MM-DD";
+            };
+            readonly website: {
+                readonly type: "string";
+            };
+            readonly last_contacted_at: {
+                readonly type: "string";
+                readonly description: "ISO 8601 datetime of last contact";
+            };
+            readonly preferred_contact_method: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "phone", "telegram", "whatsapp", "linkedin", "twitter", "other"];
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "pending_reply", "converted", "closed", "other"];
+            };
+            readonly follow_up_at: {
+                readonly type: "string";
+                readonly description: "ISO 8601 datetime for follow-up reminder (null to clear)";
+            };
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Primary project ID (single, null to clear)";
+            };
+            readonly project_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Replace all project links with this array of todos project IDs";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly enum: readonly ["manual", "import", "linkedin", "github", "twitter", "email", "calendar", "crm", "other"];
+            };
+            readonly sensitivity: {
+                readonly type: "string";
+                readonly enum: readonly ["normal", "confidential", "restricted"];
+            };
+            readonly emails_add: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly address: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                        };
+                        readonly is_primary: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["address"];
+                };
+                readonly description: "New email addresses to append (duplicates are skipped)";
+            };
+            readonly phones_add: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly number: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                        };
+                        readonly country_code: {
+                            readonly type: "string";
+                        };
+                        readonly is_primary: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["number"];
+                };
+                readonly description: "New phone numbers to append (duplicates are skipped)";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "delete_contact";
+    readonly description: "Permanently delete a contact by ID. All associated emails, phones, addresses, tags, and relationships are also deleted.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "list_contacts";
+    readonly description: "List contacts with optional filters. Supports filtering by company, tag(s), source, status, project, follow-up due, last_contacted date range, and archived state. Returns paginated results with total count.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly tag_id: {
+                readonly type: "string";
+                readonly description: "Filter by a single tag ID";
+            };
+            readonly tag_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Filter by multiple tag IDs (AND logic — contact must have all tags)";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly enum: readonly ["manual", "import", "linkedin", "github", "twitter", "email", "calendar", "crm", "other"];
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "pending_reply", "converted", "closed", "other"];
+            };
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Filter by project ID";
+            };
+            readonly archived: {
+                readonly type: "boolean";
+                readonly description: "Include archived contacts (default false)";
+            };
+            readonly include_restricted: {
+                readonly type: "boolean";
+                readonly description: "Include restricted-sensitivity contacts (default false)";
+            };
+            readonly follow_up_due: {
+                readonly type: "boolean";
+                readonly description: "Only return contacts whose follow_up_at is in the past";
+            };
+            readonly last_contacted_after: {
+                readonly type: "string";
+                readonly description: "ISO 8601 date — only contacts last contacted after this date";
+            };
+            readonly last_contacted_before: {
+                readonly type: "string";
+                readonly description: "ISO 8601 date — only contacts last contacted before this date";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (default 50)";
+            };
+            readonly offset: {
+                readonly type: "number";
+            };
+            readonly order_by: {
+                readonly type: "string";
+                readonly enum: readonly ["display_name", "created_at", "updated_at", "last_contacted_at", "follow_up_at"];
+            };
+            readonly order_dir: {
+                readonly type: "string";
+                readonly enum: readonly ["asc", "desc"];
+            };
+        };
+    };
+}, {
+    readonly name: "search_contacts";
+    readonly description: "Full-text search across contacts by name, nickname, notes, job title, and more. Also searches email addresses and phone numbers. Returns up to 50 results.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "create_company";
+    readonly description: "Create a new company/organization. Attach emails, phones, addresses, and social_profiles as arrays. Tag with tag_ids.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly domain: {
+                readonly type: "string";
+                readonly description: "Primary domain, e.g. acme.com";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly industry: {
+                readonly type: "string";
+            };
+            readonly size: {
+                readonly type: "string";
+                readonly description: "e.g. '1-10', '11-50', '51-200', '201-500', '500+'";
+            };
+            readonly founded_year: {
+                readonly type: "number";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly emails: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly phones: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly addresses: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly social_profiles: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly tag_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+}, {
+    readonly name: "get_company";
+    readonly description: "Get a company by ID, including all emails, phones, addresses, social profiles, tags, and employee count.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "update_company";
+    readonly description: "Update an existing company's fields. Only provided fields are changed; omitted fields remain unchanged.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly domain: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly industry: {
+                readonly type: "string";
+            };
+            readonly size: {
+                readonly type: "string";
+            };
+            readonly founded_year: {
+                readonly type: "number";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "delete_company";
+    readonly description: "Permanently delete a company by ID. Contacts that belong to this company will have their company_id cleared.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "list_companies";
+    readonly description: "List companies with optional filters by industry, tag, project, or archived state. Returns paginated results with total count.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly tag_id: {
+                readonly type: "string";
+            };
+            readonly industry: {
+                readonly type: "string";
+            };
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Filter by project ID";
+            };
+            readonly archived: {
+                readonly type: "boolean";
+                readonly description: "Include archived companies (default false)";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+            readonly offset: {
+                readonly type: "number";
+            };
+        };
+    };
+}, {
+    readonly name: "search_companies";
+    readonly description: "Search companies by name or domain using full-text search. Returns up to 50 matches.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "create_tag";
+    readonly description: "Create a new tag for categorizing contacts and companies. Tags are shared across contacts and companies.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly color: {
+                readonly type: "string";
+                readonly description: "Hex color (e.g. #FF5733). Defaults to indigo.";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+}, {
+    readonly name: "list_tags";
+    readonly description: "List all available tags with their colors and descriptions.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "delete_tag";
+    readonly description: "Delete a tag by ID. The tag will be removed from all contacts and companies it was applied to.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "add_tag_to_contact";
+    readonly description: "Apply an existing tag to a contact. Use list_tags to find tag IDs.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly tag_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "tag_id"];
+    };
+}, {
+    readonly name: "remove_tag_from_contact";
+    readonly description: "Remove a tag from a contact. The tag itself is not deleted.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly tag_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "tag_id"];
+    };
+}, {
+    readonly name: "add_relationship";
+    readonly description: "Link two contacts with a typed relationship. relationship_type: colleague (work peer), friend (personal), family (relative), reports_to (A reports to B), mentor (A mentors B), investor (A invests in B), partner (business partner), client, vendor, other.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_a_id: {
+                readonly type: "string";
+            };
+            readonly contact_b_id: {
+                readonly type: "string";
+            };
+            readonly relationship_type: {
+                readonly type: "string";
+                readonly enum: readonly ["colleague", "friend", "family", "reports_to", "mentor", "investor", "partner", "client", "vendor", "other"];
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_a_id", "contact_b_id", "relationship_type"];
+    };
+}, {
+    readonly name: "list_relationships";
+    readonly description: "List all relationships for a contact, showing both directions (where contact is A or B).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "delete_relationship";
+    readonly description: "Delete a relationship by its ID. Use list_relationships to find relationship IDs.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "merge_contacts";
+    readonly description: "Merge two contacts into one — all emails, phones, addresses, tags, and relationships from merge_id are moved to keep_id, then merge_id is deleted. Fields missing in keep_id are filled from merge_id.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly keep_id: {
+                readonly type: "string";
+            };
+            readonly merge_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["keep_id", "merge_id"];
+    };
+}, {
+    readonly name: "import_contacts";
+    readonly description: "Import contacts from CSV (Google Contacts format), vCard (.vcf, v3/v4), or JSON array. Pass raw file contents as the data string. format: 'csv'|'vcf'|'json'.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["json", "csv", "vcf"];
+            };
+            readonly data: {
+                readonly type: "string";
+                readonly description: "Raw file contents (CSV text, vCard text, or JSON array string)";
+            };
+        };
+        readonly required: readonly ["format", "data"];
+    };
+}, {
+    readonly name: "export_contacts";
+    readonly description: "Export contacts to CSV, vCard (.vcf), or JSON format. Optionally specify contact_ids to export a subset; omit to export all contacts. Use updated_since to export only contacts updated after a date.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["json", "csv", "vcf"];
+            };
+            readonly contact_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Specific contact IDs to export (omit for all)";
+            };
+            readonly updated_since: {
+                readonly type: "string";
+                readonly description: "ISO 8601 date — only export contacts updated/contacted after this date";
+            };
+        };
+        readonly required: readonly ["format"];
+    };
+}, {
+    readonly name: "get_stats";
+    readonly description: "Get database statistics: total counts of contacts, companies, tags, and groups.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "log_interaction";
+    readonly description: "Record a contact interaction — sets last_contacted_at to now (or a provided date) and optionally appends a timestamped note. Use this to track when you last spoke with someone.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly note: {
+                readonly type: "string";
+                readonly description: "Optional note about the interaction to append to the contact's notes";
+            };
+            readonly date: {
+                readonly type: "string";
+                readonly description: "ISO 8601 datetime (defaults to now)";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "find_or_create_contact";
+    readonly description: "Find an existing contact by email or name, or create a new one if not found. Returns { contact, found: boolean, created: boolean }. The #1 tool for agent workflows — avoids duplicate creation. Searches by email first (exact match), then by display_name.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly first_name: {
+                readonly type: "string";
+            };
+            readonly last_name: {
+                readonly type: "string";
+            };
+            readonly display_name: {
+                readonly type: "string";
+            };
+            readonly nickname: {
+                readonly type: "string";
+            };
+            readonly job_title: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly birthday: {
+                readonly type: "string";
+            };
+            readonly website: {
+                readonly type: "string";
+            };
+            readonly last_contacted_at: {
+                readonly type: "string";
+            };
+            readonly preferred_contact_method: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "phone", "telegram", "whatsapp", "linkedin", "twitter", "other"];
+            };
+            readonly emails: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly address: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                        };
+                        readonly is_primary: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["address"];
+                };
+            };
+            readonly phones: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly addresses: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly social_profiles: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly tag_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly source: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "upsert_contact";
+    readonly description: "Update a contact if one with matching email exists, otherwise create a new one. Returns { contact, action: 'created'|'updated' }. Ideal for syncing data from external sources. Requires email in the emails array or as a top-level email field.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly first_name: {
+                readonly type: "string";
+            };
+            readonly last_name: {
+                readonly type: "string";
+            };
+            readonly display_name: {
+                readonly type: "string";
+            };
+            readonly nickname: {
+                readonly type: "string";
+            };
+            readonly job_title: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly birthday: {
+                readonly type: "string";
+            };
+            readonly website: {
+                readonly type: "string";
+            };
+            readonly last_contacted_at: {
+                readonly type: "string";
+            };
+            readonly preferred_contact_method: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "phone", "telegram", "whatsapp", "linkedin", "twitter", "other"];
+            };
+            readonly email: {
+                readonly type: "string";
+                readonly description: "Primary email address (alternative to emails array)";
+            };
+            readonly emails: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly address: {
+                            readonly type: "string";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                        };
+                        readonly is_primary: {
+                            readonly type: "boolean";
+                        };
+                    };
+                    readonly required: readonly ["address"];
+                };
+            };
+            readonly phones: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly addresses: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly social_profiles: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+            readonly tag_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly source: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "add_note";
+    readonly description: "Add a structured timestamped note to a contact. Returns the note object with id, body, created_at. Optionally scope the note to a specific company context.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly note: {
+                readonly type: "string";
+                readonly description: "Note text/body";
+            };
+            readonly created_by: {
+                readonly type: "string";
+                readonly description: "Agent or user who created the note (optional)";
+            };
+            readonly company_id: {
+                readonly type: "string";
+                readonly description: "Optional company context — scope this note to a specific contact-company pair";
+            };
+        };
+        readonly required: readonly ["contact_id", "note"];
+    };
+}, {
+    readonly name: "list_notes";
+    readonly description: "List all structured notes for a contact, ordered by date ascending. Optionally filter by company_id to show only notes scoped to that contact-company pair.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+                readonly description: "Optional company ID — if provided, only returns notes scoped to this contact-company pair";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "delete_note";
+    readonly description: "Delete a specific note by its ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly note_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["note_id"];
+    };
+}, {
+    readonly name: "link_contact_to_project";
+    readonly description: "Associate a contact with a todos project ID. Contacts can belong to multiple projects.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Todos project ID";
+            };
+        };
+        readonly required: readonly ["contact_id", "project_id"];
+    };
+}, {
+    readonly name: "unlink_contact_from_project";
+    readonly description: "Remove the association between a contact and a todos project.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly project_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "project_id"];
+    };
+}, {
+    readonly name: "list_contacts_by_project";
+    readonly description: "List all contacts linked to a specific todos project ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly project_id: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (default 100)";
+            };
+            readonly offset: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["project_id"];
+    };
+}, {
+    readonly name: "list_contacts_by_company";
+    readonly description: "List all contacts belonging to a specific company. Equivalent to list_contacts with company_id filter but more ergonomic.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (default 50)";
+            };
+            readonly offset: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "list_contacts_by_tag";
+    readonly description: "List all contacts with a specific tag. Accepts either a tag ID (UUID) or a tag name string.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly tag: {
+                readonly type: "string";
+                readonly description: "Tag name or tag ID (UUID)";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (default 50)";
+            };
+            readonly offset: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["tag"];
+    };
+}, {
+    readonly name: "create_group";
+    readonly description: "Create a new group for organizing contacts. Groups are named collections that can hold multiple contacts.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Associate this group with a todos project ID";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+}, {
+    readonly name: "list_groups";
+    readonly description: "List all groups with their member counts.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Filter groups by todos project ID";
+            };
+        };
+    };
+}, {
+    readonly name: "get_group";
+    readonly description: "Get a group by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "update_group";
+    readonly description: "Update a group's name, description, or project association.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Associate with a todos project ID (null to clear)";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "delete_group";
+    readonly description: "Delete a group by ID. Contacts in the group are not deleted — only the group itself.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "add_contact_to_group";
+    readonly description: "Add one or more contacts to a group. Pass contact_id for a single contact, or contact_ids (array) for bulk.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+                readonly description: "Single contact ID (use contact_ids for bulk)";
+            };
+            readonly contact_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Multiple contact IDs to add at once";
+            };
+            readonly group_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["group_id"];
+    };
+}, {
+    readonly name: "remove_contact_from_group";
+    readonly description: "Remove a contact from a group.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly group_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "group_id"];
+    };
+}, {
+    readonly name: "list_contacts_in_group";
+    readonly description: "List all contact IDs in a group.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly group_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["group_id"];
+    };
+}, {
+    readonly name: "list_groups_for_contact";
+    readonly description: "List all groups that a contact belongs to.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "get_contact_by_email";
+    readonly description: "Fast lookup of a contact by exact email address. Returns null if not found. Unlike search_contacts, this is a precise read-only lookup with no side effects.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly email: {
+                readonly type: "string";
+                readonly description: "Exact email address to look up";
+            };
+        };
+        readonly required: readonly ["email"];
+    };
+}, {
+    readonly name: "add_email_to_contact";
+    readonly description: "Append a new email address to a contact. Idempotent — silently skips if the email already exists on this contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly address: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["work", "personal", "other"];
+            };
+            readonly is_primary: {
+                readonly type: "boolean";
+            };
+        };
+        readonly required: readonly ["contact_id", "address"];
+    };
+}, {
+    readonly name: "add_phone_to_contact";
+    readonly description: "Append a new phone number to a contact. Idempotent — silently skips if the number already exists on this contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly number: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["mobile", "work", "home", "fax", "whatsapp", "other"];
+            };
+            readonly country_code: {
+                readonly type: "string";
+            };
+            readonly is_primary: {
+                readonly type: "boolean";
+            };
+        };
+        readonly required: readonly ["contact_id", "number"];
+    };
+}, {
+    readonly name: "archive_contact";
+    readonly description: "Soft-delete a contact by setting archived=true. Archived contacts are excluded from list_contacts and search_contacts by default. Use unarchive_contact to restore.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "unarchive_contact";
+    readonly description: "Restore an archived contact. Sets archived=false so the contact reappears in lists and searches.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "archive_company";
+    readonly description: "Soft-delete a company by setting archived=true. Archived companies are excluded from list_companies by default.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "unarchive_company";
+    readonly description: "Restore an archived company. Sets archived=false.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "find_duplicates";
+    readonly description: "Scan contacts for potential duplicates — by shared email address (exact) or by similar display name (Levenshtein distance ≤ 2). Returns groups of contact IDs that may be the same person.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "list_interactions";
+    readonly description: "List activity log entries for a contact or company. Shows all logged interactions, creates, updates, and merges in reverse chronological order.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (default 50)";
+            };
+            readonly offset: {
+                readonly type: "number";
+            };
+        };
+    };
+}, {
+    readonly name: "add_tag_to_company";
+    readonly description: "Apply an existing tag to a company. Use list_tags to find tag IDs.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly tag_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id", "tag_id"];
+    };
+}, {
+    readonly name: "remove_tag_from_company";
+    readonly description: "Remove a tag from a company. The tag itself is not deleted.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly tag_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id", "tag_id"];
+    };
+}, {
+    readonly name: "add_company_to_group";
+    readonly description: "Add a company to a group. Returns { added, already_member } — idempotent.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly group_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id", "group_id"];
+    };
+}, {
+    readonly name: "remove_company_from_group";
+    readonly description: "Remove a company from a group.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly group_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id", "group_id"];
+    };
+}, {
+    readonly name: "list_companies_in_group";
+    readonly description: "List all company IDs in a group.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly group_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["group_id"];
+    };
+}, {
+    readonly name: "list_groups_for_company";
+    readonly description: "List all groups that a company belongs to.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "bulk_create_contacts";
+    readonly description: "Create multiple contacts in one call. Each item in the contacts array follows the same schema as create_contact. Returns { created, errors }.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contacts: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+                readonly description: "Array of contact input objects (same schema as create_contact)";
+            };
+        };
+        readonly required: readonly ["contacts"];
+    };
+}, {
+    readonly name: "auto_link_to_company";
+    readonly description: "Auto-link a contact to a company by matching the contact's email domain against known company domains. Only sets company_id if the contact has no company yet and a matching company exists. Returns the updated contact, or null if no match.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "add_company_relationship";
+    readonly description: "Declare a typed relationship between a contact and a company. relationship_type: client|vendor|partner|employee|contractor|investor|advisor|tax_preparer|bank_manager|attorney|registered_agent|accountant|payroll_specialist|insurance_broker|other. Supports optional start_date, end_date, is_primary, and status fields.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly relationship_type: {
+                readonly type: "string";
+                readonly enum: readonly ["client", "vendor", "partner", "employee", "contractor", "investor", "advisor", "tax_preparer", "bank_manager", "attorney", "registered_agent", "accountant", "payroll_specialist", "insurance_broker", "other"];
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly start_date: {
+                readonly type: "string";
+                readonly description: "ISO date when the relationship began (YYYY-MM-DD)";
+            };
+            readonly end_date: {
+                readonly type: "string";
+                readonly description: "ISO date when the relationship ended (YYYY-MM-DD)";
+            };
+            readonly is_primary: {
+                readonly type: "boolean";
+                readonly description: "Whether this is the primary contact for this relationship type at this company";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "inactive", "ended"];
+                readonly description: "Relationship status (default: active)";
+            };
+        };
+        readonly required: readonly ["contact_id", "company_id", "relationship_type"];
+    };
+}, {
+    readonly name: "list_company_relationships";
+    readonly description: "List typed contact↔company relationships, optionally filtered by contact, company, or type.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly relationship_type: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "delete_company_relationship";
+    readonly description: "Delete a contact↔company relationship by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "import_contacts_from_gmail";
+    readonly description: "Extract unique contacts from Gmail messages matching a search query and batch-upsert them. Requires connect-gmail auth login first. Returns { imported, skipped, errors }.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Gmail search query, e.g. 'from:(company.com) newer_than:30d'";
+            };
+            readonly max_messages: {
+                readonly type: "number";
+                readonly description: "Max messages to scan (default 200, max 500)";
+            };
+            readonly gmail_profile: {
+                readonly type: "string";
+                readonly description: "connect-gmail profile to use (default: 'default')";
+            };
+            readonly tag_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Tag IDs to apply to all imported contacts";
+            };
+            readonly group_id: {
+                readonly type: "string";
+                readonly description: "Group ID to add all imported contacts to";
+            };
+            readonly dry_run: {
+                readonly type: "boolean";
+                readonly description: "If true, extract contacts but do not save to database";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "sync_from_google_contacts";
+    readonly description: "Pull contacts from Google Contacts (People API) and upsert them into the local database. Skips contacts that already exist by email. Requires connect-googlecontacts auth login. Returns { imported, skipped, errors }.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Optional search query to filter which Google Contacts to import";
+            };
+            readonly page_size: {
+                readonly type: "number";
+                readonly description: "Contacts per page (default: connector default)";
+            };
+            readonly google_profile: {
+                readonly type: "string";
+                readonly description: "connect-googlecontacts profile (default: 'default')";
+            };
+            readonly tag_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Tag IDs to apply to all imported contacts";
+            };
+            readonly project_id: {
+                readonly type: "string";
+                readonly description: "Project ID to assign to all imported contacts";
+            };
+            readonly dry_run: {
+                readonly type: "boolean";
+                readonly description: "Preview what would be imported without saving";
+            };
+        };
+    };
+}, {
+    readonly name: "push_contact_to_google";
+    readonly description: "Push a local contact to Google Contacts — creates a new Google contact (or updates if google_resource_name is stored in custom_fields). Requires connect-googlecontacts auth login.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+                readonly description: "Local contact ID to push";
+            };
+            readonly google_profile: {
+                readonly type: "string";
+                readonly description: "connect-googlecontacts profile (default: 'default')";
+            };
+            readonly update_existing: {
+                readonly type: "boolean";
+                readonly description: "If true, update existing Google contact when google_resource_name is present in custom_fields";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "search_google_contacts";
+    readonly description: "Search Google Contacts by name or email (read-only, does not import). Returns raw Google People API objects. Useful for lookup or preview before a push/sync.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+            readonly google_profile: {
+                readonly type: "string";
+                readonly description: "connect-googlecontacts profile (default: 'default')";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "get_contact_workload";
+    readonly description: "Get a comprehensive workload summary for a contact: entities/companies they manage, active tasks assigned to them, overdue tasks, pending applications they're linked to, days since last contact, org memberships with specializations. Essential for checking if a key contact is overloaded or responsive.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "list_overdue_contact_tasks";
+    readonly description: "List all contact tasks that are past their deadline and not yet completed/cancelled. Includes escalation rules so agents know who to escalate to.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "check_escalations";
+    readonly description: "Check all contact tasks with escalation rules to see which ones should be escalated now based on days overdue vs escalation thresholds. Returns tasks with the contact to escalate to.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "add_org_member";
+    readonly description: "Add a contact as an org member of a company (employee, team member) with optional title, specialization, office phone, SLA hours, and notes.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly specialization: {
+                readonly type: "string";
+            };
+            readonly office_phone: {
+                readonly type: "string";
+            };
+            readonly response_sla_hours: {
+                readonly type: "number";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id", "contact_id"];
+    };
+}, {
+    readonly name: "list_org_members";
+    readonly description: "List all org members (contacts) of a company.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "update_org_member";
+    readonly description: "Update an org member's title, specialization, office phone, SLA hours, or notes.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly specialization: {
+                readonly type: "string";
+            };
+            readonly office_phone: {
+                readonly type: "string";
+            };
+            readonly response_sla_hours: {
+                readonly type: "number";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "remove_org_member";
+    readonly description: "Remove a contact from a company's org members by org member record ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "log_vendor_communication";
+    readonly description: "Log a vendor communication (email, invoice request, call, payment, etc.) for a company. Track invoice amounts, references, follow-up dates, and status.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly comm_date: {
+                readonly type: "string";
+                readonly description: "ISO date (defaults to today)";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "call", "meeting", "invoice_request", "invoice_received", "payment", "dispute", "other"];
+            };
+            readonly direction: {
+                readonly type: "string";
+                readonly enum: readonly ["inbound", "outbound"];
+            };
+            readonly subject: {
+                readonly type: "string";
+            };
+            readonly body: {
+                readonly type: "string";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["sent", "awaiting_response", "responded", "no_response", "resolved"];
+            };
+            readonly invoice_amount: {
+                readonly type: "number";
+            };
+            readonly invoice_currency: {
+                readonly type: "string";
+            };
+            readonly invoice_ref: {
+                readonly type: "string";
+            };
+            readonly follow_up_date: {
+                readonly type: "string";
+                readonly description: "ISO date for follow-up (YYYY-MM-DD)";
+            };
+        };
+        readonly required: readonly ["company_id", "type"];
+    };
+}, {
+    readonly name: "list_vendor_communications";
+    readonly description: "List vendor communications for a company, optionally filtered by type or status.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "call", "meeting", "invoice_request", "invoice_received", "payment", "dispute", "other"];
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["sent", "awaiting_response", "responded", "no_response", "resolved"];
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "list_missing_invoices";
+    readonly description: "List all invoice_request communications with no_response or awaiting_response status — vendors who haven't sent invoices yet.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "list_pending_followups";
+    readonly description: "List all vendor communications with follow_up_date on or before today that haven't been marked done.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "mark_followup_done";
+    readonly description: "Mark a vendor communication follow-up as done.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "create_contact_task";
+    readonly description: "Create a task assigned to a contact, with optional deadline, priority, entity link, escalation rules, and todos task link.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly assigned_by: {
+                readonly type: "string";
+            };
+            readonly deadline: {
+                readonly type: "string";
+                readonly description: "ISO date (YYYY-MM-DD)";
+            };
+            readonly priority: {
+                readonly type: "string";
+                readonly enum: readonly ["low", "medium", "high", "critical"];
+            };
+            readonly entity_id: {
+                readonly type: "string";
+                readonly description: "Company/entity ID this task is for";
+            };
+            readonly escalation_rules: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly after_days: {
+                            readonly type: "number";
+                        };
+                        readonly escalate_to_contact_id: {
+                            readonly type: "string";
+                        };
+                        readonly method: {
+                            readonly type: "string";
+                            readonly enum: readonly ["email", "note", "both"];
+                        };
+                    };
+                    readonly required: readonly ["after_days", "escalate_to_contact_id", "method"];
+                };
+            };
+            readonly linked_todos_task_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["title", "contact_id"];
+    };
+}, {
+    readonly name: "list_contact_tasks";
+    readonly description: "List contact tasks, optionally filtered by contact, entity, status, or priority.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly entity_id: {
+                readonly type: "string";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["pending", "awaiting_response", "in_progress", "completed", "cancelled", "escalated"];
+            };
+            readonly priority: {
+                readonly type: "string";
+                readonly enum: readonly ["low", "medium", "high", "critical"];
+            };
+        };
+    };
+}, {
+    readonly name: "update_contact_task";
+    readonly description: "Update a contact task's title, status, deadline, priority, description, or escalation rules.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["pending", "awaiting_response", "in_progress", "completed", "cancelled", "escalated"];
+            };
+            readonly deadline: {
+                readonly type: "string";
+            };
+            readonly priority: {
+                readonly type: "string";
+                readonly enum: readonly ["low", "medium", "high", "critical"];
+            };
+            readonly description: {
+                readonly type: "string";
+            };
+            readonly escalation_rules: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                };
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "delete_contact_task";
+    readonly description: "Delete a contact task by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "create_application";
+    readonly description: "Create an application record (grant, AI credits, startup program, visa, trademark, tax filing, etc.).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly program_name: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["ai_credits", "grant", "startup_program", "visa", "trademark", "tax_filing", "loan", "other"];
+            };
+            readonly value_usd: {
+                readonly type: "number";
+            };
+            readonly provider_company_id: {
+                readonly type: "string";
+            };
+            readonly primary_contact_id: {
+                readonly type: "string";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["draft", "submitted", "pending", "approved", "rejected", "follow_up_needed", "expired", "cancelled"];
+            };
+            readonly submitted_date: {
+                readonly type: "string";
+            };
+            readonly follow_up_date: {
+                readonly type: "string";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly method: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "form", "typeform", "hubspot", "manual", "browser", "feathery", "other"];
+            };
+            readonly form_url: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["program_name"];
+    };
+}, {
+    readonly name: "list_applications";
+    readonly description: "List applications, optionally filtered by type, status, or provider company.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["ai_credits", "grant", "startup_program", "visa", "trademark", "tax_filing", "loan", "other"];
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["draft", "submitted", "pending", "approved", "rejected", "follow_up_needed", "expired", "cancelled"];
+            };
+            readonly provider_company_id: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "update_application";
+    readonly description: "Update an application's program name, status, dates, value, notes, or other fields.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly program_name: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["ai_credits", "grant", "startup_program", "visa", "trademark", "tax_filing", "loan", "other"];
+            };
+            readonly value_usd: {
+                readonly type: "number";
+            };
+            readonly provider_company_id: {
+                readonly type: "string";
+            };
+            readonly primary_contact_id: {
+                readonly type: "string";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["draft", "submitted", "pending", "approved", "rejected", "follow_up_needed", "expired", "cancelled"];
+            };
+            readonly submitted_date: {
+                readonly type: "string";
+            };
+            readonly decision_date: {
+                readonly type: "string";
+            };
+            readonly follow_up_date: {
+                readonly type: "string";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly method: {
+                readonly type: "string";
+            };
+            readonly form_url: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "get_followup_due_applications";
+    readonly description: "List applications with follow_up_date on or before today that haven't been completed or cancelled.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "list_owned_entities";
+    readonly description: "List all companies marked as owned entities (is_owned_entity=true) — your legal entities, subsidiaries, and operating companies.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "get_entity_team";
+    readonly description: "Get the full team for an owned entity — all contacts linked via company_relationships, with their roles and primary status.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "get_contact_brief";
+    readonly description: "Generate a comprehensive pre-meeting briefing for a contact. Returns structured markdown covering: role/company, contact details, status, last contacted, open tasks, overdue items, entity relationships, recent notes, recent activity. Feed this to an AI before a meeting or call.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "list_cold_contacts";
+    readonly description: "List contacts you haven't been in touch with for N days (default 30). Sorted by most neglected first. Use to identify who needs re-engagement. 'never' means last_contacted_at was never set.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly days: {
+                readonly type: "number";
+                readonly description: "Days threshold (default 30)";
+            };
+        };
+    };
+}, {
+    readonly name: "get_upcoming";
+    readonly description: "Get a unified calendar of upcoming items: follow-ups due, birthdays, task deadlines, application follow-ups, vendor follow-ups. Default 7-day window. Returns items sorted by date with urgency (overdue/today/upcoming).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly days: {
+                readonly type: "number";
+                readonly description: "Days ahead to show (default 7)";
+            };
+        };
+    };
+}, {
+    readonly name: "get_network_stats";
+    readonly description: "Get comprehensive network health stats: contact counts, cold contacts (30d/60d/never), data completeness, overdue tasks, pending applications, missing invoices, active deal pipeline value. The health dashboard for your network.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "audit_contacts";
+    readonly description: "Score all contacts for data completeness (0-100). Points: email +20, phone +15, company +15, last_contacted_at +20, tags +10, notes +10, job_title +10. Returns contacts sorted by score ascending (worst first) so you know who to enrich.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Number to show (default 20)";
+            };
+        };
+    };
+}, {
+    readonly name: "create_deal";
+    readonly description: "Create a new deal or opportunity, optionally linked to a contact and/or company.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly stage: {
+                readonly type: "string";
+                readonly enum: readonly ["lead", "qualified", "proposal", "negotiation", "won", "lost", "cancelled"];
+                readonly description: "Deal stage (default: lead)";
+            };
+            readonly value_usd: {
+                readonly type: "number";
+            };
+            readonly currency: {
+                readonly type: "string";
+            };
+            readonly close_date: {
+                readonly type: "string";
+                readonly description: "Expected close date (YYYY-MM-DD)";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["title"];
+    };
+}, {
+    readonly name: "get_deal";
+    readonly description: "Get a deal by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "list_deals";
+    readonly description: "List deals, optionally filtered by stage, contact, or company.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly stage: {
+                readonly type: "string";
+                readonly enum: readonly ["lead", "qualified", "proposal", "negotiation", "won", "lost", "cancelled"];
+            };
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "update_deal";
+    readonly description: "Update a deal's title, stage, value, close date, or notes.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly stage: {
+                readonly type: "string";
+                readonly enum: readonly ["lead", "qualified", "proposal", "negotiation", "won", "lost", "cancelled"];
+            };
+            readonly value_usd: {
+                readonly type: "number";
+            };
+            readonly close_date: {
+                readonly type: "string";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "delete_deal";
+    readonly description: "Delete a deal by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "log_event";
+    readonly description: "Log a meeting, call, or interaction event with one or more contacts.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["meeting", "call", "email", "lunch", "conference", "demo", "other"];
+            };
+            readonly event_date: {
+                readonly type: "string";
+                readonly description: "ISO date or datetime of the event";
+            };
+            readonly duration_min: {
+                readonly type: "number";
+                readonly description: "Duration in minutes";
+            };
+            readonly contact_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Contact IDs who attended";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+            readonly outcome: {
+                readonly type: "string";
+            };
+            readonly deal_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["title", "event_date"];
+    };
+}, {
+    readonly name: "list_events";
+    readonly description: "List events, optionally filtered by contact, company, type, or date range.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+            };
+            readonly date_from: {
+                readonly type: "string";
+            };
+            readonly date_to: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "delete_event";
+    readonly description: "Delete an event by ID.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "get_contact_timeline";
+    readonly description: "Get full chronological activity history for a contact: notes, events, tasks, vendor communications, interactions — all unified in reverse date order. The account history view.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max items (default 50)";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "enrich_contact";
+    readonly description: "Search the web for missing contact data (LinkedIn, Twitter, GitHub, phone, company website) using the contact's name, email, and company. Returns SUGGESTIONS only — does not auto-apply. Review and apply with update_contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "get_contacts_for_context";
+    readonly description: "Find contacts relevant to a topic or domain. Searches job titles, notes, specializations, company names, relationship types, tags, and org memberships. Returns ranked results with relevance reason. Essential for agents: 'who do I contact about trademark law?' → returns attorneys at Revision Legal.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly topic: {
+                readonly type: "string";
+                readonly description: "Topic or domain to search for (e.g. 'trademark law', 'payroll', 'banking')";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly description: "Max results (default 10)";
+            };
+        };
+        readonly required: readonly ["topic"];
+    };
+}, {
+    readonly name: "set_reminder";
+    readonly description: "Schedule a follow-up reminder for a contact. Sets follow_up_at to the specified date and adds a note with the reminder text. Will appear in get_upcoming results. Use: set_reminder({contact_id, remind_at: '2026-04-01', note: 'Check on invoice status'})";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly remind_at: {
+                readonly type: "string";
+                readonly description: "Reminder date (YYYY-MM-DD)";
+            };
+            readonly note: {
+                readonly type: "string";
+                readonly description: "Optional reminder note";
+            };
+        };
+        readonly required: readonly ["contact_id", "remind_at"];
+    };
+}, {
+    readonly name: "check_and_fire_webhooks";
+    readonly description: "Check all registered webhooks and fire any that match current conditions: contact.stale (last_contacted_at > 30 days), task.overdue (deadline passed), followup.due (follow_up_at <= today). Returns list of fired webhooks.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "bulk_tag_contacts";
+    readonly description: "Apply or remove a tag from multiple contacts at once. Either pass contact_ids array directly, or pass a search query and all matching contacts will be tagged. Returns count of contacts tagged.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly tag_id_or_name: {
+                readonly type: "string";
+                readonly description: "Tag ID (UUID) or tag name to apply/remove";
+            };
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["add", "remove"];
+            };
+            readonly contact_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Specific contact IDs (alternative to query)";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query — all matching contacts will be tagged";
+            };
+        };
+        readonly required: readonly ["tag_id_or_name", "action"];
+    };
+}, {
+    readonly name: "set_do_not_contact";
+    readonly description: "Mark a contact as do-not-contact (DNC). They will be excluded from list_contacts, cold, and upcoming results unless explicitly requested. Use for GDPR compliance or unsubscribes.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly do_not_contact: {
+                readonly type: "boolean";
+            };
+            readonly reason: {
+                readonly type: "string";
+                readonly description: "Reason for DNC flag (optional)";
+            };
+        };
+        readonly required: readonly ["contact_id", "do_not_contact"];
+    };
+}, {
+    readonly name: "get_field_history";
+    readonly description: "Get the change history for one or all fields of a contact (temporal audit trail).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly field_name: {
+                readonly type: "string";
+                readonly description: "Optional — filter to a single field";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "get_contact_at";
+    readonly description: "Reconstruct a contact's profile as it was at a specific point in time, using field history.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly timestamp: {
+                readonly type: "string";
+                readonly description: "ISO 8601 datetime — reconstruct profile at this point in time";
+            };
+        };
+        readonly required: readonly ["contact_id", "timestamp"];
+    };
+}, {
+    readonly name: "get_job_history";
+    readonly description: "Get the employment timeline for a contact — all past and current job entries in reverse chronological order.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "add_job_entry";
+    readonly description: "Add a job history entry to a contact's employment timeline.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly company_name: {
+                readonly type: "string";
+            };
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly start_date: {
+                readonly type: "string";
+            };
+            readonly end_date: {
+                readonly type: "string";
+            };
+            readonly is_current: {
+                readonly type: "boolean";
+            };
+        };
+        readonly required: readonly ["contact_id", "company_name"];
+    };
+}, {
+    readonly name: "save_learning";
+    readonly description: "Save a structured learning about a contact — preferences, facts, inferences, warnings, or signals. Include confidence (0-100) and importance (1-10).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly content: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["preference", "fact", "inference", "warning", "signal"];
+            };
+            readonly confidence: {
+                readonly type: "number";
+            };
+            readonly importance: {
+                readonly type: "number";
+            };
+            readonly learned_by: {
+                readonly type: "string";
+            };
+            readonly visibility: {
+                readonly type: "string";
+                readonly enum: readonly ["private", "shared", "human"];
+            };
+            readonly tags: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+        readonly required: readonly ["contact_id", "content"];
+    };
+}, {
+    readonly name: "get_learnings";
+    readonly description: "Get all learnings for a contact, optionally filtered by type and minimum importance.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["preference", "fact", "inference", "warning", "signal"];
+            };
+            readonly min_importance: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "search_learnings";
+    readonly description: "Cross-contact search across all learnings for a keyword or phrase.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+            readonly type: {
+                readonly type: "string";
+            };
+            readonly contact_id: {
+                readonly type: "string";
+                readonly description: "Optional — limit to a specific contact";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "confirm_learning";
+    readonly description: "Confirm a learning as correct, boosting its confidence score.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly learning_id: {
+                readonly type: "string";
+            };
+            readonly agent_name: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["learning_id", "agent_name"];
+    };
+}, {
+    readonly name: "get_stale_learnings";
+    readonly description: "Find learnings that haven't been confirmed recently and may need review.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly days_old: {
+                readonly type: "number";
+            };
+            readonly min_confidence: {
+                readonly type: "number";
+            };
+        };
+    };
+}, {
+    readonly name: "run_learning_maintenance";
+    readonly description: "Run decay (reduce confidence on old unconfirmed learnings) and contradiction detection across all learnings.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "acquire_contact_lock";
+    readonly description: "Acquire a write lock on a contact to prevent conflicts when multiple agents edit the same record. Returns {acquired, lock, held_by}.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly agent_name: {
+                readonly type: "string";
+            };
+            readonly ttl_seconds: {
+                readonly type: "number";
+            };
+            readonly reason: {
+                readonly type: "string";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "agent_name"];
+    };
+}, {
+    readonly name: "release_contact_lock";
+    readonly description: "Release a contact write lock previously acquired by this agent.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly agent_name: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "agent_name"];
+    };
+}, {
+    readonly name: "check_contact_lock";
+    readonly description: "Check if a contact is currently locked by any agent.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "log_agent_activity";
+    readonly description: "Log an agent action against a contact for audit/coordination purposes.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly agent_name: {
+                readonly type: "string";
+            };
+            readonly action: {
+                readonly type: "string";
+            };
+            readonly details: {
+                readonly type: "string";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "agent_name", "action"];
+    };
+}, {
+    readonly name: "get_contact_agent_activity";
+    readonly description: "Get the recent agent activity log for a contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "get_relationship_strength";
+    readonly description: "Compute and return the relationship strength score (0-100) for a contact based on interaction frequency and recency.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "find_warm_path";
+    readonly description: "Find the shortest warm introduction path between two contacts through the relationship graph.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly from_contact_id: {
+                readonly type: "string";
+            };
+            readonly to_contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["from_contact_id", "to_contact_id"];
+    };
+}, {
+    readonly name: "find_connections_at_company";
+    readonly description: "Find all contacts linked to a specific company, with relationship strength scores.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "get_cooling_relationships";
+    readonly description: "Get all relationships that are cooling (no contact in 45+ days) — use to prioritize re-engagement outreach.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "resolve_contact_identity";
+    readonly description: "Resolve a contact's identity from partial signals (email, name, LinkedIn URL, phone, or external system ID). Returns ranked matches with confidence scores.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly email: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly linkedin_url: {
+                readonly type: "string";
+            };
+            readonly phone: {
+                readonly type: "string";
+            };
+            readonly system: {
+                readonly type: "string";
+            };
+            readonly external_id: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "add_contact_identity";
+    readonly description: "Register an external system identity (e.g. Salesforce ID, LinkedIn URL) for a contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly system: {
+                readonly type: "string";
+            };
+            readonly external_id: {
+                readonly type: "string";
+            };
+            readonly external_url: {
+                readonly type: "string";
+            };
+            readonly confidence: {
+                readonly type: "string";
+                readonly enum: readonly ["verified", "inferred"];
+            };
+        };
+        readonly required: readonly ["contact_id", "system", "external_id"];
+    };
+}, {
+    readonly name: "get_contact_identities";
+    readonly description: "Get all registered external system identities for a contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "semantic_search_contacts";
+    readonly description: "Search contacts by capability or context using TF-IDF semantic similarity — finds contacts based on meaning, not just keyword match.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+}, {
+    readonly name: "embed_all_contacts";
+    readonly description: "Build TF-IDF embeddings for all contacts in the database — run once to enable semantic_search_contacts.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "get_relationship_signals";
+    readonly description: "Get relationship health signals for a contact: warming/cooling/ghost/healthy status with reasons.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "get_ghost_contacts";
+    readonly description: "List contacts you haven't been in touch with for 180+ days — relationships at risk of becoming permanently cold.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "get_warming_contacts";
+    readonly description: "List contacts with rising interaction frequency — relationships gaining momentum.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "recompute_signals";
+    readonly description: "Recompute engagement_status for all contacts based on interaction counts and recency.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "get_contact_card";
+    readonly description: "Get a minimal ~50-token contact summary: name, title, company, primary email and phone. Ideal for lists and agent context injection.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "assemble_context";
+    readonly description: "Assemble a multi-contact context package for meetings, deals, outreach, or research. Returns task-relevant briefs for each contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_ids: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["meeting_prep", "deal_review", "outreach", "research"];
+            };
+        };
+        readonly required: readonly ["contact_ids"];
+    };
+}, {
+    readonly name: "parse_email_signature";
+    readonly description: "Parse an email signature text to extract contact fields (name, title, company, phone, email, LinkedIn, website). Does NOT create a contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly signature_text: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["signature_text"];
+    };
+}, {
+    readonly name: "ingest_email_participants";
+    readonly description: "Find or create contacts from email thread participants (with optional signatures). Returns { created, updated, contacts }.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly participants: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly email: {
+                            readonly type: "string";
+                        };
+                        readonly signature: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly required: readonly ["email"];
+                };
+            };
+            readonly context: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["participants"];
+    };
+}, {
+    readonly name: "ingest_meeting_participants";
+    readonly description: "Ingest meeting attendees: find-or-create contacts and log the meeting as an event. Returns { created, updated, contact_ids }.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly title: {
+                readonly type: "string";
+            };
+            readonly event_date: {
+                readonly type: "string";
+            };
+            readonly attendees: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly email: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly required: readonly ["name", "email"];
+                };
+            };
+            readonly context: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["title", "event_date", "attendees"];
+    };
+}, {
+    readonly name: "get_freshness_score";
+    readonly description: "Get a per-field freshness and confidence breakdown for a contact — shows which fields are verified, stale, or missing.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "get_stale_contacts";
+    readonly description: "List contacts with low data completeness scores (below threshold). Default threshold: 40.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly threshold: {
+                readonly type: "number";
+                readonly description: "Score threshold 0-100 (default 40)";
+            };
+        };
+    };
+}, {
+    readonly name: "mark_field_verified";
+    readonly description: "Mark a specific contact field as verified by a human or trusted source.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly field_name: {
+                readonly type: "string";
+            };
+            readonly source: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "field_name"];
+    };
+}, {
+    readonly name: "add_org_chart_edge";
+    readonly description: "Add a relationship edge to the org chart for a company (reports_to, manages, peer, collaborates_with).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly contact_a_id: {
+                readonly type: "string";
+            };
+            readonly contact_b_id: {
+                readonly type: "string";
+            };
+            readonly edge_type: {
+                readonly type: "string";
+                readonly enum: readonly ["reports_to", "manages", "collaborates_with", "peer"];
+            };
+        };
+        readonly required: readonly ["company_id", "contact_a_id", "contact_b_id", "edge_type"];
+    };
+}, {
+    readonly name: "get_org_chart";
+    readonly description: "Get the org chart for a company as a list of directed edges with contact names.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "set_deal_contact_role";
+    readonly description: "Assign a contact a buying committee role in a deal (economic_buyer, technical_evaluator, champion, blocker, influencer, user, sponsor, other).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly deal_id: {
+                readonly type: "string";
+            };
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly account_role: {
+                readonly type: "string";
+                readonly enum: readonly ["economic_buyer", "technical_evaluator", "champion", "blocker", "influencer", "user", "sponsor", "other"];
+            };
+        };
+        readonly required: readonly ["deal_id", "contact_id", "account_role"];
+    };
+}, {
+    readonly name: "get_deal_team";
+    readonly description: "Get the full buying committee for a deal with contact names and roles.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly deal_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["deal_id"];
+    };
+}, {
+    readonly name: "get_coverage_gaps";
+    readonly description: "Identify coverage gaps in a company account — missing economic buyer, technical evaluator, or org chart relationships.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "get_recent_contact_events";
+    readonly description: "Polling fallback for change events — returns recent activity log entries, optionally filtered by event type or date.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly since: {
+                readonly type: "string";
+                readonly description: "ISO 8601 datetime — only events after this date";
+            };
+            readonly event_types: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+}, {
+    readonly name: "set_contact_photo";
+    readonly description: "Set a contact's profile photo. Provide either a local file path or base64-encoded image data (with or without data URI prefix). Stores image in ~/.hasna/contacts/images/ and updates avatar_url. Supported formats: jpg, png, gif, webp, svg, avif.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly image: {
+                readonly type: "string";
+                readonly description: "File path (e.g. /tmp/photo.jpg) OR base64 data (e.g. data:image/png;base64,...) OR raw base64 string";
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly description: "Image format hint when using raw base64 (jpg, png, webp). Not needed for file paths or data URIs.";
+            };
+        };
+        readonly required: readonly ["contact_id", "image"];
+    };
+}, {
+    readonly name: "get_contact_photo";
+    readonly description: "Get a contact's profile photo as base64 data URI. Returns null if no photo is set.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "delete_contact_photo";
+    readonly description: "Remove a contact's profile photo.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "set_company_logo";
+    readonly description: "Set a company's logo image. Provide either a local file path or base64-encoded image data. Stores image in ~/.hasna/contacts/images/ and updates logo_url.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+            readonly image: {
+                readonly type: "string";
+                readonly description: "File path or base64 data";
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly description: "Image format hint for raw base64";
+            };
+        };
+        readonly required: readonly ["company_id", "image"];
+    };
+}, {
+    readonly name: "get_company_logo";
+    readonly description: "Get a company's logo as base64 data URI.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "delete_company_logo";
+    readonly description: "Remove a company's logo image.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly company_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["company_id"];
+    };
+}, {
+    readonly name: "set_sensitivity";
+    readonly description: "Set a contact's sensitivity level (normal, confidential, restricted). Restricted contacts are hidden from list/search unless explicitly requested.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly sensitivity: {
+                readonly type: "string";
+                readonly enum: readonly ["normal", "confidential", "restricted"];
+            };
+        };
+        readonly required: readonly ["contact_id", "sensitivity"];
+    };
+}, {
+    readonly name: "vault_init";
+    readonly description: "Initialize the encrypted document vault with a passphrase. Must be called before storing documents or health data.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly passphrase: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["passphrase"];
+    };
+}, {
+    readonly name: "vault_unlock";
+    readonly description: "Unlock the vault for this session with a passphrase.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly passphrase: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["passphrase"];
+    };
+}, {
+    readonly name: "vault_lock";
+    readonly description: "Lock the vault, clearing the encryption key from memory.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "vault_status";
+    readonly description: "Check vault initialization and lock status.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "add_document";
+    readonly description: "Store a document for a contact (passport, tax_id, medical_record, etc.). Text values are encrypted; file attachments are stored plain so agents can read them. Vault must be unlocked.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly doc_type: {
+                readonly type: "string";
+                readonly enum: readonly ["passport", "national_id", "tax_id", "ssn", "drivers_license", "bank_account", "visa", "insurance", "contract", "certificate", "medical_record", "prescription", "allergy_list", "vaccination", "blood_type", "health_insurance", "medical_condition", "emergency_contact_medical", "other"];
+            };
+            readonly label: {
+                readonly type: "string";
+            };
+            readonly value: {
+                readonly type: "string";
+                readonly description: "Plaintext value (will be encrypted in DB)";
+            };
+            readonly file_path: {
+                readonly type: "string";
+                readonly description: "File to attach — stored PLAIN in ~/.hasna/contacts/documents/ for agent access";
+            };
+            readonly metadata: {
+                readonly type: "object";
+            };
+            readonly expires_at: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id", "doc_type", "value"];
+    };
+}, {
+    readonly name: "list_documents";
+    readonly description: "List documents for a contact (metadata only — no decryption needed). Returns file_path for attachments so agents can read them directly.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "get_document";
+    readonly description: "Get a document with decrypted value and file_path. Vault must be unlocked for the text value; file is always accessible.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly document_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["document_id"];
+    };
+}, {
+    readonly name: "get_document_file";
+    readonly description: "Get the plain file path for a document attachment. Agents can read this file directly — it is NOT encrypted. Returns null if no file attached.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly document_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["document_id"];
+    };
+}, {
+    readonly name: "delete_document";
+    readonly description: "Delete a document and its file attachment.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly document_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["document_id"];
+    };
+}, {
+    readonly name: "scan_document";
+    readonly description: "Scan a document image using AI vision (OpenAI GPT-4o) to extract structured data. Optionally auto-save to vault.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly image: {
+                readonly type: "string";
+                readonly description: "File path or base64 image data";
+            };
+            readonly doc_type: {
+                readonly type: "string";
+                readonly description: "Hint: passport, national_id, drivers_license, etc.";
+            };
+            readonly contact_id: {
+                readonly type: "string";
+                readonly description: "Contact to associate scanned document with";
+            };
+            readonly auto_save: {
+                readonly type: "boolean";
+                readonly description: "Automatically save extracted data as a vault document";
+            };
+        };
+        readonly required: readonly ["image"];
+    };
+}, {
+    readonly name: "set_health_data";
+    readonly description: "Set or update health data for a contact. Vault must be unlocked.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly blood_type: {
+                readonly type: "string";
+            };
+            readonly allergies: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly medical_conditions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly medications: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+            };
+            readonly emergency_contacts: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                        };
+                        readonly phone: {
+                            readonly type: "string";
+                        };
+                        readonly relationship: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly required: readonly ["name", "phone", "relationship"];
+                };
+            };
+            readonly health_insurance_provider: {
+                readonly type: "string";
+            };
+            readonly health_insurance_id: {
+                readonly type: "string";
+            };
+            readonly primary_physician: {
+                readonly type: "string";
+            };
+            readonly primary_physician_phone: {
+                readonly type: "string";
+            };
+            readonly organ_donor: {
+                readonly type: "boolean";
+            };
+            readonly notes: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "get_health_data";
+    readonly description: "Get health data for a contact. Vault must be unlocked.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "delete_health_data";
+    readonly description: "Delete all health data for a contact.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "send_feedback";
+    readonly description: "Send feedback about this service";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly message: {
+                readonly type: "string";
+            };
+            readonly email: {
+                readonly type: "string";
+            };
+            readonly category: {
+                readonly type: "string";
+                readonly enum: readonly ["bug", "feature", "general"];
+            };
+        };
+        readonly required: readonly ["message"];
+    };
+}, {
+    readonly name: "register_agent";
+    readonly description: "Register an agent session. Returns agent_id. Auto-triggers a heartbeat.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["name"];
+    };
+}, {
+    readonly name: "heartbeat";
+    readonly description: "Update last_seen_at to signal agent is active.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly agent_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["agent_id"];
+    };
+}, {
+    readonly name: "set_focus";
+    readonly description: "Set active project context for this agent session.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly agent_id: {
+                readonly type: "string";
+            };
+            readonly project_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["agent_id"];
+    };
+}, {
+    readonly name: "list_agents";
+    readonly description: "List all registered agents.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "create_audience";
+    readonly description: "Create an audience segment (hasna.audience.v1): predicates over contact tags, attributes (columns or custom fields), and group membership. match: all|any. consent_policy: opt_in|opt_out|transactional|none.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly audience_id: {
+                readonly type: "string";
+                readonly description: "Lowercase dashed slug, e.g. beta-testers";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly match: {
+                readonly type: "string";
+                readonly enum: readonly ["all", "any"];
+            };
+            readonly predicates: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly kind: {
+                            readonly type: "string";
+                            readonly enum: readonly ["tag", "attribute", "group"];
+                        };
+                        readonly key: {
+                            readonly type: "string";
+                            readonly description: "Attribute key (required for attribute predicates)";
+                        };
+                        readonly op: {
+                            readonly type: "string";
+                            readonly enum: readonly ["eq", "neq", "in", "not_in", "exists", "not_exists"];
+                        };
+                        readonly value: {
+                            readonly description: "Value for eq/neq";
+                        };
+                        readonly values: {
+                            readonly type: "array";
+                            readonly description: "Values for in/not_in";
+                        };
+                    };
+                    readonly required: readonly ["kind"];
+                };
+            };
+            readonly consent_policy: {
+                readonly type: "string";
+                readonly enum: readonly ["opt_in", "opt_out", "transactional", "none"];
+            };
+        };
+        readonly required: readonly ["audience_id", "name", "predicates"];
+    };
+}, {
+    readonly name: "get_audience";
+    readonly description: "Get an audience by id or slug as its hasna.audience.v1 contract document.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "list_audiences";
+    readonly description: "List all audience segments.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {};
+    };
+}, {
+    readonly name: "update_audience";
+    readonly description: "Update an audience's name, match mode, predicates, or consent policy.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly match: {
+                readonly type: "string";
+                readonly enum: readonly ["all", "any"];
+            };
+            readonly predicates: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly kind: {
+                            readonly type: "string";
+                            readonly enum: readonly ["tag", "attribute", "group"];
+                        };
+                        readonly key: {
+                            readonly type: "string";
+                            readonly description: "Attribute key (required for attribute predicates)";
+                        };
+                        readonly op: {
+                            readonly type: "string";
+                            readonly enum: readonly ["eq", "neq", "in", "not_in", "exists", "not_exists"];
+                        };
+                        readonly value: {
+                            readonly description: "Value for eq/neq";
+                        };
+                        readonly values: {
+                            readonly type: "array";
+                            readonly description: "Values for in/not_in";
+                        };
+                    };
+                    readonly required: readonly ["kind"];
+                };
+            };
+            readonly consent_policy: {
+                readonly type: "string";
+                readonly enum: readonly ["opt_in", "opt_out", "transactional", "none"];
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "delete_audience";
+    readonly description: "Delete an audience segment by id or slug.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["id"];
+    };
+}, {
+    readonly name: "resolve_audience";
+    readonly description: "Resolve an audience to per-channel recipients honoring consent policy, per-channel consent, suppressions, and do_not_contact. Returns recipients plus exclusions with reasons.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly id: {
+                readonly type: "string";
+            };
+            readonly channel: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "telegram", "sms"];
+            };
+        };
+        readonly required: readonly ["id", "channel"];
+    };
+}, {
+    readonly name: "set_contact_consent";
+    readonly description: "Set a contact's subscription consent for a channel (opt_in, opt_out, unknown).";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly channel: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "telegram", "sms"];
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["opt_in", "opt_out", "unknown"];
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly description: "Where the consent signal came from";
+            };
+        };
+        readonly required: readonly ["contact_id", "channel", "status"];
+    };
+}, {
+    readonly name: "get_contact_consent";
+    readonly description: "Get a contact's consent status for all channels.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contact_id: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["contact_id"];
+    };
+}, {
+    readonly name: "suppress_address";
+    readonly description: "Suppress an address on a channel (unsubscribe/bounce/complaint). Also records an opt-out for the linked contact when contact_id is provided.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly channel: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "telegram", "sms"];
+            };
+            readonly address: {
+                readonly type: "string";
+            };
+            readonly contact_id: {
+                readonly type: "string";
+            };
+            readonly reason: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["channel", "address"];
+    };
+}, {
+    readonly name: "unsuppress_address";
+    readonly description: "Remove an address from the suppression list.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly channel: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "telegram", "sms"];
+            };
+            readonly address: {
+                readonly type: "string";
+            };
+        };
+        readonly required: readonly ["channel", "address"];
+    };
+}, {
+    readonly name: "list_suppressions";
+    readonly description: "List suppressed addresses, optionally filtered by channel or unsynced-only.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly channel: {
+                readonly type: "string";
+                readonly enum: readonly ["email", "telegram", "sms"];
+            };
+            readonly unsynced_only: {
+                readonly type: "boolean";
+            };
+        };
+        readonly required: readonly [];
+    };
+}, {
+    readonly name: "sync_suppressions";
+    readonly description: "Push unsynced email suppressions to mailery via @hasna/mailery. Use dry_run to preview.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly dry_run: {
+                readonly type: "boolean";
+            };
+        };
+        readonly required: readonly [];
+    };
+}];
+//# sourceMappingURL=tools.d.ts.map