@voyant-travel/finance 0.138.9 → 0.139.0

package/dist/tools.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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
+ * by intersection so this module stays deployment-agnostic.
+ */
+import { type ToolContext } from "@voyant-travel/tools";
+import { z } from "zod";
+import { invoiceListQuerySchema } from "./validation.js";
+export interface FinanceToolServices {
+    listInvoices(query: z.infer<typeof invoiceListQuerySchema>): Promise<unknown>;
+    getInvoiceById(id: string): Promise<unknown>;
+    voidInvoice(id: string, input: {
+        reason?: string;
+    }): Promise<unknown>;
+}
+export type FinanceToolContext = ToolContext & {
+    finance?: FinanceToolServices;
+};
+export declare const listInvoicesTool: import("@voyant-travel/tools").ToolDefinition<{
+    sortBy: "status" | "createdAt" | "invoiceNumber" | "totalCents" | "paidCents" | "balanceDueCents" | "issueDate" | "dueDate";
+    sortDir: "asc" | "desc";
+    limit: number;
+    offset: number;
+    status?: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void" | undefined;
+    bookingId?: string | undefined;
+    personId?: string | undefined;
+    organizationId?: string | undefined;
+    currency?: string | undefined;
+    dueDateFrom?: string | undefined;
+    dueDateTo?: string | undefined;
+    search?: string | undefined;
+}, unknown, FinanceToolContext>;
+export declare const getInvoiceTool: import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+}, unknown, FinanceToolContext>;
+export declare const voidInvoiceTool: import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+    reason?: string | undefined;
+}, unknown, FinanceToolContext>;
+export declare const financeTools: readonly [import("@voyant-travel/tools").ToolDefinition<{
+    sortBy: "status" | "createdAt" | "invoiceNumber" | "totalCents" | "paidCents" | "balanceDueCents" | "issueDate" | "dueDate";
+    sortDir: "asc" | "desc";
+    limit: number;
+    offset: number;
+    status?: "draft" | "pending_external_allocation" | "issued" | "partially_paid" | "paid" | "overdue" | "void" | undefined;
+    bookingId?: string | undefined;
+    personId?: string | undefined;
+    organizationId?: string | undefined;
+    currency?: string | undefined;
+    dueDateFrom?: string | undefined;
+    dueDateTo?: string | undefined;
+    search?: string | undefined;
+}, unknown, FinanceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+}, unknown, FinanceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+    reason?: string | undefined;
+}, unknown, FinanceToolContext>];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACnG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAExD,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7E,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5C,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACtE;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAAE,OAAO,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAA;AAMhF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;+BAe3B,CAAA;AAIF,eAAO,MAAM,cAAc;;+BAezB,CAAA;AAOF,eAAO,MAAM,eAAe;;;+BAqB1B,CAAA;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;gCAA+D,CAAA"}

package/dist/tools.js

@@ -0,0 +1,58 @@
+/**
+ * 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
+ * by intersection so this module stays deployment-agnostic.
+ */
+import { defineTool, READ_ONLY_RISK, requireService } from "@voyant-travel/tools";
+import { z } from "zod";
+import { invoiceListQuerySchema } from "./validation.js";
+function finance(ctx) {
+    return requireService(ctx.finance, "finance");
+}
+export const listInvoicesTool = defineTool({
+    name: "list_invoices",
+    description: "List invoices with filters and pagination. Read-only.",
+    inputSchema: invoiceListQuerySchema,
+    outputSchema: z.custom(),
+    requiredScopes: ["finance:read"],
+    tier: "read",
+    riskPolicy: READ_ONLY_RISK,
+    async handler(query, ctx) {
+        return finance(ctx).listInvoices(query);
+    },
+});
+const getInvoiceArgs = z.object({ id: z.string().min(1).describe("The invoice id.") });
+export const getInvoiceTool = defineTool({
+    name: "get_invoice",
+    description: "Read a single invoice by id. Read-only.",
+    inputSchema: getInvoiceArgs,
+    outputSchema: z.custom(),
+    requiredScopes: ["finance:read"],
+    tier: "read",
+    riskPolicy: READ_ONLY_RISK,
+    async handler({ id }, ctx) {
+        return finance(ctx).getInvoiceById(id);
+    },
+});
+const voidInvoiceArgs = z.object({
+    id: z.string().min(1).describe("The invoice id to void."),
+    reason: z.string().optional().describe("Optional reason recorded on the void."),
+});
+export const voidInvoiceTool = defineTool({
+    name: "void_invoice",
+    description: "Void an invoice (irreversible). Returns a not-found status when the invoice does not exist.",
+    inputSchema: voidInvoiceArgs,
+    outputSchema: z.custom(),
+    requiredScopes: ["finance:void"],
+    tier: "destructive",
+    riskPolicy: {
+        destructive: true,
+        reversible: false,
+        dryRunSupported: false,
+        confirmationRequired: true,
+    },
+    async handler({ id, reason }, ctx) {
+        return finance(ctx).voidInvoice(id, { reason });
+    },
+});
+export const financeTools = [listInvoicesTool, getInvoiceTool, voidInvoiceTool];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/finance",
-  "version": "0.138.9",
+  "version": "0.139.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -93,6 +93,11 @@
       "types": "./dist/validation-public.d.ts",
       "import": "./dist/validation-public.js",
       "default": "./dist/validation-public.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js",
+      "default": "./dist/tools.js"
     }
   },
   "dependencies": {
@@ -100,17 +105,18 @@
     "@voyant-travel/data-sdk": "^0.7.1",
     "drizzle-orm": "^0.45.2",
     "fflate": "^0.8.2",
-    "hono": "^4.12.25",
+    "hono": "^4.12.27",
     "zod": "^4.4.3",
-    "@voyant-travel/action-ledger": "^0.105.11",
-    "@voyant-travel/core": "^0.111.1",
-    "@voyant-travel/bookings": "^0.138.8",
-    "@voyant-travel/db": "^0.109.4",
-    "@voyant-travel/types": "^0.106.1",
-    "@voyant-travel/storage": "^0.106.0",
-    "@voyant-travel/utils": "^0.105.5",
+    "@voyant-travel/bookings": "^0.139.0",
+    "@voyant-travel/core": "^0.112.0",
+    "@voyant-travel/action-ledger": "^0.105.12",
+    "@voyant-travel/db": "^0.109.5",
+    "@voyant-travel/types": "^0.107.0",
     "@voyant-travel/finance-contracts": "^0.105.9",
-    "@voyant-travel/hono": "^0.120.1"
+    "@voyant-travel/hono": "^0.121.0",
+    "@voyant-travel/storage": "^0.106.0",
+    "@voyant-travel/utils": "^0.105.6",
+    "@voyant-travel/tools": "^0.1.0"
   },
   "devDependencies": {
     "drizzle-kit": "^0.31.10",