@voyant-travel/finance 0.158.0 → 0.161.0

package/dist/tools.d.ts

@@ -1,17 +1,40 @@
 /**
- * Finance agent tools on the framework tool contract. Thin, read-only wrappers
- * over the existing finance service; the service is injected on the tool context
+ * Finance agent tools on the framework tool contract. Thin wrappers over the
+ * existing finance service; the service is injected on the tool context
  * by intersection so this module stays deployment-agnostic.
+ * Refunds are issued through the credit-note service after action approval.
  */
 import { type ToolContext } from "@voyant-travel/tools";
 import { z } from "zod";
+import { type BookingCreateOutcome, bookingCreateSchema } from "./service-booking-create.js";
 import { invoiceListQuerySchema } from "./validation.js";
 export interface FinanceToolServices {
     listInvoices(query: z.infer<typeof invoiceListQuerySchema>): Promise<unknown>;
     getInvoiceById(id: string): Promise<unknown>;
+    getFinanceAggregates(query: {
+        range?: "this_month" | "last_month" | "year_to_date" | "all_time" | "custom";
+        from?: string;
+        to?: string;
+        outstandingTopLimit?: number;
+    }): Promise<unknown>;
     voidInvoice(id: string, input: {
         reason?: string;
     }): Promise<unknown>;
+    issueInvoiceRefund(input: {
+        invoiceId: string;
+        creditNoteNumber: string;
+        amountCents: number;
+        currency: string;
+        baseCurrency?: string | null;
+        baseAmountCents?: number | null;
+        fxRateSetId?: string | null;
+        reason: string;
+        notes?: string | null;
+        idempotencyKey: string;
+        approvalId?: string;
+    }): Promise<unknown>;
+    createBooking(input: z.infer<typeof bookingCreateSchema>): Promise<BookingCreateOutcome>;
+    issueInvoiceFromBooking(input: z.infer<typeof issueInvoiceFromBookingToolInputSchema>): Promise<unknown>;
 }
 export type FinanceToolContext = ToolContext & {
     finance?: FinanceToolServices;
@@ -37,6 +60,760 @@ export declare const voidInvoiceTool: import("@voyant-travel/tools").ToolDefinit
     id: string;
     reason?: string | undefined;
 }, unknown, FinanceToolContext>;
