@voyant-travel/mice 0.14.0 → 0.16.0

package/dist/mcp-runtime.d.ts

@@ -0,0 +1,2 @@
+export * from "./tools.js";
+export declare const voyantToolContextContribution: import("@voyant-travel/tools").ToolContextContribution;

package/dist/mcp-runtime.js

@@ -0,0 +1,17 @@
+import { defineToolContextContribution } from "@voyant-travel/tools";
+import { miceService } from "./service.js";
+export * from "./tools.js";
+export const voyantToolContextContribution = defineToolContextContribution({
+    context: ["mice"],
+    contribute: ({ context }) => {
+        const db = context.db;
+        return {
+            mice: {
+                listPrograms: (query) => miceService.listPrograms(db, query),
+                getProgram: (id) => miceService.getProgram(db, id),
+                createProgram: (input) => miceService.createProgram(db, input),
+                updateProgram: ({ id, ...input }) => miceService.updateProgram(db, id, input),
+            },
+        };
+    },
+});

package/dist/tools.d.ts

@@ -0,0 +1,293 @@
+/** Module-owned Tools for the MICE program lifecycle. */
+import { type ToolContext } from "@voyant-travel/tools";
+import { z } from "zod";
+import { createProgramSchema, programListQuerySchema } from "./validation.js";
+declare const updateProgramToolSchema: z.ZodIntersection<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        other: "other";
+        meeting: "meeting";
+        incentive: "incentive";
+        conference: "conference";
+        exhibition: "exhibition";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        lead: "lead";
+        planning: "planning";
+        contracted: "contracted";
+        operating: "operating";
+        completed: "completed";
+        cancelled: "cancelled";
+    }>>;
+    organizationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    primaryContactPersonId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    accountManagerId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    code: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    destination: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    endDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    estimatedPax: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    confirmedPax: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    currency: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    budgetAmountCents: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>>;
+type ProgramListQuery = z.infer<typeof programListQuerySchema>;
+type CreateProgramInput = z.infer<typeof createProgramSchema>;
+type UpdateProgramInput = z.infer<typeof updateProgramToolSchema>;
+export interface MiceToolServices {
+    listPrograms(query: ProgramListQuery): Promise<unknown>;
+    getProgram(id: string): Promise<unknown>;
+    createProgram(input: CreateProgramInput): Promise<unknown>;
+    updateProgram(input: UpdateProgramInput): Promise<unknown>;
+}
+export type MiceToolContext = ToolContext & {
+    mice?: MiceToolServices;
+};
+export declare const listMiceProgramsTool: import("@voyant-travel/tools").ToolDefinition<{
+    limit: number;
+    offset: number;
+    status?: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled" | undefined;
+    type?: "other" | "meeting" | "incentive" | "conference" | "exhibition" | undefined;
+    organizationId?: string | undefined;
+}, {
+    data: {
+        id: string;
+        organizationId: string | null;
+        primaryContactPersonId: string | null;
+        accountManagerId: string | null;
+        name: string;
+        code: string | null;
+        type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+        status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+        destination: string | null;
+        startDate: string | null;
+        endDate: string | null;
+        estimatedPax: number | null;
+        confirmedPax: number | null;
+        currency: string | null;
+        budgetAmountCents: number | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+    limit: number;
+    offset: number;
+}, MiceToolContext>;
+export declare const getMiceProgramTool: import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+}, {
+    id: string;
+    organizationId: string | null;
+    primaryContactPersonId: string | null;
+    accountManagerId: string | null;
+    name: string;
+    code: string | null;
+    type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+    status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+    destination: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    estimatedPax: number | null;
+    confirmedPax: number | null;
+    currency: string | null;
+    budgetAmountCents: number | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+} | null, MiceToolContext>;
+export declare const createMiceProgramTool: import("@voyant-travel/tools").ToolDefinition<{
+    type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+    status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+    name: string;
+    organizationId?: string | undefined;
+    primaryContactPersonId?: string | undefined;
+    accountManagerId?: string | undefined;
+    code?: string | undefined;
+    destination?: string | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    estimatedPax?: number | undefined;
+    confirmedPax?: number | undefined;
+    currency?: string | undefined;
+    budgetAmountCents?: number | undefined;
+}, {
+    id: string;
+    organizationId: string | null;
+    primaryContactPersonId: string | null;
+    accountManagerId: string | null;
+    name: string;
+    code: string | null;
+    type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+    status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+    destination: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    estimatedPax: number | null;
+    confirmedPax: number | null;
+    currency: string | null;
+    budgetAmountCents: number | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}, MiceToolContext>;
+export declare const updateMiceProgramTool: import("@voyant-travel/tools").ToolDefinition<{
+    name?: string | undefined;
+    type?: "other" | "meeting" | "incentive" | "conference" | "exhibition" | undefined;
+    status?: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled" | undefined;
+    organizationId?: string | null | undefined;
+    primaryContactPersonId?: string | null | undefined;
+    accountManagerId?: string | null | undefined;
+    code?: string | null | undefined;
+    destination?: string | null | undefined;
+    startDate?: string | null | undefined;
+    endDate?: string | null | undefined;
+    estimatedPax?: number | null | undefined;
+    confirmedPax?: number | null | undefined;
+    currency?: string | null | undefined;
+    budgetAmountCents?: number | null | undefined;
+} & {
+    id: string;
+}, {
+    id: string;
+    organizationId: string | null;
+    primaryContactPersonId: string | null;
+    accountManagerId: string | null;
+    name: string;
+    code: string | null;
+    type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+    status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+    destination: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    estimatedPax: number | null;
+    confirmedPax: number | null;
+    currency: string | null;
+    budgetAmountCents: number | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+} | null, MiceToolContext>;
+export declare const miceTools: readonly [import("@voyant-travel/tools").ToolDefinition<{
+    limit: number;
+    offset: number;
+    status?: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled" | undefined;
+    type?: "other" | "meeting" | "incentive" | "conference" | "exhibition" | undefined;
+    organizationId?: string | undefined;
+}, {
+    data: {
+        id: string;
+        organizationId: string | null;
+        primaryContactPersonId: string | null;
+        accountManagerId: string | null;
+        name: string;
+        code: string | null;
+        type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+        status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+        destination: string | null;
+        startDate: string | null;
+        endDate: string | null;
+        estimatedPax: number | null;
+        confirmedPax: number | null;
+        currency: string | null;
+        budgetAmountCents: number | null;
+        metadata: Record<string, unknown> | null;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+    limit: number;
+    offset: number;
+}, MiceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    id: string;
+}, {
+    id: string;
+    organizationId: string | null;
+    primaryContactPersonId: string | null;
+    accountManagerId: string | null;
+    name: string;
+    code: string | null;
+    type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+    status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+    destination: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    estimatedPax: number | null;
+    confirmedPax: number | null;
+    currency: string | null;
+    budgetAmountCents: number | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+} | null, MiceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+    status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+    name: string;
+    organizationId?: string | undefined;
+    primaryContactPersonId?: string | undefined;
+    accountManagerId?: string | undefined;
+    code?: string | undefined;
+    destination?: string | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    estimatedPax?: number | undefined;
+    confirmedPax?: number | undefined;
+    currency?: string | undefined;
+    budgetAmountCents?: number | undefined;
+}, {
+    id: string;
+    organizationId: string | null;
+    primaryContactPersonId: string | null;
+    accountManagerId: string | null;
+    name: string;
+    code: string | null;
+    type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+    status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+    destination: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    estimatedPax: number | null;
+    confirmedPax: number | null;
+    currency: string | null;
+    budgetAmountCents: number | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+}, MiceToolContext>, import("@voyant-travel/tools").ToolDefinition<{
+    name?: string | undefined;
+    type?: "other" | "meeting" | "incentive" | "conference" | "exhibition" | undefined;
+    status?: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled" | undefined;
+    organizationId?: string | null | undefined;
+    primaryContactPersonId?: string | null | undefined;
+    accountManagerId?: string | null | undefined;
+    code?: string | null | undefined;
+    destination?: string | null | undefined;
+    startDate?: string | null | undefined;
+    endDate?: string | null | undefined;
+    estimatedPax?: number | null | undefined;
+    confirmedPax?: number | null | undefined;
+    currency?: string | null | undefined;
+    budgetAmountCents?: number | null | undefined;
+} & {
+    id: string;
+}, {
+    id: string;
+    organizationId: string | null;
+    primaryContactPersonId: string | null;
+    accountManagerId: string | null;
+    name: string;
+    code: string | null;
+    type: "other" | "meeting" | "incentive" | "conference" | "exhibition";
+    status: "lead" | "planning" | "contracted" | "operating" | "completed" | "cancelled";
+    destination: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    estimatedPax: number | null;
+    confirmedPax: number | null;
+    currency: string | null;
+    budgetAmountCents: number | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+    updatedAt: string;
+} | null, MiceToolContext>];
+export {};

