@frihet/mcp-server 2.0.1 → 2.0.2

package/dist/openai-103/openai-expansion-103.d.ts

@@ -0,0 +1,1192 @@
+/**
+ * Candidate 1.0.3 capability expansion for the Frihet ChatGPT (OpenAI) profile.
+ *
+ * Developed in isolation (branch `feat/openai-1.0.3-candidate`) without mutating
+ * the live 1.0.2 production endpoint (`https://openai-mcp.frihet.io/mcp`, 33 tools).
+ *
+ * Exposes four read-only operational intelligence & commercial-search capabilities
+ * (expanding the surface from 33 to 37 tools):
+ * 1. `get_daily_operational_brief` — Prioritized daily brief with record provenance
+ * 2. `get_business_period_summary` — Period & month-over-month comparison by currency
+ * 3. `search_clients` — Multi-page commercial-name client search with ambiguity & coverage truth
+ * 4. `search_vendors` — Multi-page commercial-name vendor search with ambiguity & coverage truth
+ *
+ * Architectural note on `update_draft_invoice` (excluded from 1.0.3):
+ * Inspection of `Frihet-ERP/functions/src/publicApi.ts:10175-10350` (`updateResource`)
+ * shows that an MCP-only pre-flight (`getInvoice` + `updateInvoice`) is NOT atomic
+ * end-to-end:
+ * - `PATCH /v1/invoices/:id` runs a Firestore transaction (`db.runTransaction`),
+ *   but does not accept an `expectedStatus: "draft"` or `expectedUpdatedAt`
+ *   precondition inside that transaction.
+ * - `documentNumber` is assigned at draft creation (`POST /v1/invoices`), so
+ *   `expectedDocumentNumber` is not a revision token.
+ * - If a concurrent session transitions a draft invoice to `'sent'` (prior to
+ *   `verifactu.hash` or `documentNumberFinal`) between the MCP's `GET` and `PATCH`,
+ *   sending `{ status: "draft", ... }` is permitted by `publicApi.ts:10323-10333`,
+ *   which would demote an unhashed `'sent'` invoice back to `'draft'`.
+ * Therefore, draft editing is intentionally kept outside 1.0.3 until the ERP
+ * backend enforces `ifStatus === "draft"` + `ifUpdatedAt` inside `updateResource`.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod/v4";
+import type { IFrihetClient } from "../client-interface.js";
+export declare const CLIENT_SEARCH_SERVER_PROJECTION: "id,name,stage,email,phone";
+export declare const VENDOR_SEARCH_SERVER_PROJECTION: "id,name,email,phone";
+/**
+ * Rejects queries that look like Spanish NIF/NIE/CIF or EU VAT numbers
+ * (including labeled forms like "NIF: B87654321" or numeric stems) so
+ * name-only search tools can never be used as government-ID lookup oracles.
+ */
+export declare function isLikelyGovernmentIdQuery(raw: string): boolean;
+export type NameMatchRank = "exact" | "prefix" | "token" | "substring";
+export declare function matchCommercialName(candidateName: unknown, rawQuery: string): {
+    matched: boolean;
+    rank?: NameMatchRank;
+    score: number;
+};
+export declare const dailyOperationalBriefOutputSchema: z.ZodObject<{
+    question: z.ZodString;
+    coverage: z.ZodObject<{
+        asOfDate: z.ZodString;
+        referenceMonth: z.ZodString;
+        temporalScope: z.ZodLiteral<"unfiltered_operational_sample_as_of_date">;
+        temporalScopeNote: z.ZodString;
+        isPartial: z.ZodBoolean;
+        resources: z.ZodArray<z.ZodObject<{
+            collection: z.ZodEnum<{
+                invoices: "invoices";
+                expenses: "expenses";
+                clients: "clients";
+                quotes: "quotes";
+                client_activities: "client_activities";
+            }>;
+            sourceTool: z.ZodString;
+            inspected: z.ZodNumber;
+            total: z.ZodNumber;
+            complete: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    activitySeparation: z.ZodObject<{
+        draftActivity: z.ZodObject<{
+            note: z.ZodString;
+            invoiceDraftsCount: z.ZodNumber;
+            invoiceDraftsTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            invoiceDrafts: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                documentNumber: z.ZodNullable<z.ZodString>;
+                status: z.ZodString;
+                counterpartyName: z.ZodString;
+                issueDate: z.ZodNullable<z.ZodString>;
+                dueDate: z.ZodNullable<z.ZodString>;
+                amount: z.ZodObject<{
+                    amount: z.ZodNullable<z.ZodNumber>;
+                    currency: z.ZodString;
+                    provenance: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                        business_context_summary: "business_context_summary";
+                        mixed_currency_unconverted: "mixed_currency_unconverted";
+                    }>;
+                    fieldOrFormula: z.ZodString;
+                    totalsByCurrency: z.ZodArray<z.ZodObject<{
+                        currency: z.ZodString;
+                        amount: z.ZodNumber;
+                        documentCount: z.ZodNumber;
+                        provenance: z.ZodEnum<{
+                            stored_field: "stored_field";
+                            derived_from_items: "derived_from_items";
+                        }>;
+                    }, z.core.$strip>>;
+                    unavailableCount: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            quoteDraftsCount: z.ZodNumber;
+            quoteDraftsTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            quoteDrafts: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                documentNumber: z.ZodNullable<z.ZodString>;
+                status: z.ZodString;
+                counterpartyName: z.ZodString;
+                issueDate: z.ZodNullable<z.ZodString>;
+                dueDate: z.ZodNullable<z.ZodString>;
+                amount: z.ZodObject<{
+                    amount: z.ZodNullable<z.ZodNumber>;
+                    currency: z.ZodString;
+                    provenance: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                        business_context_summary: "business_context_summary";
+                        mixed_currency_unconverted: "mixed_currency_unconverted";
+                    }>;
+                    fieldOrFormula: z.ZodString;
+                    totalsByCurrency: z.ZodArray<z.ZodObject<{
+                        currency: z.ZodString;
+                        amount: z.ZodNumber;
+                        documentCount: z.ZodNumber;
+                        provenance: z.ZodEnum<{
+                            stored_field: "stored_field";
+                            derived_from_items: "derived_from_items";
+                        }>;
+                    }, z.core.$strip>>;
+                    unavailableCount: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        issuedActivity: z.ZodObject<{
+            note: z.ZodString;
+            realOutstandingBalanceDeterminable: z.ZodLiteral<false>;
+            unpaidNominalSemantics: z.ZodLiteral<"nominal_unpaid_invoice_totals_without_partial_payments">;
+            issuedInvoicesCount: z.ZodNumber;
+            paidInvoicesCount: z.ZodNumber;
+            paidInvoicesTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            unpaidNominalInvoicesCount: z.ZodNumber;
+            unpaidNominalTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            overdueNominalInvoicesCount: z.ZodNumber;
+            overdueNominalTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            onTimeNominalPendingCount: z.ZodNumber;
+            onTimeNominalPendingTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            outstandingInvoices: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                documentNumber: z.ZodNullable<z.ZodString>;
+                status: z.ZodString;
+                counterpartyName: z.ZodString;
+                issueDate: z.ZodNullable<z.ZodString>;
+                dueDate: z.ZodNullable<z.ZodString>;
+                amount: z.ZodObject<{
+                    amount: z.ZodNullable<z.ZodNumber>;
+                    currency: z.ZodString;
+                    provenance: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                        business_context_summary: "business_context_summary";
+                        mixed_currency_unconverted: "mixed_currency_unconverted";
+                    }>;
+                    fieldOrFormula: z.ZodString;
+                    totalsByCurrency: z.ZodArray<z.ZodObject<{
+                        currency: z.ZodString;
+                        amount: z.ZodNumber;
+                        documentCount: z.ZodNumber;
+                        provenance: z.ZodEnum<{
+                            stored_field: "stored_field";
+                            derived_from_items: "derived_from_items";
+                        }>;
+                    }, z.core.$strip>>;
+                    unavailableCount: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        recordedExpenses: z.ZodObject<{
+            note: z.ZodString;
+            expensesCount: z.ZodNumber;
+            expensesTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            deductibleCount: z.ZodNumber;
+            deductibleTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            nonDeductibleCount: z.ZodNumber;
+            nonDeductibleTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            pendingReviewCount: z.ZodNumber;
+        }, z.core.$strip>;
+        currentMonthActivity: z.ZodObject<{
+            referenceMonth: z.ZodString;
+            note: z.ZodString;
+            issuedInvoicesInMonthCount: z.ZodNumber;
+            issuedInvoicesInMonthTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            invoiceDraftsInMonthCount: z.ZodNumber;
+            invoiceDraftsInMonthTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            expensesInMonthCount: z.ZodNumber;
+            expensesInMonthTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    priorities: z.ZodArray<z.ZodObject<{
+        priority: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>;
+        category: z.ZodEnum<{
+            draft_invoice: "draft_invoice";
+            overdue_invoice: "overdue_invoice";
+            draft_or_expiring_quote: "draft_or_expiring_quote";
+            expense_review: "expense_review";
+            client_followup: "client_followup";
+            plan_quota: "plan_quota";
+        }>;
+        title: z.ZodString;
+        why: z.ZodString;
+        recordRefs: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<{
+                invoice: "invoice";
+                expense: "expense";
+                client: "client";
+                plan_quota: "plan_quota";
+                quote: "quote";
+                client_activity: "client_activity";
+            }>;
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        amount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNullable<z.ZodNumber>;
+            currency: z.ZodString;
+            provenance: z.ZodEnum<{
+                unavailable: "unavailable";
+                stored_field: "stored_field";
+                derived_from_items: "derived_from_items";
+                business_context_summary: "business_context_summary";
+                mixed_currency_unconverted: "mixed_currency_unconverted";
+            }>;
+            fieldOrFormula: z.ZodString;
+            totalsByCurrency: z.ZodArray<z.ZodObject<{
+                currency: z.ZodString;
+                amount: z.ZodNumber;
+                documentCount: z.ZodNumber;
+                provenance: z.ZodEnum<{
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                }>;
+            }, z.core.$strip>>;
+            unavailableCount: z.ZodNumber;
+        }, z.core.$strip>>;
+        suggestedNextAction: z.ZodObject<{
+            description: z.ZodString;
+            recommendedTool: z.ZodString;
+            requiresConfirmation: z.ZodBoolean;
+            autoExecuted: z.ZodLiteral<false>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    knownUnknowns: z.ZodArray<z.ZodString>;
+    mutationsExecuted: z.ZodLiteral<0>;
+}, z.core.$strip>;
+export declare const businessPeriodSummaryOutputSchema: z.ZodObject<{
+    accountingSemanticsNote: z.ZodString;
+    primaryPeriod: z.ZodObject<{
+        period: z.ZodString;
+        coverage: z.ZodObject<{
+            invoicesInspected: z.ZodNumber;
+            invoicesTotal: z.ZodNumber;
+            invoicesComplete: z.ZodBoolean;
+            expensesInspected: z.ZodNumber;
+            expensesTotal: z.ZodNumber;
+            expensesComplete: z.ZodBoolean;
+            isComplete: z.ZodBoolean;
+            telemetry: z.ZodObject<{
+                invoicePagesFetched: z.ZodNumber;
+                expensePagesFetched: z.ZodNumber;
+                totalApiRequests: z.ZodNumber;
+                recordsInspected: z.ZodNumber;
+                approximatePayloadBytes: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        draftInvoices: z.ZodObject<{
+            note: z.ZodString;
+            count: z.ZodNumber;
+            total: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        issuedInvoices: z.ZodObject<{
+            selectionBasis: z.ZodLiteral<"issue_date_cohort_not_payment_date">;
+            note: z.ZodString;
+            realOutstandingBalanceDeterminable: z.ZodLiteral<false>;
+            count: z.ZodNumber;
+            currentlyMarkedPaidCount: z.ZodNumber;
+            unpaidNominalCount: z.ZodNumber;
+            overdueNominalCount: z.ZodNumber;
+            issuedTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            currentlyMarkedPaidTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            unpaidNominalTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            overdueNominalTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        expenses: z.ZodObject<{
+            note: z.ZodString;
+            count: z.ZodNumber;
+            total: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            deductibleCount: z.ZodNumber;
+            deductibleTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            nonDeductibleCount: z.ZodNumber;
+            nonDeductibleTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            undeterminedDeductibilityCount: z.ZodNumber;
+            undeterminedDeductibilityTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            byCategory: z.ZodArray<z.ZodObject<{
+                category: z.ZodString;
+                currency: z.ZodString;
+                amount: z.ZodNumber;
+                expenseCount: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        netOperatingByCurrency: z.ZodArray<z.ZodObject<{
+            currency: z.ZodString;
+            issuedRevenueMinusExpenses: z.ZodNullable<z.ZodNumber>;
+            issuedCohortCurrentlyPaidMinusExpenses: z.ZodNullable<z.ZodNumber>;
+            completeAndDeterminable: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    comparisonPeriod: z.ZodOptional<z.ZodObject<{
+        period: z.ZodString;
+        coverage: z.ZodObject<{
+            invoicesInspected: z.ZodNumber;
+            invoicesTotal: z.ZodNumber;
+            invoicesComplete: z.ZodBoolean;
+            expensesInspected: z.ZodNumber;
+            expensesTotal: z.ZodNumber;
+            expensesComplete: z.ZodBoolean;
+            isComplete: z.ZodBoolean;
+            telemetry: z.ZodObject<{
+                invoicePagesFetched: z.ZodNumber;
+                expensePagesFetched: z.ZodNumber;
+                totalApiRequests: z.ZodNumber;
+                recordsInspected: z.ZodNumber;
+                approximatePayloadBytes: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        draftInvoices: z.ZodObject<{
+            note: z.ZodString;
+            count: z.ZodNumber;
+            total: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        issuedInvoices: z.ZodObject<{
+            selectionBasis: z.ZodLiteral<"issue_date_cohort_not_payment_date">;
+            note: z.ZodString;
+            realOutstandingBalanceDeterminable: z.ZodLiteral<false>;
+            count: z.ZodNumber;
+            currentlyMarkedPaidCount: z.ZodNumber;
+            unpaidNominalCount: z.ZodNumber;
+            overdueNominalCount: z.ZodNumber;
+            issuedTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            currentlyMarkedPaidTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            unpaidNominalTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            overdueNominalTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        expenses: z.ZodObject<{
+            note: z.ZodString;
+            count: z.ZodNumber;
+            total: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            deductibleCount: z.ZodNumber;
+            deductibleTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            nonDeductibleCount: z.ZodNumber;
+            nonDeductibleTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            undeterminedDeductibilityCount: z.ZodNumber;
+            undeterminedDeductibilityTotal: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+            byCategory: z.ZodArray<z.ZodObject<{
+                category: z.ZodString;
+                currency: z.ZodString;
+                amount: z.ZodNumber;
+                expenseCount: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        netOperatingByCurrency: z.ZodArray<z.ZodObject<{
+            currency: z.ZodString;
+            issuedRevenueMinusExpenses: z.ZodNullable<z.ZodNumber>;
+            issuedCohortCurrentlyPaidMinusExpenses: z.ZodNullable<z.ZodNumber>;
+            completeAndDeterminable: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    comparison: z.ZodOptional<z.ZodObject<{
+        primaryMonth: z.ZodString;
+        compareWithMonth: z.ZodString;
+        bothPeriodsComplete: z.ZodBoolean;
+        issuedInvoicesCountDelta: z.ZodNumber;
+        draftInvoicesCountDelta: z.ZodNumber;
+        expensesCountDelta: z.ZodNumber;
+        deltasByCurrency: z.ZodArray<z.ZodObject<{
+            currency: z.ZodString;
+            primaryIssuedRevenue: z.ZodNullable<z.ZodNumber>;
+            comparisonIssuedRevenue: z.ZodNullable<z.ZodNumber>;
+            issuedRevenueDelta: z.ZodNullable<z.ZodNumber>;
+            primaryIssuedCurrentlyPaid: z.ZodNullable<z.ZodNumber>;
+            comparisonIssuedCurrentlyPaid: z.ZodNullable<z.ZodNumber>;
+            issuedCurrentlyPaidDelta: z.ZodNullable<z.ZodNumber>;
+            primaryExpenses: z.ZodNullable<z.ZodNumber>;
+            comparisonExpenses: z.ZodNullable<z.ZodNumber>;
+            expensesDelta: z.ZodNullable<z.ZodNumber>;
+            completeAndDeterminable: z.ZodBoolean;
+        }, z.core.$strip>>;
+        notes: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const searchMatchStatusSchema: z.ZodEnum<{
+    exact: "exact";
+    none: "none";
+    unambiguous: "unambiguous";
+    ambiguous: "ambiguous";
+    partial_scan_single_match: "partial_scan_single_match";
+    partial_scan_no_match: "partial_scan_no_match";
+}>;
+export declare const searchClientsOutputSchema: z.ZodObject<{
+    query: z.ZodString;
+    searchedFields: z.ZodArray<z.ZodLiteral<"name">>;
+    matchStatus: z.ZodEnum<{
+        exact: "exact";
+        none: "none";
+        unambiguous: "unambiguous";
+        ambiguous: "ambiguous";
+        partial_scan_single_match: "partial_scan_single_match";
+        partial_scan_no_match: "partial_scan_no_match";
+    }>;
+    disambiguationNote: z.ZodString;
+    coverage: z.ZodObject<{
+        inspected: z.ZodNumber;
+        total: z.ZodNumber;
+        uninspectedCount: z.ZodNumber;
+        complete: z.ZodBoolean;
+        nextCursor: z.ZodNullable<z.ZodString>;
+        telemetry: z.ZodObject<{
+            directoryPagesFetched: z.ZodNumber;
+            contextRequestsMade: z.ZodNumber;
+            totalApiRequests: z.ZodNumber;
+            recordsInspected: z.ZodNumber;
+            approximatePayloadBytes: z.ZodNumber;
+            serverProjectionFields: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    matches: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        stage: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        matchRank: z.ZodEnum<{
+            substring: "substring";
+            token: "token";
+            exact: "exact";
+            prefix: "prefix";
+        }>;
+        context: z.ZodOptional<z.ZodObject<{
+            recentInvoices: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                invoiceNumber: z.ZodNullable<z.ZodString>;
+                status: z.ZodString;
+                issueDate: z.ZodNullable<z.ZodString>;
+                dueDate: z.ZodNullable<z.ZodString>;
+                amount: z.ZodObject<{
+                    amount: z.ZodNullable<z.ZodNumber>;
+                    currency: z.ZodString;
+                    provenance: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                        business_context_summary: "business_context_summary";
+                        mixed_currency_unconverted: "mixed_currency_unconverted";
+                    }>;
+                    fieldOrFormula: z.ZodString;
+                    totalsByCurrency: z.ZodArray<z.ZodObject<{
+                        currency: z.ZodString;
+                        amount: z.ZodNumber;
+                        documentCount: z.ZodNumber;
+                        provenance: z.ZodEnum<{
+                            stored_field: "stored_field";
+                            derived_from_items: "derived_from_items";
+                        }>;
+                    }, z.core.$strip>>;
+                    unavailableCount: z.ZodNumber;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+            recentActivities: z.ZodArray<z.ZodObject<{
+                type: z.ZodString;
+                title: z.ZodString;
+                timestamp: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const searchVendorsOutputSchema: z.ZodObject<{
+    query: z.ZodString;
+    searchedFields: z.ZodArray<z.ZodLiteral<"name">>;
+    matchStatus: z.ZodEnum<{
+        exact: "exact";
+        none: "none";
+        unambiguous: "unambiguous";
+        ambiguous: "ambiguous";
+        partial_scan_single_match: "partial_scan_single_match";
+        partial_scan_no_match: "partial_scan_no_match";
+    }>;
+    disambiguationNote: z.ZodString;
+    coverage: z.ZodObject<{
+        inspected: z.ZodNumber;
+        total: z.ZodNumber;
+        uninspectedCount: z.ZodNumber;
+        complete: z.ZodBoolean;
+        nextCursor: z.ZodNullable<z.ZodString>;
+        telemetry: z.ZodObject<{
+            directoryPagesFetched: z.ZodNumber;
+            contextRequestsMade: z.ZodNumber;
+            totalApiRequests: z.ZodNumber;
+            recordsInspected: z.ZodNumber;
+            approximatePayloadBytes: z.ZodNumber;
+            serverProjectionFields: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    matches: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        matchRank: z.ZodEnum<{
+            substring: "substring";
+            token: "token";
+            exact: "exact";
+            prefix: "prefix";
+        }>;
+        recentExpenses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodString;
+            date: z.ZodNullable<z.ZodString>;
+            category: z.ZodNullable<z.ZodString>;
+            taxDeductible: z.ZodNullable<z.ZodBoolean>;
+            amount: z.ZodObject<{
+                amount: z.ZodNullable<z.ZodNumber>;
+                currency: z.ZodString;
+                provenance: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    stored_field: "stored_field";
+                    derived_from_items: "derived_from_items";
+                    business_context_summary: "business_context_summary";
+                    mixed_currency_unconverted: "mixed_currency_unconverted";
+                }>;
+                fieldOrFormula: z.ZodString;
+                totalsByCurrency: z.ZodArray<z.ZodObject<{
+                    currency: z.ZodString;
+                    amount: z.ZodNumber;
+                    documentCount: z.ZodNumber;
+                    provenance: z.ZodEnum<{
+                        stored_field: "stored_field";
+                        derived_from_items: "derived_from_items";
+                    }>;
+                }, z.core.$strip>>;
+                unavailableCount: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function registerOpenAI103CandidateTools(server: McpServer, client: IFrihetClient): void;
+//# sourceMappingURL=openai-expansion-103.d.ts.map