+export declare const issueInvoiceRefundInputSchema: z.ZodObject<{
+    notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    currency: z.ZodString;
+    baseCurrency: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    fxRateSetId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    amountCents: z.ZodNumber;
+    baseAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    creditNoteNumber: z.ZodString;
+    reason: z.ZodString;
+    invoiceId: z.ZodString;
+    idempotencyKey: z.ZodString;
+    approvalId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const issueInvoiceRefundOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    status: z.ZodLiteral<"approval_required">;
+    requestedAction: z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodString;
+        actionName: z.ZodString;
+        targetType: z.ZodString;
+        targetId: z.ZodString;
+    }, z.core.$strip>;
+    approval: z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodString;
+        requestedActionId: z.ZodString;
+        policyName: z.ZodString;
+        policyVersion: z.ZodString;
+        riskSnapshot: z.ZodString;
+        reasonCode: z.ZodString;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+    replayed: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"issued">;
+    creditNote: z.ZodObject<{
+        id: z.ZodString;
+        creditNoteNumber: z.ZodString;
+        invoiceId: z.ZodString;
+        status: z.ZodEnum<{
+            draft: "draft";
+            issued: "issued";
+            applied: "applied";
+        }>;
+        amountCents: z.ZodNumber;
+        currency: z.ZodString;
+        baseCurrency: z.ZodNullable<z.ZodString>;
+        baseAmountCents: z.ZodNullable<z.ZodNumber>;
+        fxRateSetId: z.ZodNullable<z.ZodString>;
+        reason: z.ZodString;
+        notes: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    replayed: z.ZodBoolean;
+}, z.core.$strip>]>;
+export declare const issueInvoiceRefundTool: import("@voyant-travel/tools").ToolDefinition<{
+    currency: string;
+    amountCents: number;
+    creditNoteNumber: string;
+    reason: string;
+    invoiceId: string;
+    idempotencyKey: string;
+    notes?: string | null | undefined;
+    baseCurrency?: string | null | undefined;
+    fxRateSetId?: string | null | undefined;
+    baseAmountCents?: number | null | undefined;
+    approvalId?: string | undefined;
+}, {
+    status: "approval_required";
+    requestedAction: {
+        id: string;
+        status: string;
+        actionName: string;
+        targetType: string;
+        targetId: string;
+    };
+    approval: {
+        id: string;
+        status: string;
+        requestedActionId: string;
+        policyName: string;
+        policyVersion: string;
+        riskSnapshot: string;
+        reasonCode: string;
+        expiresAt: string | null;
+        createdAt: string;
+    };
+    replayed: boolean;
+} | {
+    status: "issued";
+    creditNote: {
+        id: string;
+        creditNoteNumber: string;
+        invoiceId: string;
+        status: "draft" | "issued" | "applied";
+        amountCents: number;
+        currency: string;
+        baseCurrency: string | null;
+        baseAmountCents: number | null;
+        fxRateSetId: string | null;
+        reason: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+    replayed: boolean;
+}, FinanceToolContext>;
+export declare const createBookingToolInputSchema: z.ZodObject<{
+    booking: z.ZodObject<{
+        productId: z.ZodString;
+        optionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        slotId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        availabilityHoldToken: z.ZodOptional<z.ZodString>;
+        bookingNumber: z.ZodString;
+        personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        pax: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        internalNotes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        sellAmountCentsOverride: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        catalogSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        confirmedSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        priceOverrideReason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        initialStatus: z.ZodOptional<z.ZodEnum<{
+            draft: "draft";
+            on_hold: "on_hold";
+            awaiting_payment: "awaiting_payment";
+            confirmed: "confirmed";
+            in_progress: "in_progress";
+            completed: "completed";
+            expired: "expired";
+            cancelled: "cancelled";
+        }>>;
+        suppressNotifications: z.ZodOptional<z.ZodBoolean>;
+        allowDuplicate: z.ZodOptional<z.ZodBoolean>;
+        contactFirstName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactLastName: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactEmail: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPhone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPreferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCountry: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactRegion: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactCity: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactAddressLine1: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactAddressLine2: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        contactPostalCode: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        travelers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientTravelerKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            firstName: z.ZodString;
+            lastName: z.ZodString;
+            email: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            phone: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            personId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            participantType: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                traveler: "traveler";
+                occupant: "occupant";
+            }>>;
+            travelerCategory: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+                other: "other";
+                adult: "adult";
+                child: "child";
+                infant: "infant";
+                senior: "senior";
+            }>>>;
+            preferredLanguage: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            specialRequests: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            roomUnitId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            isPrimary: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+            notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>;
+        itemLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientLineKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            optionUnitId: z.ZodString;
+            quantity: z.ZodNumber;
+            title: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            unitSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            totalSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            travelerKeys: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            travelerIndexes: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+        }, z.core.$strip>>>;
+        extraLines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            clientLineKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            productExtraId: z.ZodString;
+            optionExtraConfigId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            name: z.ZodString;
+            description: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            pricingMode: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            pricedPerPerson: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
+            quantity: z.ZodNumber;
+            sellCurrency: z.ZodString;
+            unitSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            totalSellAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            travelerKeys: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            travelerIndexes: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
+        }, z.core.$strip>>>;
+        paymentSchedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            scheduleType: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                deposit: "deposit";
+                installment: "installment";
+                balance: "balance";
+                hold: "hold";
+            }>>;
+            status: z.ZodDefault<z.ZodEnum<{
+                paid: "paid";
+                pending: "pending";
+                cancelled: "cancelled";
+                expired: "expired";
+                due: "due";
+                waived: "waived";
+            }>>;
+            dueDate: z.ZodString;
+            currency: z.ZodString;
+            amountCents: z.ZodNumber;
+            notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>;
+        travelCreditRedemption: z.ZodOptional<z.ZodObject<{
+            travelCreditId: z.ZodString;
+            amountCents: z.ZodNumber;
+        }, z.core.$strip>>;
+        groupMembership: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            action: z.ZodLiteral<"join">;
+            groupId: z.ZodString;
+            role: z.ZodDefault<z.ZodEnum<{
+                primary: "primary";
+                shared: "shared";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            action: z.ZodLiteral<"create">;
+            kind: z.ZodDefault<z.ZodEnum<{
+                other: "other";
+                shared_room: "shared_room";
+            }>>;
+            label: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            optionUnitId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            makeBookingPrimary: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>], "action">>;
+        documentGeneration: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+            contractDocument: z.ZodDefault<z.ZodBoolean>;
+            invoiceDocument: z.ZodDefault<z.ZodBoolean>;
+            invoiceType: z.ZodDefault<z.ZodEnum<{
+                invoice: "invoice";
+                proforma: "proforma";
+            }>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const createBookingTool: import("@voyant-travel/tools").ToolDefinition<{
+    booking: {
+        productId: string;
+        bookingNumber: string;
+        optionId?: string | null | undefined;
+        slotId?: string | null | undefined;
+        availabilityHoldToken?: string | undefined;
+        personId?: string | null | undefined;
+        organizationId?: string | null | undefined;
+        pax?: number | null | undefined;
+        internalNotes?: string | null | undefined;
+        sellAmountCentsOverride?: number | null | undefined;
+        catalogSellAmountCents?: number | null | undefined;
+        confirmedSellAmountCents?: number | null | undefined;
+        priceOverrideReason?: string | null | undefined;
+        initialStatus?: "draft" | "completed" | "cancelled" | "expired" | "on_hold" | "awaiting_payment" | "confirmed" | "in_progress" | undefined;
+        suppressNotifications?: boolean | undefined;
+        allowDuplicate?: boolean | undefined;
+        contactFirstName?: string | null | undefined;
+        contactLastName?: string | null | undefined;
+        contactEmail?: string | null | undefined;
+        contactPhone?: string | null | undefined;
+        contactPreferredLanguage?: string | null | undefined;
+        contactCountry?: string | null | undefined;
+        contactRegion?: string | null | undefined;
+        contactCity?: string | null | undefined;
+        contactAddressLine1?: string | null | undefined;
+        contactAddressLine2?: string | null | undefined;
+        contactPostalCode?: string | null | undefined;
+        travelers?: {
+            firstName: string;
+            lastName: string;
+            participantType: "other" | "traveler" | "occupant";
+            clientTravelerKey?: string | null | undefined;
+            email?: string | null | undefined;
+            phone?: string | null | undefined;
+            personId?: string | null | undefined;
+            travelerCategory?: "other" | "adult" | "child" | "infant" | "senior" | null | undefined;
+            preferredLanguage?: string | null | undefined;
+            specialRequests?: string | null | undefined;
+            roomUnitId?: string | null | undefined;
+            isPrimary?: boolean | null | undefined;
+            notes?: string | null | undefined;
+        }[] | undefined;
+        itemLines?: {
+            optionUnitId: string;
+            quantity: number;
+            clientLineKey?: string | null | undefined;
+            title?: string | null | undefined;
+            description?: string | null | undefined;
+            unitSellAmountCents?: number | null | undefined;
+            totalSellAmountCents?: number | null | undefined;
+            travelerKeys?: string[] | null | undefined;
+            travelerIndexes?: number[] | null | undefined;
+        }[] | undefined;
+        extraLines?: {
+            productExtraId: string;
+            name: string;
+            quantity: number;
+            sellCurrency: string;
+            clientLineKey?: string | null | undefined;
+            optionExtraConfigId?: string | null | undefined;
+            description?: string | null | undefined;
+            pricingMode?: string | null | undefined;
+            pricedPerPerson?: boolean | null | undefined;
+            unitSellAmountCents?: number | null | undefined;
+            totalSellAmountCents?: number | null | undefined;
+            travelerKeys?: string[] | null | undefined;
+            travelerIndexes?: number[] | null | undefined;
+        }[] | undefined;
+        paymentSchedules?: {
+            scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
+            status: "paid" | "pending" | "cancelled" | "expired" | "due" | "waived";
+            dueDate: string;
+            currency: string;
+            amountCents: number;
+            notes?: string | null | undefined;
+        }[] | undefined;
+        travelCreditRedemption?: {
+            travelCreditId: string;
+            amountCents: number;
+        } | undefined;
+        groupMembership?: {
+            action: "join";
+            groupId: string;
+            role: "primary" | "shared";
+        } | {
+            action: "create";
+            kind: "other" | "shared_room";
+            makeBookingPrimary: boolean;
+            label?: string | null | undefined;
+            optionUnitId?: string | null | undefined;
+        } | undefined;
+        documentGeneration?: {
+            contractDocument: boolean;
+            invoiceDocument: boolean;
+            invoiceType: "invoice" | "proforma";
+        } | undefined;
+    };
+}, {
+    status: "created";
+    booking: {
+        id: string;
+        bookingNumber: string;
+        status: string;
+        currency: string;
+        amountCents: number | null;
+        pax: number | null;
+    };
+    travelerIds: string[];
+    paymentSchedules: {
+        id: string;
+        scheduleType: string;
+        status: string;
+        dueDate: string;
+        currency: string;
+        amountCents: number;
+    }[];
+    invoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: string;
+        status: string;
+    } | null;
+    invoiceDocument: {
+        status: "requested";
+        renditionId: string | null;
+    } | {
+        status: "generated";
+        renditionId: string;
+    } | {
+        status: "failed" | "not_available" | "not_requested";
+    };
+    paymentIds: string[];
+    groupId: string | null;
+    travelCreditRedemptionId: string | null;
+}, FinanceToolContext>;
+export declare const financeBookingsCreateTools: readonly [import("@voyant-travel/tools").ToolDefinition<{
+    booking: {
+        productId: string;
+        bookingNumber: string;
+        optionId?: string | null | undefined;
+        slotId?: string | null | undefined;
+        availabilityHoldToken?: string | undefined;
+        personId?: string | null | undefined;
+        organizationId?: string | null | undefined;
+        pax?: number | null | undefined;
+        internalNotes?: string | null | undefined;
+        sellAmountCentsOverride?: number | null | undefined;
+        catalogSellAmountCents?: number | null | undefined;
+        confirmedSellAmountCents?: number | null | undefined;
+        priceOverrideReason?: string | null | undefined;
+        initialStatus?: "draft" | "completed" | "cancelled" | "expired" | "on_hold" | "awaiting_payment" | "confirmed" | "in_progress" | undefined;
+        suppressNotifications?: boolean | undefined;
+        allowDuplicate?: boolean | undefined;
+        contactFirstName?: string | null | undefined;
+        contactLastName?: string | null | undefined;
+        contactEmail?: string | null | undefined;
+        contactPhone?: string | null | undefined;
+        contactPreferredLanguage?: string | null | undefined;
+        contactCountry?: string | null | undefined;
+        contactRegion?: string | null | undefined;
+        contactCity?: string | null | undefined;
+        contactAddressLine1?: string | null | undefined;
+        contactAddressLine2?: string | null | undefined;
+        contactPostalCode?: string | null | undefined;
+        travelers?: {
+            firstName: string;
+            lastName: string;
+            participantType: "other" | "traveler" | "occupant";
+            clientTravelerKey?: string | null | undefined;
+            email?: string | null | undefined;
+            phone?: string | null | undefined;
+            personId?: string | null | undefined;
+            travelerCategory?: "other" | "adult" | "child" | "infant" | "senior" | null | undefined;
+            preferredLanguage?: string | null | undefined;
+            specialRequests?: string | null | undefined;
+            roomUnitId?: string | null | undefined;
+            isPrimary?: boolean | null | undefined;
+            notes?: string | null | undefined;
+        }[] | undefined;
+        itemLines?: {
+            optionUnitId: string;
+            quantity: number;
+            clientLineKey?: string | null | undefined;
+            title?: string | null | undefined;
+            description?: string | null | undefined;
+            unitSellAmountCents?: number | null | undefined;
+            totalSellAmountCents?: number | null | undefined;
+            travelerKeys?: string[] | null | undefined;
+            travelerIndexes?: number[] | null | undefined;
+        }[] | undefined;
+        extraLines?: {
+            productExtraId: string;
+            name: string;
+            quantity: number;
+            sellCurrency: string;
+            clientLineKey?: string | null | undefined;
+            optionExtraConfigId?: string | null | undefined;
+            description?: string | null | undefined;
+            pricingMode?: string | null | undefined;
+            pricedPerPerson?: boolean | null | undefined;
+            unitSellAmountCents?: number | null | undefined;
+            totalSellAmountCents?: number | null | undefined;
+            travelerKeys?: string[] | null | undefined;
+            travelerIndexes?: number[] | null | undefined;
+        }[] | undefined;
+        paymentSchedules?: {
+            scheduleType: "other" | "deposit" | "installment" | "balance" | "hold";
+            status: "paid" | "pending" | "cancelled" | "expired" | "due" | "waived";
+            dueDate: string;
+            currency: string;
+            amountCents: number;
+            notes?: string | null | undefined;
+        }[] | undefined;
+        travelCreditRedemption?: {
+            travelCreditId: string;
+            amountCents: number;
+        } | undefined;
+        groupMembership?: {
+            action: "join";
+            groupId: string;
+            role: "primary" | "shared";
+        } | {
+            action: "create";
+            kind: "other" | "shared_room";
+            makeBookingPrimary: boolean;
+            label?: string | null | undefined;
+            optionUnitId?: string | null | undefined;
+        } | undefined;
+        documentGeneration?: {
+            contractDocument: boolean;
+            invoiceDocument: boolean;
+            invoiceType: "invoice" | "proforma";
+        } | undefined;
+    };
+}, {
+    status: "created";
+    booking: {
+        id: string;
+        bookingNumber: string;
+        status: string;
+        currency: string;
+        amountCents: number | null;
+        pax: number | null;
+    };
+    travelerIds: string[];
+    paymentSchedules: {
+        id: string;
+        scheduleType: string;
+        status: string;
+        dueDate: string;
+        currency: string;
+        amountCents: number;
+    }[];
+    invoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: string;
+        status: string;
+    } | null;
+    invoiceDocument: {
+        status: "requested";
+        renditionId: string | null;
+    } | {
+        status: "generated";
+        renditionId: string;
+    } | {
+        status: "failed" | "not_available" | "not_requested";
+    };
+    paymentIds: string[];
+    groupId: string | null;
+    travelCreditRedemptionId: string | null;
+}, FinanceToolContext>];
+export declare const issueInvoiceFromBookingToolInputSchema: z.ZodObject<{
+    command: z.ZodObject<{
+        bookingId: z.ZodString;
+        bookingPaymentScheduleId: z.ZodOptional<z.ZodString>;
+        invoiceNumber: z.ZodOptional<z.ZodString>;
+        seriesId: z.ZodOptional<z.ZodString>;
+        convertedFromInvoiceId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        issueDate: z.ZodString;
+        dueDate: z.ZodString;
+        notes: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        currency: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        baseCurrency: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        fxRateSetId: z.ZodOptional<z.ZodString>;
+        subtotalCents: z.ZodOptional<z.ZodNumber>;
+        taxCents: z.ZodOptional<z.ZodNumber>;
+        totalCents: z.ZodOptional<z.ZodNumber>;
+        lineItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            quantity: z.ZodNumber;
+            unitAmountCents: z.ZodNumber;
+            taxRateBps: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+            taxAmountCents: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>>>;
+        paymentScheduleLineDescriptionFormat: z.ZodOptional<z.ZodEnum<{
+            schedule_first: "schedule_first";
+            product_first: "product_first";
+            product_only: "product_only";
+        }>>;
+        externalRefs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            provider: z.ZodString;
+            externalId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            externalNumber: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            externalUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            status: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            metadata: z.ZodNullable<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            syncedAt: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            syncError: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>>;
+        invoiceType: z.ZodDefault<z.ZodEnum<{
+            invoice: "invoice";
+            proforma: "proforma";
+        }>>;
+        skipExternalSync: z.ZodOptional<z.ZodBoolean>;
+        wait: z.ZodOptional<z.ZodPreprocess<z.ZodEnum<{
+            any: "any";
+            none: "none";
+            pdf: "pdf";
+        }>>>;
+        waitTimeoutMs: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>;
+    idempotencyKey: z.ZodString;
+    approvalId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const issueInvoiceFromBookingToolOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    status: z.ZodLiteral<"approval_required">;
+    requestedAction: z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodString;
+        actionName: z.ZodString;
+        targetType: z.ZodString;
+        targetId: z.ZodString;
+    }, z.core.$strip>;
+    approval: z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodString;
+        requestedActionId: z.ZodString;
+        policyName: z.ZodString;
+        policyVersion: z.ZodString;
+        riskSnapshot: z.ZodString;
+        reasonCode: z.ZodString;
+        expiresAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+    replayed: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"issued">;
+    invoice: z.ZodObject<{
+        id: z.ZodString;
+        invoiceNumber: z.ZodString;
+        invoiceType: z.ZodEnum<{
+            invoice: "invoice";
+            proforma: "proforma";
+            credit_note: "credit_note";
+        }>;
+        convertedFromInvoiceId: z.ZodNullable<z.ZodString>;
+        seriesId: z.ZodNullable<z.ZodString>;
+        sequence: z.ZodNullable<z.ZodNumber>;
+        templateId: z.ZodNullable<z.ZodString>;
+        taxRegimeId: z.ZodNullable<z.ZodString>;
+        language: z.ZodNullable<z.ZodString>;
+        bookingId: z.ZodString;
+        personId: z.ZodNullable<z.ZodString>;
+        organizationId: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            draft: "draft";
+            pending_external_allocation: "pending_external_allocation";
+            issued: "issued";
+            partially_paid: "partially_paid";
+            paid: "paid";
+            overdue: "overdue";
+            void: "void";
+        }>;
+        currency: z.ZodString;
+        baseCurrency: z.ZodNullable<z.ZodString>;
+        fxRateSetId: z.ZodNullable<z.ZodString>;
+        subtotalCents: z.ZodNumber;
+        baseSubtotalCents: z.ZodNullable<z.ZodNumber>;
+        taxCents: z.ZodNumber;
+        baseTaxCents: z.ZodNullable<z.ZodNumber>;
+        totalCents: z.ZodNumber;
+        baseTotalCents: z.ZodNullable<z.ZodNumber>;
+        paidCents: z.ZodNumber;
+        basePaidCents: z.ZodNullable<z.ZodNumber>;
+        balanceDueCents: z.ZodNumber;
+        baseBalanceDueCents: z.ZodNullable<z.ZodNumber>;
+        commissionPercent: z.ZodNullable<z.ZodNumber>;
+        commissionAmountCents: z.ZodNullable<z.ZodNumber>;
+        issueDate: z.ZodString;
+        dueDate: z.ZodString;
+        notes: z.ZodNullable<z.ZodString>;
+        voidedAt: z.ZodNullable<z.ZodString>;
+        voidReason: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>;
+    replayed: z.ZodBoolean;
+}, z.core.$strip>]>;
+export declare const issueInvoiceFromBookingTool: import("@voyant-travel/tools").ToolDefinition<{
+    command: {
+        bookingId: string;
+        issueDate: string;
+        dueDate: string;
+        invoiceType: "invoice" | "proforma";
+        bookingPaymentScheduleId?: string | undefined;
+        invoiceNumber?: string | undefined;
+        seriesId?: string | undefined;
+        convertedFromInvoiceId?: string | null | undefined;
+        notes?: string | null | undefined;
+        currency?: string | undefined;
+        baseCurrency?: string | undefined;
+        fxRateSetId?: string | undefined;
+        subtotalCents?: number | undefined;
+        taxCents?: number | undefined;
+        totalCents?: number | undefined;
+        lineItems?: {
+            description: string;
+            quantity: number;
+            unitAmountCents: number;
+            taxRateBps?: number | null | undefined;
+            taxAmountCents?: number | null | undefined;
+        }[] | undefined;
+        paymentScheduleLineDescriptionFormat?: "schedule_first" | "product_first" | "product_only" | undefined;
+        externalRefs?: {
+            provider: string;
+            externalId?: string | null | undefined;
+            externalNumber?: string | null | undefined;
+            externalUrl?: string | null | undefined;
+            status?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
+            syncedAt?: string | null | undefined;
+            syncError?: string | null | undefined;
+        }[] | undefined;
+        skipExternalSync?: boolean | undefined;
+        wait?: "pdf" | "any" | "none" | undefined;
+        waitTimeoutMs?: number | undefined;
+    };
+    idempotencyKey: string;
+    approvalId?: string | undefined;
+}, {
+    status: "approval_required";
+    requestedAction: {
+        id: string;
+        status: string;
+        actionName: string;
+        targetType: string;
+        targetId: string;
+    };
+    approval: {
+        id: string;
+        status: string;
+        requestedActionId: string;
+        policyName: string;
+        policyVersion: string;
+        riskSnapshot: string;
+        reasonCode: string;
+        expiresAt: string | null;
+        createdAt: string;
+    };
+    replayed: boolean;
+} | {
+    status: "issued";
+    invoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: "invoice" | "proforma" | "credit_note";
+        convertedFromInvoiceId: string | null;
+        seriesId: string | null;
+        sequence: number | null;
+        templateId: string | null;
+        taxRegimeId: string | null;
+        language: string | null;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void";
+        currency: string;
+        baseCurrency: string | null;
+        fxRateSetId: string | null;
+        subtotalCents: number;
+        baseSubtotalCents: number | null;
+        taxCents: number;
+        baseTaxCents: number | null;
+        totalCents: number;
+        baseTotalCents: number | null;
+        paidCents: number;
+        basePaidCents: number | null;
+        balanceDueCents: number;
+        baseBalanceDueCents: number | null;
+        commissionPercent: number | null;
+        commissionAmountCents: number | null;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        voidedAt: string | null;
+        voidReason: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+    replayed: boolean;
+}, FinanceToolContext>;
 export declare const financeTools: readonly [import("@voyant-travel/tools").ToolDefinition<{
     sortBy: "status" | "createdAt" | "invoiceNumber" | "totalCents" | "paidCents" | "balanceDueCents" | "issueDate" | "dueDate";
     sortDir: "asc" | "desc";
@@ -55,4 +832,157 @@ export declare const financeTools: readonly [import("@voyant-travel/tools").Tool
 }, unknown, FinanceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
     id: string;
     reason?: string | undefined;
-}, unknown, FinanceToolContext>];
+}, unknown, FinanceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    currency: string;
+    amountCents: number;
+    creditNoteNumber: string;
+    reason: string;
+    invoiceId: string;
+    idempotencyKey: string;
+    notes?: string | null | undefined;
+    baseCurrency?: string | null | undefined;
+    fxRateSetId?: string | null | undefined;
+    baseAmountCents?: number | null | undefined;
+    approvalId?: string | undefined;
+}, {
+    status: "approval_required";
+    requestedAction: {
+        id: string;
+        status: string;
+        actionName: string;
+        targetType: string;
+        targetId: string;
+    };
+    approval: {
+        id: string;
+        status: string;
+        requestedActionId: string;
+        policyName: string;
+        policyVersion: string;
+        riskSnapshot: string;
+        reasonCode: string;
+        expiresAt: string | null;
+        createdAt: string;
+    };
+    replayed: boolean;
+} | {
+    status: "issued";
+    creditNote: {
+        id: string;
+        creditNoteNumber: string;
+        invoiceId: string;
+        status: "draft" | "issued" | "applied";
+        amountCents: number;
+        currency: string;
+        baseCurrency: string | null;
+        baseAmountCents: number | null;
+        fxRateSetId: string | null;
+        reason: string;
+        notes: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+    replayed: boolean;
+}, FinanceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    command: {
+        bookingId: string;
+        issueDate: string;
+        dueDate: string;
+        invoiceType: "invoice" | "proforma";
+        bookingPaymentScheduleId?: string | undefined;
+        invoiceNumber?: string | undefined;
+        seriesId?: string | undefined;
+        convertedFromInvoiceId?: string | null | undefined;
+        notes?: string | null | undefined;
+        currency?: string | undefined;
+        baseCurrency?: string | undefined;
+        fxRateSetId?: string | undefined;
+        subtotalCents?: number | undefined;
+        taxCents?: number | undefined;
+        totalCents?: number | undefined;
+        lineItems?: {
+            description: string;
+            quantity: number;
+            unitAmountCents: number;
+            taxRateBps?: number | null | undefined;
+            taxAmountCents?: number | null | undefined;
+        }[] | undefined;
+        paymentScheduleLineDescriptionFormat?: "schedule_first" | "product_first" | "product_only" | undefined;
+        externalRefs?: {
+            provider: string;
+            externalId?: string | null | undefined;
+            externalNumber?: string | null | undefined;
+            externalUrl?: string | null | undefined;
+            status?: string | null | undefined;
+            metadata?: Record<string, unknown> | null | undefined;
+            syncedAt?: string | null | undefined;
+            syncError?: string | null | undefined;
+        }[] | undefined;
+        skipExternalSync?: boolean | undefined;
+        wait?: "pdf" | "any" | "none" | undefined;
+        waitTimeoutMs?: number | undefined;
+    };
+    idempotencyKey: string;
+    approvalId?: string | undefined;
+}, {
+    status: "approval_required";
+    requestedAction: {
+        id: string;
+        status: string;
+        actionName: string;
+        targetType: string;
+        targetId: string;
+    };
+    approval: {
+        id: string;
+        status: string;
+        requestedActionId: string;
+        policyName: string;
+        policyVersion: string;
+        riskSnapshot: string;
+        reasonCode: string;
+        expiresAt: string | null;
+        createdAt: string;
+    };
+    replayed: boolean;
+} | {
+    status: "issued";
+    invoice: {
+        id: string;
+        invoiceNumber: string;
+        invoiceType: "invoice" | "proforma" | "credit_note";
+        convertedFromInvoiceId: string | null;
+        seriesId: string | null;
+        sequence: number | null;
+        templateId: string | null;
+        taxRegimeId: string | null;
+        language: string | null;
+        bookingId: string;
+        personId: string | null;
+        organizationId: string | null;
+        status: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void";
+        currency: string;
+        baseCurrency: string | null;
+        fxRateSetId: string | null;
+        subtotalCents: number;
+        baseSubtotalCents: number | null;
+        taxCents: number;
+        baseTaxCents: number | null;
+        totalCents: number;
+        baseTotalCents: number | null;
+        paidCents: number;
+        basePaidCents: number | null;
+        balanceDueCents: number;
+        baseBalanceDueCents: number | null;
+        commissionPercent: number | null;
+        commissionAmountCents: number | null;
+        issueDate: string;
+        dueDate: string;
+        notes: string | null;
+        voidedAt: string | null;
+        voidReason: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+    replayed: boolean;
+}, FinanceToolContext>];