package/dist/tools.js

@@ -0,0 +1,124 @@
+/** Module-owned Tools for the MICE program lifecycle. */
+import { defineTool, READ_ONLY_RISK, requireService } from "@voyant-travel/tools";
+import { z } from "zod";
+import { createProgramSchema, programListQuerySchema, programStatusSchema, programTypeSchema, updateProgramSchema, } from "./validation.js";
+const OWNER = "@voyant-travel/mice";
+const STAFF_AUDIENCE = { source: "grant", allowed: ["staff"] };
+const READ_METADATA = {
+    owner: OWNER,
+    capabilityVersion: "v1",
+    requiredScopes: ["mice:read"],
+    audience: STAFF_AUDIENCE,
+    tier: "read",
+    riskPolicy: READ_ONLY_RISK,
+    annotations: { readOnlyHint: true, idempotentHint: true },
+};
+const WRITE_METADATA = {
+    owner: OWNER,
+    capabilityVersion: "v1",
+    requiredScopes: ["mice:write"],
+    audience: STAFF_AUDIENCE,
+    tier: "write",
+    riskPolicy: {
+        destructive: false,
+        reversible: true,
+        dryRunSupported: false,
+        confirmationRequired: false,
+        sideEffects: ["data-write"],
+    },
+};
+const idArgsSchema = z.object({ id: z.string().min(1) });
+const programValueSchema = z.object({
+    id: z.string(),
+    organizationId: z.string().nullable(),
+    primaryContactPersonId: z.string().nullable(),
+    accountManagerId: z.string().nullable(),
+    name: z.string(),
+    code: z.string().nullable(),
+    type: programTypeSchema,
+    status: programStatusSchema,
+    destination: z.string().nullable(),
+    startDate: z.string().nullable(),
+    endDate: z.string().nullable(),
+    estimatedPax: z.number().int().nullable(),
+    confirmedPax: z.number().int().nullable(),
+    currency: z.string().nullable(),
+    budgetAmountCents: z.number().int().nullable(),
+    metadata: z.record(z.string(), z.unknown()).nullable(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+});
+const programListValueSchema = z.object({
+    data: z.array(programValueSchema),
+    limit: z.number().int(),
+    offset: z.number().int(),
+});
+const updateProgramToolSchema = updateProgramSchema.and(idArgsSchema);
+function mice(ctx) {
+    return requireService(ctx.mice, "mice");
+}
+export const listMiceProgramsTool = defineTool({
+    ...READ_METADATA,
+    capabilityId: `${OWNER}#tool.list-programs`,
+    name: "list_mice_programs",
+    description: "List staff-visible meetings, incentives, conferences, and exhibition programs.",
+    inputSchema: programListQuerySchema,
+    outputSchema: programListValueSchema,
+    async handler(query, ctx) {
+        return parseJsonResult(programListValueSchema, await mice(ctx).listPrograms(query));
+    },
+});
+export const getMiceProgramTool = defineTool({
+    ...READ_METADATA,
+    capabilityId: `${OWNER}#tool.get-program`,
+    name: "get_mice_program",
+    description: "Read one MICE program, including buyer, dates, attendance, and budget fields.",
+    inputSchema: idArgsSchema,
+    outputSchema: programValueSchema.nullable(),
+    async handler({ id }, ctx) {
+        return parseJsonResult(programValueSchema.nullable(), await mice(ctx).getProgram(id));
+    },
+});
+export const createMiceProgramTool = defineTool({
+    ...WRITE_METADATA,
+    capabilityId: `${OWNER}#tool.create-program`,
+    name: "create_mice_program",
+    description: "Create a MICE program with validated dates, lifecycle status, and budget data.",
+    inputSchema: createProgramSchema,
+    outputSchema: programValueSchema,
+    async handler(input, ctx) {
+        return parseJsonResult(programValueSchema, await mice(ctx).createProgram(input));
+    },
+});
+export const updateMiceProgramTool = defineTool({
+    ...WRITE_METADATA,
+    capabilityId: `${OWNER}#tool.update-program`,
+    name: "update_mice_program",
+    description: "Update a MICE program's ownership, dates, lifecycle, attendance, or budget.",
+    inputSchema: updateProgramToolSchema,
+    outputSchema: programValueSchema.nullable(),
+    annotations: { idempotentHint: true },
+    async handler(input, ctx) {
+        return parseJsonResult(programValueSchema.nullable(), await mice(ctx).updateProgram(input));
+    },
+});
+export const miceTools = [
+    listMiceProgramsTool,
+    getMiceProgramTool,
+    createMiceProgramTool,
+    updateMiceProgramTool,
+];
+function parseJsonResult(schema, value) {
+    return schema.parse(toJsonValue(value));
+}
+function toJsonValue(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (Array.isArray(value))
+        return value.map(toJsonValue);
+    if (typeof value !== "object" || value === null)
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .map(([key, nested]) => [key, toJsonValue(nested)])
+        .filter(([, nested]) => nested !== undefined));
+}

package/dist/voyant.js

@@ -148,6 +148,86 @@ export const miceVoyantModule = defineModule({
             },
         ],
     },
+    tools: [
+        {
+            id: "@voyant-travel/mice#tool.list-programs",
+            name: "list_mice_programs",
+            runtime: { entry: "@voyant-travel/mice/tools", export: "listMiceProgramsTool" },
+            requiredScopes: ["mice:read"],
+            context: ["mice"],
+            risk: "low",
+        },
+        {
+            id: "@voyant-travel/mice#tool.get-program",
+            name: "get_mice_program",
+            runtime: { entry: "@voyant-travel/mice/tools", export: "getMiceProgramTool" },
+            requiredScopes: ["mice:read"],
+            context: ["mice"],
+            risk: "low",
+        },
+        {
+            id: "@voyant-travel/mice#tool.create-program",
+            name: "create_mice_program",
+            runtime: { entry: "@voyant-travel/mice/tools", export: "createMiceProgramTool" },
+            requiredScopes: ["mice:write"],
+            context: ["mice"],
+            risk: "medium",
+        },
+        {
+            id: "@voyant-travel/mice#tool.update-program",
+            name: "update_mice_program",
+            runtime: { entry: "@voyant-travel/mice/tools", export: "updateMiceProgramTool" },
+            requiredScopes: ["mice:write"],
+            context: ["mice"],
+            risk: "medium",
+        },
+    ],
+    actions: [
+        {
+            id: "@voyant-travel/mice#action.list-programs",
+            version: "v1",
+            kind: "read",
+            targetType: "mice-program",
+            requiredScopes: ["mice:read"],
+            risk: "low",
+            ledger: "optional",
+            from: { tools: ["@voyant-travel/mice#tool.list-programs"] },
+        },
+        {
+            id: "@voyant-travel/mice#action.get-program",
+            version: "v1",
+            kind: "read",
+            targetType: "mice-program",
+            requiredScopes: ["mice:read"],
+            risk: "low",
+            ledger: "optional",
+            from: { tools: ["@voyant-travel/mice#tool.get-program"] },
+        },
+        {
+            id: "@voyant-travel/mice#action.create-program",
+            version: "v1",
+            kind: "execute",
+            targetType: "mice-program",
+            requiredScopes: ["mice:write"],
+            risk: "medium",
+            ledger: "required",
+            approval: "never",
+            reversible: true,
+            from: { tools: ["@voyant-travel/mice#tool.create-program"] },
+        },
+        {
+            id: "@voyant-travel/mice#action.update-program",
+            version: "v1",
+            kind: "execute",
+            targetType: "mice-program",
+            requiredScopes: ["mice:write"],
+            risk: "medium",
+            ledger: "required",
+            approval: "never",
+            reversible: true,
+            from: { tools: ["@voyant-travel/mice#tool.update-program"] },
+        },
+    ],
     events: [
         {
             id: "@voyant-travel/mice#event.rfp-awarded",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/mice",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -44,6 +44,16 @@
       "import": "./dist/runtime-contributor.js",
       "default": "./dist/runtime-contributor.js"
     },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js",
+      "default": "./dist/tools.js"
+    },
+    "./mcp-runtime": {
+      "types": "./dist/mcp-runtime.d.ts",
+      "import": "./dist/mcp-runtime.js",
+      "default": "./dist/mcp-runtime.js"
+    },
     "./voyant": {
       "types": "./dist/voyant.d.ts",
       "import": "./dist/voyant.js",
@@ -57,17 +67,18 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.27",
     "zod": "^4.4.3",
-    "@voyant-travel/db": "^0.114.5",
-    "@voyant-travel/hono": "^0.126.3",
-    "@voyant-travel/operations": "^0.6.13",
-    "@voyant-travel/accommodations": "^0.118.0",
-    "@voyant-travel/core": "^0.122.2"
+    "@voyant-travel/core": "^0.124.0",
+    "@voyant-travel/db": "^0.114.7",
+    "@voyant-travel/hono": "^0.127.1",
+    "@voyant-travel/tools": "^0.3.0",
+    "@voyant-travel/operations": "^0.7.0",
+    "@voyant-travel/accommodations": "^0.120.0"
   },
   "peerDependencies": {
-    "@voyant-travel/bookings": "^0.158.0",
-    "@voyant-travel/distribution": "^0.148.0",
-    "@voyant-travel/relationships": "^0.125.3",
-    "@voyant-travel/quotes": "^0.128.7"
+    "@voyant-travel/bookings": "^0.160.0",
+    "@voyant-travel/relationships": "^0.126.0",
+    "@voyant-travel/quotes": "^0.129.0",
+    "@voyant-travel/distribution": "^0.150.0"
   },
   "devDependencies": {
     "drizzle-kit": "^0.31.10",